OpenCode 安装教程（Windows）

0. 前置：安装 Node.js

先装 Node.js：Nodejs Windows

1. 安装 OpenCode

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

2. 安装 SDK 依赖（必须）

2.1 什么是 SDK？

SDK 就是让 OpenCode 能够调用不同 AI 服务的工具包。OpenCode 支持多种 AI 服务，需要先安装对应的 SDK。

2.2 安装 Claude SDK（推荐）

第一步：创建配置目录

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.config\opencode"

第二步：进入配置目录

cd "$env:USERPROFILE\.config\opencode"

第三步：安装 Anthropic SDK（用于 Claude 模型）

npm install @ai-sdk/anthropic

等待安装完成（可能需要几分钟）。

2.3 可选：安装 OpenAI SDK

如果你还想用 GPT 模型，可以再安装 OpenAI SDK：

npm install @ai-sdk/openai

提示：词元AI 同时支持 Claude 和 GPT 模型，所以两个 SDK 都装上会更方便。

3. 配置 OpenCode（接入词元AI）

3.1 配置文件在哪里？

配置文件路径：%USERPROFILE%\.config\opencode\opencode.json

什么意思？

• 完整路径是：C:\Users\你的用户名\.config\opencode\opencode.json

3.2 获取词元AI Key

第一步：访问词元AI官网获取你的 API Key

• 如果还没有账号，需要先注册
• 登录后在控制台找到 API Key，复制保存好

3.3 写入配置文件

下面是一份 Claude 模型的配置示例（注意替换 API Key）：

@'
{
  “$schema”: “https://opencode.ai/config.json”,
  “provider”: {
    “flashapi-claude”: {
      “npm”: “@ai-sdk/anthropic”,
      “options”: {
        “apiKey”: “你的词元AI Key”,
        “baseURL”: “https://api.ci-yuan-ai.com/v1”
      },
      “models”: {
        “claude-sonnet-4-6”: {
          “name”: “Claude Sonnet 4.6”,
          “attachment”: true
        }
      }
    }
  },
  “model”: “flashapi-claude/claude-sonnet-4-6”
}
'@ | Set-Content -Path “$env:USERPROFILE\.config\opencode\opencode.json” -Encoding UTF8

必须替换：把 你的词元AI Key 替换成你从词元AI官网复制的真实 Key

3.4 如果想同时配置 GPT 模型

如果你前面安装了 @ai-sdk/openai，可以用下面这个配置（同时支持 Claude 和 GPT）：

@'
{
  “$schema”: “https://opencode.ai/config.json”,
  “provider”: {
    “flashapi-claude”: {
      “npm”: “@ai-sdk/anthropic”,
      “options”: {
        “apiKey”: “你的词元AI Key”,
        “baseURL”: “https://api.ci-yuan-ai.com/v1”
      },
      “models”: {
        “claude-sonnet-4-6”: {
          “name”: “Claude Sonnet 4.6”,
          “attachment”: true
        }
      }
    },
    “flashapi-openai”: {
      “npm”: “@ai-sdk/openai”,
      “options”: {
        “apiKey”: “你的词元AI Key”,
        “baseURL”: “https://api.ci-yuan-ai.com/v1”
      },
      “models”: {
        “gpt-5.2”: {
          “name”: “GPT-5.2”,
          “attachment”: true
        }
      }
    }
  },
  “model”: “flashapi-claude/claude-sonnet-4-6”
}
'@ | Set-Content -Path “$env:USERPROFILE\.config\opencode\opencode.json” -Encoding UTF8

配置说明：

• ”model” 这一行设置默认使用的模型
• 如果想默认用 GPT，改成：”model”: “flashapi-openai/gpt-5.2”
• ”attachment”: true 表示支持上传文件（比如图片、代码文件）

4. 启动并验证

cd C:\path\to\your\project
opencode