ccproxy-server
v0.1.0
Published
OpenAI- and Anthropic-compatible HTTP API served by your local Claude Code CLI, with API keys, admin console and request logs
Maintainers
Readme
ccproxy-server
An OpenAI- and Anthropic-compatible HTTP API served by the Claude Code CLI on the machine where this server runs. Apps and SDKs that talk to OpenAI, Anthropic or OpenRouter can point at it instead and use your Claude Code subscription.
Full documentation, comparison and client packages: https://github.com/wubbyweb/ccproxy
Requirements (server machine only)
- Node.js 18+
- Claude Code installed and logged in:
claude --versionworks andclaude -p "hi"answers
Clients of this server need neither. They only need the server's URL and an API key.
Install and run
npm install -g ccproxy-server
ccproxy doctor # checks the Claude Code CLI can answer a turn
ccproxy serve # http://127.0.0.1:8787
ccproxy admin token # token for the admin console at /adminOpen http://127.0.0.1:8787/admin, sign in with the token, create an API key, and give that key to your apps:
curl -s http://127.0.0.1:8787/v1/chat/completions \
-H "Authorization: Bearer sk-ccp-..." -H "Content-Type: application/json" \
-d '{"model":"sonnet","messages":[{"role":"user","content":"Hello!"}]}'Clients: npm install ccproxy-client, pip install ccproxy-client, or the official openai / anthropic SDKs with the base URL set to this server.
Commands
ccproxy serve [--port 8787] [--host 127.0.0.1]
ccproxy admin token | reset-token
ccproxy keys list | create [--name <label>] | disable <ref> | enable <ref> | revoke <ref>
ccproxy doctorConfiguration is by environment variables (CCPROXY_PORT, CCPROXY_HOST, CCPROXY_DEFAULT_MODEL, CCPROXY_MAX_CONCURRENCY, CCPROXY_RATE_LIMIT, CCPROXY_LOG_LEVEL, ...) or ~/.ccproxy/config.json. See the repository README for the full table.
Note on terms
Claude Code consumer plans are licensed for your own use. Serving other people's applications from one may violate Anthropic's usage policies. Check your plan's terms before exposing this beyond personal experimentation.
