OpenCode 操作指导书四基础使用适用版本OpenCode v1.18.3本篇目标完成项目初始化、发起第一次对话、理解 Plan/Build 模式、掌握引用与撤销跑通最小工作流。1. 启动与项目初始化# 进入你的项目目录cd/path/to/project# 启动 OpenCode不传参数默认启动 TUIopencode启动后先让 OpenCode 理解项目结构/init该命令会分析项目并生成项目根目录的AGENTS.md文件记录项目结构、技术栈与编码约定使后续对话更精准。渲染错误:Mermaid 渲染失败: Lexical error on line 3. Unrecognized text. ...C[/init 生成 AGENTS.md] C -- D[开始对话] -----------------------^2. 发起对话Ask你可以直接提问OpenCode 会结合代码库回答How is authentication handled in packages/functions/src/api/index.ts路径表示引用某文件模型会读取该文件内容。适合理解不熟悉的代码、定位逻辑、解释报错。3. Plan 模式与 Build 模式OpenCode 有两套核心工作模式用Tab键切换右下角显示当前模式。按 Tab再按 Tab标准开发所有工具可用仅规划不改动代码file/bash 默认 ask3.1 Plan 模式推荐先规划进入Tab切换到 Plan受限 Agentfile edits与bash默认ask。行为只给方案不实际修改代码。用法描述你想要的功能OpenCode 会输出实现计划。When a user deletes a note, wed like to flag it as deleted in the database. Then create a screen that shows all the recently deleted notes. From this screen, the user can undelete or permanently delete it.可追加细节 / 图片直接把图片拖入终端OpenCode 会读取并加入上下文。对计划提反馈迭代到满意。3.2 Build 模式执行改动确认计划后再按Tab切回 Build。下达执行指令Sounds good! Go ahead and make the changes.3.3 直接构建简单改动对明确的小改动可跳过规划直接让 Build 执行但务必给足上下文We need to add authentication to the /settings route. Take a look at how this is handled in the /notes route in packages/functions/src/notes.ts and implement the same logic in packages/functions/src/settings.ts4. 权限确认当 OpenCode 要读/写文件或执行命令时会弹出权限确认y 允许本次 n 拒绝本次 a 本次会话始终允许auto-approve也可在配置中用permission字段预设见第 05 篇。推荐初次使用时逐项确认熟悉后对相关命令设为允许。5. 撤销与重做改错了用/undo回退到上一次改动前/undoOpenCode 会还原文件改动并重新展示你原先的消息便于重新下达指令。/redo # 重做若支持快捷键Leader → u撤销、Leader → r重做。6. 上下文压缩compact长会话会占用大量上下文。可执行/compact或快捷键Leader → c将历史压缩为摘要释放上下文窗口。也可用/clear清屏开始全新会话。7. 第一次完整流程示例OpenCode你OpenCode你opencode /init生成 AGENTS.md(Plan 模式) 描述新功能输出实现计划反馈/确认(切回 Build) 执行改动修改文件 权限确认y 允许完成展示 diff练习任务找一个你熟悉的真实小项目执行/init然后用 Plan 模式让它为某个函数补充单元测试确认计划后切 Build 执行最后用/undo体会回退。下一步进入05-进阶使用.md学习 Agent、MCP 与多会话。本篇为 OpenCode 操作指导书系列之一版本 v1.18.3。
04-基础使用
OpenCode 操作指导书四基础使用适用版本OpenCode v1.18.3本篇目标完成项目初始化、发起第一次对话、理解 Plan/Build 模式、掌握引用与撤销跑通最小工作流。1. 启动与项目初始化# 进入你的项目目录cd/path/to/project# 启动 OpenCode不传参数默认启动 TUIopencode启动后先让 OpenCode 理解项目结构/init该命令会分析项目并生成项目根目录的AGENTS.md文件记录项目结构、技术栈与编码约定使后续对话更精准。渲染错误:Mermaid 渲染失败: Lexical error on line 3. Unrecognized text. ...C[/init 生成 AGENTS.md] C -- D[开始对话] -----------------------^2. 发起对话Ask你可以直接提问OpenCode 会结合代码库回答How is authentication handled in packages/functions/src/api/index.ts路径表示引用某文件模型会读取该文件内容。适合理解不熟悉的代码、定位逻辑、解释报错。3. Plan 模式与 Build 模式OpenCode 有两套核心工作模式用Tab键切换右下角显示当前模式。按 Tab再按 Tab标准开发所有工具可用仅规划不改动代码file/bash 默认 ask3.1 Plan 模式推荐先规划进入Tab切换到 Plan受限 Agentfile edits与bash默认ask。行为只给方案不实际修改代码。用法描述你想要的功能OpenCode 会输出实现计划。When a user deletes a note, wed like to flag it as deleted in the database. Then create a screen that shows all the recently deleted notes. From this screen, the user can undelete or permanently delete it.可追加细节 / 图片直接把图片拖入终端OpenCode 会读取并加入上下文。对计划提反馈迭代到满意。3.2 Build 模式执行改动确认计划后再按Tab切回 Build。下达执行指令Sounds good! Go ahead and make the changes.3.3 直接构建简单改动对明确的小改动可跳过规划直接让 Build 执行但务必给足上下文We need to add authentication to the /settings route. Take a look at how this is handled in the /notes route in packages/functions/src/notes.ts and implement the same logic in packages/functions/src/settings.ts4. 权限确认当 OpenCode 要读/写文件或执行命令时会弹出权限确认y 允许本次 n 拒绝本次 a 本次会话始终允许auto-approve也可在配置中用permission字段预设见第 05 篇。推荐初次使用时逐项确认熟悉后对相关命令设为允许。5. 撤销与重做改错了用/undo回退到上一次改动前/undoOpenCode 会还原文件改动并重新展示你原先的消息便于重新下达指令。/redo # 重做若支持快捷键Leader → u撤销、Leader → r重做。6. 上下文压缩compact长会话会占用大量上下文。可执行/compact或快捷键Leader → c将历史压缩为摘要释放上下文窗口。也可用/clear清屏开始全新会话。7. 第一次完整流程示例OpenCode你OpenCode你opencode /init生成 AGENTS.md(Plan 模式) 描述新功能输出实现计划反馈/确认(切回 Build) 执行改动修改文件 权限确认y 允许完成展示 diff练习任务找一个你熟悉的真实小项目执行/init然后用 Plan 模式让它为某个函数补充单元测试确认计划后切 Build 执行最后用/undo体会回退。下一步进入05-进阶使用.md学习 Agent、MCP 与多会话。本篇为 OpenCode 操作指导书系列之一版本 v1.18.3。
