OpenCode 安装教程（macOS）

0. 前置：安装 Node.js

先装 Node.js：Nodejs macOS

1. 安装 OpenCode

第一步：全局安装 OpenCode

npm i -g opencode-ai@latest

第二步：验证安装

opencode --version

如果看到版本号，说明安装成功了。

2. 安装 SDK 依赖（必须）

2.1 什么是 SDK？

SDK 就是让 OpenCode 能够调用不同 AI 服务的工具包。我们需要先安装对应的 SDK。

2.2 安装 Claude SDK（推荐）

第一步：创建配置目录

mkdir -p ~/.config/opencode

第二步：进入配置目录

cd ~/.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 配置文件在哪里？

配置文件路径：~/.config/opencode/opencode.json

什么意思？

• ~ 表示你的用户主目录
• 完整路径是：/Users/你的用户名/.config/opencode/opencode.json

3.2 获取词元AI Key

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

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

3.3 写入配置文件

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

cat > ~/.config/opencode/opencode.json <<'EOF'
{
  "$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"
}
EOF

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

如何替换？

1. 复制上面整段命令
2. 把 你的词元AI Key 这几个字替换成你的真实 Key
3. 然后粘贴到终端执行

3.4 如果想同时配置 GPT 模型

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

cat > ~/.config/opencode/opencode.json <<'EOF'
{
  "$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"
}
EOF

配置说明：

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

4. 启动并验证

第一步：进入你的项目目录

cd /path/to/your/project

把 /path/to/your/project 替换成你实际的项目路径。

第二步：启动 OpenCode

opencode

如果配置正确，OpenCode 会启动并连接到词元AI。