OpenCode 配置教程 - 极速安装指南

快速生成配置命令

输入你的 API Key，下面的教程命令将自动更新，可直接复制使用。

你的 API KEY (sk-...)

安装 Node.js 环境

OpenCode 需要 Node.js 环境才能运行。建议安装 LTS (长期支持) 版本。

官网下载（推荐）

1. 访问 nodejs.org
2. 点击 "LTS" 版本进行下载
3. 运行 .msi 文件按默认引导安装

命令行安装

# 使用 Scoop

scoop install nodejs

# 或使用 Choco

choco install nodejs

Windows 注意事项

建议使用 PowerShell 而不是 CMD
如果遇到权限问题，尝试以管理员身份运行
某些杀毒软件可能会误报，需要添加白名单

验证安装是否成功

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

# 检查 Node.js 版本

node --version

# 检查 npm 版本

npm --version

如果显示版本号，说明安装成功了！

安装 OpenCode

打开 PowerShell 或 CMD，运行以下命令：

# 全局安装 OpenCode

npm i -g opencode-ai

# 国内镜像（下载慢可用）

npm i -g opencode-ai --registry=https://registry.npmmirror.com

这个命令会从 npm 官方仓库下载并安装最新版本的 OpenCode。

提示

建议使用 PowerShell 而不是 CMD，功能更强大
如果遇到权限问题，以管理员身份运行 PowerShell

验证 OpenCode 安装

安装完成后，输入以下命令检查是否安装成功：

opencode --version

如果显示版本号，恭喜你！OpenCode 已经成功安装了。

修改配置文件

编辑 C:/用户/<用户名>/.config/opencode/opencode.json 文件。

如果没有上述文件夹或文件，需要手动创建它们。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "qmcode": {
      "options": {
        "baseURL": "https://ai.wdcodex.xyz/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      },
      "models": {
        "gpt-5.2": { "name": "gpt-5.2" },
        "gpt-5.2-codex": { "name": "gpt-5.2-codex" },
        "gpt-5.3-codex": { "name": "gpt-5.3-codex" }
      }
    }
  }
}

开始使用

现在你可以开始使用 OpenCode 了！

启动 OpenCode

opencode

# 输入 /model 选择模型

/model

# 选择 qmcode 分组里的模型

在特定项目中使用

# 进入你的项目目录

cd C:\path\to\your\project

# 启动 OpenCode

opencode

# 输入 /model 选择模型

/model

# 选择 qmcode 分组里的模型

如需在 VSCode 中使用 OpenCode，上述步骤完成后，再在扩展中安装 OpenCode 插件即可。（上面的步骤不能跳过）

安装 Node.js 环境

# 使用 Homebrew 安装

brew install node

或者访问 nodejs.org 下载 .pkg 安装包。

验证安装是否成功

安装完成后，打开 Terminal，输入以下命令：

# 检查 Node.js 版本

node --version

# 检查 npm 版本

npm --version

如果显示版本号，说明安装成功了！

安装 OpenCode

打开终端，运行以下命令：

# 使用 sudo 全局安装

sudo npm i -g opencode-ai

# 国内镜像（下载慢可用）

sudo npm i -g opencode-ai --registry=https://registry.npmmirror.com

在 macOS 上，全局安装通常需要管理员权限（sudo）。

提示

如果提示 Enter password，请输入你的 Mac 登录密码（输入时不会显示字符）
建议在安装完成后运行验证命令确保路径已生效

验证 OpenCode 安装

安装完成后，输入以下命令检查是否安装成功：

opencode --version

如果显示版本号，恭喜你！OpenCode 已经成功安装了。

修改配置文件

编辑 ~/.config/opencode/opencode.json 文件。

如果没有上述文件夹或文件，需要手动创建它们。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "qmcode": {
      "options": {
        "baseURL": "https://ai.wdcodex.xyz/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      },
      "models": {
        "gpt-5.2": { "name": "gpt-5.2" },
        "gpt-5.2-codex": { "name": "gpt-5.2-codex" },
        "gpt-5.3-codex": { "name": "gpt-5.3-codex" }
      }
    }
  }
}

开始使用

现在你可以开始使用 OpenCode 了！

启动 OpenCode

opencode

# 输入 /model 选择模型

/model

# 选择 qmcode 分组里的模型

在特定项目中使用

# 进入你的项目目录

cd /path/to/your/project

# 启动 OpenCode

opencode

# 输入 /model 选择模型

/model

# 选择 qmcode 分组里的模型

如需在 VSCode 中使用 OpenCode，上述步骤完成后，再在扩展中安装 OpenCode 插件即可。（上面的步骤不能跳过）

安装 Node.js

# Ubuntu/Debian

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

验证安装是否成功

安装完成后，打开终端，输入以下命令：

# 检查 Node.js 版本

node --version

# 检查 npm 版本

npm --version

如果显示版本号，说明安装成功了！

安装 OpenCode

在终端中运行以下命令：

# 全局安装 OpenCode

sudo npm i -g opencode-ai

# 国内镜像（下载慢可用）

sudo npm i -g opencode-ai --registry=https://registry.npmmirror.com

Linux 系统通常需要 sudo 权限来安装全局 npm 包。

提示

如果不想使用 sudo，建议配置 npm 全局目录到用户目录下
WSL2 用户请确保 Node.js 环境已在子系统中正确安装

验证 OpenCode 安装

安装完成后，输入以下命令检查是否安装成功：

opencode --version

如果显示版本号，恭喜你！OpenCode 已经成功安装了。

修改配置文件

编辑 ~/.config/opencode/opencode.json 文件。

如果没有上述文件夹或文件，需要手动创建它们。

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "qmcode": {
      "options": {
        "baseURL": "https://ai.wdcodex.xyz/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      },
      "models": {
        "gpt-5.2": { "name": "gpt-5.2" },
        "gpt-5.2-codex": { "name": "gpt-5.2-codex" },
        "gpt-5.3-codex": { "name": "gpt-5.3-codex" }
      }
    }
  }
}

开始使用

现在你可以开始使用 OpenCode 了！

启动 OpenCode

opencode

# 输入 /model 选择模型

/model

# 选择 qmcode 分组里的模型

在特定项目中使用

# 进入你的项目目录

cd /path/to/your/project

# 启动 OpenCode

opencode

# 输入 /model 选择模型

/model

# 选择 qmcode 分组里的模型

如需在 VSCode 中使用 OpenCode，上述步骤完成后，再在扩展中安装 OpenCode 插件即可。（上面的步骤不能跳过）

🎉 恭喜你！安装配置完成后，即可享受 AI 编程助手带来的便利。