CodeBuddy

CodeBuddy Code 是腾讯云推出的 AI 编程命令行工具，支持通过 models.json 配置文件自定义接入第三方大模型。本文介绍如何在 CodeBuddy CLI 中接入 Sophnet 云算力平台的 API。

1. 安装 CodeBuddy 教程

1.1 安装 Node.js

CodeBuddy 通过 npm 安装时，建议使用 Node.js LTS 版本。如果系统里已经有可用的 Node.js，可直接跳到下一节。

步骤 1：确认 Node.js 是否已安装

node -v
npm -v

步骤 2：如未安装，再安装 Node.js

可使用你熟悉的方式安装，例如从 Node.js 官网安装 LTS 版本，或在已安装 nvm 的环境中执行：

nvm install --lts
nvm use --lts

步骤 3：验证安装

node -v
npm -v

---

1.2 安装 CodeBuddy CLI

在 macOS / Linux 上安装

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

验证安装

codebuddy --version

---

2. 环境配置

2.1 获取 Sophnet API Key

Sophnet 云算力平台网址：https://sophnet.com

步骤 1：创建 API Key

在用户中心界面找到：+新的API Key，保存生成的 API Key，后续配置将使用。

步骤 2：新建服务并选择模型

进入 Sophnet 控制台，创建新项目 → 点击项目列表中 详情 → 在项目详情页进入 服务总览，点击 创建新服务

Sophnet 支持多种主流大模型，例如：

• DeepSeek-V4-Flash
• GLM-5.2
• GLM-5.1
• qwen3.7-plus

在此界面添加所有想要使用的模型。

---

2.2 配置 CodeBuddy 模型（models.json）

CodeBuddy CLI 通过 models.json 配置文件管理自定义模型列表，并控制模型下拉列表的显示。

配置文件位置

CodeBuddy 支持两个级别的配置：

• 用户级：~/.codebuddy/models.json —— 全局配置，适用于所有项目
• 项目级：<项目根目录>/.codebuddy/models.json —— 项目特定配置，优先级高于用户级

配置优先级

配置合并优先级从高到低：

1. 项目级 models.json
2. 用户级 models.json
3. 内置默认配置

项目级配置会覆盖用户级配置中相同 id 的模型定义。

添加 Sophnet 模型

建议优先通过环境变量引用 API Key，避免把密钥明文写入 models.json。

先设置环境变量：

export SOPHNET_API_KEY="你的 Sophnet API Key"

再在 models.json 中添加 Sophnet 模型配置，以 DeepSeek-V4-Flash 为例：

mkdir -p ~/.codebuddy && vim ~/.codebuddy/models.json

写入以下内容：

{
  "models": [
    {
      "id": "DeepSeek-V4-Flash",
      "name": "Sophnet DeepSeek",
      "vendor": "Sophnet",
      "apiKey": "${SOPHNET_API_KEY}",
      "url": "https://www.sophnet.com/api/open-apis/v1/chat/completions",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true
    }
  ]
}

📌 说明：

• id 填写 Sophnet 平台上的模型名称。
• apiKey 建议写为环境变量引用，例如 ${SOPHNET_API_KEY}。
• url 必须是接口完整路径，一般以 /chat/completions 结尾。
• 如需使用其他模型，将 id 改为对应模型名称即可。

字段说明

字段	类型	必填	说明
id	string	✓	模型唯一标识符
name	string	-	模型显示名称
vendor	string	-	模型供应商
apiKey	string	-	API 密钥，支持 ${VAR_NAME} 环境变量引用
url	string	-	API 端点 URL，支持 ${VAR_NAME} 环境变量引用；如直接填写，必须是完整路径，一般以 /chat/completions 结尾
maxInputTokens	number	-	最大输入 token 数
maxOutputTokens	number	-	最大输出 token 数
temperature	number	-	采样温度，范围 0-2
supportsToolCall	boolean	-	是否支持工具调用
supportsImages	boolean	-	是否支持图片输入
supportsReasoning	boolean	-	是否支持推理模式
relatedModels	object	-	关联模型配置，可指定不同场景下使用的模型

目前 CodeBuddy 仅支持 OpenAI 接口格式的 API。

环境变量会在 CodeBuddy CLI 启动时解析；如果变量未设置，原始占位符会被保留，进而导致 API 调用失败。

控制下拉列表中的可用模型

可使用 availableModels 字段控制模型选择下拉列表中显示哪些模型，只有在该数组中列出的模型 ID 才会显示：

{
  "models": [
    {
      "id": "DeepSeek-V4-Flash",
      "name": "Sophnet DeepSeek",
      "vendor": "Sophnet",
      "apiKey": "${SOPHNET_API_KEY}",
      "url": "https://www.sophnet.com/api/open-apis/v1/chat/completions",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true
    },
    {
      "id": "GLM-5.2",
      "name": "Sophnet GLM",
      "vendor": "Sophnet",
      "apiKey": "${SOPHNET_API_KEY}",
      "url": "https://www.sophnet.com/api/open-apis/v1/chat/completions",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true
    }
  ],
  "availableModels": [
    "DeepSeek-V4-Flash",
    "GLM-5.2"
  ]
}

如果同时存在用户级和项目级配置，需要注意：

• models 会按 id 合并，同名模型由项目级配置覆盖用户级配置。
• availableModels 不会合并；一旦项目级配置中定义了 availableModels，就会完整覆盖用户级的 availableModels。

---

3. 运行 CodeBuddy

启动命令

在终端执行命令 codebuddy 运行 CodeBuddy CLI：

codebuddy

首次运行会进入交互式界面。

切换模型

在 CodeBuddy CLI 中执行 /model 命令查看并切换模型，选择刚通过 models.json 添加的 Sophnet 模型（自动标记 custom 标签）：

/model

开始使用

在输入框中输入指令，CodeBuddy 将调用 Sophnet 平台的 API 完成对话或代码任务。

至此，你成功实现在 CodeBuddy CLI 中调用 Sophnet 云算力平台的 API。

---

4. 常见问题

1. 配置未生效

• 检查 models.json 的 JSON 格式是否正确。
• 确认文件路径是否正确（~/.codebuddy/models.json 或 <项目>/.codebuddy/models.json）。
• 查看 CodeBuddy CLI 日志确认配置是否被加载。
• 如果 apiKey 使用了环境变量引用，确认对应环境变量已经设置，并在启动 codebuddy 前已生效。

2. 模型未在列表中显示

• 若配置了 availableModels，检查模型 id 是否在数组中列出。
• 如果项目级 models.json 中定义了 availableModels，它会完整覆盖用户级 availableModels。
• 验证必填字段（如 id）是否都已提供。
• 不同 id 的模型会被追加，相同 id 的模型会被覆盖（项目级优先）。

3. URL 配置错误

url 字段必须为接口完整路径，一般以 /chat/completions 结尾。

✅ 正确示例：

https://www.sophnet.com/api/open-apis/v1/chat/completions

❌ 错误示例：

https://www.sophnet.com/api/open-apis/v1
https://www.sophnet.com/api/open-apis

4. 官方文档建议

更多详细配置可参考 CodeBuddy 官方文档：models.json 配置指南。