CodeBuddy Code

CodeBuddy Code 是腾讯云代码助手 CodeBuddy 推出的终端 AI 编程工具（CLI），支持通过命令行与 AI 对话、生成代码、操作文件和执行终端命令。

准备工作

已开通云开发环境，获取环境ID cloudBase环境ID
在 AI 控制台中开启所需模型
在 AI 控制台中获取 Base URL 和 API Key

Base URLhttps://<ENV_ID>.api.tcloudbasegateway.com/v1/ai/cloudbase

配置步骤

CodeBuddy Code 通过 models.json 配置文件管理自定义模型。

配置字段对照表

字段	解释
id	大模型 ID，在 AI 控制台模型列表复制已启用的大模型标识填入
name	模型显示名称，便于区分
url	大模型 Base URL，在 AI 控制台中获取
apiKey	调用大模型 API Key，在 AI 控制台中获取

用户级配置（全局生效）
项目级配置（当前项目生效）

打开或创建 CodeBuddy Code 配置文件

备注

如果通过您文件浏览器找到文件，文件浏览器默认会隐藏掉以"."开头的文件名的文件，您可能需要打开文件浏览器的隐藏文件选项才能看到。

Mac 通过访达快捷键 Command + Shift + . 打开，Windows 可以通过勾选 "文件资源管理器 - 查看 - 显示 - 隐藏项目" 打开。

Mac/Linux 配置路径

~/.codebuddy/models.json

Windows 配置路径

C:\Users\<你的用户名>\.codebuddy\models.json

填入以下配置

{
  "models": [
    {
      "id": "hy3-preview",
      "name": "hy3-preview (CloudBase)",
      "vendor": "CloudBase",
      "url": "https://{{cloudBase环境ID}}.api.tcloudbasegateway.com/v1/ai/cloudbase",
      "apiKey": "eyJhbGciOiJSUzI1N...",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true
    }
  ],
  "availableModels": ["hy3-preview"]
}

启动 CodeBuddy Code

codebuddy --model hy3-preview

或在交互中通过 /model 命令切换模型。

在项目根目录创建 .codebuddy/models.json，配置格式与用户级相同。项目级配置优先级高于用户级，会覆盖同 ID 模型。

<项目根目录>/.codebuddy/models.json

配置内容示例同用户级配置。启动时 CodeBuddy Code 会自动读取项目级配置。

常见错误排查

报错信息	解决方法
请求失败 / 连接超时	确认 `url` 字段中的 Base URL 是否正确
`401` 认证失败	API Key 错误或已失效，请在 AI 控制台中重新获取
`429` Token usage exceeded quota limit	模型名称填写错误，或者大模型未在 AI 控制台中启用
模型列表中看不到	检查 `availableModels` 数组中是否包含该模型 ID

准备工作

配置步骤​

常见错误排查​

配置步骤

常见错误排查