CC Bridge
github.com/ranaroussi/cc-bridge- Category
- Developer Tools
- Rank
- No. 1698Tools index
Previous survey · No. 1601 ·
- Pricing
- Open Source
- Platform
- cli · desktop
- Type
- TOOL
- Builder
- @ranaroussi
- GitHub
- 53 stars
- Latest release
- v0.1.7
- Date
About
A bridge server that wraps the official Claude Code CLI to provide Anthropic API compatibility for local development. Allows developers to use their existing Anthropic SDK code with local Claude CLI authentication when OAuth tokens are restricted.
What it does
CC Bridge runs an HTTP service that translates message requests into authenticated Claude CLI processes, then reshapes their output for Anthropic SDK clients. It handles ordinary responses, Server-Sent Events, system prompts, tool exchanges, structured output, images, documents, and simulated thinking.
Why it's ranked here
This is a useful compatibility sandbox with unusually broad request shaping and both binary and macOS app distribution. The implementation also exposes its compromises clearly: several accepted controls do nothing, tool use relies on prompt and schema emulation, and the project explicitly rejects production status.
What's good
Existing JavaScript and Python SDK clients can target the local endpoint by changing their base address. Streaming emits the expected event sequence. Structured output uses JSON Schema enforcement. Base64 media gets temporary files with cleanup. Unit and integration test commands cover the translation layer.
Tradeoffs
The Claude CLI must already be installed and authenticated. Temperature, probability controls, output limits, and stop sequences are accepted but ignored. Tool requests buffer the full CLI response before emitting events. Thinking is prompt-engineered rather than native. The server defaults to all network interfaces and launches the CLI with permission checks skipped.
How to use it well
Use it for local experiments, integration tests, scripts, and developer tools that already speak the Anthropic messages format. Bind it to localhost when remote access is unnecessary, set an execution timeout, and validate important behavior against the official API. It does not replace supported production access, precise sampling control, beta headers, prompt caching, computer use, or batch requests.
Technical notes+
The Go module is declared in go.mod and built from ./src by Makefile, with cross-compilation targets for macOS, Linux, and Windows. src/main.go registers /v1/messages and /health, defaults to 0.0.0.0:8321, and implements signal-driven shutdown. src/handler.go validates requests, manages media cleanup, and selects streaming or non-streaming execution. src/mapper.go builds claude -p arguments with --no-session-persistence, --dangerously-skip-permissions, Read access, optional JSON Schema, and model-name reduction. src/cli.go executes the child process and decodes JSON. src/streaming.go translates CLI events into SSE, but buffers tool-mode output. src/tools.go implements prompt-based tool and thinking emulation. src/vision.go writes decoded media into temporary directories. src/tools_test.go and src/mapper_test.go exercise tool parsing, prompt conversion, model mapping, and argument construction.
Observed
- License
- MIT License
- Primary implementation
- Go HTTP server, with a Swift macOS menu bar app described in the repository structure
- Install surface
- Signed macOS DMG, pre-built binaries, source build, and local binary installation target
- Platforms
- macOS x64 and ARM64, Linux x64 and ARM64, and Windows x64
- Interfaces
- Command-line server and HTTP API with messages, health, JSON responses, and Server-Sent Events
- Testing
- Go unit tests are colocated under src, with a separate integration test target requiring an authenticated Claude CLI
Read from README.md, go.mod, Makefile, src/cli.go, src/main.go, src/tools.go, src/types.go, src/mapper.go, src/vision.go, src/handler.go, src/version.go, src/streaming.go, src/tools_test.go, src/mapper_test.go.
What it can do
Wrap Claude Code CLI with API-compatible interface
Claude Code CLI installation → Anthropic API-compatible bridge server
Enable local development with existing Anthropic SDK code
Anthropic SDK code and local Claude CLI authentication → Functional local development environment
Bypass OAuth token restrictions
Local Claude CLI credentials → Access to Claude functionality without OAuth tokens
Transform Claude CLI responses to Anthropic API format
Claude CLI output → Anthropic API-compatible JSON responses
Provide bridge server for development workflows
Developer requests through existing SDK → Claude responses via local CLI authentication
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.