OpenCode 安装指南：Windows 双击 EXE，macOS 一行命令
你需要准备什么
两样东西：
- 一台电脑（Windows 10/11 或 macOS 12+）
- 一个 DeepSeek API Key → 获取方法看这里（注册充值 5 分钟搞定）
不需要编程基础。Windows 用户不需要懂命令行，macOS 用户需要会打开终端（文章里会教）。
如果你还没搞清楚 OpenCode 是什么、为什么要用它，先看这篇：OpenCode 是什么？为什么从 Claude Code 换到它？
Windows：双击 EXE，输 Key 搞定
我写了一个 EXE 安装包，右键管理员运行，输 API Key，完工。
第一步：下载安装包
下载完之后，把 skills/ 文件夹和 EXE 放在同一个目录下。Zip 包里已经放好了，解压就行。
第二步：以管理员身份运行
找到下载的 EXE，右键 → 以管理员身份运行。
为什么要管理员？因为安装过程需要装 Node.js 和全局 npm 包，普通权限做不到。装完就没事了。
如果 Windows Defender 弹警告，点「更多信息」→「仍要运行」。这不是病毒，是打包工具 ps2exe 导致的误报。360 的话点「允许运行」即可。
第三步：跟着提示走
运行后会弹出一个命令行窗口，自动完成 7 个步骤。下面拆开说清楚每一步在干什么。
第 1 步：Node.js 环境
安装器先检查你电脑有没有 Node.js。OpenCode 是基于 Node.js 的，没有装不了。如果检测不到，安装器会自动下载安装（优先 winget，不行走 npmmirror 镜像）。全程不需要你操作。
第 2 步：Python（可选）
问你要不要装 Python。不装也能用 OpenCode 写周报、整文件、做简历。只有处理 Excel 图表、WPS 文档生成时才用得上。不确定就选 n 跳过。
第 3 步：npm 镜像
自动把 npm 源切到 npmmirror.com（淘宝镜像），国内下载不卡。
第 4 步：安装 OpenCode
npm install -g opencode-ai，一到两分钟。装过了会检测到并问你要不要更新。
第 5 步：配置 API
选 DeepSeek（推荐），输入你的 API Key。输入时不显示字符，防止旁边人看到。输入完安装器会发一条测试请求验证 Key 能不能用，确认没问题才写进配置。
如果 Key 输错或者账户没钱了，安装器会报具体错误（401 是 Key 不对，403 是没权限，429 是请求太频繁），让你重输。
默认选的是 deepseek-v4-pro（主力）+ deepseek-v4-flash（轻量）。想用通义千问、硅基流动、OpenAI、本地 Ollama 也支持，安装器里可以自定义。
第 6 步：部署技能
安装器带了 5 个办公技能：
| 序号 | 技能 | 能帮你干什么 |
|---|---|---|
| 1 | 日常办公助手 | 写周报、邮件、会议纪要、工作总结 |
| 2 | 文件整理能手 | 批量重命名、分类整理、查重复文件、桌面清理 |
| 3 | 简历求职助手 | 写简历（STAR 法则）、求职信、模拟面试 |
| 4 | 学习规划助手 | 制定学习计划、整理笔记、生成复习提纲 |
| 5 | 表格数据处理 | Excel/CSV 汇总统计、生成图表、数据清洗 |
| 6 | 全部部署 | 五个一起上 |
| 7 | 不部署 | 先不要，以后想加再加 |
我推荐选 6（全部部署），反正不占地方。
选了之后安装器把对应技能拷到配置目录。启动 OpenCode 后 AI 会自动加载，你不用说"请帮我写一份 STAR 法则的简历"，说"帮我写份简历"就行。
第 7 步：完成
全部搞定后显示总结页面，列出常用命令，问你要不要直接启动 OpenCode。选 y 就帮你开新窗口启动。
第四步：验证安装
手动启动的话：按 Win + R，输入 cmd，回车。输入 opencode，看到欢迎界面就是装好了。
macOS：一行命令搞定
实话实说：这一节我没法实测。我没有 Mac 电脑，macOS 版本的脚本是按文档写的，理论上能跑。如果你遇到问题，欢迎在评论区反馈，我会尽量修。
macOS 的安装流程和 Windows 基本一样，区别在于没有 EXE：用终端跑一个脚本。
第一步：下载
下载 OpenCode安装器-macOS-v2.1.0.zip，解压后你会看到两个东西：
install.sh— 安装脚本skills/— 5 个办公技能
第二步：打开终端
在 Finder 里找到解压出来的文件夹。然后打开终端：
方法一：按 Command + 空格，输入"终端"（或"Terminal"），回车。
方法二：在 Finder 里打开文件夹，空白处右键 →「服务」→「在终端中打开」（如果没看到这个选项，用方法一）。
第三步：运行安装脚本
在终端里输入下面两行命令：
cd ~/Downloads/OpenCode安装器-macOS # 进入解压后的文件夹
chmod +x install.sh && ./install.sh # 给脚本执行权限，然后运行
第一行的路径改成你实际解压的位置。如果不确定，在 Finder 里把文件夹拖进终端窗口，路径会自动填上。
运行后会看到一个彩色界面，自动完成 7 个步骤：
第 1 步：Homebrew
macOS 安装软件需要通过 Homebrew（类似手机上的应用商店）。脚本会自动检查，没装的话帮你装。
第 2 步：Node.js 环境
通过 Homebrew 安装 Node.js。这个是运行 OpenCode 必须的。
第 3 步：Python（可选）
和 Windows 一样，问你要不要装。不装也不影响基本使用。
第 4 步：国内镜像
配置 npm 和 pip 镜像，国内下载不卡。
第 5 步：安装 OpenCode
npm install -g opencode-ai，一到两分钟。
第 6 步：配置 API
选 DeepSeek，输 API Key，自动验证。
第 7 步：部署技能
和 Windows 一样，选 6 全部部署。
第四步：验证安装
终端里输入 opencode，看到欢迎界面就是装好了。
常见小问题
Windows
双击 EXE 被拦截？
Windows Defender 点「更多信息」→「仍要运行」，360 点「允许运行」，浏览器阻止下载点「保留」。ps2exe 打包的 EXE 没有数字签名，杀毒软件不认识就报警。我之前 Claude Code 安装器几千人下载也没事。
CMD 里输入 opencode 提示找不到命令？
关掉当前窗口重新打开一个。还不行就重启电脑，环境变量没刷新。
macOS
提示"无法打开 install.sh，因为它来自身份不明的开发者"？
这是 macOS 的安全机制。打开「系统设置」→「隐私与安全性」，找到被拦截的记录，点「仍要打开」。或者终端里用 chmod +x install.sh && ./install.sh 就不会弹这个。
提示 command not found: brew？
Homebrew 没装上。手动装一下：打开 https://brew.sh，复制那行命令到终端运行，然后再跑 ./install.sh。
通用
npm 安装报错？
通常是网络问题。安装器已经自动切了国内镜像，但公司内网、校园网环境下可能需要手动设代理。后面单开一篇讲。
API Key 验证失败？
检查三件事：Key 有没有复制全（以 sk- 开头）、账户里有没有余额（DeepSeek 最低充 10 块）、网络能不能访问 api.deepseek.com。
跟 Claude Code 冲突吗？
不冲突。两台可以共存。claude 启动 Claude Code，opencode 启动 OpenCode。各用各的配置，互不干扰。
装好之后试试第一句话
启动 OpenCode，输入：
帮我创建一个叫"测试"的文件夹
OpenCode 会问你是否允许执行，输入 y 确认。然后去你的用户目录看看，多了一个"测试"文件夹，AI 帮你建的。
下期预告
装完了，然后呢？下期来一次实战：让 OpenCode 帮你整理桌面、批量改文件名、写一篇周报。
