OpenCode

🛠️ OpenCode 工具是什么

OpenCode 是一款开源的终端优先 AI 编程 Agent，由 CEO Jay V 和联合创始人 Dax Raad 等人创建，2025 年 6 月正式发布，定位为“开源、中立的 AI 编程助手”。它诞生于创始团队使用 Claude Code 之后，决定自己开发一款不绑定任何模型厂商的替代品。

它的定位可以用一句话概括：OpenCode 不是一个“聊天窗口”，而是一个住在终端里的 AI 程序员。你给它目标，它读取项目、规划任务、执行修改、运行命令，把整个改动直接写进代码库。它内置 build 和 plan 两种 Agent 模式，plan 模式先规划后执行，build 模式直接动手。

它解决的核心问题是：开发者不想被任何一家模型或产品生态锁死。Cursor 绑定自己的编辑器，Claude Code 绑定 Anthropic 生态，而 OpenCode 从第一天就设计为支持任意模型提供商——Claude、GPT、Gemini、DeepSeek、本地 Ollama，甚至任何 OpenAI 兼容的端点。它的 CEO Jay V 说得很直接：“OpenCode 不是 AI 产品，它是一个设计来使用 AI 的产品”。

几个关键事实要先说清楚。第一，OpenCode 软件完全免费且开源（MIT 协议），你只需要为模型 API 付费，平台零加价。第二，截至 2026 年 6 月底，月活跃用户达到约 1300 万，年经常性收入接近 4000 万美元。第三，2026 年 1 月 Anthropic 切断了 OpenCode 对 Claude 订阅的 OAuth 访问，现在用 Claude 只能走 API 按量计费。第四，它提供终端 TUI、桌面应用和 IDE 扩展三种形态，功能和配置完全一致。

⚡ 核心功能

• 终端 TUI 交互界面：OpenCode 的核心体验是一个全屏终端界面，支持文件引用（@）、Bash 命令（!）、斜杠命令（/）和 Vim 风格快捷键。界面干净，没有多余元素，启动速度比重型 IDE 快得多。
• Plan/Build 双模式 Agent：这是 OpenCode 的核心工作流。Plan 模式下，AI 只读不写，分析代码库、理解需求、生成实现计划，不修改任何文件。你审批计划后切到 Build 模式，AI 才开始写代码、改文件、跑命令。这个“先想清楚再动手”的设计，避免了大多数 AI 工具“直接开始写然后祈祷没问题”的毛病。
• 多模型架构（75+ 提供商）：支持 Claude、GPT、Gemini、DeepSeek、Llama，以及本地 Ollama、LM Studio、llama.cpp。任何 OpenAI 兼容的端点都可以接入。你可以给 Plan 和 Build 模式分别配置不同的模型——比如 Plan 用 Claude 做规划，Build 用便宜的 DeepSeek 执行。
• 内置工具集：OpenCode 自带 bash（执行 shell）、edit（字符串替换修改文件）、write（创建文件）、read（读取文件）、grep（正则搜索）、glob（模式匹配文件）、webfetch（获取网页）、websearch（Exa 网络搜索）、question（执行中向用户提问）等工具。所有工具默认启用，可以通过权限配置控制。
• LSP 集成：连接 20+ Language Server Protocol 服务器，提供真正的代码智能——定义跳转、引用查找、悬停信息、调用层次。这意味着 Agent 不是只读文本，而是像编辑器一样理解代码结构。
• MCP 支持：支持 Model Context Protocol，可以连接数据库、API、第三方服务来扩展 Agent 能力。
• 会话管理与持久化：对话历史存储在本地 SQLite 数据库中，支持多会话管理、撤销/重做、导出为 Markdown。
• 多形态部署：终端 TUI、桌面应用（Windows/macOS/Linux）、VS Code 扩展三种形态，功能完全一致，按使用习惯选择。

✨ 主要亮点与优势

1. 真正的模型中立，不被任何厂商锁死。这是 OpenCode 最核心的差异化。Cursor 绑定自己的模型和编辑器，Claude Code 绑定 Anthropic，而 OpenCode 是一个纯粹的客户端——你用谁的 API 就付谁的钱，OpenCode 不加价，也不限制你换。

2. 零成本起步，真正的“免费”。OpenCode 软件本身完全免费，MIT 协议，GitHub 星标超过 17 万，是星标最多的开源编程 Agent。你可以用免费模型（如 Big Pickle、DeepSeek V4 Flash Free）零成本使用，也可以用本地 Ollama 模型完全离线。

3. 本地优先，数据不出机器。代码、对话历史、文件操作默认全部存储在本地，不上传云端。支持完全离线部署。对于处理敏感代码或合规要求高的场景，这是核心价值。

4. 开源带来的可定制性。500 多名贡献者，配置灵活——你可以改系统提示词、加自定义模式（如 Orchestrator、Artist）、接入任意 OpenAI 兼容端点。这种灵活性在闭源工具里做不到。

🎯 使用场景

OpenCode 的场景集中在“终端环境下的编码任务”上。它不是写作工具，不是设计工具，核心就是编程。

• 终端重度用户的日常编码：习惯用 Vim、Neovim、tmux 的开发者，不想为了用 AI 而换编辑器。OpenCode 在终端里跑，跟你的工作流无缝衔接。
• 远程服务器开发：SSH 到服务器上直接改代码，没有图形界面也能用。这是 Cursor 这类 IDE 工具做不到的。
• 模型路由与成本控制：你可以用便宜的 DeepSeek 做日常编码，复杂任务切到 Claude 或 GPT。OpenCode 的配置里改一行就能换模型。
• 隐私敏感场景：配合本地 Ollama 模型，代码和数据完全不出机器。对于不能把代码传给第三方服务器的团队来说，这是刚需。
• 技术探索与模型测试：OpenCode 曾作为新模型的匿名公测平台——智谱 GLM-5.3-Flash 以代号“Ox-Alpha”在 OpenCode 上进行匿名公测，六天处理了 42 万亿 Token。
• 不适用的人群：不写代码的普通用户；习惯图形界面且不愿碰命令行的开发者（桌面版可以缓解，但核心体验在终端）；只需要简单代码补全的用户（Copilot 更轻）。

📋 如何使用

第一步：安装

最推荐的一键安装（macOS/Linux）：curl -fsSL https://opencode.ai/install | bash。npm 用户：npm install -g opencode-ai。macOS 也可以用 Homebrew：brew install sst/tap/opencode。Windows 用户推荐在 WSL 中运行，或用 Scoop：scoop install opencode。

第二步：配置模型

启动 OpenCode 后在 TUI 里输入 /connect，选择提供商并填入 API Key。支持 Anthropic、OpenAI、Google、DeepSeek、OpenRouter 等。你也可以用环境变量：export ANTHROPIC_API_KEY=your-key。

第三步：用 Plan 模式理解项目

进入项目目录，运行 opencode 启动 TUI。默认在 Plan 模式下，你可以问“帮我看看这个项目的结构”，OpenCode 会读取文件、分析代码，但不做任何修改。

第四步：切到 Build 模式执行任务

审批 Plan 方案后，切换到 Build 模式。用自然语言描述任务，比如“给 src/utils.ts 添加一个防抖函数”或“修复 index.ts 第 42 行的类型错误”。OpenCode 会执行修改并显示 diff。

第五步：用快捷键和命令提效

用 @ 引用文件、! 运行 shell 命令、/ 调用斜杠命令。ctrl+x 是默认的 leader key，配合其他键可以快速执行操作。

💡 使用技巧

• 用 AGENTS.md 固化项目规则。OpenCode 有 /init 命令引导创建 AGENTS.md，写明构建命令、测试流程、编码规范。Agent 每个任务都会读取这些规则。
• Plan 和 Build 用不同模型。Plan 模式用擅长推理的强模型（如 Claude Sonnet）做规划，Build 模式用性价比高的模型（如 DeepSeek）执行。OpenCode 支持给两种模式分别配模型，成本能压得很低。
• 注意 OpenCode 的系统提示词限制。有用户反馈 OpenCode 的开发者提示词强制 Agent“不要做大改动”“不要未经明确要求就 commit”“用 edit 工具而不是 shell”。如果你处理的是大型遗留系统重构，这些限制可能成为阻碍。社区的建议是克隆仓库直接改源码再编译。
• 关注免费模型的试用期。OpenCode Zen 提供的免费模型（如 Big Pickle、DeepSeek V4 Flash Free）在测试期免费，但数据可能被用于改进模型。付费 Zen 模型默认零保留。
• 从简单任务开始。先用 Plan 模式让它分析项目结构，确认它理解对了，再让它改代码。不要一上来就派大活。

📦 安装方式

一个实际建议：如果你只是试试，一键脚本最快。习惯图形界面的话装桌面版。Windows 用户如果遇到兼容性问题，WSL 是最稳的方案。

💰 收费情况

OpenCode 软件本身完全免费，MIT 协议开源。你只需要为模型 API 付费，OpenCode 平台不加价。

几个关键点要留意：BYOK 模式下你付的是模型提供商的原价，OpenCode 不加价。2026 年 1 月 Anthropic 切断了 Claude 订阅的 OAuth 访问后，用 Claude 只能走 API 按量计费，重度 Claude 用户的成本可能高于 Claude Code 的固定订阅。用本地模型或便宜模型（DeepSeek）可以把成本压得很低甚至为零。

👥 适用人群

• 终端重度用户：习惯命令行工作流，不想为了用 AI 而打开重型 IDE。OpenCode 启动快、资源占用低，跟你的工作流无缝衔接。
• 对模型锁定敏感的开发者：不想被 Cursor 或 Claude Code 绑死，想自己控制用哪个模型、花多少钱。OpenCode 的模型中立性是同类工具里最彻底的。
• 需要数据隐私的团队：本地优先 + 本地模型，代码不出机器。适合处理敏感代码或合规要求高的场景。
• 远程/服务器开发：SSH 到服务器上直接改代码，没有图形界面也能用。
• 喜欢折腾和定制的开发者：愿意花时间配置 API Key、调模型、改系统提示词。OpenCode 的灵活性对这类用户是吸引力，对其他人是门槛。
• 不适用的人群：只需要简单代码补全的开发者（Copilot 更轻）；不习惯终端工作流的用户（桌面版可以缓解，但核心体验在终端）；不愿意花时间配置 API Key 的用户；处理大型遗留系统重构且需要 Agent 自主 commit 的用户（OpenCode 的系统提示词有限制）。

🌍 全球使用情况

OpenCode 的增长速度在开源 AI 编程 Agent 里属于现象级。2025 年 6 月发布，12 月月活 65 万，2026 年 1 月 250 万，到 6 月底飙升至约 1300 万月活用户，年经常性收入突破 4000 万美元。GitHub 星标超过 17.2 万，是星标最多的开源编程 Agent。

2026 年 1 月，Anthropic 试图阻止用户通过 OpenCode 调用 Claude 订阅，随后 OpenCode 获得了 OpenAI 的官方支持。这个事件让 OpenCode 在“模型中立”的定位上获得了更多关注。企业客户包括 Cloudflare 等。

在中国市场，OpenCode 的认知度在快速上升。阿里云开发者社区有多篇 OpenCode 教程，涵盖安装、配置、国内模型适配（DeepSeek）。中文社区关注的重点包括：模型中立、免费开源、本地部署、国内模型接入。智谱 GLM-5.3-Flash 以“Ox-Alpha”代号在 OpenCode 上进行匿名公测，创下平台调用量纪录，也让 OpenCode 在国内 AI 圈获得了更多曝光。

⚖️ 优缺点分析

优点

• 模型中立是真正的差异化。支持 75+ 提供商，BYOK 零加价，不被任何厂商锁死。对比 Cursor 和 Claude Code 的生态绑定，OpenCode 的灵活性在同类工具里是独一档的。
• 完全免费 + 零加价。MIT 协议，软件零成本。你付的是模型原价，OpenCode 不抽成。用免费模型或本地模型可以做到零成本使用。
• 本地优先，数据不出机器。代码、对话、操作全部本地存储，支持完全离线部署。隐私敏感场景的刚需。
• Plan/Build 双模式避免“乱写代码”。先规划后执行的设计，在复杂任务上比“直接开始写”的工具更可靠。
• 开源生态活跃。500+ 贡献者，快速迭代（GitHub 上几乎每天都有新版本），社区可以改源码、加自定义模式。

缺点

• 系统提示词限制可能影响某些工作流。有用户反馈 OpenCode 强制 Agent“不要做大改动”“不要未经明确要求就 commit”“用 edit 工具而不是 shell”。处理大型遗留系统重构时，这些限制可能成为阻碍，而且这些规则硬编码在二进制里，改起来麻烦。
• Claude 访问成本上升。2026 年 1 月 Anthropic 切断 OAuth 后，用 Claude 只能走 API 按量计费，重度 Claude 用户的成本可能高于 Claude Code 的固定订阅。
• 配置门槛比商业产品高。需要自己管理 API Key、选模型、配权限。对于习惯“开箱即用”的用户来说，初始设置有一定学习成本。
• 体验不如商业产品“精致”。有用户对比后反馈 OpenCode 的输入响应有时“感觉慢”，多行输入支持不如 Claude Code 顺畅，系统提示词导致模型在非编码任务上更容易拒绝。

🔄 与同类工具对比

跟 Claude Code 的对比值得多说一句。两者都是终端优先的 AI Agent，但定位完全不同。Claude Code 绑 Anthropic 生态，有固定订阅和速率限制；OpenCode 模型中立，BYOK 零加价，无速率限制。有用户对比后说“同样的模型，Claude Code 的输出质量更好，因为它的系统提示词更宽泛，不会把所有任务都框在‘编码助手’的定位里”。OpenCode 的系统提示词更窄，导致它在写文档、设计讨论等非纯编码任务上更容易拒绝。如果你主要做编码，OpenCode 的模型自由和成本优势很吸引人；如果你需要 AI 处理更广泛的任务，Claude Code 的系统提示词设计更合适。

跟 Cursor 的对比：Cursor 是 AI 原生编辑器，OpenCode 是终端 Agent。Cursor 的 Tab 补全和编辑器内体验更好，OpenCode 的模型自由度、终端原生灵活性、零成本优势更强。如果你大部分时间在编辑器里“边写边改”，Cursor 更顺手。如果你习惯终端工作流、对成本敏感、需要模型自由，OpenCode 更合适。

📝 总结：值不值得用

明确结论：如果你是终端重度用户、对模型锁定敏感、或者需要数据隐私，OpenCode 是 2026 年最值得认真试的开源 AI 编程 Agent。如果你只需要简单补全，或者不习惯命令行，Cursor 或 Copilot 更省心。

OpenCode 的核心价值不在“AI 能写代码”——现在所有工具都能做。它的价值在于它把“AI 编程 Agent”这件事从“付费订阅的生态绑定”变成了“跑在终端里的开源工具”。MIT 协议、75+ 模型提供商、BYOK 零加价、本地优先、Plan/Build 双模式——这套组合在开源 Agent 里是独一档的。1300 万月活和 17 万 GitHub 星标说明它不是小众玩具。

什么时候值得用：你不想每月付订阅费，但需要一个能真正干活的 AI Agent；你在处理敏感代码，不能把信息传到第三方服务器；你想用 DeepSeek 或其他国产模型但需要一个好的 Agent 框架；你在远程服务器上开发，需要终端原生的 AI 工具；你愿意花一点时间配置 API Key 和模型。

什么时候不推荐：你只需要简单的代码补全（Copilot 更轻）；你不习惯命令行操作（桌面版可以缓解，但核心体验在终端）；你主要用 Claude 且对成本敏感（Anthropic 切断 OAuth 后，Claude 走 API 成本更高）；你处理大型遗留系统重构且需要 Agent 自主 commit（OpenCode 的系统提示词有限制）；你对中文界面和文档有硬性要求。

说得直白一点：OpenCode 是一个“为模型自由和终端工作流设计的开源 Agent”，不是一个“开箱即用的商业产品”。它选择了一条更“自由”的路——开源、模型中立、零加价、本地优先。如果你恰好需要这些，一键脚本几分钟就能试。如果不符合你的场景，它就是一个需要花时间配置的工具，不如直接用 Copilot 或 Cursor。