Claude Code 接入中转教程：终端代理与 Base URL 配置
Anthropic 官方终端编码代理 Claude Code 接入教程：安装、设置 ANTHROPIC_BASE_URL 与密钥、切换模型，以及常见排查。
一、Claude Code 是什么
Claude Code 是 Anthropic 官方的终端编码代理（CLI），能在终端里直接读写代码、运行命令、执行任务。它原生读取 ANTHROPIC_BASE_URL 与 ANTHROPIC_API_KEY 等环境变量，因此可以方便地指向中转网关，用你的密钥与额度来跑。
二、安装 Claude Code
需要 Node.js（官方推荐 18 及以上），然后全局安装：
npm install -g @anthropic-ai/claude-code安装后终端输入 claude 即可启动；用 /model 或 claude --model … 切换模型。
三、配置环境变量
Windows（PowerShell）
$env:ANTHROPIC_BASE_URL="https://www.relay-api.com"
$env:ANTHROPIC_API_KEY="sk-你的密钥"
$env:ANTHROPIC_MODEL="claude-sonnet-5"
claudemacOS / Linux（bash / zsh）
export ANTHROPIC_BASE_URL="https://www.relay-api.com"
export ANTHROPIC_API_KEY="sk-你的密钥"
export ANTHROPIC_MODEL="claude-sonnet-5"
claude说明：ANTHROPIC_API_KEY 会作为请求头携带，ANTHROPIC_BASE_URL 用于覆盖默认 API 端点，指向本站 Anthropic 入口即可。
四、接口地址对照
| 模型分组 | 本站入口（Base URL） | 协议 |
|---|---|---|
| Claude / Anthropic | https://www.relay-api.com | Anthropic Messages |
| GPT / OpenAI | https://www.relay-api.com/v1 | OpenAI Chat Completions |
| Gemini | https://www.relay-api.com/v1beta | Google generateContent |
五、常见问题排查
| 现象 | 处理 |
|---|---|
| 401 / 403 | 密钥无效、未启用或余额不足；确认 sk- 正确并充值。 |
| 404 / 模型不可用 | 模型名与平台 slug 不一致，或该模型未启用；核对模型 ID。 |
| Unknown model | 填的模型 id 要精确（含大小写），用模型广场核对。 |
| 请求超时 | 较长任务可适当调大超时；网络波动时重试。 |
安全建议：密钥别写法进公开仓库，用 .env 或环境变量；生成类任务 token 消耗大，注意余额，可在「用量日志」核对每次调用。
Base URL 说明：本站同时接受 /v1beta/models/... 与 /v1beta/v1beta/models/...（以及 /v1/... 与 /v1/v1/...），所以客户端是否自己补 /v1、/v1beta 都不影响调用：Base URL 填域名根或填带 /v1beta 的地址都能用。模型 ID 请在控制台「令牌」页右上角「模型 ID」里查询复制。