OpenCode 是由 SST 团队开发、于 2025 年 4 月开源的 AI 编程 Agent截至 2026 年 8 月 GitHub 累计 192,000 ★npm 包 opencode-ai 单周下载量超 200 万次超过 Codexopenai/codex103K ★约 86%。它的核心卖点是「不绑定任何模型、提供免费使用路线」——通过接入 Google Gemini 免费层、Groq 免费 API 或本地 Ollama可以做到零成本 AI 编程同时也支持 Claude、GPT、DeepSeek 等 75 个付费 ProviderBYOK自带 API Key即可切换。本文覆盖三条免费使用路线、完整安装配置流程以及 OpenCode / Codex / Claude Code 三方在真实开发场景下的选型依据。OpenCode 是什么不是 Codex 的克隆是另一条路OpenCode 和 Codex 的表面功能很相似——都是终端里运行的 AI 编程 Agent都能读写文件、执行命令、帮你写代码和调 bug。但两者的底层逻辑不同Codexopenai/codex是 OpenAI 官方发布的轻量编程 Agent强绑定 OpenAI 的模型和订阅体系。用 GPT-5.6 系列享受 OpenAI 的工具调用和沙箱能力但需要 OpenAI API Key按用量计费。OpenCode的设计哲学是「不预设模型」。它是一个 Agent 框架你决定用哪个模型——可以填自己的 API Key也可以选内置的免费 Provider甚至完全离线跑本地模型。MIT 协议开源代码可审计不经过任何中间服务器。这个差异决定了两类用户的分流有 OpenAI 订阅、追求开箱即用的开发者倾向 Codex需要控制成本、希望自由切换模型、或者对数据隐私有要求的开发者倾向 OpenCode。最新版本 v1.18.112026 年 8 月 1 日发布修复了 MCP SSE 连接在服务器报错后陷入重连循环的问题并新增了 Modal 等 Provider 接入文档。三条免费使用路线OpenCode 的「免费」不是营销话术而是有具体路线可以走通的。路线一Google Gemini 免费层推荐最简单Google 的 Gemini 模型提供免费 API 层Free tier每天可以调用 1M tokensGemini 1.5 Flash完全够个人开发者日常使用。配置步骤到aistudio.google.com免费申请一个 Gemini API Key不需要信用卡安装 OpenCode 后执行/connect选择 Google 作为 Provider填入 API Key选择gemini-1.5-flash作为默认模型Gemini 免费层的限制是速率每分钟 15 次请求对于单人开发基本够用连续大量调用时会碰到限速。路线二Groq 免费 API最快适合高频调用Groq 提供免费 API基于自家 LPU 芯片做推理速度比大多数托管服务快 3-5 倍免费层没有严格的 token 总量限制只有速率限制。支持 LLaMA 3.3 70B、DeepSeek R2 等开源模型。配置类似 Gemini在/connect里选 Groq填入从console.groq.com申请的免费 Key。适合需要快速响应的场景如代码自动补全类的高频调用。路线三Ollama 本地模型完全离线数据不出机器对数据隐私要求严格的场景企业内网、处理敏感代码Ollama 是最彻底的方案模型完全跑在本地不需要任何 API Key不联网。# 先安装 Ollamacurl-fsSLhttps://ollama.ai/install.sh|sh# 下载一个编程模型qwen2.5-coder 14B约 9GBollama pull qwen2.5-coder:14b# OpenCode 会自动检测本地 Ollama 服务opencode14B 参数的编程模型在 16GB 内存的 MacBook 上可以流畅运行代码补全和简单重构够用复杂多文件推理会比云端模型慢。32B 及以上的模型需要 32GB 内存以上或独立 GPU。安装一行命令还是多种包管理器OpenCode 提供多种安装方式选最顺手的即可# 一键安装脚本macOS / Linuxcurl-fsSLhttps://opencode.ai/install|bash# npm / pnpm / bun / yarnnpmi-gopencode-ailatest# macOSHomebrew推荐自动更新brewinstallanomalyco/tap/opencode# WindowsScoopscoopinstallopencode# WindowsChocolateychocoinstallopencode# Arch Linuxsudopacman-Sopencode# 稳定版paru-Sopencode-bin# AUR 最新版安装完成后直接在任意项目目录执行opencode首次启动会引导你配置 Provider。桌面端BetaOpenCode 也提供图形界面桌面应用支持 macOSApple Silicon / Intel、Windows 和 Linux.deb / .rpm / .AppImage。从opencode.ai/download下载或# macOSbrewinstall--caskopencode-desktop# Windowsscoop bucketaddextras;scoopinstallextras/opencode-desktop两个内置 Agentbuild 和 planOpenCode 内置两个可以用Tab键切换的 Agent对应不同工作阶段build默认完整开发权限可读写文件、执行 bash 命令适合实际编码、调 bug、重构。plan只读默认拒绝文件修改执行 bash 命令需确认。适合在改代码之前先让 AI 分析代码库、制定方案不会引入意外改动。实际使用建议进入一个陌生代码库时先用 plan 模式让 AI 解释结构和关键逻辑确认理解后再切换 build 开始修改。这样比上来就让 AI 改代码安全得多。此外还有一个内部子 Agentgeneral用于复杂搜索和多步任务可在对话中用general显式调用。OpenCode vs Codex vs Claude Code怎么选三个工具在开发者社区已经有相当多的横向对比以下基于公开基准和社区实测整理核心差异维度OpenCodeCodexClaude Code费用免费路线可用Gemini/Groq/Ollama需 OpenAI API 或订阅需 Claude 订阅$20/月起GitHub ★192K103K~140Knpm 周下载约 200 万次—约 1000 万次领先 5x模型绑定无75 ProviderOpenAI 优先Anthropic Claude代码库理解LSP 感知自我修正沙箱隔离安全性强长上下文多文件能力强SWE-bench 成绩依所选模型浮动GPT-5.5 → 58.6%Claude Opus 4.7 → 64.3%离线使用支持Ollama不支持不支持数据隐私本地路线完全不出网走 OpenAI 服务器走 Anthropic 服务器选 OpenCode 的场景预算有限想用 Gemini / Groq 免费层或本地模型实现零成本 AI 编程已有 DeepSeek、Qwen、Kimi 等 API Key想在 Agent 场景里复用处理企业内网代码要求数据不出本地Ollama 路线对工具链有掌控偏好不想锁定单一厂商选 Codex 的场景已经是 OpenAI Plus / Pro 订阅用户不需要额外配置任务场景以 OpenAI 模型见长的推理、代码沙箱执行为主选 Claude Code 的场景长上下文、跨文件修改的复杂任务SWE-bench Pro 成绩目前最高已有 Anthropic 订阅追求原生工具集成质量配置多个 Provider 的实际工作流OpenCode 的/connect命令可以一次性配置多个 Provider按任务类型切换使用日常轻量任务切 Groq LLaMA 3.3 70B速度快免费复杂多文件重构切 Claude Opus 4.7 或 DeepSeek V4-Flash推理能力更强敏感代码审查切 Ollama数据不出机器如果你的业务已有多个模型的 API Key 需要统一管理七牛云 AI 大模型广场支持 DeepSeek V4、Qwen 系列、Kimi K3 等多款主流模型的 API 接入国内访问稳定统一 API Key 格式可以直接配置到 OpenCode 的 Provider 设置里详见 qiniu.com/ai/models。常见问题QOpenCode 完全免费吗OpenCode 本身是 MIT 协议开源软件永久免费。「免费使用」取决于你选的模型 Provider——Gemini 免费层、Groq 免费层、Ollama 本地模型都可以做到零成本如果接入 Claude / GPT / DeepSeek 等付费模型按对应 Provider 的 API 计费跟使用 OpenCode 本身无关。QOpenCode 和 Codex 哪个编程能力更强能力取决于背后的模型。OpenCode 接 Claude Opus 4.7其 SWE-bench Pro 成绩64.3%高于 Codex 接 GPT-5.5 的成绩58.6%接 Gemini Flash 免费版则弱于两者。也就是说OpenCode 是框架模型才是能力的决定因素。QOpenCode 支持哪些编辑器终端版不依赖编辑器直接在项目目录运行。官方也提供 IDE 插件VSCode 等。桌面应用处于 Beta 阶段支持 macOS / Windows / Linux。Q本地模型能满足日常编程需求吗14B 参数模型如 qwen2.5-coder:14b在单文件编辑、代码解释、简单重构上够用复杂的多文件任务和架构推理70B 以上的模型更稳定但对硬件要求更高。Q和 Aider、Cline 相比呢OpenCode 的定位最接近 Codex 和 Claude Code——作为终端里的完整 Agent 工作而不只是代码补全。Aider 更偏 git-aware 的提交工作流Cline 更偏 VSCode 插件场景。三者功能有重叠选哪个更多看习惯和工作流。小结OpenCode 在两件事上有明确优势免费路线可走通Gemini / Groq / Ollama 三条路均有实测以及模型不锁定75 ProviderBYOK 即可切换。192K ★ 的数字不是靠炒作堆出来的——在同类工具里它是星数最高的npm 单周 200 万次下载说明实际使用者已经形成规模。Codex 和 Claude Code 的优势在于原生模型质量和更高的 SWE-bench 成绩。如果你有订阅预算、追求开箱即用它们仍然是更省心的选择。但如果你想在 AI 编程上做到成本可控、模型可替换OpenCode 目前是最完整的免费路线。数据来源GitHub 仓库 sst/opencode2026 年 8 月 3 日、npmjs.com opencode-ai 下载量2026 年 8 月、tech-insider.org OpenCode vs Claude Code 对比报告2026 年、MarkTechPost 编程 Agent 基准对比2026 年。延伸阅读OpenCode 官方文档opencode.ai/docsOpenCode 安装下载opencode.ai/downloadOpenCode GitHub 仓库github.com/sst/opencode多款主流模型 API 统一接入配合 OpenCode 使用qiniu.com/ai/models