AI 扫盲系列第 3 篇：认识并安装 OpenCode——跑在你电脑上的 AI 助手
阅读时长：约 12 分钟。
上一篇我们定下路线：本地工具 + 云端模型。这篇就把"本地工具"装进你电脑里，它就是 OpenCode。
一、OpenCode 是什么？为什么选它？
一句话介绍：
OpenCode 是一个免费、开源、运行在你电脑上的 AI 助手程序。
你可以在里面和 AI 对话，更重要的是——它能直接读写你电脑上的文件，替你干活。
它和网页聊天框的最大区别，用一张图说明：
网页聊天框： 你 → 复制粘贴内容 → 网页 AI
OpenCode： 你 → 直接告诉它文件在哪 → 它自己读文件 → 帮你改好
为什么偏偏是它？
| 优点 | 说明 |
|---|---|
| 完全免费 | 工具本体一分钱不花，只花模型的钱（DeepSeek 几乎免费） |
| 开源安全 | 代码全世界公开，没有隐私猫腻 |
| 可视化界面 | 不要求你会敲命令，鼠标点一点就能用 |
| 能干活 | 能读文件、改文件、生成文档，真正的"本地助手" |
| 长期可玩 | 学会它，就等于拿到了一把万能钥匙 |
它长什么样？（可视化界面讲解）
打开 OpenCode 后，你会看到一个分为几块的界面（建议对照你的实际截图看）：
- 对话区（中间最大）：你和 AI 聊天的主要区域，它的话、你的指令都在这里。
- 输入框（底部）：打字的地方，输入
/还能呼出指令菜单（第 6 篇细讲）。 - 状态/会话列表（侧边栏）：显示当前用的模型、可以新建/切换会话。
别怕界面"看着像程序"——它本质就是个聊天窗口，只是多了几个按钮。你只要会用输入框打字，就已经会一半了。
二、安装前，你需要准备什么？
只有一样东西：一台 Windows 电脑（Win10 / Win11 均可）。
不需要会编程，不需要装复杂的软件环境。下面两种方式，推荐第二种，最省事。
三、安装方式一：用官方安装包（推荐新手）
- 打开 OpenCode 官网，找到下载页面。
- 选择 Windows 版本 的安装包下载。
- 双击下载好的文件，按提示"下一步 → 下一步 → 完成"即可。
- 安装完成后，在开始菜单搜索"OpenCode"，点击打开。
如果你在官网没找到 Windows 安装包，或者下载页面看不懂，直接跳到方式二。
四、安装方式二：用 Node.js 安装（进阶，备用）
这种方式多一步，但更通用。全程只需要复制粘贴命令，不需要懂原理。
-
安装 Node.js
- 打开 Node.js 官网下载页，下载 Windows 安装包（LTS 版本）。
- 双击安装，一路"下一步"，直到完成。
- 检验是否成功：打开任意命令窗口，输入
node -v，能显示版本号就成功了。
-
安装 OpenCode
- 在命令窗口里粘贴这行命令并回车：
npm install -g opencode - 等它跑完，出现版本信息就说明装好了。
- 在命令窗口里粘贴这行命令并回车：
-
启动 OpenCode
- 在命令窗口输入
opencode回车，或直接双击桌面生成的图标。 - 看到界面弹出，恭喜，安装完成！
- 在命令窗口输入
小技巧：如果在命令窗口里用
opencode打开，关掉窗口 AI 就退出了；想"随时待命"，用桌面图标方式打开更顺手。
五、第一次打开：走一遍初始引导
- 打开后，它会问你要不要初始化一个文件夹（工作区）——建议新建一个文件夹，比如
C:\AI学习，专门放 AI 帮你做的文件。 - 它可能提示"还没有配置模型"——别慌，这是正常的，下一篇我们就去接上 DeepSeek。
- 你可以在输入框里随便打一句"你好"，看它能不能回复。这一步不成功也没关系，等第 4 篇配好模型就通了。
记住一个概念：工作区文件夹就是 AI 的"办公室"。你让它读文件、改文件，它都只在这个文件夹里活动，这样不会弄乱你别的资料。
六、常见问题排查表（遇到再说）
| 问题 | 原因 | 解决办法 |
|---|---|---|
| 安装时提示"权限不足" | 没以管理员身份运行 | 右键安装包 → 以管理员身份运行 |
命令 node -v 没反应 |
Node.js 没装好 | 重新安装 Node.js，勾选自动加环境变量 |
npm install 报错超时 |
网络问题 | 换网络重试，或等会再试 |
| 打开后界面是黑屏/空白 | 显示问题 | 更新显卡驱动，或重启电脑重试 |
| 想卸载重装 | — | 控制面板 → 程序卸载 → 找到 OpenCode 卸载 |
| 提示没有模型可用 | 这是"正常"的 | 别管它，完成第 4 篇配置即可解决 |
七、本篇小结
- OpenCode = 免费开源、能读写你电脑文件的本地 AI 助手。
- 新手装它只需要：下载安装包 → 双击下一步 → 打开。全程不需要编程。
- 界面就是"聊天窗口 + 几个按钮"，会打字就会用。
- 第一次打开没配模型，完全正常，下一篇就去接上。
下一篇预告：《接上模型——获取 API 密钥并完成配置》，带你把 DeepSeek 这"台发动机"接进 OpenCode，让它真正开口说话。