第三方工具接入 AIGoCode：Key 分组、协议地址和模型 ID 怎么选

第三方工具接入，先看“支持外接”再看模型

AIGoCode 的第三方工具接入有一个容易被忽略的先后顺序：先确认 API Key 分组支持外接，再按工具和协议填写地址、适配器或端点。只记住“我有一把 Key”，很容易把不匹配的分组、模型和协议混在一起。

本文把 Cherry Studio、Trae 和 Pi 的官方配置放到一张选择表里，帮助你在开始填写前决定检查顺序。它不替代任何一个工具的完整安装教程，也不意味着不同客户端可以任意共用 Key。

先按工具判断 Key 分组

三个官方教程给出的分组名称并不完全相同。Cherry Studio 要求创建支持外接（第三方调用）的分组；Trae 按模型区分，GPT 使用 Codex（可外接），Claude 使用 Claude Code（可外接）；Pi 也分别使用支持第三方调用的 Codex（可外接）、Claude Code（可外接）和 Gemini 分组。

因此，第一步不是先复制模型 ID，而是回到 API Key 页面确认你准备使用的工具、协议和分组。记录分组名称即可，不要把真实 Key 放进截图、文章或共享日志。

Pi 先找对 models.json

Pi 官方文档给出的配置位置是：Windows 使用 %USERPROFILE%\.pi\agent\models.json，macOS/Linux 使用 ~/.pi/agent/models.json。如果目录或文件不存在，先创建；保存时确认文件名确实是 models.json，不要变成 models.json.txt。已有其他供应商时，把新 provider 加进现有 providers，保留原内容。

三个工具的配置重点不在同一个字段

这张表只用于选方向。真正填写时仍要打开对应工具的官方页面，按它给出的字段名称和默认行为操作。

地址不能只按“根地址”或“/v1”一刀切

Cherry Studio 教程让你在对应协议的端点输入框填写 https://api.aigocode.dev，Gemini 端点也在更多设置中填写同一根地址。Trae 的 GPT 示例保留 https://api.aigocode.dev/v1，因为 Trae 会在末尾追加 /chat/completions；Claude 示例则填写 https://api.aigocode.dev，由 Trae 追加 /v1/messages。

Pi 的 models.json 又按协议写不同的 baseUrl：OpenAI 使用带 /v1 的地址，Claude 使用根地址，Gemini 使用带 /v1beta 的地址。不要把 Cherry Studio 的根地址直接复制到 Pi，也不要把 Trae 的完整接口路径手工追加进去。

如果出现 404，先检查工具是否会自行拼接路径，以及你填写的是根地址、协议地址还是完整接口地址。地址的规则属于工具配置行为，不能只看一条 API 示例推断所有客户端都相同。

模型 ID 也要跟着协议和工具配置走

Cherry Studio 教程用 GPT-6 Astra 演示添加模型；Trae 的 GPT 示例使用 gpt-6-astra，Claude 示例使用 claude-sonnet-5-5；Pi 的三个 provider 示例分别登记 gpt-6-astra、claude-sonnet-5-5 和 gemini-3.8-flash。

这些是教程中的示例模型，不是完整可用清单。模型不可用时，三个页面都把“检查模型名称列表”放在排查路径中。先确认模型 ID，再核对 Key 分组和请求地址，避免一次修改三个对象后无法判断原因。

最后用工具自己的方式验收

Cherry Studio 要回到对话页选择刚添加的模型并发送消息；Trae 要在自定义列表确认模型启用，再在对话页选择并测试；Pi 则在项目目录运行 pi，发送消息，并可让 Pi 读取项目文件确认工具调用。

把这些步骤放在配置之后，是因为“看见模型条目”不能代表实际请求已成功。验收时记录当前工具、分组、模型 ID、地址规则，以及是否收到回复。若请求返回 401、403 或 429，进入错误码排查；连接失败也要区分网络、代理、认证和模型配置。

你可以参考本站的API 与工具接入路径选择和401、403 认证与额度排查，但具体字段仍以当前工具教程为准。最终检查顺序保持固定：分组支持外接 → 协议与地址规则 → 模型 ID → 工具内实际请求。