ARTICLE · 1192993
双击 exe 就能用的开源 AI 编程助手:opencode 自带免费模型,白嫖真香
聊 AI 编程工具，大家张口就是 Claude Code、Cursor。但这两个都是要花钱的：Claude Code 绑定 Anthropic 订阅或 API，Cursor 按月付费。对想「先白嫖试试」的开发者来说，门槛始终在那里。 这次聊个不一样的——opencode。一个开源 AI 编程 Agent，GitHub 上 208,000+ Star、950 位贡献者、13,000+ 提交，官方称每月有 1600 万开发者在用。它本身完全开源免费，模型任你选，Windows、macOS、Linux 全平台可用，桌面端、终端、IDE 插件三种形态都能装，而且还自带一批限时免费模型。 |
01开源的 AI 编程 Agent
一句话定位：opencode 是一个开源的 AI 编程 Agent，帮你在终端、IDE 或桌面端写代码。
它的能力很具体：你用自然语言描述需求，它自动读写文件、执行命令、修改代码——相当于一个住在你电脑里的 AI 程序员。
🔓 开源：代码完全公开，可以自己审计、自己部署 🔀 模型任选：不绑定任何一家厂商，支持 DeepSeek 等国内模型，也支持本地模型 🖥️ 三端形态：桌面应用、终端命令行、IDE 插件 🎁 自带免费模型：内置一批限时免费模型，装完开箱即用，不需要登录 🔒 隐私友好：代码数据默认保存在本机，用本地模型可以完全离线 |
02Windows / macOS / Linux 都能装
这是很多人忽略的部分——opencode 并不是只有终端版。按你的习惯选一种，装一个就够了。
⚠️ 一个重要前置：IDE 插件本身不包含命令行工具，用插件前必须先装好命令行版本。桌面端安装包约 100MB，各平台都有。 |
🪟 Windows 安装
| 桌面版（Beta，最省事） 1. 下载 2. 默认安装到 C 盘，整个过程无需手动操作，耐心等待即可 3. 装完桌面会出现 OpenCode 快捷图标，界面自动弹出 |
| 命令版 装了 Node.js 的话，国内推荐走镜像源： npm i -g opencode-ai@latest --registry=https://registry.npmmirror.com 或者用包管理器： 装完在命令行输入 |
🍎 macOS 安装
| 桌面版 按芯片（Apple Silicon / Intel）选对应 dmg，双击打开后，把 OpenCode 图标直接拖进「应用程序」文件夹即可。 命令版brewinstallopencode 官方更推荐用他们自己的 tap（更新更及时）： curl-fsSL https://opencode.ai/install | bash 脚本会自动下载安装，不需要 root 权限，装完 opencode 位于用户目录下。重新打开一个终端就能用。 注意版本区别：这个脚本装的是 OpenCode 1；官网首页给出的 |
🐧 Linux 安装
| 桌面版 Debian / Ubuntu 下载 deb 包，执行 最省事的方式是脚本安装： curl-fsSL https://opencode.ai/install | bash Arch 系用户执行 |
🧩 IDE 插件
opencode 可以集成到 VS Code、Cursor、Windsurf、VSCodium 等主流编辑器（其他支持终端的 IDE 一般也能用）。以 VS Code 为例： 1. 先装命令行版本（Windows 上用 npm / scoop / choco 任选其一） 2. 在 VS Code 扩展市场搜索 OpenCode，选第一个，点击 Install 3. 点击侧边栏的 OpenCode 按钮打开面板，或直接在集成终端里输入 opencode 启动 |
装好后用法和终端版完全一样：描述需求、让 AI 改代码、检查改动，不需要额外学习成本。
🔑 配置模型：什么都不填也能先用起来
opencode 本身不含 AI 模型，但内置了免费模型，安装后不用配置任何东西就能直接体验。 先用免费模型：不填任何 key，直接选内置免费模型，熟悉「用自然语言让 AI 写代码」的用法 换云端模型：在模型选择界面选提供商，需要 API Key 的按提示填入，按实际用量计费（DeepSeek 等国内模型都在列表里） 接本地模型：先装好 Ollama 并下载一个模型（比如 qwen3、llama3），然后在模型列表里选本地模型，完全离线使用，代码数据不出本机 |
03七个核心特性：它到底强在哪
| ① LSP 自动加载 opencode 会自动为 LLM 加载合适的 Language Server。意思是：Agent 不只是「读文本」，它能拿到真实的代码跳转、类型定义、引用关系——这让它的代码理解比纯文本拼接的 Agent 准得多。 |
| ② 多会话并行 同一个项目里可以同时开多个 Agent 并行干活。一个改前端、一个补测试、一个查文档，互不干扰。这对「一个需求拆三份同时推进」的场景非常实用，会话列表点一下就能切换。 |
| ③ 会话分享链接 任何会话都可以生成一个分享链接，方便别人参考或帮你 Debug。团队里「复现一个问题」的成本被降到最低。 |
| ④ 直接登录你已有的订阅 这是最香的一点。如果你已经有 GitHub Copilot 或 ChatGPT Plus/Pro，/connect 里直接登录就能用，零额外配置。等于花一份订阅的钱，换一个开源 Agent 来驱动。 |
| ⑤ 75+ 模型提供商 通过 AI SDK 和 Models.dev，opencode 支持 75+ 个 LLM 提供商，覆盖云厂商（Amazon Bedrock、Google Vertex、Azure）、模型厂商（Anthropic、OpenAI、DeepSeek、Moonshot、MiniMax、Groq、NVIDIA）、聚合网关（302.AI、Helicone、Eden AI），以及本地模型。 |
| ⑥ 桌面 / 终端 / IDE 三端 前面讲透了，这里再强调一次：这不是一个只能蹲终端的工具。图形界面党有桌面版，VS Code 用户有插件，习惯终端的照旧用 TUI。 |
| ⑦ 一套成熟的交互设计 Plan / Build 双模式：按 Tab 切换。Plan 模式只出方案不动代码，想清楚再让它动手 /init：一键分析项目并生成 AGENTS.md，让 Agent 真正理解你的代码规范（建议提交进 Git） @ 文件模糊搜索：直接引用项目里的文件来提问，Agent 会优先读取 /undo 和 /redo：改坏了？一键回滚，可以连续撤销多步 主题、键位、格式化器、自定义命令全都可以配 |
04免费模型：内置即用
这是本次的重点。先把两件事分清楚，不然后面会绕晕：
内置免费模型：opencode 自带的一批限时免费模型，装完直接能在模型列表里选，不需要登录、不需要绑卡。 OpenCode Console（原 Zen）：opencode 团队运营的 AI 模型网关，一个「验证过才上架」的模型目录。免费模型的名单也在这个文档里维护；想拿 API key 换更稳定的额度时，才会用到它。 |
两者不是一回事：前者开箱即用，后者是可选的进阶路径。Console 解决的是什么问题？模型很多，但真正适合当 coding agent 的没几个；而且同一个模型走不同网关，效果可能完全不一样。官方直接帮你筛好了。
| Console 的四条设计原则（我很认同） 1. Benchmark：只收录实测适合编程 Agent 的模型和提供商组合 2. 不降级：不做偷偷路由到便宜供应商这种操作 3. 按成本卖：售价基本等于成本，只加一点手续费 4. 无锁定：Console 可以配任何编程 Agent 用；opencode 也照样能接任何其他提供商 |
如果你想拿 Console 的 API key（可选的进阶步骤），三步搞定。在 TUI 或桌面端里输入：
/connect选择 opencode 提供商，跳转 opencode.ai/auth 登录、充值、复制 API key 粘贴进去。然后选模型：
/models模型在配置里的写法是 opencode/<模型ID>，比如：
{"$schema": "https://opencode.ai/config.json","model": "opencode/gpt-5.5"}
想看当前全部可用模型，直接拉官方接口：
curlhttps://opencode.ai/inference/v1/models
当前 13 个限时免费模型
以下模型输入、输出、缓存读取全部免费（限时，随时可能增减，以 /models 实际列表为准）：
| ⚠️ 三个必须提醒的坑 第一，免费是有条件的。大部分免费模型在免费期内收集的数据可能被用于改进模型；Nemotron 三个跑在 NVIDIA 试用端点上，官方明确说不要提交个人或机密数据，使用过程会被记录。真正「零保留、不训练」的只有 Space Bunny Free、DeepSeek V4.1 Flash Free、LongCat 2.5 Preview Free 这几个。 第二，别用免费模型处理敏感代码。公司项目、含密钥的代码，宁可花钱用零保留的付费模型，或者干脆本地跑。 |
免费模型的额度：官方不公布数字，但确实有上限
这一节要说清楚，因为它既是最大的福利，也最容易让人误会。
| ① 不需要登录、不需要绑卡、不需要 API Key opencode 内置了一批免费模型，装完直接就能用。官网首页写的就是「内置免费模型，或连接任意提供商的任意模型」。我在 Windows 桌面端上实测过：设置里 Providers 显示「No connected providers」，免费模型照样能正常对话。所以「先绑卡才能用」那套流程，针对的是 Console 按量付费那条路径，跟内置免费模型是两回事。 |
| ② 额度确实存在，而官方没有公布具体数字 官方文档对免费模型只标注「输入 / 输出 / 缓存读取 Free」和「限时提供」，没有给出任何按请求数或 token 数的配额——官方在介绍 Muse Spark 免费版时也明确说过「未公布使用上限」。但免费模型是按 IP 维度限流的：同一个网络出口下所有人共享额度，这也是为什么你会看到「额度超限」或 rate limited 的提示。 |
| ③ 我实测到的量级供参考 在 Windows 桌面端连续使用的情况下，每天大约 1.8 亿 token 会触发额度超限提示。这只是我的单次观察，不同网络环境、不同模型、不同时间都可能不一样，不要当成官方规格。它的意义在于给你个心理预期：免费额度足够日常开发和练手用，但不适合长时间连续跑批量任务。 |
| ④ 超额之后会怎样 通常表现为请求被拒或提示 rate limited。几种应对方式：换一个免费模型试试（不同模型的额度是分开算的）、等额度重置、或者登录 Console 拿 API Key 走付费通道。 |
| ⑤ 免费模型还有两个「附加条件」 限时，且名单每月轮换：官方措辞是 free for a limited time，没给固定结束日期，但名单确实在换——这个月有 Big Pickle，上个月是 Grok Code Fast 1、GLM 4.7。隐身模型还可能突然下线不响应。 部分模型有风控记录：Nemotron 三个跑在 NVIDIA 试用端点，官方明确写着 use is logged（使用会被记录），这类端点通常也有更严格的调用限制。 |
| ⑥ 付费侧的额度控制工具倒是很明确 Auto-reload：余额低于 $5 自动充值 $20，额度可改，也可以完全关闭 月度上限：可以给整个 workspace 和每个成员分别设上限（比如设 $20/月，一个月内就不超过 $20） 注意两者叠加的坑：官方原文提醒过——即使设了 $20 月度上限，如果同时开着自动充值，余额跌破 $5 时仍可能扣超过 $20。想真正控住成本，关掉自动充值 + 设月度上限是最稳的组合 |
顺带提醒：网上流传的「每天 100 次」「每天 700-1400 次调用」这类具体数字，都来自第三方社区站，官方文档里并不存在（连它们描述的 zen-default / zen-advanced / zen-fast 三档模型都是虚构的）。引用前最好先核对官方文档。 |
05付费模型多少钱：部分价格参考
Console 按量付费，价格单位是每百万 token。挑几个有代表性的：
🎯 Gemini 4 Argon 五折，优惠持续到 2026 年 11 月 30 日（折后 $2.00 / $10.00） 💳 信用卡手续费按成本转嫁：4.4% + 每笔 $0.30，官方不加价 📝 会话标题会用便宜模型生成：用量记录里看到 Haiku、Nano、Flash 这类消费，是自动生成会话标题，不是出错 🔁 余额低于 $5 会自动充值 $20，可以在设置里改额度或关掉 👥 团队版支持月度预算上限、按成员限额、按需启停模型 |
除了按量付费，官方还有 OpenCode Go——一个低价订阅计划，提供主流开源编程模型的稳定访问。
06四条路线：总有一种适合你
| 路线 A：纯白嫖（免费模型） 装完什么都不填，直接用内置免费模型。适合学习、练手、跑 demo。前提是接受数据可能被收集。 |
| 路线 B：用已有订阅（零额外成本） 已有 GitHub Copilot 或 ChatGPT Plus/Pro 的话，/connect 直接登录即可，部分模型可能需要 Pro+ 订阅。这是性价比最高的一条路——花一份钱，换个开源 Agent 用。 |
| 路线 C：自有 API key Anthropic、OpenAI、DeepSeek、Moonshot、MiniMax、Groq、NVIDIA 等 75+ 提供商，/connect 填 key 就行。也支持在 opencode.json 里自定义 OpenAI 兼容端点、自定义 headers、模型黑白名单。 |
| 路线 D：完全本地，一分钱不花 先装 Ollama 并下载模型（推荐 Qwen-Coder、DeepSeek-Coder 这类工具调用能力强的 coder 模型），再在 opencode 的模型列表里选本地模型。Ollama 较新版本有一条命令可以直接配好启动： ollamalaunchopencode |
| ⚠️ 本地模型有个著名的坑 Ollama 默认按显存给上下文长度——显存小于 24GB 默认只给 4K。而编程 Agent 至少需要 64K 上下文，否则会出现「工具调用失败、刚读的文件就忘、反复循环」这类像坏了一样的症状。 修复方法：Ollama 设置里把上下文长度拉到 64K，或者命令行启动时指定： OLLAMA_CONTEXT_LENGTH=64000ollamaserve 然后用 ollama ps 确认实际分配的上下文档位。 |
另一个提醒：Anthropic 明确禁止通过第三方插件使用 Claude Pro/Max 订阅，opencode 从 1.3.0 起也不再内置这类插件。如果你看到某个教程教你用 Pro 订阅登 Claude，那是过时信息。
07上手：五步跑起来
第一步，装一个形态。图形界面选桌面版，终端党用脚本或包管理器，VS Code 用户记得先装命令行版再用插件。 |
第二步，接模型。桌面版打开界面后选择项目文件夹；命令版在项目根目录打开终端输入 opencode。然后 /connect 选提供商——没有 key 就先用免费模型。 |
第三步，初始化项目。输入： /init它会分析你的项目并生成 AGENTS.md。建议把这个文件提交进 Git——这是 Agent 理解你项目规范的核心依据。 |
第四步，用 @ 精准提问。说得越具体越好： How is authentication handled in @packages/functions/src/api/index.ts |
第五步，先 Plan 再 Build。按 Tab 切到 Plan 模式描述需求，等它出方案、你反复修正，满意了再按 Tab 切回 Build 模式说「Sounds good! Go ahead」。改坏了不慌：/undo 回滚，/redo 重做。 |
| ⚠️ 新手最重要的两条提醒 1. AI 改代码前，重要项目先 git 提交一版或者备份一下。这是最便宜的保险。 2. AI 改完后会列出改动让你逐个确认，看清楚再点接受，不要一股脑全部应用。把 AI 当成一个需要 review 的同事，而不是自动改动的脚本。 |
注意：OpenCode 1 和 2 都用 opencode 命令，默认情况下不能共存安装。从 v1 迁移到 v2 参考官方 v2 文档。
08和 Claude Code、Cursor 怎么选
| 我的建议 🎯 想零成本入门 AI 编程 → opencode + 免费模型，或者 opencode + 已有 Copilot 订阅 🖥️ 不想碰命令行 → opencode 桌面端，双击 exe 就能用，比装 WSL 简单 🏢 公司报销、追求稳定省心 → Claude Code 或 Cursor，生态成熟、踩坑成本低 🔒 数据敏感、必须本地 → opencode + Ollama/LM Studio，这是它相对封闭竞品最大的优势 ⚡ 重度 Agent 用户 → 三个都可以装，opencode 的多会话并行和 /undo 是真实提效点 |
09写在最后
三个判断：
一是「开源 Agent + 自营模型网关 + 多形态覆盖」这个组合正在成为新范式。opencode 把最难的「模型选型」问题替用户解决了，用免费模型降低了尝试门槛，还把桌面端、终端、IDE 全覆盖了——这比单纯开源一个终端壳子有价值得多。 二是免费模型的正确用法是「试」而不是「用」。数据可能被收集、限时、随时下线。拿来学习、验证想法、跑 demo 很香；公司代码和敏感数据，请用零保留的付费模型或本地部署。 三是别忘了 git。AI 编程工具再聪明也是工具，改你的代码之前先提交一版，这是最便宜的安全带。 |
如果你还没试过 AI 编程，从 opencode 开始是个不错的切入点——它有桌面端、有中文模型、有免费模型，数据还能完全不出本机。
官网：https://opencode.ai GitHub 仓库：https://github.com/anomalyco/opencode 文档：https://opencode.ai/docs 桌面版下载：https://opencode.ai/download 模型列表接口：https://opencode.ai/inference/v1/models |
开源 · 免费模型 · 75+ 提供商 · 桌面/终端/IDE 全平台opencode，值得每个开发者试一次。⭐ |
