准备 claude-api-proxy
这条路线使用 yansd001/claude-api-proxy。它的作用是把 Claude Code 的 Anthropic 请求转换成 OpenAI 兼容请求。
LOCAL PATH
推荐位置
AGG 之前验证过的位置是用户目录下的 Codex tools 文件夹。
~\.codex\tools\claude-api-proxy\publish\启动 localhost:8000 代理
运行代理后,它默认监听 0.0.0.0:8000,管理界面是 http://localhost:8000/ui/,并会自动生成本地代理 API Key。
POWERSHELL START
Start-Process "$env:USERPROFILE\.codex\tools\claude-api-proxy\publish\claude-api-proxy.exe" -WindowStyle Hidden添加 OpenAI Provider
可以在管理界面添加,也可以用 API 添加。下面示例里的 API Key 必须换成你自己的 OpenAI 官方 Key。
PYTHON PROVIDER SETUP
import requests
requests.post("http://localhost:8000/api/providers", json={
"type": "openai",
"name": "OpenAI",
"base_url": "https://api.openai.com",
"api_key": "sk-your-openai-key",
"enabled": True,
"default_model": "gpt-4o-mini"
})!
不要截图完整 key
如果完整 OpenAI Key 出现在截图、聊天或公开仓库里,立即撤销并重新创建。
如果完整 OpenAI Key 出现在截图、聊天或公开仓库里,立即撤销并重新创建。
让 Claude Code 指向 localhost:8000
编辑 ~\.claude\settings.json,把 Claude Code 的 Anthropic Base URL 指向本地代理,并把认证 Token 设置成 /api/server 返回的代理 API Key。
~/.claude/settings.json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "proxy-api-key-from-localhost-8000",
"ANTHROPIC_BASE_URL": "http://localhost:8000",
"ANTHROPIC_MAX_TOKENS": "16000",
"CLAUDE_CODE_MAX_OUTPUT_TOKENS": "16000"
},
"theme": "dark"
}i
为什么限制 16000
Claude Code 可能默认请求更大的输出上限。部分 OpenAI 模型不接受过大的 max_tokens,因此先用 16000 更稳。
Claude Code 可能默认请求更大的输出上限。部分 OpenAI 模型不接受过大的 max_tokens,因此先用 16000 更稳。
先开 VPN,再重启代理
如果上游是 OpenAI 官方 API,国内网络通常需要 VPN。建议先开 VPN,再启动或重启 localhost:8000 代理,避免连接池缓存失败状态。
RESTART PROXY
Get-Process | Where-Object { $_.ProcessName -like "*claude-api-proxy*" } | Stop-Process -Force
Start-Process "$env:USERPROFILE\.codex\tools\claude-api-proxy\publish\claude-api-proxy.exe" -WindowStyle Hidden验证代理和 provider
先确认服务器信息,再确认 provider 列表。输出里如果包含 token 或 key,只保留是否存在、名称和模型,不要公开完整密钥。
POWERSHELL VERIFY
Invoke-WebRequest -Uri "http://localhost:8000/api/server" -UseBasicParsing
Invoke-WebRequest -Uri "http://localhost:8000/api/providers" -UseBasicParsing