开源 AI 编程工具 , Claude Code 最佳平替
OpenCode 是什么
OpenCode 是一款开源的 AI 编程智能体(Coding Agent),被称为 Claude Code 的最佳平替。OpenCode 采用客户端/服务器架构,支持终端 TUI、桌面应用(macOS / Windows / Linux)及 VS Code / Cursor 等 IDE 插件多端统一,内置 LSP 语言服务器协议与 MCP 工具调用,让开发者在本地隔离环境中高效编写、审查和重构代码。OpenCode 支持接入 75+ LLM 提供商——包括 Claude、GPT、Gemini、DeepSeek 及本地 Ollama 模型,默认不存储任何代码或上下文数据,适合隐私敏感场景与企业合规需求。
OpenCode 的主要功能
多端统一访问:提供原生终端 TUI(响应式主题可定制)、Electron 重构的桌面应用(支持多 Tab 并行会话),以及 VS Code / Cursor IDE 扩展,同一 OpenCode 服务驱动所有入口。
75+ 模型提供商接入:通过 Models.dev 注册表接入 Anthropic、OpenAI、Google Gemini、Moonshot、DeepSeek、Z.ai 等,支持 OpenAI 兼容端点及本地 Ollama 模型;也可用 GitHub Copilot 或 ChatGPT Plus/Pro 账号登录直连。
Plan / Build 双模式:Plan 模式以只读方式分析代码库并输出执行方案,不修改文件;Build 模式允许 Agent 执行文件编辑、Shell 命令与 Git 操作,配合 /undo 快照回滚保障安全。
LSP + MCP 深度集成:自动拉起项目对应语言的 LSP 服务器,将类型错误、语法诊断实时反馈给模型实现自修正;支持 Model Context Protocol 接入外部工具与数据源。
多会话并行 & 标签页:同项目可同时开启多个独立 Agent 会话(各会话上下文隔离),桌面端 v2 支持 Tab 页管理,不同会话可分配不同模型并行执行任务。
上下文压缩(Auto Compact):对话接近模型上下文上限时自动摘要历史,保留关键信息丢弃冗余,降低长任务 token 消耗与响应延迟。
Git 集成与会话分享:内置 Git 操作,TUI/桌面端可直接审阅文件变更差异(Diff);支持生成会话分享链接,方便团队调试与协作。
隐私优先 & 本地化:默认不上传、不存储用户代码与对话上下文;支持纯本地模型运行,满足金融、医疗等受监管行业的合规要求。
如何使用 OpenCode
安装 OpenCode:终端执行 curl -fsSL https://opencode.ai/install | bash,或通过 npm(npm i -g opencode)、Homebrew(brew install opencode)安装;桌面版从官网下载安装包。
启动与连接模型:终端输入 opencode 启动 TUI,首次可通过 /connect 配置 API Key 或登录 Claude/ChatGPT/GitHub 账号;桌面端在设置面板选择内置免费模型或添加外部提供商。
初始化项目:进入项目目录执行 opencode init 生成配置文件(AGENTS.md / opencode.json),定义项目规范与 Agent 行为。
发起任务:在输入框用自然语言描述需求,如”为用户模块添加 JWT 鉴权”,按 Tab 切换 Plan/Build 模式。Plan 模式先输出方案供确认,再切入 Build 模式执行修改。
审查与回滚:任务完成后通过内置 Diff 视图逐条审阅变更,确认无误后可提交;若改动不符合预期,输入 /undo 一键回滚至上个 Git 快照。
桌面端高级操作:利用多 Tab 同时开启”写接口”和”修 Bug”两个并行会话;通过 @文件名 引用上下文,使用 /review 触发代码评审,/compact 手动触发上下文压缩。
OpenCode 的关键信息和使用要求
- 运行环境:Core 服务端支持 Node.js(v2 已弃用 Bun),桌面端基于 Electron,TUI 基于自研 OpenTUI 框架。
- 配置文件:项目级
AGENTS.md定义编码规范与指令,opencode.json管理模型、权限与 MCP 服务器;支持目录级级联加载。 - 权限控制:可配置 Shell 命令、文件读写、MCP 工具调用的允许/拒绝列表,细粒度管控 Agent 操作范围。
- 网络与远程:支持
opencode serve启动后台服务,通过 Tailscale 等组网实现跨设备远程会话同步与状态恢复。 - 上下文管理:单会话独立上下文,Auto Compact 自动压缩,MCP 服务器建议按需启用以避免Token浪费。
OpenCode 的核心优势
- 模型无关零锁定:不绑定任何厂商模型,随时切换 Claude / GPT / Gemini / 本地模型,规避 API 停服与涨价风险。
- 开源可审计:MIT 许可证,代码完全开放,企业可自托管、二次开发与合规审计。
- 低 Token 开销:精简的 Agent Harness(约 7k token 基线 vs Claude Code ~33k),相同模型下上下文利用率更高、缓存命中率更好。
- 多端并行工作流:桌面 v2 多 Tab + 多会话并行,不同 Agent 可分配不同模型协作完成任务。
- 隐私合规友好:零数据存储承诺 + 本地模型支持,满足严格的数据不出境/不出域要求。
- LSP 驱动自修正:编辑后即时拉取 LSP 诊断回传模型,减少低级语法与类型错误。
OpenCode 的同类竞品对比
| 对比维度 | OpenCode | Claude Code (Anthropic) | Cursor (Anysphere) | OpenAI Codex CLI |
|---|---|---|---|---|
| 产品定位 | 开源模型无关 AI Coding Agent | Anthropic 官方终端 Agent | AI 原生 IDE | OpenAI 官方终端 Agent |
| 交互界面 | TUI + 桌面应用 + IDE 插件 | 纯终端 TUI | 完整图形化 IDE | 终端 CLI + 云端 |
| 核心模型 | 75+ 提供商 / 本地模型 | Claude Opus / Sonnet 系列 | GPT / Claude / 自研 | GPT-5.x-codex |
| 执行模式 | Plan/Build 双模式 + 多会话并行 | 单会话逐步执行 + 嵌套子 Agent | Tab 补全 + Agent 模式 | 多 Agent 并行 + 定时任务 |
| 项目管理 | 会话级隔离 + 可选工作区 | 基于目录的会话 | 基于工作区文件树 | 文件夹工作区 + Thread |
| 开源协议 | MIT 完全开源 | 闭源专有 | 闭源专有 | Apache-2.0(CLI 部分) |
| 模型锁定 | 无锁定,随意切换 | 仅 Anthropic 模型 | 多模型但需平台订阅 | 优先 OpenAI 模型 |
| 本地/隐私 | 支持本地模型,零数据上报 | 依赖 Anthropic 数据策略 | 依赖平台数据策略 | 可选本地执行 |
| 适用人群 | 重视开源/隐私/多模型切换的开发者 | Claude 生态深度用户、后端工程师 | 全栈开发者、重度 IDE 用户 | ChatGPT 订阅用户 |
OpenCode 的应用场景
- 日常功能开发:用自然语言描述需求生成 CRUD、API 接口、单元测试,自动运行测试并修复报错。
- 遗留代码库分析与重构:Plan 模式先梳理复杂模块依赖与架构问题,输出重构方案后再执行,降低误改风险。
- 多模型协作的长时任务:规划阶段用强推理模型(Claude Opus / GPT-5),执行阶段切到性价比模型(Sonnet / 本地模型),控制成本。
- 隐私敏感行业开发:金融、医疗、政务项目使用本地 Ollama 模型跑 Agent,代码不出内网。
- 教学与结对编程:学生通过会话分享链接向导师展示 AI 辅助解题过程,或团队内部共享 Agent 会话复盘决策路径。
