跳转到主要内容
一个 Capriole AI API Key 可以为 Codex、Claude Code、Kilo Code、GitHub Copilot CLI、OpenCode、OpenClaw、Cline、Qwen Code、Crush 和 Pi 提供身份验证。API Key 保持不变,但 Base URL、协议和模型选择方式必须与正在配置的客户端匹配。 按照本指南操作,可以从一个 Capriole 账户开始配置可用的编程智能体。个人 Premium 每月 USD 9,包含 500 万计费 API token,还可以在网页聊天中不限量使用受支持的 Premium 模型。同一份会员权益可以覆盖浏览器工作区和全部 10 条持续维护的编程智能体路径。 各集成页面仍是完整客户端配置的事实依据。

开始前

你需要准备以下内容。
  • 有效的 Capriole AI Premium 或符合条件的 Team 权限
  • 从 API 页面获取的 Capriole AI API Key
  • 至少一个已经安装的编程智能体
  • 可以设置环境变量的终端
不要把 API Key 放入代码仓库或已经提交的配置文件。示例使用 YOUR_CAPRIOLE_AI_API_KEY 作为占位符。
本指南复用一个 Key 来验证兼容性。长期运行或 Team 环境应为每个智能体或用户创建单独命名的 Key。分开使用 Key 可以降低凭据泄露的影响,也能从 API 页面独立筛选用量或撤销权限。

为智能体匹配正确的协议

虽然这些客户端共用一个账户 Key,但每个客户端仍使用自身支持的传输协议。 Responses 和 Chat Completions 路径的 Base URL 包含 /v1。Anthropic Messages 路径使用 API 根地址,除非集成页面注明了客户端专用的适配器值。请复制对应集成页面中的准确值。

设置共用 Key

1

导出 Capriole API Key

打开编程智能体前设置一个 Shell 变量。
验证变量已经存在,同时不要打印 Secret。
预期结果是 Capriole API key is set。
2

选择客户端路径

打开表格中的集成页面,复制其中持续维护的配置。客户端要求提供 Token 时,统一使用 CAPRIOLE_AI_API_KEY 的值。
  • Codex 通过 env_key 从 CAPRIOLE_AI_API_KEY 读取 Key。
  • Claude Code 使用 ANTHROPIC_AUTH_TOKEN。启动前从共用变量设置该值。
  • Kilo Code 在 apiKey 和 Authorization 请求头中引用 {env:CAPRIOLE_AI_API_KEY}。它的一个 Capriole 提供商会按模型家族把请求发送到 Responses、Messages 或 Chat Completions。
  • GitHub Copilot CLI 在 OpenAI 兼容路径中使用 COPILOT_PROVIDER_API_KEY,在 Anthropic Messages 路径中使用 COPILOT_PROVIDER_BEARER_TOKEN。
  • OpenCode 在 apiKey 和 Authorization 请求头中引用 {env:CAPRIOLE_AI_API_KEY}。它的一个 Capriole 提供商会按模型家族把请求发送到 Responses、Messages 或 Chat Completions。
  • OpenClaw 提供商条目直接引用 ${CAPRIOLE_AI_API_KEY}。请在启动 Gateway 的终端中导出共用变量。
  • Cline 通过 cline auth -k "$CAPRIOLE_AI_API_KEY" 一次性保存 Key。
  • Qwen Code 在 envKey 中指定变量名,并可以从 ~/.qwen/.env 读取该变量。
  • Crush 在 crushrc 的提供商条目中读取 $CAPRIOLE_AI_API_KEY。
  • Pi 在 models.json 中读取 $CAPRIOLE_AI_API_KEY。
对于 Claude Code:
3

让模型使用兼容路由

除非需要指定准确模型版本,否则先使用持续维护的别名。
  • OpenAI Responses 路径使用 openai-latest,Codex 中使用原生 gpt-6.2-astra
  • Anthropic Messages 路径使用 claude-latest,Claude Code 中使用 claude-fable-5-1
  • Chat Completions 兼容路径使用集成页面列出的模型
当前模型目录列出了公共 API 模型。
4

启动并验证智能体

在测试项目中启动已配置的客户端,然后发送以下内容。
检查是否收到非空回答,最好是要求返回的 CAPRIOLE_OK 标记。模型不一定严格遵循只输出指定内容的 Prompt,因此实际措辞可能不同。然后打开 API 页面,确认请求显示在用量视图中,并对应预期的 Key 和模型。用量记录是客户端确实使用 Capriole 的决定性依据。客户端配置了其他提供商或回退时,只收到回答并不足以证明请求经过 Capriole。API Key 与用量指南介绍了准确的筛选方式和 Key 生命周期。

成功标准

编程智能体使用你的 API 密钥,按用量从个人或团队 API 余额中扣费。运行大型自动化工作负载前,请阅读 Capriole AI 计费 token 说明。

解决常见配置问题

后续阅读

需要了解这些路由背后的模型时,请阅读编程智能体兼容性文章。如需直接编写应用代码,请继续阅读 OpenAI 和 Anthropic SDK 指南。LLM 网关安全风险列出了在智能体发送你的源代码之前需要检查的事项。如果你的智能体不在这 10 个之中,可以通过自定义端点连接。 在免费网页聊天中试用当前旗舰模型。准备好创建编程智能体使用的 API Key 后,可升级到 Premium。
最后修改于 2026年11月18日