添加 OpenAI 兼容的 EcoToken provider，在终端或 Web 界面中选择模型。

01 准备接入信息

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

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

02 安装 OpenCode

推荐使用 v1.18.18 或更高版本。

npm install -g opencode-ai

03 方式一：EcoToken 工具配置

配置工具默认修改 ~/.config/opencode/opencode.json；如果已有 opencode.jsonc，则修改该文件。原文件需要修改时会在实际文件名后追加 .ecotoken.bak。

npm install -g @ecophase-ai/ecotoken

04 方式二：手动配置

在项目根目录创建 opencode.json，provider ID 与模型前缀都使用 ecotoken。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "ecotoken/deepseek-v4.1-flash",
  "provider": {
    "ecotoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "EcoToken",
      "options": {
        "baseURL": "https://ecotoken.ecophase-ai.com/v1",
        "apiKey": "{env:ECOTOKEN_API_KEY}"
      },
      "models": {
        "deepseek-v4.1-flash": {
          "name": "deepseek-v4.1-flash"
        }
      }
    }
  }
}

export ECOTOKEN_API_KEY="YOUR_API_KEY"
opencode

05 启动并验证

进入项目目录后运行 opencode，选择 ecotoken/deepseek-v4.1-flash 并发送一个简短问题。控制台“用量与费用 → 请求记录”出现对应记录即表示接入成功。

06 常见错误

• 401：确认 ECOTOKEN_API_KEY 在启动 OpenCode 的同一终端会话中生效。
• 403：检查 API Key 分组、模型权限和账户状态。
• model not found：确认 model、provider 下的模型键和 EcoToken 模型 ID 完全一致。