OpenCode 安装教程（Linux / WSL2）

本页指导你在 Linux 或 Windows WSL2 环境下安装 OpenCode 并接入 AI通道。

0. 前置：安装 Node.js

node --version

需要 Node.js 22 或更高。使用 nvm 安装：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
nvm use 22

1. 安装 OpenCode

npm i -g opencode-ai@latest
opencode --version

2. 安装 SDK 依赖（必须）

2.1 什么是 SDK

OpenCode 通过 Vercel AI SDK 与各家模型服务通信。使用 Claude 协议就需要 @ai-sdk/anthropic，使用 OpenAI 协议就需要 @ai-sdk/openai，这些包必须装在 OpenCode 的配置目录下，OpenCode 启动时会从那里加载。

2.2 安装 Claude SDK（推荐）

mkdir -p ~/.config/opencode
cd ~/.config/opencode
npm install @ai-sdk/anthropic

2.3 可选：安装 OpenAI SDK

npm install @ai-sdk/openai

3. 配置 OpenCode（接入 AI通道）

3.1 配置文件在哪里

~/.config/opencode/opencode.json

3.2 获取 AI通道 Key

在 aitongdao.com 登录后进入「令牌」菜单，按使用场景选择分组：Claude 选 claude 或 ccmax，GPT 选 codex。

3.3 写入配置文件

cat > ~/.config/opencode/opencode.json <<'EOF'
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "sk-你的密钥",
        "baseURL": "https://aitongdao.com"
      },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
        "claude-opus-4-6": { "name": "Claude Opus 4.6" }
      }
    }
  },
  "model": "anthropic/claude-sonnet-4-6"
}
EOF

关键字段：

• apiKey：AI通道 令牌
• baseURL：Anthropic 协议 https://aitongdao.com，OpenAI 协议 https://ai.aitongdao.com/v1
• model：provider/model-id 组合

3.4 如果想同时配置 GPT 模型

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "sk-你的密钥",
        "baseURL": "https://aitongdao.com"
      },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    },
    "openai": {
      "options": {
        "apiKey": "sk-你的密钥",
        "baseURL": "https://ai.aitongdao.com/v1"
      },
      "models": {
        "gpt-5": { "name": "GPT-5" }
      }
    }
  },
  "model": "anthropic/claude-sonnet-4-6"
}

4. 启动并验证

opencode

/models 命令切换模型，发送一条测试消息即可确认。

常见问题

• opencode 命令找不到：npm bin -g 路径未加入 $PATH，使用 nvm 管理的 Node 一般自动加入。
• Cannot find module '@ai-sdk/*'：provider 包未安装在 ~/.config/opencode/ 目录下，cd 进去重新 npm install。
• 401 错误：API Key 错误、被删除或令牌余额不足，返回后台重新创建。
• Anthropic 请求 404：baseURL 错误加了 /v1，Anthropic 协议不需要。
• WSL2 网络异常：检查 /etc/resolv.conf 的 DNS；WSL2 部分场景需要临时改用 1.1.1.1。