Claude Code 接入第三方 API 完全指南：ANTHROPIC_BASE_URL 配置与常见问题

Claude Code 默认把请求发往 Anthropic 官方 API。当官方链路网络不稳定、你想统一管理多个模型的密钥与账单，或者希望在同一个编码工具里切换不同模型时，把 Claude Code 指向一个 Anthropic 兼容的第三方 API 端点是最直接的解法。这篇指南只讲实际配置：改哪些变量、怎样验证生效、出错先查哪里。

先理解：Claude Code 是一个"客户端"

定义： Claude Code 通过读取一组环境变量来决定请求发往哪里、用哪个密钥、跑哪个模型。只要目标端点实现了 Anthropic Messages API 的请求与响应格式，Claude Code 就能像使用官方 API 一样使用它——模型列表、工具调用、流式输出都由端点侧保证兼容。

所以接入第三方 API 不是"破解"，而是官方支持的配置能力。EXAIV 提供 Anthropic 兼容端点，Claude Code 的官方接入文档与本文配置一致。

决定一切的几个环境变量

方式一：settings.json（推荐，长期生效）

Claude Code 支持在 ~/.claude/settings.json 中声明环境变量，对所有会话生效，也便于团队统一接入文档。以 EXAIV 为例：

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://exaiv.com/api/ai/v1/anthropic",
    "ANTHROPIC_API_KEY": "你的_EXAIV_API_KEY",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "model": "claude-opus-5-5"
}

保存后重新启动 claude 即可。如果只想在某个项目生效，把同样的结构放进项目根目录的 .claude/settings.json。

方式二：临时环境变量（快速验证）

不改任何文件，在当前终端直接导出：

export ANTHROPIC_BASE_URL="https://exaiv.com/api/ai/v1/anthropic"
export ANTHROPIC_API_KEY="你的_EXAIV_API_KEY"

# 最小验证命令
claude --print "say hi"

能正常返回即接入成功。要长期生效，可把两行 export 写入 ~/.zshrc 或 ~/.bashrc——但注意这会影响所有 claude 调用；如果你同时持有官方订阅，更稳妥的做法是只写在项目级 settings.json 里，避免误用第三方额度。

可用模型在哪里看

第三方端点支持的模型以端点侧列表为准。EXAIV 的完整模型目录（含 Claude、GPT、Gemini、DeepSeek、Kimi 等系列）见模型页，在 Claude Code 中通过 ANTHROPIC_MODEL 或会话内 /model 切换。

出错排查：按固定顺序检查

谁适合用第三方 API 接入

不是每个 Claude Code 用户都需要改配置。以下三类场景收益最明显：

官方链路不稳的用户。 部分地区访问官方端点超时频繁，写代码写到一半断流是真实的效率杀手。通过就近的兼容网关接入，请求链路更短，编码会话的连续性明显改善。

重度使用者。 Claude Code 的 token 消耗远高于普通对话场景——每次工具调用、每次文件读取都会计入上下文。如果你每天都在用，按量计费叠加更低的单价，月度成本差异会相当可观。具体差额建议用实际用量估算，而不是听信任何一方的宣传数字。

多工具统一管理的团队。 团队里同时有 Claude Code、Cursor、自研脚本时，把所有工具指向同一个网关入口、用同一套密钥和账单，比每个工具各管各的账号更容易控制预算。EXAIV 同时提供 OpenAI 兼容与 Anthropic 兼容端点，一个 Key 覆盖两类协议的工具。

成本怎么算：从体验包开始

EXAIV 采用 credits 按量计费：充值一次性购买 credits，调用按模型单价逐次扣减，没有订阅费。最低档是定价页上列出的最小套餐（实时价格见定价页），足够完成一个真实的验证流程：

1. 注册账号，在控制台生成 API Key
2. 按本文方式配置 Claude Code
3. 用日常任务真实跑一两个小时，观察控制台的余额消耗曲线
4. 据此估算月度成本，再决定是否升级到更大的套餐

不同模型的单价不同，精确价格以定价页的实时数据为准——这也是为什么本文不写死任何"每次调用多少钱"的数字：价格会随官方调整而更新，实时页永远是最准确的。

团队协作：统一配置的正确姿势

团队接入最怕每个人配置不一样。推荐的做法：

把 settings.json 模板放进仓库。 在项目根目录放一份不含密钥的模板文件，新人复制后填入自己的 Key 即可，五分钟完成接入。

密钥按人发放，不共享。 每个成员用自己的 API Key，用量和消耗在控制台各自可见，出问题时容易定位，离职时直接吊销单个 Key 而不影响他人。

用 wrapper 脚本隔离场景。 如果团队成员同时持有官方订阅，可以写一个别名脚本指向项目级配置，避免官方会话和第三方会话互相污染额度。

安全最佳实践

API Key 就是钱包凭证，四条底线：

• Key 永远不进 git。 含真实密钥的配置文件要加入版本控制忽略清单；仓库里只放不含密钥的模板
• 按需轮换。 定期在控制台重新生成 Key，旧 Key 吊销；怀疑泄露立即换
• 最小权限使用。 不要把 Key 写进 CI 日志、前端代码或聊天记录
• 异常监控。 发现余额消耗速度与日常明显不符，先吊销 Key 再排查

三个常见误区

误区一：把 Key 写进 shell 配置就一劳永逸。 shell 配置里的变量对所有 claude 会话生效，包括你以为在走官方订阅的那些。混用场景的正确解法是项目级 settings.json，而不是全局变量。

误区二：报错先重装 Claude Code。 接入失败与客户端版本几乎无关，重装解决不了环境变量和密钥问题，反而丢掉已有配置。

误区三：认为换模型要重新配置端点。 端点和模型是两层：端点（Base URL + Key）配一次就不动，模型用 ANTHROPIC_MODEL 或 /model 随时切换。把两件事混在一起，是配置越改越乱的主因。

FAQ

相关阅读

• Claude Code 官方接入文档 — 站内文档版配置
• Anthropic Messages API 参考 — 端点的请求/响应格式
• 定价 — 实时模型价格