Ccproxy

ccproxy

OpenAI-compatible HTTP proxy in front of a locally-installed Claude Code CLI. Any client that speaks `POST /v1/chat/completions` (n8n, LibreChat, Open WebUI, the `openai` SDKs) can drive Claude Code over the network. Callers inherit the host's MCP servers, skills, subagents, and Bash tool access: that's the whole product.

Status

**Actively in development.** ccproxy is pre-1.0: the wire surface (headers, config schema, scopes) may still shift between minor versions. Expect breaking changes; pin a specific version (`go install …@v0.x.y`) if you deploy it, and read the commit log before upgrading. Bug reports and PRs welcome.

Requirements

• Go 1.26+ (only for go install or building from source)
• A working claude binary on $PATH (or set claude_binary: in config.yaml)
• macOS or Linux

Install

Two **feature profiles** are available, regardless of how you install:

• A. Server only (no bridge): the standard install. Server runs chat against ephemeral or pre-configured workspaces. No system dependencies.
• B. Server + bridge: adds the optional Bridge feature, where Claude Code operates on a directory mounted from a user's laptop. Requires a system FUSE library on the server host (the bridge_fuse build tag links it in) and a separate daemon binary on the user side.

And two **installation methods**:

• Install from Go package registry (go install): the fastest path. Fetches a tagged release from GitHub and drops the binary into $GOBIN (or $(go env GOPATH)/bin). Make sure that directory is on your $PATH. Pin a specific version with @v0.2.0, or track main with @main.
• Install from source: clone the repo and go build. Use this when you're hacking on the code or you need a build flag the package install doesn't take.

Install from Go package registry

A. Server only

Single command:

go install github.com/guryn/ccproxy/cmd/ccproxy@latest
ccproxy version

You can run `ccpro