Windows 安装 OpenCode 教程

← 返回首页

📦 所需资源下载

🟢

Node.js

JavaScript 运行时环境

前往下载

🔴

Git for Windows/x64

版本控制工具

前往下载

⬛

Windows Terminal

现代化终端工具

百度网盘

🔵

CC.Switch

API 配置切换工具

百度网盘

安装 Node.js

点击上方下载 Node.js 的 "Windows 安装程序 (.msi)"，双击运行，全程默认下一步安装即可。

安装 Git for Windows

点击上方下载 "Git for Windows/x64 Setup"，双击运行，全程默认下一步安装即可。

安装 Windows Terminal

下载上方的 WindowsTerminal.zip，保存到 D 盘后解压缩，进入目录，选中 WindowsTerminal 右键 → 发送到桌面快捷方式。

💡 以下所有命令都在 Windows Terminal 界面中执行。

设置执行策略

双击打开桌面上的 Windows Terminal，复制以下命令粘贴并按回车：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

合并系统环境变量

在 Windows Terminal 中，复制以下命令粘贴并按回车：

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

验证环境安装

依次执行以下命令，安装成功会显示版本号：

      
      node -v

      npm -v

      git --version

设置国内镜像源

加速 npm 包下载：

npm config set registry https://registry.npmmirror.com

确认是否设置成功：

npm config get registry

全局安装 OpenCode

npm install -g opencode-ai

验证安装

opencode --version

配置 CC.Switch

安装并打开上方下载的 CC.Switch，按以下步骤操作：

① 选择第五个 OpenCode 图标

② 选中并启用 "One API"

③ 点击 "使用中" 右边的 "编辑" 按钮

④ 粘贴从 One API 网站获取的 API Key

⑤ 展开 "高级选项"，在 "模型映射" 中输入 One API 支持的模型

⑥ 点击保存

💡 建议优先设置 Claude、GPT 模型，兼容性比较好。

启动 OpenCode

在终端输入以下命令启动：

opencode

开始使用

进入 OpenCode 界面后，即可让它帮你安装插件、编写代码。试试输入：

      "请帮我在 D 盘创建一个 Test 目录，然后写一个首页介绍如何使用 OpenCode？"
    

更新 OpenCode

可每天执行一次更新：

npm update -g opencode-ai

更新成功后正常启动：

opencode

故障排除

如报错，可重新下载 Node.js、Git for Windows、Windows Terminal、CC.Switch，然后执行：

      
      # 1. 清除现有的安装

      npm uninstall -g opencode-ai

      # 2. 清除 npm 缓存

      npm cache clean --force

      # 3. 重新安装

      npm install -g opencode-ai

⚠️ 提示：安装完一个智能体后，你就可以让它教你怎么安装其它智能体了。也可以在 VS Code 扩展中搜索 Cline 或 Claude Code 插件安装。