EcoPhase 文档 - 接入 WorkBuddy/CodeBuddy

通过 models.json 注册 EcoToken 模型，让 WorkBuddy/CodeBuddy 使用 OpenAI 兼容接口。

Base URL	认证方式	接口协议
`https://ecotoken.ecophase-ai.com/v1`	Bearer API Key	OpenAI Chat Completions

01 准备接入信息

先在 EcoToken 控制台创建 API Key，并确认该 API Key 可以访问 deepseek-v4.1-flash。

YOUR_API_KEY 是占位符。真实 API Key 通过 ECOTOKEN_API_KEY 环境变量提供。

02 安装客户端

从 WorkBuddy/CodeBuddy 官方网站安装桌面应用或 IDE 插件。如果已安装，直接进入配置步骤。

03 配置模型

创建用户级 ~/.codebuddy/models.json，或在项目根目录创建 .codebuddy/models.json。项目配置优先，文件必须保存为 UTF-8。

{
  "models": [
    {
      "id": "deepseek-v4.1-flash",
      "name": "deepseek-v4.1-flash",
      "vendor": "EcoToken",
      "url": "https://ecotoken.ecophase-ai.com/v1/chat/completions",
      "apiKey": "${ECOTOKEN_API_KEY}",
      "maxInputTokens": 128000,
      "maxOutputTokens": 8192,
      "supportsToolCall": true,
      "supportsImages": false
    }
  ],
  "availableModels": ["deepseek-v4.1-flash"]
}

maxInputTokens、maxOutputTokens、图片与工具调用开关应以控制台中所选模型的实际能力为准。

04 配置 API Key

export ECOTOKEN_API_KEY="YOUR_API_KEY"

Windows 使用 setx 后，需要完全退出并重新启动 WorkBuddy/CodeBuddy，使新环境变量生效。

05 启动并验证

完全退出并重新启动客户端，在模型选择器中选择 deepseek-v4.1-flash，发送一个简短问题。EcoToken 控制台“用量与费用 → 请求记录”出现对应记录即表示接入成功。

06 常见错误

401：检查 ECOTOKEN_API_KEY 是否在启动客户端的进程环境中生效。
403：检查 API Key 分组、模型权限和账户状态。
Base URL：url 字段需要填写完整的 https://ecotoken.ecophase-ai.com/v1/chat/completions 请求地址。