Guides / 04 / 8000 route
Guide 04 · localhost:8000 route

让 Claude Code 通过本地代理使用 OpenAI Key.

Claude Code 发送 Anthropic 协议请求。localhost:8000 的 claude-api-proxy 负责把请求翻译成 OpenAI 兼容请求,再转发到你配置的上游模型。

CLAUDE CODELOCALHOST:8000ANTHROPIC ADAPTER
Claude Codelocalhost:8000OpenAIToken stays local
01

准备 claude-api-proxy

这条路线使用 yansd001/claude-api-proxy。它的作用是把 Claude Code 的 Anthropic 请求转换成 OpenAI 兼容请求。

GITHUB RELEASE

claude-api-proxy

下载 Windows 预编译版并解压到本机工具目录。

打开下载页
LOCAL PATH

推荐位置

AGG 之前验证过的位置是用户目录下的 Codex tools 文件夹。

~\.codex\tools\claude-api-proxy\publish\
02

启动 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
03

添加 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 出现在截图、聊天或公开仓库里,立即撤销并重新创建。
04

让 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 更稳。
05

先开 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
06

验证代理和 provider

先确认服务器信息,再确认 provider 列表。输出里如果包含 token 或 key,只保留是否存在、名称和模型,不要公开完整密钥。

POWERSHELL VERIFY
Invoke-WebRequest -Uri "http://localhost:8000/api/server" -UseBasicParsing
Invoke-WebRequest -Uri "http://localhost:8000/api/providers" -UseBasicParsing
Alternative route

Codex 和 OpenAI 兼容客户端走 3000

如果工具要求 OpenAI Base URL 或 OpenAI 兼容 endpoint,请使用 CCSwitch 的 localhost:3000 路线。

打开 3000 教程