CodeBuddy CLI 接入 Models Hub:环境变量与 settings.json

用 CODEBUDDY_BASE_URL 等环境变量或 settings.json 把腾讯云 CodeBuddy CLI 指向 Models Hub 的 Claude 系列模型,附验证步骤与常见报错排查。

CodeBuddy CLI 是腾讯云推出的终端 AI 编程助手,协议与配置方式都参照 Claude Code:同样用 _BASE_URL / _API_KEY / _MODEL 这套环境变量,同样支持 settings.json 里的 env 段。把它指向 Models Hub 后,codebuddy 里的对话与代码修改都会用 Models Hub 的额度调用你指定的模型。本文只讲接入,不讲 CodeBuddy CLI 本身的用法。

三样东西

接入只需要:Models Hub 的 API Key、接入地址 https://modelsok.com、一个模型名。没有一键配置,CodeBuddy CLI 不在 Models Hub CLI 的支持范围内。

准备

已安装 CodeBuddy CLI。没装的话运行 npm install -g @tencent-ai/codebuddy-code(需要 Node.js 18.20 及以上),macOS/Linux 也可以 curl -fsSL https://www.codebuddy.cn/cli/install.sh | bash,装完 codebuddy --version 能出版本号即可,详见官方安装文档。
一个 Models Hub API Key。在控制台的令牌页创建,令牌所在分组要能访问你打算用的模型。

用途	模型名	定价	实时状态
日常编码,速度与质量的平衡点	`claude-sonnet-4-6`	查看价格	可用率与延迟
复杂重构、长任务	`claude-opus-4-6`	查看价格	可用率与延迟
后台轻量任务	`claude-haiku-4-5`	查看价格	可用率与延迟

配置步骤

临时测试可以直接在当前 shell 导出环境变量:

export CODEBUDDY_API_KEY="你的 Models Hub API Key"
export CODEBUDDY_BASE_URL="https://modelsok.com"
export CODEBUDDY_MODEL="claude-sonnet-4-6"

Windows(PowerShell):

$env:CODEBUDDY_API_KEY="你的 Models Hub API Key"
$env:CODEBUDDY_BASE_URL="https://modelsok.com"
$env:CODEBUDDY_MODEL="claude-sonnet-4-6"

想固定生效,编辑用户级 ~/.codebuddy/settings.json(Windows 为 %USERPROFILE%\.codebuddy\settings.json),写入 env 段:

{
  "env": {
    "CODEBUDDY_API_KEY": "你的 Models Hub API Key",
    "CODEBUDDY_BASE_URL": "https://modelsok.com",
    "CODEBUDDY_MODEL": "claude-sonnet-4-6",
    "CODEBUDDY_SMALL_FAST_MODEL": "claude-haiku-4-5"
  }
}

变量	作用
`CODEBUDDY_API_KEY`	你的 Models Hub API Key
`CODEBUDDY_BASE_URL`	接入地址,不要加 `/v1`,CodeBuddy CLI 自己会拼路径
`CODEBUDDY_MODEL`	默认模型
`CODEBUDDY_SMALL_FAST_MODEL`	后台小任务用的模型,配一个便宜的

CodeBuddy CLI 的配置按优先级合并(高覆盖低):命令行参数 > 项目本地 ./.codebuddy/settings.local.json > 项目共享 ./.codebuddy/settings.json > 用户级 ~/.codebuddy/settings.json。团队统一配置建议写进项目共享文件。

验证

在任意项目目录运行 codebuddy,输入一句话,例如「用一句话介绍当前目录」。能正常回复即接通。两个补充判据:输入 /model 能看到当前使用的模型;打开 Models Hub 控制台的用量日志,几秒内会出现一条对应模型名的请求。

常见报错

现象	原因	处理
`401` / 鉴权失败	Key 写错、多了空格,或令牌已被禁用	到令牌页重新复制
`model not found` / 无可用渠道	模型名拼错,或令牌所在分组没有该模型	对照定价页核对名字
请求 404	`CODEBUDDY_BASE_URL` 误写成了 `/v1/chat/completions` 这类 OpenAI 路径	CodeBuddy CLI 走 Anthropic 兼容协议,`CODEBUDDY_BASE_URL` 不要带路径后缀
改了 `settings.json` 没生效	已开启的会话不读取新配置	重启 `codebuddy` 或执行 `/clear` 新建会话
`429`	触发限流,通常是并发过高	稍后重试;持续出现联系客服提额

更多排查见故障排查。

常见问题

计费方式? 按请求实际消耗的输入与输出 token 计费,价格在各模型的定价页,用量日志里能看到每一条请求的明细。

和直接用腾讯云官方账号有什么区别? 配置后 CodeBuddy CLI 的所有请求都会走 Models Hub 接入点,不再消耗官方账号的额度;你不需要单独申请腾讯云 CodeBuddy 的订阅。

怎么切换模型? 在 CodeBuddy CLI 里输入 /model 选择,或运行 codebuddy config set model <模型名>,也可以改 CODEBUDDY_MODEL 后重启。

CodeBuddy CLI 接入 Models Hub:环境变量与 settings.json

准备

推荐模型

配置步骤

验证

常见报错

常见问题

相关

本页目录