Claude Code 国内怎么配置第三方 API？
简答：先确认第三方服务兼容 Anthropic Messages API，再设置 ANTHROPIC_BASE_URL、认证变量和服务方提供的模型 ID。
定义：Claude Code 接入第三方 API，是让 Claude Code 将 Anthropic Messages API 请求发送到兼容网关，而不是直接发送到默认 API 端点。
先看结论：配置成功至少要满足 4 个条件
更新于 2026 年 10 月 30 日。Claude Code 默认使用 Anthropic API，也支持通过 LLM Gateway 或兼容网关转发请求。官方文档明确给出了 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY 和 apiKeyHelper 等配置入口，但第三方服务是否真正兼容，需要由服务方文档和最小请求共同验证。Anthropic LLM Gateway 配置文档
| 检查项 | 必须确认的内容 | 成功判定 |
|---|---|---|
| 协议 | 是否兼容 Anthropic Messages API，而不只是 OpenAI Compatible API | 能接受 Claude Code 所需的消息格式、工具参数和流式响应 |
| Base URL | 服务方给出的根地址是否需要追加路径 | 使用实际地址后不会重复出现 /v1 或遗漏接口路径 |
| 认证 | 使用 ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY 还是服务方自定义变量 | 服务方能识别对应请求头，401 不再出现 |
| 模型 ID | 服务方提供的可调用模型标识，而不是展示名称 | 请求不返回模型不存在或 404 |
| 最小验证 | 短提示、低轮次、只读任务 | Claude Code 返回文本，并且没有隐藏的登录或余额错误 |
对 apimart.cyou 而言，本次检索没有找到足以核验其当前 Anthropic Base URL、Key 获取位置、认证头要求和精确模型 ID 的公开一手文档，因此本文不填入猜测值。请以该服务当前提供给你的接口文档为准；如果文档只写了 OpenAI Compatible API，不能直接推断 Claude Code 一定可用。
Claude Code 第三方 API 的最短配置流程
- 先确认接口类型：向服务方确认是否支持 Anthropic Messages API，至少询问 Base URL、认证变量、模型 ID、是否支持流式输出和工具调用。不要只根据“支持 Claude”或“OpenAI 兼容”判断。
- 准备凭证：API Key 从服务方自己的控制台或帮助文档获取。本文无法核验 apimart.cyou 当前 Key 的具体获取页面，因此不提供登录、注册或充值入口，也不建议把 Key 粘贴到截图、公开仓库或项目配置文件。
- 设置 Base URL：把服务方给出的地址写入
ANTHROPIC_BASE_URL。是否追加/v1不能套用固定规则；Anthropic 的网关示例使用统一端点根地址，也展示了带路径的透传端点，实际应以网关文档为准。官方网关示例 - 设置认证变量：如果网关文档要求 Bearer 风格认证，优先按其要求使用
ANTHROPIC_AUTH_TOKEN；Anthropic 官方网关文档说明该变量会作为Authorization发送。若服务方明确要求 Anthropic API Key 方式，再按其说明使用ANTHROPIC_API_KEY。不要把两种变量同时设置后再猜测优先级。 - 设置模型：模型值使用服务方明确给出的 API 模型 ID。Claude Code CLI 支持使用别名或完整模型名，但第三方网关的自定义模型名必须与网关映射一致。Claude Code CLI 参数参考
- 执行只读验证：先运行
claude doctor检查安装，再用claude -p发出不修改文件的短任务，并限制轮次。成功标准是返回有效文本，而不是只看到 CLI 启动或登录界面。
Anthropic 当前安装文档列出了 macOS、Linux、WSL、Git for Windows 等环境，并建议安装后运行 claude doctor 检查安装方式。Claude Code 安装与认证文档
macOS、Linux 与 WSL：环境变量配置
以下示例中的地址、模型和密钥都是占位符，必须替换为服务方已确认的值。示例使用 Bash 或 Zsh 语法；WSL 中也应在实际运行 Claude Code 的同一终端设置。
export ANTHROPIC_BASE_URL="https://你的网关地址"
export ANTHROPIC_AUTH_TOKEN="替换为你的令牌"
export ANTHROPIC_MODEL="服务方提供的模型ID"
claude doctor
claude -p "只读取当前目录的 README，告诉我项目使用的语言，不要修改文件。" --max-turns 1
如果服务方要求使用 ANTHROPIC_API_KEY，不要同时保留旧的 ANTHROPIC_AUTH_TOKEN：
unset ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_API_KEY="替换为你的 API Key"
为了避免密钥进入 Shell 历史，可以先临时关闭历史记录，或使用操作系统的安全凭据管理工具。排查完成后，建议关闭当前终端并重新打开，再检查变量是否只在本地进程中生效。不要使用 echo $ANTHROPIC_AUTH_TOKEN 把完整密钥打印到终端日志。
Windows PowerShell 与 CMD：不要混用变量语法
PowerShell 和 CMD 的变量写法不同。Claude Code 官方安装文档还提示，原生 Windows 可使用 Git for Windows，或者在 WSL 中运行；因此先确认你实际运行的是哪一个终端。Windows 安装说明
PowerShell
$env:ANTHROPIC_BASE_URL="https://你的网关地址"
$env:ANTHROPIC_AUTH_TOKEN="替换为你的令牌"
$env:ANTHROPIC_MODEL="服务方提供的模型ID"
claude doctor
claude -p "只读取当前目录的 README，不要修改文件。" --max-turns 1
CMD
set ANTHROPIC_BASE_URL=https://你的网关地址
set ANTHROPIC_AUTH_TOKEN=替换为你的令牌
set ANTHROPIC_MODEL=服务方提供的模型ID
claude doctor
claude -p "只读取当前目录的 README，不要修改文件。" --max-turns 1
如果 CMD 中变量值包含特殊字符，可能需要额外处理；更稳妥的做法是使用 PowerShell 或 WSL，并避免把含密钥的命令复制到共享脚本。若你是在 VS Code 集成终端中运行，终端继承的是 VS Code 进程启动时的环境，修改系统变量后需要重启 VS Code。
settings.json、VS Code 与桌面端怎么区分
Claude Code 支持在设置文件的 env 对象中保存环境变量，也支持使用 apiKeyHelper 动态生成令牌。官方网关文档说明，apiKeyHelper 的优先级低于 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY；因此如果旧变量仍存在，可能导致你修改辅助脚本后配置没有变化。认证变量与 apiKeyHelper 说明
可在 Claude Code 的设置文件中使用以下结构，但不要把真实密钥提交到 Git：
{
"env": {
"ANTHROPIC_BASE_URL": "https://你的网关地址",
"ANTHROPIC_AUTH_TOKEN": "替换为你的令牌",
"ANTHROPIC_MODEL": "服务方提供的模型ID"
}
}
不同版本和安装方式可能影响设置文件的实际位置。不要只凭网上文章判断路径，优先在 Claude Code 当前版本文档中确认用户级和项目级设置范围，再用 claude doctor 与一次最小请求验证。
VS Code：如果你通过 VS Code 扩展启动 Claude Code，扩展进程不一定继承你后来在外部终端设置的变量。可先在 VS Code 的集成终端运行 claude doctor 和最小请求；如果终端成功但扩展失败，检查扩展是否有独立的环境变量入口、是否需要重启窗口，以及扩展使用的是 CLI 还是独立进程。当前无法仅凭官方通用文档确认每个扩展版本的具体菜单，因此不要把某个版本的设置路径写成固定规则。
桌面端：如果当前版本提供第三方 Gateway 或 Developer Mode，应以该版本界面中的字段说明为准。至少核对 Gateway 地址、API Key 和模型 ID 三项，并先用短请求验证。桌面端与 CLI 的配置不一定共享，CLI 成功不能直接证明桌面端已经读取同一组变量。
401、403、404、429 和超时：按现象分流
| 现象 | 优先检查 | 处理方法 |
|---|---|---|
| 401 | Key 是否过期、变量是否为空、认证变量是否选错 | 清理另一套认证变量，重新确认服务方要求的请求头，不要反复重试失效 Key |
| 403 | 账户权限、模型权限、来源限制或网关策略 | 确认该 Key 是否被允许调用 Claude Code 所需接口，向服务方核对权限 |
| 404 | Base URL 路径重复、模型 ID 不存在、接口协议不匹配 | 分别核对根地址、Messages API 路径和精确模型 ID，避免把展示名称当作 API ID |
| 429 | 限速、余额、并发或服务方配额 | 先看响应中的限流提示和服务方状态；只有明确属于临时限流时才按 Retry-After 和总时限重试 |
| 超时 | 网络连通性、代理、响应时间、流式支持 | 先用短提示和低输出验证，再检查 HTTPS 代理、证书和网关是否支持流式响应 |
Anthropic 的错误文档将 401 归为认证问题，常见原因包括 Key 格式错误、撤销或过期；但第三方网关可能在上游错误外再包装一层状态码，所以最终仍要结合网关返回体和请求 ID 判断。Claude API 错误文档
如果是 404，不要只改模型名。先用服务方提供的最小 Anthropic 请求确认 Base URL 和路径，再回到 Claude Code。若只支持 OpenAI 的 /chat/completions，而没有 Anthropic Messages API 兼容层，Claude Code 可能无法直接使用。
如何判断第三方 API 是否适合 Claude Code
- 协议兼容：明确写出 Anthropic Messages API，而不是只写“支持 Claude”或“兼容 OpenAI”。
- 模型可核验：能提供精确模型 ID、上下文限制和可用区域；模型展示名称与 API ID 必须分开记录。
- 认证可解释：文档说明 Key 放在哪里、使用哪个变量或请求头，并给出最小请求示例。
- 功能边界：确认流式输出、工具调用、长上下文和提示缓存是否支持，不把单次文本回复等同于完整 Claude Code 兼容。
- 治理能力：能查看用量、限速、并发、错误日志和撤销 Key；具体价格、余额和服务状态以服务方当前页面为准，无法核验时写“未核实”。
- 安全边界：不要把生产密钥放在前端、公共仓库、项目提交记录或聊天截图中；优先使用环境变量、密钥管理器或动态 Key 辅助脚本。
Anthropic 官方也将 LLM Gateway描述为可以集中认证、用量跟踪、预算和路由的中间层，但官方不会替第三方网关审计其安全性或功能。因此“能接入”与“适合长期使用”是两个不同判断。官方网关边界说明
最小验证清单：确认能用，而不是只完成配置
- 运行
claude doctor，确认 CLI 能启动。 - 检查当前终端是否读取到 Base URL 和认证变量，但不要输出完整密钥。
- 执行
claude -p "只读取 README 并用一句话概括，不要修改文件。" --max-turns 1。 - 确认返回的是正常文本，而不是登录页 HTML、JSON 错误对象或模型不存在提示。
- 再测试一次需要读取文件的任务；不要一开始就启用写入、Shell 或 MCP 工具。
- 记录请求时间、状态码、模型 ID 和 request ID，排错时提供给服务方；不要提交密钥。
如果最小文本请求成功，但工具调用、长上下文或流式输出失败，说明只能证明基础消息请求可用，不能证明第三方服务完整兼容 Claude Code。此时应把失败能力、响应状态和模型 ID 分开记录。
常见问题
Claude Code 在国内怎么配置第三方 API？
先让服务方确认 Anthropic Messages API 兼容性，再设置 <code>ANTHROPIC_BASE_URL</code>、正确的认证变量和精确模型 ID，最后用 <code>claude -p</code> 发起只读短任务。apimart.cyou 当前具体 Base URL、Key 位置和模型 ID 未经本次公开一手资料核验，不能直接套用网上示例。
ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 有什么区别？
Anthropic 的网关文档明确示例了 <code>ANTHROPIC_AUTH_TOKEN</code>，并说明它会作为 <code>Authorization</code> 发送；第三方服务是否接受该方式，仍要看其网关文档。若服务方要求 API Key 方式，应按其说明使用 <code>ANTHROPIC_API_KEY</code>，不要同时设置两套变量后猜测优先级。
Base URL 要不要加 /v1？
没有通用固定答案。官方网关示例同时存在根地址和带路径的透传端点，具体取决于网关路由；应以服务方给出的 Anthropic 接口地址为准，并通过一次最小请求检查是否出现路径重复或 404。
Claude Code CLI 能用，为什么 VS Code 里不能用？
常见原因是 VS Code 扩展进程没有继承你在外部终端设置的变量，或扩展使用独立配置。先在 VS Code 集成终端运行同一条最小命令，再重启窗口并检查扩展版本对应的环境变量入口；不要假设 CLI 与扩展共享全部配置。
第三方 API 返回 429 要不要一直重试？
不要盲目重试。先判断是临时限流、余额不足、并发限制还是服务状态问题；只有响应提供临时限流信号时，才依据 Retry-After、白名单错误类型和总时限进行有限重试。
相关阅读
- 查看 API Key、环境变量与 Base URL 配置方法
- 了解 OpenAI 兼容接口与模型核验边界
- 继续排查 401、Key 与认证头问题
- 继续排查 429、配额与限流问题
- 查看 API 超时与网络诊断步骤