OpenCode
OpenCode是开源AI编程代理,MIT协议完全免费,支持Plan & Build双模式(代码一次性通过率提升40%)、多Agent系统、75+模型自由切换(Claude/GPT/Gemini/DeepSeek/Olla…
📋 工具信息卡片
OpenCode 是什么
OpenCode 是一款开源AI编程代理(AI Coding Agent),由SST团队开发并于2025年4月开源。它不是一个"聊天窗口",而是一个能理解你的项目结构、读取文件、规划修改方案、执行命令、审查差异,然后把整个改动直接写进代码库的智能代理。
OpenCode 的核心设计理念是 "模型中立、终端优先、本地优先"——它不绑定任何一家模型厂商,你可以自由选择 Claude、GPT、Gemini、DeepSeek 等75+模型提供商,也可以用 Ollama 跑本地模型。它运行在终端里,启动速度快、资源占用低,代码、对话历史、文件操作默认全部存储在本地,不上传云端,支持完全离线部署。
OpenCode 在 GitHub 上已累计超过 192,000 颗星,拥有 900 位贡献者、超过 13,000 次提交,每月被超过 750 万开发者使用并信赖。npm 包 opencode-ai 单周下载量超 200 万次。OpenCode 不是帮你写代码的工具,是替你把代码写完的 Agent。
🔗 OpenCode官网:https://opencode.ai/(完全开源免费,MIT协议)
OpenCode 主要功能
📐 Plan & Build 双模式——先规划后执行,效率提升40%
OpenCode 独创的 Plan(规划)与 Build(构建)双模式工作流,从根本上解决了AI直接生成代码导致的逻辑偏差问题。Plan 模式以架构师视角生成实施计划,不直接修改代码;Build 模式以工程师视角基于规划执行具体代码编写。采用"先Plan后Build"策略的复杂重构任务,代码一次性通过率提升约40%。
🤖 多Agent系统——专才专用,并行协作
OpenCode 内置多个专业化Agent,不同Agent负责不同任务阶段。默认 build Agent 拥有完整开发权限,可读写文件、执行bash命令,适合实际编码、调bug、重构;plan Agent 默认只读,执行bash命令需确认;还有 explore Agent 用于代码探索、 general Agent 用于并行子任务。每个Agent可配置不同模型、Token限制和推理参数。
🔌 75+模型自由切换 + MCP插件生态
OpenCode 支持 75种以上AI模型提供商,从Claude、GPT、Gemini到本地部署的Ollama,全部可以接入。通过 BYOK(自带API Key) 自由切换模型。同时支持 无限MCP插件(Model Context Protocol),扩展能力不受限。官方还提供 Zen——一组经过OpenCode专门测试和基准测试的精选AI模型。
⚡ Slash命令体系——精确控制上下文
OpenCode 提供强大的 Slash Command(斜杠命令)体系,通过结构化指令精确控制上下文窗口。核心命令包括:/init 初始化项目配置、/add 添加文件到上下文(支持通配符 *.ts)、/compact 压缩上下文历史、/undo 撤销上一步操作、/web 联网搜索、/review 代码审查。
🔒 隐私优先——100%本地处理,代码不上云
OpenCode 采用 隐私优先的设计,不存储任何代码或上下文数据。代码、对话历史、文件操作默认全部存储在本地。支持通过 Ollama 完全离线运行,模型跑在本地,不需要任何API Key,不联网。适合企业内网、处理敏感代码等对数据隐私要求严格的场景。
📦 多端覆盖——终端 / 桌面 / IDE 全覆盖
OpenCode 提供 终端界面(TUI)、桌面应用及IDE扩展三种运行方式。终端优先的设计让启动速度快、资源占用低,适合远程开发、服务器端调试、快速脚本编写。桌面版已推出 Beta 版,支持 macOS、Windows 和 Linux。
适合人群
OpenCode 价格方案
说明:OpenCode 本身 完全免费、MIT开源。你需要自行准备AI模型的API Key(BYOK)。但也可以通过 三条零成本路线 实现完全免费使用:① Google Gemini 免费层(每天1M tokens);② Groq 免费API;③ Ollama 本地模型(完全离线)。OpenCode 不对API调用加价,你支付的只是模型提供商的原价。
✅ 优点
- 完全免费开源:MIT协议,192K GitHub Stars,工具本身$0。
- Plan & Build双模式:先规划后执行,代码一次性通过率提升40%。
- 75+模型自由切换:不绑定任何模型厂商,BYOK自由选择。
- 隐私优先:100%本地处理,支持完全离线部署。
- 多Agent系统:专才专用,不同Agent负责不同任务阶段。
- MCP插件生态:无限扩展能力。
- 多端覆盖:终端/桌面/IDE三端可用。
⚠️ 注意事项
- 终端优先的学习曲线:需要适应TUI界面和命令行操作。
- 需自行管理API Key:需要自己申请和配置各模型的API Key。
- 免费API有速率限制:Gemini免费层每分钟15次请求。
- 依赖Node.js环境:需要Node.js 18及以上版本。
- Claude Pro限制:官方文档明确禁止将Claude Pro/Max订阅用于第三方工具。
📖 使用教程
1
安装 OpenCode
访问 opencode.ai,三种安装方式任选:npm全局安装 npm install -g opencode-ai;一键安装脚本 curl -fsSL https://opencode.ai/install | bash;或 Homebrew brew install sst/tap/opencode。需要 Node.js 18+ 环境。
2
配置AI模型(配置API Key)
OpenCode本身免费,需要配置一个AI模型的API Key。可通过环境变量配置(如 export ANTHROPIC_API_KEY=your-key),或通过 /connect 命令交互式配置。零成本可选 Gemini免费层(每天1M tokens)、Groq免费API或 Ollama本地模型(完全离线)。
3
启动 OpenCode,开始你的第一次对话
在项目目录下运行 opencode run 启动。输入自然语言需求,如"帮我创建一个 hello.txt 文件,内容是 Hello OpenCode!",Agent会自动完成。
4
Plan & Build 双模式实战
输入需求后默认进入 Plan模式,AI分析代码库并生成实施计划。确认计划无误后,按 Tab键 或输入 /build 切换至执行状态。AI开始生成Diff并写入文件。熟练使用 /init、/add、/compact 等Slash命令提升效率。
常见问题
Q:OpenCode 真的完全免费吗?
A:是的。OpenCode 本身 完全免费、MIT开源。你只需要支付所连接AI模型的API费用。还可以通过 Gemini免费层、Groq免费API或Ollama本地模型 实现零成本使用。
Q:OpenCode 和 Cursor 有什么区别?
A:OpenCode 是 免费开源的终端AI编程代理,支持75+模型自由切换;Cursor 是 $20/月的图形化IDE,将模型访问捆绑在订阅中。OpenCode 在 SWE-bench 上的综合准确率评分为 0.816,略高于 Cursor 的 0.751,而成本仅为 Cursor 的约 1/27。
Q:Plan 和 Build 模式有什么区别?
A:Plan模式 是架构师视角,不直接修改代码,而是生成自然语言的实施计划;Build模式 是工程师视角,基于Plan阶段的路径执行具体的代码编写与文件修改。采用"先Plan后Build"策略,复杂重构任务代码一次性通过率提升约 40%。
Q:OpenCode 支持哪些AI模型?
A:支持 75种以上AI模型提供商,包括 Claude、GPT、Gemini、DeepSeek、GLM、Kimi 等。也支持 本地模型 如 Ollama、LM Studio、llama.cpp。通过 BYOK 自由切换,想换就换。
Q:OpenCode 的数据会上传云端吗?
A:不会。OpenCode 采用隐私优先的设计,不存储任何代码或上下文数据。代码、对话历史、文件操作默认全部存储在本地。使用 Ollama 本地模型时可实现 完全离线运行,数据不出机器。
相关工具推荐
选择建议:OpenCode 的核心优势在于 完全免费开源 + 75+模型自由切换 + Plan/Build双模式 + 隐私优先。如需零成本、高自由度、终端优先的AI编程体验,OpenCode 是首选;如需图形化IDE和开箱即用,Cursor 更合适;如需深度Git集成,Aider 是理想之选。
✍️ NavCN 点评
OpenCode 是 AI 编程领域 "开源、自由、隐私优先"的旗帜。当大多数AI编程工具走向闭源订阅和生态绑定,OpenCode 选择了一条截然不同的路——MIT协议开源、完全免费、不绑定任何模型。它不只是另一个AI编程工具,更代表了一种"开发者主权"的理念:你拥有工具、你选择模型、你掌控数据。
OpenCode 最值得称道的是其 Plan & Build 双模式和75+模型自由切换能力。Plan模式先规划后执行,让复杂重构任务的代码一次性通过率提升约40%。75+模型支持让开发者可以自由选择最适合当前任务的模型——用Claude写复杂逻辑、用DeepSeek做算法实验、用Ollama跑本地推理,用什么模型、花多少钱,全由你决定。
当然,OpenCode 也有其适用边界——终端优先的设计意味着需要一定的命令行适应成本;BYOK模式需要自行管理API Key;免费API有速率限制。但这些"局限"恰恰是其"自由"的另一面。对于 追求工具自由、数据隐私、零成本的开发者,以及开源社区贡献者、终端爱好者 来说,OpenCode 是 当前最值得投入的AI编程工具,没有之一。
一句话总结:OpenCode——开源AI编程代理,Plan & Build双模式驱动,75+模型自由切换,隐私优先、完全免费,让编程从"付费订阅"回归"开源自由"。
