用 AI “写代码帮手”OpenCode：从装到用的全流程体验与实战感悟

听说过 OpenCode 吗？它其实就是一位可以在终端里陪你写代码的 AI 小伙伴。把它想象成一位全能的“码农助理”，不需要在 VS Code 里装插件，只要打开命令行，像聊天一样跟它对话，它就能帮你阅读代码、生成新功能、甚至修复 Bug。下面这篇长文，像和朋友喝茶一样，慢慢拆解它的安装、配置、日常使用，还有一些真实的小案例，帮助大家把这位“代码管家”请进自己的工作流。

一、为什么会被 OpenCode 吸引

很多人用 ChatGPT、Claude 这类聊天模型，偶尔会让它帮忙写几行代码。但每次都要复制粘贴、手动打开文件，感觉像在用遥控器操纵老式电视。

OpenCode 把这一步省掉了：它直接跑在终端里，能够读取项目结构、打开文件、执行 git 命令，甚至可以在编辑器里实时写入代码。把它比作厨房里的万能料理机：把原材料（代码库）倒进去，按下按钮，它就会帮你切、剁、调味，最后端上成品。

二、安装全攻略（以 Windows 为例）

在官方文档里，最推荐的方式是一键 curl 脚本。但这玩意儿是给 Linux/macOS 写的，Windows 上直接跑会卡死，甚至把路径写进 .bashrc，根本不识别。

经过几位社区大佬的踩坑经验，最靠谱的办法是使用 Chocolatey 包管理器：

• 打开 PowerShell，确保以管理员身份运行。
• 先检查 Chocolatey 是否已经装好：choco --version，若没有则执行官方安装脚本。
• 执行 choco install opencode。
• 安装完毕后，直接敲 opencode --version，看到类似 1.1.19 的输出，即表示成功。

为什么 Chocolatey 能顺利？因为它会自动把可执行文件的路径写进系统环境变量，并且在后台完成解压、哈希校验，省去了手动配置 PATH 的麻烦。记得在网络不太拥堵的时段（比如清晨），不然下载时会卡在 GitHub 访问上。

三、第一次启动：从“新手绊脚石”到“熟练操作”

首次运行 opencode，会弹出一个带有“/models”指令的 TUI 界面。

1️⃣ 模型选择：列表里会标注 Free 的免费模型（如 MiniMax M2.1、GLM-4.7），直接回车选它们，立刻可以使用，根本不需要 API Key。

2️⃣ 登录选项：如果以后想调通 OpenAI、Claude 等商业模型，可以在这里先跳过，稍后再用 /connect 命令补上 API Key。

3️⃣ 模式切换：打开后按 Tab 键可以在 Build（全权限）和 Plan（只读）之间切换。Plan 模式相当于先给 AI 看图纸，让它先规划再动手，安全感十足。

四、核心指令速查表（简化版）

• /init 初始化项目，自动生成 .opencode/ 索引和 AGENTS.md。
• /models 查看并切换模型。
• /connect 绑定外部模型的 API Key。
• /undo / /redo Git 项目里可以回滚、恢复变更。
• /share 一键生成会话链接，和同事共享思路。
• /compact 把会话压缩成摘要，适合做会议纪要。

所有指令都以斜杠开头，直接输入后回车即可生效，省得去翻文档。

五、日常使用案例（从零到可运行的项目）

案例一：快速搭建一个登录页面

假设你在一个空文件夹里，想要一个最基础的 HTML 登录页面，只需要：

/init
在当前目录创建一个登录页面

AI 会先分析目录结构，随后在几秒钟内生成 index.html，文件里已经带有表单、简单的 CSS 样式，甚至还能自动写好 login.js 响应提交。

如果你担心 AI 直接改文件，可以先把模式切到 Plan，等它给出实现思路后，再切回 Build 执行。

案例二：为 Node.js 项目添加 /hello 路由

1️⃣ 在项目根目录启动 OpenCode：opencode，然后 /init。

2️⃣ 输入需求：

创建一个 Express.js 服务，支持 /hello 路由返回 JSON { "message": "Hello World" }，并添加 README。

AI 会自动生成 app.js、package.json（如果不存在）以及 README.md，并在控制台提示你运行 npm install。

随后你只需要 node app.js，浏览器打开 http://localhost:3000/hello，就能看到返回的 JSON。

案例三：修复一个 Bug —— “登录函数无限循环”

在项目中发现 login() 函数总是卡住，于是打开 OpenCode，直接问：

解释 src/auth.js 中的 login 函数为什么会无限循环？

AI 会读取对应文件，指出循环条件永远为真，然后给出修复建议。接着你可以让它直接在文件里打补丁：

/patch src/auth.js
--- a/src/auth.js
+++ b/src/auth.js
@@
-while(true){ ... }
+while(!condition){ ... }

整个过程不到十秒，省了去代码审查、手动调试的时间。

六、进阶功能：oh‑my‑opencode 插件套装

如果你已经玩转了基本指令，想要更强大的多智能体协作，那可以考虑安装 oh‑my‑opencode。它相当于把单兵作战的 AI 升级为一支“特种部队”，包括：

• Sisyphus 主智能体——负责把复杂任务拆解成子任务，直到完成。
• Frontend Engineer、Backend Engineer、Oracle 等子智能体，各司其职。
• 支持 ulw 或 ultrawork 关键字，一键触发全自动模式。

安装方法也很简单，只要有 bun（或 Node.js）环境，运行：

bunx oh-my-opencode install --no-tui --claude=yes --chatgpt=yes --gemini=yes

装好后，你可以在对话里直接输入：

ulw 实现一个支持分页的商品列表页面，后端用 Prisma，前端用 React。

AI 团队会自动分配子任务：一个写后端模型，一个写前端组件，最后合并提交。虽然有时候会出现小毛病（比如路径写错），但整体效率提升明显。

七、常见坑与解决方案

1. 路径找不到：Windows 上如果使用 PowerShell，需要确保 opencode.exe 所在目录已经加入 PATH。重新打开终端或执行 $env:Path += ";C:\ProgramData\chocolatey\bin" 即可。
2. 模型响应慢：免费模型的响应时间大约在 5‑15 秒，偶尔会超时。可以先切到更快的模型（如 MiniMax），或者在网络好的时段使用。
3. 文件冲突：如果项目不是 Git 仓库，/undo、/redo 无法回滚。建议在使用 OpenCode 前先 git init 并提交一次基线。
4. 安全顾虑：Build 模式拥有编辑权限，建议在陌生项目里先用 Plan 模式确认计划，再切换。

八、个人小感悟

把 OpenCode 当作“代码的聊天伙伴”，再也不用在 IDE 里不停切窗口找文档。它把“思考”“写代码”“运行”三件事合在一起，让我像跟朋友一起敲代码一样轻松。尤其是处理重复性任务（比如生成增删改查接口、写 README），只要一句自然语言指令，AI 就能给出成品。

当然，它并不是万能的，如果你的业务逻辑特别复杂，还是需要自己把关键算法写好，再让它帮忙做边缘代码或格式化。

总的来说，OpenCode 把 AI 由“聊天工具”提升到了“真正的开发助手”。只要按照上述步骤装好、熟悉几条常用指令，任何人都可以把它当成自己的“代码副手”，省下大量的机械劳动，去思考更有价值的业务。

九、结语

如果你还在为手动敲代码、找文档、切换编辑器而烦恼，建议点开终端试试 OpenCode。先从免费模型开始，感受它的“写代码速度”。等到熟练后，可以再把 oh‑my‑opencode 加上，让 AI 团队帮你完成更大块的功能。让 AI 成为日常开发的“隐形同事”，不再是遥不可及的科技概念，而是实实在在的生产力提升。