Skip to content

5 分钟接入 ​

目标:拿到一把 Key,按协议填对地址,让工具回第一句话。

1. 登录并创建 Key ​

打开 aicode.cat,登录后到 密钥页 创建一把 API Key。

不要把 Key 发到群里或贴进公开 Issue。按钮和字段以控制台当前页面为准,详细说明见 创建 API Key。

2. 先认协议,再填地址 ​

同一把 Key 可以接多个工具,但地址不能混用:

AiCodeCat 三种协议地址

客户端使用的协议Base URL常见工具注意
Claude / Anthropichttps://aicode.catClaude Code、Claude、OpenCode 的 Claude provider不要加 /v1
GPT / OpenAIhttps://aicode.cat/v1Codex、OpenCode 的 GPT provider必须保留 /v1
Gemini / Googlehttps://aicode.cat/v1betaGemini 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 用 ANTHROPIC_AUTH_TOKEN,Codex 用 OPENAI_API_KEY,Gemini CLI 用 GEMINI_API_KEY。按对应教程填写,不要互换字段。

4. 怎么算成功 ​

在工具里发送一句短消息,例如「回复 ok」。能正常收到回复,接入就完成;调用记录可在 密钥页 查看。

失败时先看 常见报错,再检查地址后缀、密钥字段和是否重启了工具。