资讯详情

AI 扫盲系列第 3 篇：认识并安装 OpenCode——跑在你电脑上的 AI 助手

阅读时长：约 12 分钟。
上一篇我们定下路线：本地工具 + 云端模型。这篇就把"本地工具"装进你电脑里，它就是 OpenCode。

---

一、OpenCode 是什么？为什么选它？

一句话介绍：

OpenCode 是一个免费、开源、运行在你电脑上的 AI 助手程序。
你可以在里面和 AI 对话，更重要的是——它能直接读写你电脑上的文件，替你干活。

它和网页聊天框的最大区别，用一张图说明：

网页聊天框：  你  →  复制粘贴内容  →  网页 AI
OpenCode：   你  →  直接告诉它文件在哪  →  它自己读文件 → 帮你改好

为什么偏偏是它？

优点	说明
完全免费	工具本体一分钱不花，只花模型的钱（DeepSeek 几乎免费）
开源安全	代码全世界公开，没有隐私猫腻
可视化界面	不要求你会敲命令，鼠标点一点就能用
能干活	能读文件、改文件、生成文档，真正的"本地助手"
长期可玩	学会它，就等于拿到了一把万能钥匙

它长什么样？（可视化界面讲解）

打开 OpenCode 后，你会看到一个分为几块的界面（建议对照你的实际截图看）：

• 对话区（中间最大）：你和 AI 聊天的主要区域，它的话、你的指令都在这里。
• 输入框（底部）：打字的地方，输入 / 还能呼出指令菜单（第 6 篇细讲）。
• 状态/会话列表（侧边栏）：显示当前用的模型、可以新建/切换会话。

别怕界面"看着像程序"——它本质就是个聊天窗口，只是多了几个按钮。你只要会用输入框打字，就已经会一半了。

---

二、安装前，你需要准备什么？

只有一样东西：一台 Windows 电脑（Win10 / Win11 均可）。

不需要会编程，不需要装复杂的软件环境。下面两种方式，推荐第二种，最省事。

---

三、安装方式一：用官方安装包（推荐新手）

1. 打开 OpenCode 官网，找到下载页面。
2. 选择 Windows 版本 的安装包下载。
3. 双击下载好的文件，按提示"下一步 → 下一步 → 完成"即可。
4. 安装完成后，在开始菜单搜索"OpenCode"，点击打开。

如果你在官网没找到 Windows 安装包，或者下载页面看不懂，直接跳到方式二。

---

四、安装方式二：用 Node.js 安装（进阶，备用）

这种方式多一步，但更通用。全程只需要复制粘贴命令，不需要懂原理。

1. 安装 Node.js

   • 打开 Node.js 官网下载页，下载 Windows 安装包（LTS 版本）。
   • 双击安装，一路"下一步"，直到完成。
   • 检验是否成功：打开任意命令窗口，输入 node -v，能显示版本号就成功了。

2. 安装 OpenCode

   • 在命令窗口里粘贴这行命令并回车：

     npm install -g opencode
     

   • 等它跑完，出现版本信息就说明装好了。

3. 启动 OpenCode

   • 在命令窗口输入 opencode 回车，或直接双击桌面生成的图标。
   • 看到界面弹出，恭喜，安装完成！

小技巧：如果在命令窗口里用 opencode 打开，关掉窗口 AI 就退出了；想"随时待命"，用桌面图标方式打开更顺手。

---

五、第一次打开：走一遍初始引导

1. 打开后，它会问你要不要初始化一个文件夹（工作区）——建议新建一个文件夹，比如 C:\AI学习，专门放 AI 帮你做的文件。
2. 它可能提示"还没有配置模型"——别慌，这是正常的，下一篇我们就去接上 DeepSeek。
3. 你可以在输入框里随便打一句"你好"，看它能不能回复。这一步不成功也没关系，等第 4 篇配好模型就通了。

记住一个概念：工作区文件夹就是 AI 的"办公室"。你让它读文件、改文件，它都只在这个文件夹里活动，这样不会弄乱你别的资料。

---

六、常见问题排查表（遇到再说）

问题	原因	解决办法
安装时提示"权限不足"	没以管理员身份运行	右键安装包 → 以管理员身份运行
命令 node -v 没反应	Node.js 没装好	重新安装 Node.js，勾选自动加环境变量
npm install 报错超时	网络问题	换网络重试，或等会再试
打开后界面是黑屏/空白	显示问题	更新显卡驱动，或重启电脑重试
想卸载重装	—	控制面板 → 程序卸载 → 找到 OpenCode 卸载
提示没有模型可用	这是"正常"的	别管它，完成第 4 篇配置即可解决

---

七、本篇小结

• OpenCode = 免费开源、能读写你电脑文件的本地 AI 助手。
• 新手装它只需要：下载安装包 → 双击下一步 → 打开。全程不需要编程。
• 界面就是"聊天窗口 + 几个按钮"，会打字就会用。
• 第一次打开没配模型，完全正常，下一篇就去接上。

下一篇预告：《接上模型——获取 API 密钥并完成配置》，带你把 DeepSeek 这"台发动机"接进 OpenCode，让它真正开口说话。

---