OpenCode 安装教程（Windows）

本页指导你在 Windows 系统上使用 PowerShell 安装并配置 OpenCode，让它通过 AI通道 调用 Claude 或 GPT 模型。

0. 前置：安装 Node.js

检查 Node.js 版本：

node --version

低于 v22.0.0 请先按照 Node.js Windows 安装指南 升级。

1. 安装 OpenCode

全局安装 OpenCode 包：

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

2. 安装 SDK 依赖（必须）

2.1 什么是 SDK

OpenCode 本身不内置任何模型厂商的调用逻辑，而是依赖 Vercel 维护的 @ai-sdk/* 系列包。也就是说，你要用什么协议的模型，就要在 OpenCode 的配置目录里 npm install 对应的 provider 包。

2.2 创建配置目录并安装 Claude SDK（推荐）

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode" | Out-Null
Set-Location "$env:USERPROFILE\.config\opencode"
npm install @ai-sdk/anthropic

2.3 可选：安装 OpenAI SDK

如果你也想通过 OpenAI 协议调用 GPT 模型：

npm install @ai-sdk/openai

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

3.1 配置文件在哪里

%USERPROFILE%\.config\opencode\opencode.json

3.2 获取 AI通道 Key

登录 aitongdao.com，在「令牌」页面创建密钥；用 Claude 时建议选 claude 或 ccmax 分组，用 GPT 时选 codex 分组。

3.3 写入配置文件

下面的 PowerShell 命令会把配置写入 opencode.json，记得替换 sk-你的密钥：

$config = @'
{
  "$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"
}
'@
Set-Content -Path "$env:USERPROFILE\.config\opencode\opencode.json" -Value $config -Encoding UTF8

注意 Anthropic 协议的 baseURL 不带 /v1。

3.4 如果想同时配置 GPT 模型

在 provider 对象中追加 openai 分支，OpenAI 协议的 baseURL 带 /v1：

{
  "$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 命令找不到：关闭并重新打开 PowerShell；或检查 npm config get prefix 返回路径是否在系统 PATH。
• SDK 找不到：确认你是在 %USERPROFILE%\.config\opencode 目录下执行的 npm install，OpenCode 只会从该目录查找 provider 包。
• 启动提示 Cannot find module '@ai-sdk/anthropic'：没有在配置目录下安装对应 SDK，回到步骤 2 补装。
• 401 Unauthorized：检查 API Key 是否正确复制、令牌分组是否包含所请求的模型。
• 模型 ID 不识别：以 AI通道 后台「可用模型」列表为准填写 models 字段，名称区分大小写。