OpenCode 是什么
OpenCode 是一款开源 AI 编程代理，面向开发者提供终端 TUI、桌面应用和 IDE 扩展等多种使用方式。它可以帮助用户理解代码库、规划新功能、直接修改代码、调用开发工具并完成持续的软件工程任务。OpenCode 不绑定单一模型，通过 Models.dev 支持 75+ LLM 提供商及本地模型，同时可使用 GitHub Copilot、ChatGPT Plus/Pro 等现有账户能力。
OpenCode 的主要功能
- 原生终端界面： 提供可换主题、响应迅速的 TUI，直接在命令行中完成提问、改代码与查看差异，无需在编辑器和浏览器之间切换。
- Plan / Build 双代理模式： Build 为默认模式，拥有完整的文件修改与命令执行权限；Plan 为只读模式，默认拒绝文件编辑、执行命令前询问权限，适合先出方案再动手。两种模式用 Tab 键切换，另有 general 子代理处理复杂检索与多步任务。
- 任意模型接入： 通过 Models.dev 支持 75 家以上 LLM 提供商，包含本地模型；也可用 GitHub 账号复用 Copilot 订阅、用 OpenAI 账号复用 ChatGPT Plus/Pro 订阅。
- LSP 代码智能： 自动为当前项目加载对应的语言服务器，让模型可以跳转定义、查找引用、获取诊断信息，减少凭上下文猜测导致的改错。
- 多会话与会话分享： 可在同一项目上并行启动多个代理会话；
/share命令生成会话链接，便于团队参考或排查问题，会话默认不公开。 - 项目初始化与撤销重做：
/init分析项目结构并生成AGENTS.md约定文件；/undo、/redo可逐步回滚或恢复代理所做的改动。 - 可扩展配置： 支持 MCP 服务器、Agent Skills、自定义命令与自定义工具、代码格式化器、权限与策略控制、主题与键位映射。
- 面向开发者的接口： 提供官方 JS/TS SDK 与本地服务端模式（
opencode serve，附 OpenAPI 规范），支持插件机制、ACP 协议，以及 GitHub、GitLab 集成。 - OpenCode Zen 模型网关（可选）： 官方筛选并基准测试过的编程模型清单，按请求计费、零加价售卖，也可搭配其他编程代理使用；完全可选，不用它同样能使用 OpenCode。
OpenCode 的适合人群
- 软件开发者： 用于代码解释、功能开发、Bug 修复、重构和项目维护。
- AI Coding Agent 用户： 适合希望使用类似 Claude Code、Codex 的 Agentic Coding 工作方式，同时保留模型选择权的开发者。
- 开源开发者： 可结合 GitHub、GitLab、MCP 和自定义工具完成开源项目维护。
- 企业研发团队： 可配置权限、策略、模型提供商和私有环境，用于对代码隐私和工具控制要求较高的开发场景。
- 本地模型用户： 希望使用本地 LLM 编程，又需要完整 Coding Agent Harness 的用户。
OpenCode的产品定价
OpenCode 本体开源免费，采用 MIT 协议，安装与使用不收取订阅费，模型调用成本由用户自行承担——可以填入自有的各家提供商 API 密钥，也可以复用已有的 GitHub Copilot 或 ChatGPT Plus/Pro 订阅。
官方另提供可选的 OpenCode Zen 模型网关，采用按量付费：注册后先充值 20 美元余额，按请求扣费，官方称按成本价出售、不加价，仅转嫁信用卡处理费（4.4% + 0.30 美元/笔）。余额低于 5 美元时默认自动充值 20 美元，该金额可调整也可关闭，并支持为整个工作区及每位成员设置月度用量上限。Zen 模型清单中包含若干限时免费模型。团队工作区在 Beta 期间免费，后续定价官方尚未公布。具体价格与模型清单以官网为准。
如何使用OpenCode
- 安装客户端： 终端执行官方安装脚本
curl -fsSL https://opencode.ai/install | bash，也可通过 npm、Homebrew、Scoop、Chocolatey、pacman、mise、Nix 或 Docker 安装。Windows 用户官方推荐在 WSL 环境下使用。桌面版可访问 https://opencode.ai/download 下载。 - 配置模型提供商： 在 TUI 中运行
/connect命令，选择要接入的提供商并填入 API 密钥；也可选择官方 Zen 网关，前往 https://opencode.ai/auth 登录获取密钥。 - 初始化项目： 进入目标项目目录运行
opencode，再执行/init，代理会分析项目并生成AGENTS.md，建议将该文件提交到 Git。 - 用 Plan 模式规划： 按 Tab 键切到 Plan 模式，描述需求让代理先给出实现方案，可反复补充细节或提供参考图片。
- 用 Build 模式执行： 确认方案后按 Tab 键切回 Build 模式，让代理落地改动；结果不理想时用
/undo回滚，用/redo恢复。 - 分享与个性化： 用
/share生成会话链接供团队查看；按需配置主题、键位、格式化器与自定义命令，详见文档 https://opencode.ai/docs
常见问题
Q：OpenCode 是免费的吗？
A：软件本体开源免费，采用 MIT 协议。但代理需要调用大模型，这部分费用由用户承担：可以自带各家提供商的 API 密钥，可以复用已有的 Copilot 或 ChatGPT 订阅，也可以使用官方按量付费的 Zen 网关（其中含若干限时免费模型）。
Q：必须用官方的 Zen 网关吗？
A：不必须。官方文档明确说明 Zen 是完全可选的，不使用它也能正常使用 OpenCode；反过来 Zen 也可以搭配其他编程代理使用。
Q：支持哪些操作系统？
A：macOS、Linux 与 Windows 均可安装，桌面版覆盖三大平台。Windows 环境官方推荐通过 WSL 使用，以获得更好的性能与完整功能兼容性。
Q：我的代码会被上传或用于训练吗？
A：官方声明 OpenCode 不存储用户的代码与上下文数据，以便在隐私敏感环境中运行。但代码内容仍会发送给你所选择的模型提供商，具体留存策略取决于该提供商；Zen 网关中部分限时免费模型明确会将数据用于模型改进，接入前建议查阅官方 Zen 文档的隐私说明。
Q：它和 Claude Code、Codex 这类工具有什么不同？
A：最核心的差异在于模型中立与开源。Claude Code、Codex 分别绑定各自厂商的模型体系，而 OpenCode 由第三方团队 Anomaly 开源维护，可接入 75 家以上提供商乃至本地模型，用户自行选择模型与计费方式。
