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。配置
模型验证
使用下方配置,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 处理快速后台任务时使用的模型。
运行 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-5claude-opus-5claude-opus-4-8claude-opus-4-7claude-opus-4-6claude-sonnet-4-6claude-latest,始终指向我们最新的 Claude 旗舰模型(目前是 Fable 5.1)
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 网关配置。

