OpenCode 是由 SST 团队开发、于 2025 年 4 月开源的 AI 编程 Agent，截至 2026 年 8 月 GitHub 累计 192,000+ ★，npm 包 opencode-ai 单周下载量超 200 万次，超过 Codex（openai/codex，103K ★）约 86%。它的核心卖点是「不绑定任何模型、提供免费使用路线」——通过接入 Google Gemini 免费层、Groq 免费 API 或本地 Ollama，可以做到零成本 AI 编程；同时也支持 Claude、GPT、DeepSeek 等 75+ 个付费 Provider，BYOK（自带 API Key）即可切换。本文覆盖三条免费使用路线、完整安装配置流程，以及 OpenCode / Codex / Claude Code 三方在真实开发场景下的选型依据。

  

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

OpenCode 和 Codex 的表面功能很相似——都是终端里运行的 AI 编程 Agent，都能读写文件、执行命令、帮你写代码和调 bug。但两者的底层逻辑不同：

Codex（openai/codex） 是 OpenAI 官方发布的轻量编程 Agent，强绑定 OpenAI 的模型和订阅体系。用 GPT-5.6 系列，享受 OpenAI 的工具调用和沙箱能力，但需要 OpenAI API Key，按用量计费。

OpenCode 的设计哲学是「不预设模型」。它是一个 Agent 框架，你决定用哪个模型——可以填自己的 API Key，也可以选内置的免费 Provider，甚至完全离线跑本地模型。MIT 协议开源，代码可审计，不经过任何中间服务器。

这个差异决定了两类用户的分流：有 OpenAI 订阅、追求开箱即用的开发者倾向 Codex；需要控制成本、希望自由切换模型、或者对数据隐私有要求的开发者倾向 OpenCode。

最新版本 v1.18.11（2026 年 8 月 1 日发布）修复了 MCP SSE 连接在服务器报错后陷入重连循环的问题，并新增了 Modal 等 Provider 接入文档。

 

三条免费使用路线

OpenCode 的「免费」不是营销话术，而是有具体路线可以走通的。

路线一：Google Gemini 免费层（推荐，最简单）

Google 的 Gemini 模型提供免费 API 层（Free tier），每天可以调用 1M tokens（Gemini 1.5 Flash），完全够个人开发者日常使用。

配置步骤：

1. 到 aistudio.google.com 免费申请一个 Gemini API Key（不需要信用卡）

2. 安装 OpenCode 后执行 /connect，选择 Google 作为 Provider

3. 填入 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，不联网。

# 先安装 Ollama
curl -fsSL https://ollama.ai/install.sh | sh
 
# 下载一个编程模型（qwen2.5-coder 14B，约 9GB）
ollama pull qwen2.5-coder:14b
 
# OpenCode 会自动检测本地 Ollama 服务
opencode

14B 参数的编程模型在 16GB 内存的 MacBook 上可以流畅运行，代码补全和简单重构够用，复杂多文件推理会比云端模型慢。32B 及以上的模型需要 32GB 内存以上或独立 GPU。

 

安装：一行命令还是多种包管理器

OpenCode 提供多种安装方式，选最顺手的即可：

 

# 一键安装脚本（macOS / Linux）
curl -fsSL https://opencode.ai/install | bash
 
# npm / pnpm / bun / yarn
npm i -g opencode-ai@latest
 
# macOS（Homebrew，推荐，自动更新）
brew install anomalyco/tap/opencode
 
# Windows（Scoop）
scoop install opencode
 
# Windows（Chocolatey）
choco install opencode
 
# Arch Linux
sudo pacman -S opencode        # 稳定版
paru -S opencode-bin           # AUR 最新版

安装完成后直接在任意项目目录执行 opencode，首次启动会引导你配置 Provider。

桌面端（Beta）：OpenCode 也提供图形界面桌面应用，支持 macOS（Apple Silicon / Intel）、Windows 和 Linux（.deb / .rpm / .AppImage）。从 opencode.ai/download 下载，或：

 

# macOS
brew install --cask opencode-desktop
# Windows
scoop bucket add extras; scoop install extras/opencode-desktop

两个内置 Agent：build 和 plan

OpenCode 内置两个可以用 Tab 键切换的 Agent，对应不同工作阶段：

build（默认）：完整开发权限，可读写文件、执行 bash 命令，适合实际编码、调 bug、重构。

plan（只读）：默认拒绝文件修改，执行 bash 命令需确认。适合在改代码之前先让 AI 分析代码库、制定方案，不会引入意外改动。

实际使用建议：进入一个陌生代码库时，先用 plan 模式让 AI 解释结构和关键逻辑，确认理解后再切换 build 开始修改。这样比上来就让 AI 改代码安全得多。

此外还有一个内部子 Agent general，用于复杂搜索和多步任务，可在对话中用 @general 显式调用。

 

OpenCode vs Codex vs Claude Code：怎么选

三个工具在开发者社区已经有相当多的横向对比，以下基于公开基准和社区实测整理核心差异：

维度

OpenCode

Codex

Claude Code

费用

免费路线可用（Gemini/Groq/Ollama）

需 OpenAI API 或订阅

需 Claude 订阅（$20/月起）

GitHub ★

192K+

103K

~140K

npm 周下载

约 200 万次

—

约 1000 万次（领先 5x）

模型绑定

无，75+ Provider

OpenAI 优先

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）。

 

常见问题

Q：OpenCode 完全免费吗？

OpenCode 本身是 MIT 协议开源软件，永久免费。「免费使用」取决于你选的模型 Provider——Gemini 免费层、Groq 免费层、Ollama 本地模型都可以做到零成本；如果接入 Claude / GPT / DeepSeek 等付费模型，按对应 Provider 的 API 计费，跟使用 OpenCode 本身无关。Q：OpenCode 和 Codex 哪个编程能力更强？

能力取决于背后的模型。OpenCode 接 Claude Opus 4.7，其 SWE-bench Pro 成绩（64.3%）高于 Codex 接 GPT-5.5 的成绩（58.6%）；接 Gemini Flash 免费版则弱于两者。也就是说，OpenCode 是框架，模型才是能力的决定因素。Q：OpenCode 支持哪些编辑器？

终端版不依赖编辑器，直接在项目目录运行。官方也提供 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+ Provider，BYOK 即可切换）。192K ★ 的数字不是靠炒作堆出来的——在同类工具里它是星数最高的，npm 单周 200 万次下载说明实际使用者已经形成规模。

Codex 和 Claude Code 的优势在于原生模型质量和更高的 SWE-bench 成绩。如果你有订阅预算、追求开箱即用，它们仍然是更省心的选择。但如果你想在 AI 编程上做到成本可控、模型可替换，OpenCode 目前是最完整的免费路线。

数据来源：GitHub 仓库 sst/opencode（2026 年 8 月 3 日）、npmjs.com opencode-ai 下载量（2026 年 8 月）、tech-insider.org OpenCode vs Claude Code 对比报告（2026 年）、MarkTechPost 编程 Agent 基准对比（2026 年）。

 

延伸阅读

● OpenCode 官方文档：opencode.ai/docs

● OpenCode 安装下载：opencode.ai/download

● OpenCode GitHub 仓库：github.com/sst/opencode

● Token Plan（配合 OpenCode 使用）：https://www.qiniu.com/ai/plan