CodeBuddy

CodeBuddy Code 是腾讯云的终端 AI 编程工具。它支持用环境变量覆盖 API 地址、Key 和模型，因此无需修改项目代码即可接入 ModelGo。

接入前准备

• 已安装 Node.js 18+。
• 已安装 CodeBuddy CLI，并能执行 codebuddy --version。
• 已在 ModelGo 控制台创建 API Key。
• 已在模型广场确认逻辑模型名。

1. 安装 CodeBuddy

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

2. 配置 ModelGo 环境变量

在启动 CodeBuddy 的同一终端设置：

export CODEBUDDY_BASE_URL="https://api.modelgo.com/v1"
export CODEBUDDY_API_KEY="sk-你的token"
export CODEBUDDY_MODEL="你的模型名"

CODEBUDDY_BASE_URL 覆盖请求地址，CODEBUDDY_API_KEY 用于模型调用，CODEBUDDY_MODEL 指定 ModelGo 逻辑模型。不要将 CODEBUDDY_AUTH_TOKEN 与 ModelGo API Key 混用；前者是 CodeBuddy 平台登录凭据。

3. 启动并验证

curl https://api.modelgo.com/v1/models \
  -H "Authorization: Bearer $CODEBUDDY_API_KEY"
codebuddy

在会话中让 CodeBuddy 执行一个只读任务；非交互调用示例：

codebuddy -p "请用一句话介绍当前项目"

常见问题

仍然使用默认模型或地址

确认环境变量在当前终端可见，并完全退出后重新启动 codebuddy。检查变量名拼写是否为大写形式。

401 或 404

检查 CODEBUDDY_API_KEY、CODEBUDDY_MODEL 和 CODEBUDDY_BASE_URL，不要把完整接口路径写进 Base URL。

相关文档

• 首次调用：创建 API Key、查询模型并验证 ModelGo 接口。
• CodeBuddy CLI 快速开始：查看安装、登录和首次运行流程。
• CodeBuddy CLI 环境变量：查看 CODEBUDDY_BASE_URL、CODEBUDDY_API_KEY 和模型变量。