OpenCode & Oh-My-OpenCode：把 AI 变成可交付的工程队友

很多新手用 AI 写代码时，总觉得"它能写，但写完后一跑就崩"。原因不是模型不够聪明，而是缺少工程化的闭环：不知道该读哪些文件、怎么验证、怎么遵守项目规范、需求模糊时怎么决策。

OpenCode + Oh-My-OpenCode（OMO） 正好解决这个问题。它把"聊天式 AI"变成可验证、可回滚、可交付的真实队友。即使你是编程新手，也能快速上手，逐步学会"让 AI 像高级工程师一样工作"。

1. 什么是 OpenCode？

OpenCode 是一个 100% 开源 的 AI 编码代理（官网），它像一个"住在你项目里的 AI 助手"，支持：

终端（TUI）：最常用，命令行里直接聊天
桌面 App（Beta）：macOS / Windows / Linux 都有图形界面
IDE 插件：VS Code 等主流编辑器也能无缝使用

特性	说明
自动加载 LSP	拥有代码智能提示、跳转、引用查找等人类开发者才有的能力
支持 75+ 模型	包括 Claude 3.7、GPT-4o、Gemini 2.5、本地模型以及免费的 Zen 模型
内置工具集	读文件、改文件、跑命令、搜索代码、调用 LSP、联网查资料
计划模式	先画蓝图再动手，避免 AI 无脑乱改
撤销/重做	随时回滚，救命神器
严格权限控制	可以要求每次修改/命令都弹窗确认

2. 什么是 Oh-My-OpenCode（OMO）？

如果 OpenCode 是"能干活的执行体"，那 Oh-My-OpenCode（OMO） 就是一套让 AI 像高级工程师一样思考的流程规范（类似于 oh-my-zsh 给终端带来的配置层增强）。

核心理念只有一句话：先探索、再拆解、必须验证、随时可回滚。

它通过预设的模板、系统提示词和自动化脚本，将最佳实践固化下来。你只要跟着 OMO 的纪律走，就能大幅降低"AI 乱改代码"的风险。

OMO 核心功能一览

命令	作用
`ultrawork` / `ulw`	一键激活所有 agent，自动完成任务，不写完不停
`IntentGate`	分析用户真实意图再行动，杜绝字面理解错误
`Ralph Loop` / `/ulw-loop`	自引用循环，不完成 100% 就不停止
`Todo Enforcer`	agent 闲置时系统自动拉回来
`/init-deep`	自动生成多层级 `AGENTS.md` 文件

四大 Discipline Agent

Sisyphus（主协调者）：规划、委托、推动任务完成，强制并行执行，不半途而废
Hephaestus（深度工作者）：自主探索代码库、研究模式、端到端执行
Prometheus（战略规划者）：面试模式，先问清楚再动手
Librarian（上下文管理）：维护上下文清洁，避免 token 爆炸

3. 新手 5 分钟上手指南

步骤 1：安装 OpenCode 本体

# 最推荐（所有系统通用，一键安装）
curl -fsSL https://opencode.ai/install | bash

# 其他方式（根据你的习惯任选）
brew install anomalyco/tap/opencode    # macOS
npm install -g opencode-ai              # Node.js 环境通用
choco install opencode                  # Windows Chocolatey
scoop install opencode                  # Windows Scoop

喜欢图形界面？直接去 opencode.ai/download 下载桌面版 Beta。

步骤 2：安装 Oh-My-OpenCode

安装完本体后，复制下面这段话粘贴给任意 LLM Agent（Claude Code、OpenCode 等），让它帮你完成 OMO 安装：

Install and configure oh-my-opencode by following the instructions here:
https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

或者手动运行安装命令：

# 获取 OMO 安装指南
curl -s https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md

安装完成后，在 OpenCode 里输入 ultrawork（或 ulw）即可激活 OMO 的全套 agent 编排系统。

步骤 3：配置模型

终端运行 opencode 进入界面
输入 /connect → 选择 opencode
浏览器打开 opencode.ai/auth，登录获取 API Key 并粘贴回终端

推荐新手先用 OpenCode Zen（精选免费/低价模型）。不想花钱也可以用本地模型 Ollama，或绑定现有的 GitHub Copilot / ChatGPT Plus 账号。

步骤 4：进入项目并初始化

cd 你的项目文件夹
opencode          # 启动 AI 代理
/init             # 初始化项目，生成 AGENTS.md 规范文件
ultrawork         # 激活 OMO 工程模式（可选，推荐使用）

4. 新手最稳工作流

安装了 OMO 的 OpenCode，按以下 5 步走，几乎不会踩坑：

1）Intent Gate（先确认任务类型）

简单任务：直接说需求
需要了解现状：先让它"探索"
大任务：先切换到计划模式（按 Tab 键）

2）先探索，再动手

示例输入：

"先搜索项目里所有处理用户登录的地方，然后告诉我入口文件是哪几个。"

AI 会自动调用 grep、read、LSP 工具帮你精准定位。

3）拆成小 Todo + 每步验证

AI 会自动创建任务清单，随时输入 /todo 查看进度。

4）只做用户要的

示例输入：

"只修复这个 bug，绝对不要顺手重构其他文件。"

5）验证是"完成"的最后一步

让 AI 跑这几步，全部通过才算结束：

LSP 类型检查 → lint/format → npm test → npm run build

撤销神器：如果发现改坏了，随时输入 /undo 就能回滚所有修改（新手救命必备）。

5. 新手常见坑 + 避坑技巧

Token 花太多、账单爆炸？

👉 告诉它"只读这几个文件"，或者"先用 grep 缩小范围再阅读完整代码"。

安全与越权问题？

👉 在项目根目录创建 opencode.json，设置严格的权限确认机制：

{
  "edit": "ask",  // 改文件前必须弹窗问我
  "bash": "ask"   // 跑任何命令前必须弹窗问我
}

需求描述模糊？

👉 开启了 OMO 规范后，AI 不会瞎编，而是会主动用 question 工具反向问你细节（超级贴心）。

6. 推荐：新手的第一个练习任务

准备好环境后，进入你的任意测试项目，对 OpenCode 输入以下这段话：

"用计划模式帮我加一个简单的用户注册功能。请先画出完整步骤计划，如果需求有不清晰的地方先问我细节。确认无误后，再分步骤实现并运行测试。"

跟着它的计划一步步走，你会亲眼见证 AI 是如何"像高级工程师一样思考和工作"的。

7. 更多进阶资源

资源	链接
官网 + 下载	opencode.ai
中文文档	opencode.ai/docs/zh-cn
GitHub（开源仓库）	github.com/anomalyco/opencode
OMO GitHub	github.com/code-yeongyu/oh-my-openagent
桌面版下载	opencode.ai/download

更新日志（2026 年 3 月）：v1.2.27 已优化桌面多窗口、权限通知、模型兼容性。

结语

OpenCode 不是为了让你"懒得写代码"，而是让你学会如何指挥 AI。跟着 Oh-My-OpenCode 这套工程纪律走，你会发现：AI 不再是"偶尔靠谱、经常发神经的朋友"，而是真正能交付的生产力队友。

现在就去试试吧 👉 curl -fsSL https://opencode.ai/install | bash

欢迎来到 2026 年的 AI 编程新时代！