⚡ OpenCode 安装教程
Windows 安装 OpenCode
从零开始，在 Windows 系统上安装并配置 OpenCode 智能编程助手
📦 所需资源下载
1
安装 Node.js
点击上方下载 Node.js 的 "Windows 安装程序 (.msi)"，双击运行，全程默认下一步安装即可。
2
安装 Git for Windows
点击上方下载 "Git for Windows/x64 Setup"，双击运行，全程默认下一步安装即可。
3
安装 Windows Terminal
下载上方的 WindowsTerminal.zip，保存到 D 盘后解压缩，进入terminal目录，选中 WindowsTerminal 右键 → 发送到桌面快捷方式。
💡 以下所有命令都在 Windows Terminal 界面中执行。
4
设置执行策略
双击打开桌面上的 Windows Terminal，复制以下命令粘贴并按回车：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
5
合并系统环境变量
在 Windows Terminal 中，复制以下命令粘贴并按回车：
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
6
验证环境安装
依次执行以下命令，安装成功会显示版本号：
node -v
npm -v
git --version
npm -v
git --version
7
设置国内镜像源
加速 npm 包下载：
npm config set registry https://registry.npmmirror.com
确认是否设置成功：
npm config get registry
8
全局安装 OpenCode
npm install -g opencode-ai
9
验证安装
opencode --version
10
配置 CC.Switch
安装并打开上方下载的 CC.Switch，按以下步骤操作：
① 选择第五个 OpenCode 图标
② 选中并启用 "One API"
③ 点击 "使用中" 右边的 "编辑" 按钮
④ 粘贴从 One API 网站获取的 API Key
⑤ 展开 "高级选项"，在 "模型映射" 中输入 One API 支持的模型
⑥ 点击 保存
💡 建议优先设置Claude、GPT模型，兼容性比较好。
11
启动 OpenCode
在终端输入以下命令启动：
opencode
12
开始使用
进入 OpenCode 界面后，即可让它帮你安装插件、编写代码。试试输入：
"请帮我在 D 盘创建一个 Test 目录，然后写一个首页介绍如何使用 OpenCode？"
13
更新 OpenCode
可每天执行一次更新：
npm update -g opencode-ai
更新成功后正常启动：
opencode
14
故障排除
如报错或者需要更新版本，可重新下载 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
npm uninstall -g opencode-ai
# 2. 清除 npm 缓存
npm cache clean --force
# 3. 重新安装
npm install -g opencode-ai
⚠️ 提示：安装完一个智能体后，你就可以让它教你怎么安装其它智能体了。也可以在 VS Code 扩展中搜索 Cline 或 Claude Code 插件安装。