mirror of
https://github.com/Finesssee/ProxyPilot.git
synced 2026-11-19 02:17:46 +00:00
3.1 KiB
3.1 KiB
Claude Code via CLIProxyAPI (local proxy)
This documents how to route Claude Code through CLIProxyAPI, and the related server changes made to improve model aliasing and auth error reporting.
What we configured (Windows/macOS)
- Run CLIProxyAPI locally (default in this repo uses
127.0.0.1:8318). - Point Claude Code at the local proxy by setting Anthropic environment variables in your Claude Code user settings.
Claude Code reads settings from:
- Windows:
C:\Users\<you>\.claude\settings.json - macOS/Linux:
~/.claude/settings.json
Example:
{
"env": {
"ANTHROPIC_BASE_URL": "http://127.0.0.1:8318",
"ANTHROPIC_AUTH_TOKEN": "local-dev-key",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-3-pro-preview",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-claude-sonnet-4-5-thinking",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-claude-opus-4-5-thinking"
},
"model": "opus"
}
Important:
- Avoid Claude Code “Auth conflict”: do not set both
ANTHROPIC_AUTH_TOKENandANTHROPIC_API_KEYat the same time. - Restart Claude Code after editing settings so the new env vars take effect.
Server-side model aliasing (Claude handler)
CLIProxyAPI rewrites common Claude Code model aliases to locally-available models before routing:
opus/claude-opus-*→gemini-claude-opus-4-5-thinkingsonnet/claude-sonnet-*→gemini-claude-sonnet-4-5-thinkinghaiku/claude-haiku-*→gemini-3-pro-preview
Implementation: sdk/api/handlers/claude/code_handlers.go (mapClaudeCodeModel).
Auth error reporting improvements
When all credentials are blocked for a model, CLIProxyAPI now reports more informative HTTP statuses:
- Quota/rate cooldown:
429withcode: model_cooldownandRetry-After - Temporarily blocked credentials (non-quota):
503withcode: auth_unavailable,Retry-After, and a JSON error body including blocked counts and recent upstream HTTP statuses (when known)
Implementation: sdk/cliproxy/auth/selector.go, sdk/cliproxy/auth/manager.go.
Quick sanity checks
List models as Claude Code would see them:
$hdr=@{ 'User-Agent'='claude-cli'; 'Authorization'='Bearer local-dev-key' }
Invoke-RestMethod -Headers $hdr -Uri 'http://127.0.0.1:8318/v1/models' -Method Get
Or with curl (macOS/Linux):
curl -s \
-H 'User-Agent: claude-cli' \
-H 'Authorization: Bearer local-dev-key' \
'http://127.0.0.1:8318/v1/models'
Send a minimal Claude Messages request through the proxy:
$hdr=@{ 'User-Agent'='claude-cli'; 'Authorization'='Bearer local-dev-key'; 'Content-Type'='application/json' }
$body=@{ model='opus'; max_tokens=16; stream=$false; messages=@(@{ role='user'; content='hi' }) } | ConvertTo-Json -Depth 6
Invoke-RestMethod -Headers $hdr -Uri 'http://127.0.0.1:8318/v1/messages' -Method Post -Body $body
Or with curl (macOS/Linux):
curl -s \
-H 'User-Agent: claude-cli' \
-H 'Authorization: Bearer local-dev-key' \
-H 'Content-Type: application/json' \
-d '{"model":"opus","max_tokens":16,"stream":false,"messages":[{"role":"user","content":"hi"}]}' \
'http://127.0.0.1:8318/v1/messages'