CodeBuddy 配置

在 CodeBuddy 中使用平台的模型。CodeBuddy 使用 OpenAI 接口，IDE、VS Code 插件与命令行共用同一份模型配置。

准备工作

• API 密钥：在控制台的 API 密钥 页新建，把下文配置里的 sk-... 换成你的密钥。
• 接入地址：https://api.gxcy.com/v1（OpenAI 接口）。
• 模型：可以调用的模型见控制台的 模型 页，下文以 deepseek-flash 为例。

配置模型

编辑 models.json，目录不存在时自行创建：

• macOS / Linux：~/.codebuddy/models.json
• Windows：%USERPROFILE%\.codebuddy\models.json

{
  "models": [
    {
      "id": "deepseek-flash",
      "name": "deepseek-flash",
      "vendor": "国芯词元",
      "apiKey": "sk-...",
      "url": "https://api.gxcy.com/v1/chat/completions",
      "supportsToolCall": true,
      "supportsImages": false
    }
  ]
}

• url 是完整的对话接口地址，比接入地址多一段 /chat/completions。
• models 里可以列多个模型。supportsToolCall、supportsImages 按模型是否支持工具调用、识图填写。
• 可以用 maxInputTokens、maxOutputTokens 写明模型的上下文长度与最大输出，CodeBuddy 据此在对话过长时自动压缩。

使用 CodeBuddy IDE

1. 从 CodeBuddy 官网 下载并安装 IDE，支持 Windows、macOS 与 Linux。首次启动时按提示登录。
2. 在对话框底部的模型选择器中选择刚配置的模型，不要选 Auto。

使用 VS Code 插件

在 VS Code 扩展市场搜索 Tencent Cloud CodeBuddy 并安装插件。插件自动读取上文的 models.json。

使用 CodeBuddy 命令行

CodeBuddy 命令行需要 Node.js 18.20 或更新版本。

npm install -g @tencent-ai/codebuddy-code

验证安装，输出版本号即安装成功：

codebuddy --version

进入项目目录，执行 codebuddy 启动，首次使用时按提示登录。启动后用 /model 查看或切换模型，用 /status 查看当前状态。

常见问题

配置后模型没有出现在列表中

• 检查 models.json 的 JSON 语法是否正确。
• 如果配置了 availableModels，确认其中包含该模型的 id。