OpenCode 完全指南：192K星免费AI编程Agent，三条零成本路线实测

OpenCode是什么：不是Codex的克隆，是另一条路

OpenCode 是由 SST 团队开发、于2025年4月开源的AI编程Agent。截至2026年8月，GitHub累计192,000+星，npm包 opencode-ai 单周下载量超200万次，在同类工具中星数最高。其核心卖点是"不绑定任何模型、提供免费使用路线"——通过接入 Google Gemini 免费层、Groq 免费 API 或本地 Ollama，可以做到零成本 AI 编程。

与 OpenAI Codex（强绑定 OpenAI 模型和订阅体系）不同，OpenCode 是一个 Agent 框架，你决定用哪个模型。MIT 协议开源，代码可审计，不经过任何中间服务器。最新版本 v1.18.11 修复了 MCP SSE 连接重连循环问题，并新增 Modal 等 Provider 接入文档。

OpenCode在两件事上有明确优势：免费路线可走通（Gemini / Groq / Ollama三条路均有实测），以及模型不锁定（75+ Provider，BYOK即可切换）。192K星不是靠炒作堆出来的。

三条零成本路线实测

路线一：Google Gemini 免费层（推荐，最简单）。到 aistudio.google.com 免费申请 Gemini API Key（无需信用卡），安装 OpenCode 后执行 /connect，选择 Google 作为 Provider，填入 Key，选择 gemini-1.5-flash 作为默认模型。免费层每天可调用 1M tokens，每分钟15次请求，完全够个人开发者日常使用。

路线二：Groq 免费 API（最快，适合高频调用）。Groq 基于自家 LPU 芯片做推理，速度比多数托管服务快3-5倍。免费层没有严格的 token 总量限制，只有速率限制。从 console.groq.com 申请免费 Key，在 /connect 里选 Groq 即可，支持 LLaMA 3.3 70B、DeepSeek R2 等开源模型。

路线三：Ollama 本地模型（完全离线，数据不出机器）。对数据隐私要求严格的场景，Ollama 是最彻底的方案。安装后执行 ollama pull qwen2.5-coder:14b，14B 参数模型在 16GB 内存的 MacBook 上可流畅运行，代码补全和简单重构够用。32B 及以上模型需要 32GB 内存或独立 GPU。

OpenCode vs Codex vs Claude Code：怎么选

三个工具各有优势场景。OpenCode 适合预算有限、需要免费路线或数据隐私要求的开发者，支持 75+ Provider 和离线使用；Codex 适合已有 OpenAI 订阅、追求开箱即用的用户；Claude Code 在长上下文、跨文件修改的复杂任务上 SWE-bench Pro 成绩最高（Claude Opus 4.7 达 64.3%）。关键认知：OpenCode 是框架，模型才是能力的决定因素——接 Claude Opus 4.7 时 SWE-bench 成绩也达到 64.3%。

内置两个 Agent 模式值得注意：build 模式拥有完整读写和命令执行权限，适合实际编码；plan 模式默认拒绝文件修改，适合先让 AI 分析代码库、制定方案后再动手，安全性更高。进入陌生代码库时先用 plan 模式分析，确认理解后再切换 build。