Questa pagina al momento è disponibile solo in cinese. Navigazione e menu sono già in italiano.

配置 CodeBuddy IDE

CodeBuddy IDE 是 AI Agent 与编程助手工具。它支持通过本地模型配置文件添加自定义模型，可以使用 OpenAI 兼容的 Chat Completions API 接入 InOneAPI。

1. 准备工作

  1. 安装并登录 CodeBuddy IDE。
  2. 至少打开一次项目目录，让应用创建本地配置目录。
  3. 在 InOneAPI 控制台创建 API Key，并在模型详情页复制模型 ID，原样复制。YOUR_MODEL_ID 只是文档占位符。

模型详情页的 Agent 工具入口可以直接生成填好 Key 和模型 ID 的完整配置内容。

2. 配置本地模型

创建或编辑用户级配置文件：

  • macOS / Linux：~/.codebuddy/models.json
  • Windows：C:\Users\<你的用户名>\.codebuddy\models.json

如果只想让配置对某个项目生效，也可以创建项目级配置文件 <你的项目>/.codebuddy/models.json。

写入以下配置：

{
  "models": [
    {
      "id": "YOUR_MODEL_ID",
      "name": "YOUR_MODEL_ID",
      "vendor": "InOneAPI",
      "url": "https://api.inoneapi.com/v1/chat/completions",
      "apiKey": "ioa_sk_...",
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": [
    "YOUR_MODEL_ID"
  ]
}

合并 models 数组时保留其他条目。availableModels 是显示白名单，已有该字段时追加当前 ID，不要覆盖原列表。

字段说明：

  • url 是完整的 Chat Completions 端点，必须包含 /v1/chat/completions。
  • id 必须原样使用模型详情页的模型 ID，不能只填展示名称。
  • maxInputTokens 和 maxOutputTokens 是可选字段，只在明确知道模型实际上限时添加；页面不再猜测 128K / 8192。
  • supportsToolCall 和 supportsImages 按模型真实能力填写，不支持时改为 false。

请将 models.json 保存为 UTF-8 无 BOM。部分桌面版本在读取带 UTF-8 BOM 文件头的 JSON 时，可能会读取本地模型配置失败。

apiKey 按官方字段说明填写实际密钥值，不使用 ${INONEAPI_API_KEY} 等未经文档支持的替换写法。

3. 保存并选择模型

  1. 保存文件。官方支持约 1 秒防抖的热重载；若配置未生效再重启。
  2. 在模型选择器中选择刚添加的模型名称。

4. 可选：验证 API Key

macOS / Linux 可以在终端中验证 Key 和模型 ID 是否可用：

curl https://api.inoneapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ioa_sk_..." \
  -d '{"model":"YOUR_MODEL_ID","messages":[{"role":"user","content":"hi"}],"stream":false}'

如果请求成功，说明 API Key 和模型 ID 都可用。

常见问题

  • Authentication Fails 或 401：检查 apiKey 是否为真实的 InOneAPI API Key，不要把接口 URL 填到 API Key 字段。
  • 未找到模型或 404：检查 id 是否严格等于模型详情页的模型 ID。
  • 读取本地模型配置失败：检查 models.json 是否是合法 JSON，并保存为 UTF-8 无 BOM。
  • 模型选择器中不显示：完全重启 CodeBuddy IDE，并确认文件放在 .codebuddy/models.json。

生产使用时，为 CodeBuddy IDE 单独创建子 Key，并设置预算、模型白名单和告警。参阅团队 Key 与用量。

此页仅用于 CodeBuddy IDE，不适用于 CodeBuddy CLI 或所有插件版本。WorkBuddy 请使用可视化配置指南。

官方参考：CodeBuddy IDE models.json。

CodeBuddy IDE · Documentazione · InOneAPI