CA Claude Code Guide Anthropic 兼容接入

Claude Code 接入 CallAPI 教程

本页说明如何在 Claude Code 中配置 CallAPI,包括 Anthropic 兼容 Base URL、API Key、模型选择、 连通性验证和常见错误排查。

配置速查

配置项 推荐值 说明
Base URL https://callapi8.com Claude Code 使用 Anthropic 兼容协议,通常填写根地址,不要追加 /v1
API Key 控制台令牌页面创建 建议为 Claude Code 单独创建令牌,便于后续停用和排查。
模型 以控制台可见模型为准 如果返回模型不存在,先确认账号分组和模型权限。

环境变量配置

优先使用 ANTHROPIC_API_KEY

export ANTHROPIC_BASE_URL="https://callapi8.com"
export ANTHROPIC_API_KEY="YOUR_API_KEY"

如果你的客户端或网关要求 Bearer 鉴权,可以改用:

export ANTHROPIC_BASE_URL="https://callapi8.com"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
不建议同时设置 ANTHROPIC_API_KEYANTHROPIC_AUTH_TOKEN。如果连接失败,先保留一种方式测试。

验证连接

配置完成后,启动 Claude Code 发送一条简短请求。第一次测试建议选择短输出,避免把连接问题和长上下文问题混在一起。

claude "用一句话回复:连接成功"

如果你需要确认网关是否能访问,也可以先在控制台查看令牌状态、余额和可用模型。

常见错误

401 Unauthorized

  • API Key 复制不完整,或多了空格。
  • 设置了错误的鉴权变量,先在 ANTHROPIC_API_KEYANTHROPIC_AUTH_TOKEN 中只保留一个。
  • 令牌已经删除、禁用或过期。

模型不存在

  • 模型名拼写错误。
  • 当前账号分组没有该模型权限。
  • 模型已经被管理员调整或下线。

连接超时

  • 先用短问题测试,不要直接发送大型上下文。
  • 检查本地网络、代理和 DNS 是否能访问 callapi8.com
  • 如果只在某个模型上超时,优先切换模型验证。

下一步

需要接入其他客户端时,可以查看 客户端接入指南。如果你要使用 Codex,请直接查看 Codex 接入教程

还没有 API Key 时,请先进入 CallAPI 控制台 注册或登录,再到令牌页面创建。