OpenCode

OpenCode 是什么？

OpenCode 是由 Anomaly 团队及开源社区维护的 AI 编程代理，面向需要在真实代码项目中工作的开发者。它能帮助理解代码、实现需求和处理修改，支持终端、桌面与 Web 等使用方式。其鲜明特点是模型选择自由度：用户可以按任务、预算和部署要求选择不同服务商，而不必把整个工作流绑定到一个模型。官网与V2 文档提供下载和入门入口。

主要功能

• 项目理解与代码协作：在项目目录启动后，用自然语言描述问题；通过 @ 引用具体文件或行范围，让任务有明确上下文。
• 多模型接入：通过 /connect 连接提供商，再用 /models 选模型；支持自定义兼容接口，可根据实际环境配置本地或远程模型。
• 多会话与变更检查：围绕不同任务组织会话，查看文件修改差异；支持撤销、重做等交互。
• 脚本工作流：opencode run 可在非交互模式接收提示词，便于结合脚本或 CI 流程。
• 权限管理：可以约束工具执行权限，给文件改动和命令运行设置边界。

功能依据：TUI 文档、模型提供商配置、CLI 文档及权限文档。

核心价值与适用场景

从产品设计看，OpenCode 的价值在于把模型选择、项目上下文和实际开发操作放到同一工作流。适合已有代码仓库的开发者，尤其是希望保留终端习惯、尝试不同模型或自定义工具链的团队。这是基于功能的选型判断，并非性能测试结论。

• 接手陌生项目：先询问入口、模块职责和调用关系，再决定改动范围。
• 修复问题与补测试：提供报错、复现步骤和目标行为，要求生成最小修改并说明验证方法。
• 实现小功能或重构：把大需求拆成可审查的小任务，逐轮检查差异。
• 开发自动化：将重复说明、分析等任务接入脚本；涉及写入和部署时另行设置审核。

如何开始使用 V2

1. 打开 V2 官方文档，选择适合系统的安装方式。例如 Node.js 环境可使用 npm install -g @opencode/cli。
2. 进入准备处理的项目目录，运行 opencode。
3. 执行 /connect，按官方流程连接模型提供商，再通过 /models 选择模型。密钥应保存在受控配置中，不要提交进仓库。
4. 先给一个只读任务，例如“说明这个项目的登录流程，并列出相关文件”，确认理解正确后再要求修改。
5. 使用 /diff 检查变化，结合版本控制和项目测试验收。需要回退时可参考 /undo，但它不能替代备份与代码审查。

注意：V1 和 V2 默认都使用 opencode 命令，不能按默认命令并排安装。旧教程中的 opencode-ai 包属于 V1，迁移前请看官方迁移说明。V2 文档还明确 Windows 包管理器安装不受支持，Windows 用户应优先核对官方独立二进制下载选项。

价格、可用性与必要限制

OpenCode 本体为开源工具，可直接下载；首页展示内置免费模型，也可连接自己的模型服务。开源不代表所有模型调用免费：API 费用、订阅额度和调用限制取决于所选提供商；官方 Go 也是可选订阅。购买或连接前应核对具体计费与数据政策。首页的“新产品候补”订阅区并不代表 OpenCode 本体需要排队。

使用远程模型通常涉及把任务上下文交给模型提供商；不要把“本地运行客户端”理解为“代码绝不离开本机”。应按项目保密要求配置模型、权限和可访问目录。AI 生成代码也需要人工审查、安全检查和测试。

与 Claude Code、Cursor 如何选择？

• OpenCode：重点是开源与可配置模型接入，适合愿意管理模型连接、权限和开发环境的用户。
• Claude Code：可对照其官方支持的终端、IDE 等工作流，评估团队是否主要围绕 Claude 使用编程代理。
• Cursor：同时提供编辑器、CLI 和云代理等入口，适合希望在统一产品中组织编辑与代理任务的团队。

这些产品的功能存在重叠，不能简单按“终端对编辑器”二分。选择时可用同一个真实任务比较上下文理解、改动可审查性、成本与权限控制。参考Claude Code 官方概览和Cursor 官网；本文未做速度或正确率排名。

近期更新：2026 年 10 月 15—16 日

官方 V2 日志记载，10 月 15 日 v2.0.30 增加逐轮文件变更展示，以及可停靠在侧边的 TUI diff；10 月 16 日 v2.0.32 改进 /copy，使其复制最近一条助手回复，并修复无浏览器环境中的登录崩溃问题。这些属于 V2 后续迭代，不能写成“10 月 15 日首次发布 V2”。

同一日志明确移除了已退役的会话分享后端与不可用的 /share 命令。虽然首页仍残留“分享链接”文案，本文不将其列为当前 V2 功能。版本事实以官方更新日志为准。核验日期：2026 年 10 月 18 日。