OpenCode 能帮你完成什么工作
下面是根据工具能力整理的操作建议，输入、交付标准和人工核对由你确定。
场景 01 · 熟悉项目的开发者从功能想法推进到可检查的补丁
- 先准备
- 现有代码、功能需求、验收行为和可参考的实现。
- 怎么做
- 编辑建议：先用 Plan 分析涉及文件与步骤；补充遗漏约束后再交给 Build，逐项看差异并执行针对性检查。
- 得到什么
- 实现指定行为的候选补丁。
- 使用建议
- 核对需求、文件范围和实际检查输出，发现偏离时修正任务或回退后重做。
查看操作流程示意
场景 02 · 需要管理模型账户的开发者为同一个项目选择合适的模型接入方式
- 先准备
- 可用提供方账户或本地模型服务、项目任务和成本边界。
- 怎么做
- 编辑建议：按提供方文档完成连接，再使用同一个小型代码解释任务检查上下文和工具调用是否正常；确认后扩大到编辑任务。
- 得到什么
- 可用于当前开发流程的接入配置。
- 使用建议
- 验证凭据与模型可用性，检查请求发往的服务、费用方式和任务结果；不把开源客户端当作免费推理。
场景 03 · 维护多个项目或重复流程的团队把团队代码阅读规范做成可复用代理
- 先准备
- 审查关注点、仓库规范、允许读取的范围和命令清单。
- 怎么做
- 编辑建议：把长期约定放入项目规则，为专门代理配置角色和权限；先在小范围文件上检查输出，再用于同类工作。
- 得到什么
- 可重复使用的项目规则与代理配置。
- 使用建议
- 确认权限符合预期，检查意见是否指向真实文件，避免把报告内容直接当作已完成修改。
OpenCode 软件界面
官方文档界面：终端会话呈现代码搜索过程、待确认问题和当前模型信息。
OpenCode 是什么
它把模型连接、代理角色、项目规则和工具权限分开配置。使用者可以先分析方案，再允许代理改动代码，也可以为特定工作设置独立代理。
编辑建议：首次使用先确定模型接入方式和当前安装版本，再检查编辑与命令权限；用一个小任务确认整个流程。
OpenCode 的主要功能
配置模型提供方或本地模型
OpenCode 支持多种模型提供方，也支持本地模型接入。可用 /connect 添加对应凭据，并在配置中指定提供方；使用条件与成本按实际接入方确认。
在分析与执行角色间切换
内置 Plan 侧重规划与分析，Build 面向实际开发操作。代理可以设置不同模型、提示和工具权限；切换角色后应重新确认当前允许的操作。
通过 AGENTS.md 记录项目规范
项目初始化可以分析仓库并生成 AGENTS.md，后续用它描述结构、编码风格与工作约定。编辑建议：审阅生成规则，删除猜测和过时内容后再纳入版本控制。
分别控制编辑、命令和其他工具
工具权限可选择允许、请求确认或拒绝，并支持更细的匹配规则与代理覆盖。适合给代码阅读、文档更新和正式修改配置不同范围。
如何开始使用 OpenCode
按当前版本准备工具与模型接入
从官网选择对应平台与版本的安装指南，确认终端或其他入口的要求；再选择实际可用的模型提供方或本地模型服务。
连接提供方并进入项目
按文档用 /connect 或对应配置连接模型，进入目标项目运行 opencode。编辑建议：先检查当前仓库，再提交小型解释任务。
整理项目规则并确认权限
可用初始化功能生成 AGENTS.md，再人工检查其内容；同时查看当前代理及工具权限，确认是否允许编辑文件和执行命令。
先讨论方案，再检查实现
使用 Plan 讨论复杂改动，确认后切换到 Build 执行。编辑建议：保留 Git 起点，逐项读 diff 并运行验收检查，再决定是否保留改动。
费用与使用条件
选择前了解
- 经营方地区
- 海外
- 使用方式
- 命令行 / 桌面软件 / IDE 插件 / 编辑器
需按所选模型提供商配置凭据或服务；模型服务与计费条件应分别确认。
地区指经营方所在地，访问与账号要求请查看官网。
开源工具与模型服务费用分开
OpenCode 客户端开源，但连接的模型服务有各自账户、凭据和计费方式。本地模型也需要自行准备服务与资源，不能据此承诺零成本。
默认权限不代表逐项确认
官方权限说明中，多数操作默认允许，部分越出项目目录等操作才要求确认。编辑建议：希望每次确认编辑或命令时，主动配置并检查生效规则。
不同产品版本的安装与配置需对应
官方文档区分不同版本，且默认命令名可能相同。切换版本前查看对应迁移说明，避免混用安装步骤、配置字段或权限示例。
OpenCode 常见问题
OpenCode 必须使用某一家模型吗？
不必。它可连接多种提供方，也支持本地模型；具体可用模型、凭据和服务条件需要按对应提供方确认。
Plan 与 Build 应该怎样配合？
可以先用 Plan 分析方案，补齐约束后再让 Build 执行。角色的实际权限可配置，因此不要仅凭名称判断能否修改文件。
AGENTS.md 有什么用？
它用于向 OpenCode 提供项目结构、规范与工作约定。初始化生成的内容也需要审阅，确认符合真实项目后再长期使用。
安装 OpenCode 后，运行命令都会先询问吗？
不一定。权限文档说明多数操作默认允许，可将特定工具或匹配规则设为请求确认或拒绝。使用前检查当前版本和代理的有效配置。
