开始前
你需要准备以下内容。- 有效的 Capriole AI Premium 或符合条件的 Team 权限
- 从 API 页面获取的 Capriole AI API Key
- 至少一个已经安装的编程代理
- 可以设置环境变量的终端
本指南复用一个 Key 来验证兼容性。长期运行或 Team 环境应为每个代理或用户创建单独命名的 Key。分开使用 Key 可以降低凭据泄露的影响，也能从 API 页面独立筛选用量或撤销权限。
为代理匹配正确的协议
虽然这些客户端共用一个账户 Key，但每个客户端仍使用自身支持的 Wire Protocol。
Responses 和 Chat Completions 路径的 Base URL 包含
/v1。Anthropic Messages 路径使用 API 根地址，除非集成页面注明了客户端专用的适配器值。请复制对应集成页面中的准确值。
设置共用 Key
1
导出 Capriole API Key
打开编程代理前设置一个 Shell 变量。验证变量已经存在，同时不要打印 Secret。预期结果是
Capriole API key is set。2
选择客户端路径
打开表格中的集成页面，复制其中持续维护的配置。客户端要求提供 Token 时，统一使用 对于 OpenClaw：
CAPRIOLE_AI_API_KEY 的值。- Codex 通过
env_key从CAPRIOLE_AI_API_KEY读取 Key。 - Claude Code 使用
ANTHROPIC_AUTH_TOKEN。启动前从共用变量设置该值。 - Kilo Code 在提供商配置中引用
{env:CAPRIOLE_AI_API_KEY}。 - GitHub Copilot CLI 在 OpenAI 兼容路径中使用
COPILOT_PROVIDER_API_KEY，在 Anthropic Messages 路径中使用COPILOT_PROVIDER_BEARER_TOKEN。 - OpenCode 提供商条目根据适配器使用
apiKey或authToken保存 Capriole Key。 - OpenClaw 提供商条目引用
CUSTOM_API_KEY。启动 Gateway 前从共用变量设置该值。
3
让模型使用兼容路由
除非需要指定准确模型版本，否则先使用持续维护的别名。
- OpenAI Responses 路径使用
openai-latest - Anthropic Messages 路径使用
claude-latest - Chat Completions 兼容路径使用集成页面列出的模型
4
启动并验证代理
在测试项目中启动已配置的客户端，然后发送以下内容。检查是否收到非空回答，最好是要求返回的
CAPRIOLE_OK 标记。模型不一定严格遵循只输出指定内容的 Prompt，因此实际措辞可能不同。然后打开 API 页面，确认请求显示在用量视图中，并对应预期的 Key 和模型。用量记录是客户端确实使用 Capriole 的决定性依据。客户端配置了其他提供商或 fallback 时，只收到回答并不足以证明请求经过 Capriole。API Key 与用量指南介绍了准确的筛选方式和 Key 生命周期。这项检查不会测试每项工具或模型功能。成功标准
编程代理请求使用符合条件的个人或 Team API 余额，不属于付费会员不限量 Browser Chat 的范围。运行大型自动化工作负载前，请阅读 Capriole AI charged token 说明。