OpenCode 接入指南

OpenCode 是一款开源的命令行 AI 编程助手，通过加载 AI SDK provider 包的方式接入任意 OpenAI 或 Anthropic 协议后端。本页介绍在 AI通道 上使用 OpenCode 的整体流程。

你需要准备

• Node.js 22 或更高版本：OpenCode 及其 SDK 依赖都需要较新的 Node 运行环境。
• AI通道 API Key：登录 aitongdao.com 在「令牌」菜单创建。使用 Claude 选 claude 或 ccmax 分组；使用 GPT 选 codex 分组。
• 接入地址（所有 AI 调用统一走 ai. 子域）：
  • Anthropic 协议：https://ai.aitongdao.com
  • OpenAI 协议：https://ai.aitongdao.com/v1
• 钱包余额：所属账户需有余额。

选择你的系统

• Windows 手动安装
• macOS 手动安装
• Linux / WSL2 手动安装

最小可用思路

OpenCode 的接入相比其他 CLI 稍多一步——它需要在配置目录里同时安装对应的 SDK provider 包。完整流程是：

1. 全局安装 OpenCode：npm i -g opencode-ai@latest
2. 创建 OpenCode 配置目录 ~/.config/opencode/（Windows 为 %USERPROFILE%\.config\opencode\）
3. 在该目录内安装 provider 包：
   • 使用 Claude：npm install @ai-sdk/anthropic
   • 使用 GPT：npm install @ai-sdk/openai
4. 在同目录编写 opencode.json，指向 AI通道 的 base URL
5. 运行 opencode 进入会话

OpenCode 的配置遵循官方 JSON Schema（https://opencode.ai/config.json），各 provider 在 provider.<name>.options 中设置 apiKey 与 baseURL，并在 models 字段声明可用模型。