Agentsflare CodeBuddy / WorkBuddy 配置方案

CodeBuddy 是腾讯云代码助手，其 CLI 版本 CodeBuddy Code 是面向专业开发者的 coding agent；WorkBuddy 是同产品族的桌面端/智能体版本。二者均可接入 Agentsflare 网关，使用 Claude、GPT 等模型。

安装配置 CodeBuddy Code

安装 CodeBuddy Code

通过 npm 安装：

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

安装完成后在终端执行 codebuddy 启动。其他安装方式参考官方文档：CodeBuddy Code 安装指南

方式一：环境变量（Anthropic 兼容，推荐）

CodeBuddy Code 支持对接任意兼容 Anthropic 协议的第三方模型服务，只需配置 Base URL、API Key 和模型环境变量，无需修改 models.json。

在 ~/.zshrc 或 ~/.bashrc 中添加：

# 端点与密钥
export CODEBUDDY_BASE_URL="https://api.agentsflare.com/anthropic"
export CODEBUDDY_API_KEY="API-KEY"

# 主 Agent 默认模型
export CODEBUDDY_MODEL="claude-opus-5"

# 可选：复杂推理使用的大模型
export CODEBUDDY_BIG_SLOW_MODEL="claude-opus-5"

# 可选：后台/轻量任务使用的小模型
export CODEBUDDY_SMALL_FAST_MODEL="claude-sonnet-5"

然后启动 CodeBuddy Code：

codebuddy --model claude-opus-5

以上变量也可以写入 ~/.codebuddy/settings.json 的 env 字段，每个会话自动应用：

{
  "env": {
    "CODEBUDDY_BASE_URL": "https://api.agentsflare.com/anthropic",
    "CODEBUDDY_API_KEY": "API-KEY",
    "CODEBUDDY_MODEL": "claude-opus-5"
  }
}

重启 CodeBuddy Code 生效配置。

方式二：models.json（OpenAI 兼容）

如需通过 OpenAI 兼容端点使用 GPT 等其他模型，编辑用户级配置文件 ~/.codebuddy/models.json（或优先级更高的项目级 <项目根目录>/.codebuddy/models.json）：

{
  "models": [
    {
      "id": "gpt-5.6",
      "name": "GPT-5.6 (Agentsflare)",
      "vendor": "OpenAI",
      "url": "https://api.agentsflare.com/v1/chat/completions",
      "apiKey": "${AGENTSFLARE_API_KEY}",
      "maxInputTokens": 200000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": true
    }
  ],
  "availableModels": [
    "gpt-5.6"
  ]
}

设置 API 密钥环境变量后启动：

export AGENTSFLARE_API_KEY="API-KEY"
codebuddy --model gpt-5.6

注意事项：

• url 字段必须是接口完整路径，以 /chat/completions 结尾（如 https://api.agentsflare.com/v1/chat/completions）；只填 https://api.agentsflare.com/v1 这样的裸地址无法工作。
• apiKey 和 url 支持 ${变量名} 环境变量引用语法，避免密钥明文存储；建议将 models.json 文件权限设置为 600。
• availableModels 控制模型下拉列表显示哪些模型；不配置则显示所有模型。
• 配置文件支持热重载，修改后自动检测生效。

切换模型

• 启动时指定主模型：codebuddy --model <模型id>
• 会话内使用 /model 命令切换模型，或用 /model:lite / /model:reasoning 固定轻量/推理场景变体模型。

WorkBuddy

WorkBuddy 是 CodeBuddy 产品族的桌面端/智能体版本，与 CodeBuddy Code 共用同一套账号和配置体系（~/.codebuddy/ 目录），上述环境变量与 models.json 配置同样适用于 WorkBuddy。详见官方文档：CodeBuddy 环境变量参考

常见问题

配置不生效

环境变量在 CLI 启动时解析。修改 ~/.zshrc / ~/.bashrc 或 settings.json 后，需重启终端和 CodeBuddy Code。如果 models.json 中 ${变量名} 引用的环境变量不存在，占位符会原样保留并导致 API 调用失败——请确保启动前已 export 该变量。

models.json 模型请求失败

检查 url 是否为以 /chat/completions 结尾的完整路径，并确认模型 id 在你的 Agentsflare 账户可用模型列表中（见模型支持）。

相关文档

• API 地址
• 模型支持
• CodeBuddy Code 环境变量（官方）
• CodeBuddy Code models.json 配置指南（官方）