主题
5 分钟接入
目标:拿到一把 Key,按协议填对地址,让工具回第一句话。
1. 登录并创建 Key
打开 aicode.cat,登录后到 密钥页 创建一把 API Key。
不要把 Key 发到群里或贴进公开 Issue。按钮和字段以控制台当前页面为准,详细说明见 创建 API Key。
2. 先认协议,再填地址
同一把 Key 可以接多个工具,但地址不能混用:
| 客户端使用的协议 | Base URL | 常见工具 | 注意 |
|---|---|---|---|
| Claude / Anthropic | https://aicode.cat | Claude Code、Claude、OpenCode 的 Claude provider | 不要加 /v1 |
| GPT / OpenAI | https://aicode.cat/v1 | Codex、OpenCode 的 GPT provider | 必须保留 /v1 |
| Gemini / Google | https://aicode.cat/v1beta | Gemini CLI、OpenCode 的 Gemini provider | 必须保留 /v1beta |
Cherry Studio 例外:自定义提供商的 OpenAI / Anthropic 栏都填根地址 https://aicode.cat(不要加 /v1),软件会自己拼路径。见 Cherry Studio。
Trae 例外:Anthropic Messages 填 https://aicode.cat(不要 /v1);Chat Completions(GPT / Grok)必须填 https://aicode.cat/v1。见 Trae。
DeepSeek Harness 例外:自定义提供方协议选 openai-completions,四个厂家地址都填 https://aicode.cat/v1。见 DeepSeek Harness。
OpenCode 等多协议客户端,要为每个 provider 分别填对应地址,不能所有模型共用一个 URL。模型名以 主站控制台 为准。
3. 按工具完成配置
- Claude Code(终端)
- Claude(桌面版)
- Codex(终端)
- Codex(桌面版)
- Gemini CLI
- Grok(终端)
- Hermes(终端)
- OpenCode
- OpenClaw
- Cherry Studio
- Trae
- WorkBuddy AI
- Droid CLI
- DeepSeek Harness
专用客户端的密钥字段也不同,例如 Claude Code 用 ANTHROPIC_AUTH_TOKEN,Codex 用 OPENAI_API_KEY,Gemini CLI 用 GEMINI_API_KEY。按对应教程填写,不要互换字段。
4. 怎么算成功
在工具里发送一句短消息,例如「回复 ok」。能正常收到回复,接入就完成;调用记录可在 密钥页 查看。
失败时先看 常见报错,再检查地址后缀、密钥字段和是否重启了工具。