Cursor Bridge runs Claude Code through Cursor

cursor-bridge is a Rust binary that lets subscribers run Claude Code through Cursor’s backend, using Cursor’s included Auto model without separate Anthropic API credits or a Claude Pro plan. The project is designed to require no proxy management, environment-variable setup, or manual cleanup.

With Cursor installed and authenticated, users can run:

''bash cursor-bridge # interactive session cursor-bridge “refactor this file” cursor-bridge -p “list files” # one-shot prompt ''

It also supports pipe mode. The tool replaces claude as the command users launch: it starts the proxy, runs Claude Code, and shuts everything down when the terminal session ends.

How cursor-bridge works

The binary:

Recommended reading

560,000 AI apps hit Apple’s App Store in six months

• Starts a local HTTP proxy on a random port
• Reads the Cursor authentication token from the macOS keychain, or from CURSOR_TOKEN on Linux
• Spawns claude with environment variables directed at the proxy
• Translates Anthropic API calls to the Cursor agent CLI
• Cleans up on exit

The project contrasts this with existing tools such as cursor-api-proxy, cursor-composer-in-claude, and cursor-proxy. Those are Node.js background servers that require a process, a port, manual environment-variable wiring, and additional packages. cursor-bridge is a single statically compiled Rust binary of about 780 KB, rather than a Node.js setup of roughly 60+ MB.

Installation and limitations

Prerequisites include Cursor with the agent CLI authenticated using agent login, plus the Claude Code CLI:

''bash curl -O https://claude-code.anthropic.com/claude && chmod +x claude cargo install cursor-bridge ''

Binaries are also available from Releases. The requirements are macOS or Linux, a Cursor subscription with agent in PATH, and claude in PATH. macOS reads the token automatically; Linux requires CURSOR_TOKEN and has no keychain fallback.

The project currently has no workspace sandboxing, so the agent runs in the current directory. It supports a single account, with no multi-account rotation yet. cursor-bridge is not affiliated with Anthropic or Cursor/Anysphere, is provided at the user’s own risk, and is licensed under MIT.