跳转到主要内容
只需一个 Capriole AI API Key,就能在 Claude Code 中使用 Claude Fable 5.1 和 Opus 5.5,价格比官方 API 最多低 92%。

Claude Code 是什么

Claude Code 是 Anthropic 推出的智能体编程工具,可以读取代码库、编辑文件、运行命令并与开发工具集成。这套配置通过 Claude Code 的网关设置让它使用 Capriole AI,包括 API 端点、身份验证 Token 和每个别名对应的模型。用 Claude Pro 或 Max 账户登录时,Claude Code 消耗的是方案的五小时和每周用量限制;改用 Capriole AI API Key 后,消耗的是你的 API token 余额。

前置条件

开始前请确保你已经拥有以下内容。
  • Capriole AI 账户,可在此处注册
  • Premium 方案(每月 USD 9,还包含无限网页聊天)或 Team 方案,获取 API Key 需要其中之一,可在此处订阅
  • Capriole AI API Key,可在此处获取

安装

使用官方原生安装程序安装 Claude Code。
也可以使用 Homebrew 安装。
或者使用 npm 安装(需要 Node.js 22 或更高版本)。
验证安装。

配置

模型验证

使用下方配置,Claude Code 2.1.304 经 Capriole AI 调用“支持的模型”一节中的每个模型,都通过了文件读取、文件写入和最终答案检查。 创建或更新 ~/.claude/settings.json。
各项设置的作用如下。
  • model 是新会话的默认模型。通过 /model 选择的模型会被保存,下次继续使用。
  • ANTHROPIC_BASE_URL 把请求发送到 Capriole AI。不要添加 /v1,Claude Code 会自行添加 /v1/messages。
  • ANTHROPIC_AUTH_TOKEN 以 Bearer Token 形式发送你的 API Key,这是 Capriole AI 要求的方式。
  • 三个 ANTHROPIC_DEFAULT_*_MODEL 值把 opus、sonnet 和 haiku 别名指向 Capriole AI 提供的模型。haiku 是 Claude Code 处理快速后台任务时使用的模型。
如果只想在当前 Shell 中临时配置,请导出端点和 Token,然后传入模型。

运行 Claude Code

在项目目录中启动 Claude Code。
在会话中使用 /model 切换模型,例如用 /model opus 切换到 Opus 5.5。如需非交互式运行,请使用 print 模式。

支持的模型

Claude Code 使用 Anthropic Messages 协议,因此支持 Capriole AI 的 Claude 模型。
  • claude-fable-5-1(Fable 5.1,推荐的默认模型)
  • claude-opus-5-5(Opus 5.5)
  • claude-fable-5
  • claude-opus-5
  • claude-opus-4-8
  • claude-opus-4-7
  • claude-opus-4-6
  • claude-sonnet-4-6
  • claude-latest,始终指向我们最新的 Claude 旗舰模型(目前是 Fable 5.1)
Claude Code 不认识 claude-latest 这个模型名称,因此会假定它的上下文窗口为 200K。使用 claude-fable-5-1 等具体 ID,才能获得该模型的完整上下文窗口。

故障排除

为什么 Claude Code 返回身份验证错误

使用 ANTHROPIC_AUTH_TOKEN,让 Claude Code 通过 Authorization 请求头以 Bearer token 发送 Capriole AI 密钥。

为什么请求出现端点错误

确认 ANTHROPIC_BASE_URL 是不含 /v1 的 https://api.caprioletech.com。

为什么 Claude Code 每次启动都切回另一个模型

从设置和 Shell 中移除 ANTHROPIC_MODEL。设置了它时,Claude Code 下次启动会回到该模型,而不是你通过 /model 保存的模型。

为什么 /model opus 或 /model sonnet 失败

保留这三个 ANTHROPIC_DEFAULT_*_MODEL 设置,让 Claude Code 将别名映射到 Capriole AI 配置中的 Claude 模型。

为什么 Claude Code 没有使用我设置的推理强度

Claude Code 会为每个模型单独保存推理强度。请在使用该模型时通过 /effort 选择。用户设置中顶层的 effortLevel 对 Opus 5.5 不生效。

为什么 Token 计数失败

Capriole AI 会把 /v1/messages/count_tokens 转发到所选上游。如果该上游不支持 Token 计数,Claude Code 会改为估算,会话仍可正常进行。

说明

  • ~/.claude/settings.json 会在所有项目中应用于你的用户账户。请将 YOUR_CAPRIOLE_AI_API_KEY 替换为你的 Capriole AI API Key。
  • Claude Code 通过 Anthropic Messages 调用 Claude 模型。使用 Gemini、Grok、GLM 和 Kimi 时,可以选择 OpenCode 或 Kilo Code 等支持多种协议的智能体。
  • 想在其他编程智能体中使用同一个 API Key,请参阅使用一个 API Key 配置编程智能体。
  • 官方参考资料包括 Claude Code 设置、模型配置和 LLM 网关配置。
最后修改于 2026年11月18日