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