OpenCode 喂饭教程(中):Plan/Build 双模式 + 5 个实战 + 命令速查
上篇我们把 OpenCode 装好了、DeepSeek 也接通了。但这只是把车开回家——真正上路还得会挂挡。OpenCode 的"挡位"就是 Plan 和 Build 两个模式,搞懂这俩,你才算真正会用这个工具。
这篇把双模式、五个实战、命令表、高级玩法一次性讲透。看完你就能拿它干 80% 的日常开发活。

核心模式:Plan 当架构师,Build 当工程师
OpenCode 和传统 IDE 最大的不同,就是引入了 Plan(规划)和 Build(构建)两种工作模式。这是它和 Cursor 那类"边看边改"工具的本质区别。
Plan 模式——按 Tab 切进来,OpenCode 变身"架构师"。它不会直接改代码,而是分析你的需求、阅读现有代码,给出一份详细的实施计划。适用场景:跨文件、逻辑复杂的任务,比如"给应用加用户登录""重构数据库模块"。你可以和它反复讨论计划直到满意。一个小技巧——Plan 模式下可以拖设计图或截图进去,让 AI 基于视觉稿出方案。
Build 模式——计划确认无误,再按一次 Tab(或在对话框确认),就进 Build。这时 OpenCode 变身"资深工程师",开始执行计划,直接在你的文件里写、改、删代码。它能自动创建新文件、跑终端命令(比如 npm install,需你授权)、看终端报错自动修复编译错误。改错了,/undo 一键回滚。
核心精髓一句话:先让 AI 出方案,再让 AI 写代码。这么干能避免直接编码导致的逻辑偏差,代码一次性通过率能提升 40% 以上。
实战 1:复杂功能先 Plan 再 Build
适合需要跨文件、多步骤的复杂功能开发,比如新增业务模块、开发新页面。
示例需求:实现用户删除笔记后标记为软删除,新增回收站页面支持恢复/永久删除。
第一步:切到 Plan 模式——按 Tab,确认右下角显示 Plan。
第二步:描述需求——终端里输入详细需求(把 AI 当初级开发者,越细越好):
当用户删除笔记时,在数据库中将该笔记标记为 deleted 状态(软删除,不真正删除);新增一个回收站页面,展示所有标记为 deleted 的笔记;在回收站页面,用户可以点击恢复按钮将笔记恢复为正常状态,也可以点击永久删除按钮彻底删除笔记。
第三步:迭代计划——OpenCode 会生成实施计划(改哪些文件、新增哪些接口、页面布局怎么设计)。不符合预期就接着在终端补充,比如:
回收站页面的设计参考项目中已有的笔记列表页面,使用相同的 UI 组件。
小技巧:可直接把设计图拖到终端,OpenCode 会自动识别图片内容当设计参考。
第四步:切到 Build 模式——确认计划无误,按 Tab 切换。
第五步:执行编码——终端输入"按照计划执行,完成所有修改"。OpenCode 会自动改数据库模型、加接口、开发页面,所有修改实时显示在终端,随时可看。
实战 2:简单修改直接 Build 跳过 Plan
适合单行代码修改、简单功能添加、代码重构这类轻量操作,比如给接口加鉴权、改按钮样式。
示例需求:给 /settings 路由添加鉴权,参考 /notes 路由的鉴权逻辑。
直接在 Build 模式下输入指令(要给够细节,指定参考文件):
给 @packages/functions/src/settings.ts 中的 /settings 路由添加身份验证,参考 @packages/functions/src/notes.ts 中 /notes 路由的鉴权逻辑,实现完全相同的功能。
小技巧:用 @ 符号可以模糊搜索项目文件,直接引用文件路径,不用手敲完整路径,效率高一大截。

实战 3:让 AI 给你讲祖传代码
接手新项目、看老代码,是程序员最头疼的活之一。OpenCode 能直接给你讲。
示例:解释 @packages/functions/src/api/index.ts 中的认证逻辑,说明每一步的作用。
适合快速接手新项目、理解同事代码,省掉逐行读的时间。这点对新人入职、跨组接手项目特别有用。
实战 4:撤销重做,改错了一键回滚
AI 生成的代码不符合预期,别手动改,直接用命令回滚:
- 撤销修改:输入
/undo,撤销上一步操作,多次输入可连续撤销多次
- 重做修改:输入
/redo,恢复最近一次撤销的修改
这是 AI 编程里最常用的一条保命命令,养成随手可撤的习惯,敢放手让 AI 干活。
实战 5:会话分享,团队同步开发思路
要和同事沟通开发方案,不用截图不用录屏——OpenCode 能把对话生成链接分享。
终端输入 /share,链接自动复制到剪贴板,同事打开就能看完整的需求分析、计划设计、代码修改过程。省去反复沟通的来回,对远程团队特别友好。
高频 Slash 命令速查表
OpenCode 的 Slash 斜杠命令是核心操作方式,所有功能都能命令触发,不用鼠标。开发里最常用的高频命令整理如下,建议收藏:
| 命令 | 核心功能 | 适用场景 |
/connect |
配置 LLM 模型 API 密钥 | 首次使用/切换模型 |
/init |
初始化项目,生成 AGENTS.md | 新项目接入 |
/undo |
撤销上一步修改 | 代码不符合预期 |
/redo |
重做最近一次撤销 | 误操作撤销 |
/share |
生成对话链接分享 | 团队协作 |
/add |
添加指定文件到上下文 | 让 AI 聚焦特定文件 |
/compact |
压缩上下文历史,释放 Token | 对话过长 |
/review |
代码审查,查 Bug/性能 | 提交前自动查错 |
/web |
联网搜索最新资料/API 文档 | 查外部信息 |
完整命令列表在终端输入 / 就能触发,含 /help、/models、/prompt、/history、/clear、/export、/import、/settings、/theme、/language、/shortcut、/feedback、/update、/about、/quit 等十几条,每条都配了 Ctrl+x 系列快捷键。
高级玩法:自定义模型参数与 Agent
OpenCode 支持高度定制,能让工具完全适配你的开发习惯。分享两个最实用的。
1. 自定义模型参数,平衡效果与速度
配置面板里能调模型核心参数:
- 温度参数(Temperature):0–1 区间,值越小代码越严谨(推荐 0.2–0.4,生产环境),值越大创造性越强(适合原型开发)
- 最大生成长度(Max Tokens):限制单次生成代码长度,前端组件开发建议设 2048,避免冗余代码
- 上下文扫描范围:可选当前文件/当前文件夹/整个项目,大型项目建议选"当前文件夹",减少性能消耗

2. 自定义 Agent,实现专属功能
能创建自定义 Agent(比如代码审查专家、安全检测专家),让 OpenCode 扮演特定角色。三步:
- 项目根目录建文件夹
.opencode/prompts/ - 创建自定义 Agent 文件(如
security.md),写系统提示词:
你是一名资深网络安全专家,专门检查代码中的 SQL 注入、XSS 漏洞、权限绕过等安全问题,发现问题后给出详细的修复方案,不直接修改代码。
- 终端输入
/run security,调用该 Agent 对项目做安全检测
这套玩法等于给 OpenCode 装专属技能,团队沉淀的经验能直接复用。
VSCode 集成:终端 + 编辑器无缝操作
习惯用 VSCode 的开发者,可以把 OpenCode 集成进 IDE,体验更好:
- VSCode 按
Ctrl+Shift+X(Win/Linux)或Cmd+Shift+X(Mac)打开扩展市场
- 搜 OpenCode,装官方认证插件,重启 VSCode
- 打开底部终端,按正常步骤启动使用即可
- 小技巧:在
keybindings.json绑定快捷键(如Ctrl+'),快速唤起 OpenCode

最大优势——能把 VSCode 左侧文件树的文件直接拖到终端,OpenCode 自动执行 /add 加进上下文,操作效率拉满。
快捷键速查
基础操作
| 快捷键 | 功能 |
Enter |
提交消息 |
Shift+Enter 或 Ctrl+j |
输入换行 |
Ctrl+v |
粘贴 |
Ctrl+c |
清空输入/退出 |
Tab |
切换 Agent(Plan/Build) |
Shift+Tab |
反向切换 Agent |
Escape |
中断当前会话 |
消息浏览
| 快捷键 | 功能 |
PgUp / PgDown |
上下翻页 |
Ctrl+Alt+u / Ctrl+Alt+d |
上下翻半页 |
Ctrl+g 或 Home |
跳到第一条消息 |
Ctrl+Alt+g 或 End |
跳到最后一条消息 |
Ctrl+x y |
复制消息 |
这套 Plan+Build 双模式 + Slash 命令体系,是 OpenCode 区别于其他 AI 编程工具的核心。用好它,你会发现"指挥 AI 干活"比"自己敲"快太多。
下篇会讲 OpenCode 的 skill 安装和使用——把它优化到和官方那些 TUI 工具一样好用。这是系列的最后一篇,关注后续更新。