Claude Code 接入中转教程:终端代理与 Base URL 配置

Anthropic 官方终端编码代理 Claude Code 接入教程:安装、设置 ANTHROPIC_BASE_URL 与密钥、切换模型,以及常见排查。

一、Claude Code 是什么

Claude Code 是 Anthropic 官方的终端编码代理(CLI),能在终端里直接读写代码、运行命令、执行任务。它原生读取 ANTHROPIC_BASE_URLANTHROPIC_API_KEY 等环境变量,因此可以方便地指向中转网关,用你的密钥与额度来跑。

二、安装 Claude Code

需要 Node.js(官方推荐 18 及以上),然后全局安装:

npm install -g @anthropic-ai/claude-code

安装后终端输入 claude 即可启动;用 /modelclaude --model … 切换模型。

三、配置环境变量

Windows(PowerShell)

$env:ANTHROPIC_BASE_URL="https://www.azztimes.com"
$env:ANTHROPIC_API_KEY="sk-你的密钥"
$env:ANTHROPIC_MODEL="claude-sonnet-5"
claude

macOS / Linux(bash / zsh)

export ANTHROPIC_BASE_URL="https://www.azztimes.com"
export ANTHROPIC_API_KEY="sk-你的密钥"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude

说明:ANTHROPIC_API_KEY 会作为请求头携带,ANTHROPIC_BASE_URL 用于覆盖默认 API 端点,指向本站 Anthropic 入口即可。

四、接口地址对照

模型分组本站入口(Base URL)协议
Claude / Anthropichttps://www.azztimes.comAnthropic Messages
GPT / OpenAIhttps://www.azztimes.com/v1OpenAI Chat Completions
Geminihttps://www.azztimes.com/v1betaGoogle generateContent

五、常见问题排查

现象处理
401 / 403密钥无效、未启用或余额不足;确认 sk- 正确并充值。
404 / 模型不可用模型名与平台 slug 不一致,或该模型未启用;核对模型 ID。
Unknown model填的模型 id 要精确(含大小写),用模型广场核对。
请求超时较长任务可适当调大超时;网络波动时重试。

安全建议:密钥别写法进公开仓库,用 .env 或环境变量;生成类任务 token 消耗大,注意余额,可在「用量日志」核对每次调用。