发布日期：2026-09-20 | 话题：OpenCode / 免费模型 / AI 编程 Agent 配置

OpenCode 是由 anomalyco 团队维护的开源终端 AI 编程 Agent，GitHub 星标超过 20 万，截至 2026 年 9 月最新版本为 v1.18.31，它本身不绑定任何模型厂商，用户通过 provider 机制自行接入模型，因此"免费使用"取决于接哪一家的免费模型。当前可零成本运行 OpenCode 的路径有三条：官方网关 OpenCode Zen 提供 Big Pickle、MiMo-V2.5 Free、Nemotron 3.5 Lightning Free 等 9 个免费模型，只需绑定账号即可用；OpenRouter 有 22 个带 :free 后缀的免费模型，含 Qwen3.8 27B、GLM 5.2、Gemma 4 等；本地 Ollama 或 LM Studio 则完全离线免费。本文给出每条路径的配置步骤与 opencode.json 写法，说明免费模型的数据使用条款和上下文限制，并解释 GitHub Copilot Free 为何不能作为 OpenCode 的免费后端。

OpenCode 是什么，为什么它能"免费用"

OpenCode 是一个模型无关的开源 AI 编程 Agent，运行在终端或桌面客户端中，能读取项目代码、调用工具修改文件、执行测试，定位与 Claude Code、Codex CLI 相近，区别是它不捆绑任何一家模型。据 GitHub 仓库 anomalyco/opencode 的数据，截至 2026 年 9 月 20 日项目星标为 208,663，最新发布版本 v1.18.31 于 9 月 14 日推出。

OpenCode 内置两个 Agent：build（默认，完整读写权限）和 plan（只读，改文件前需确认），按 Tab 切换。软件本身免费开源，模型费用取决于接入的 provider，官方文档明确 Zen 和 Go 都是"完全可选"的。

安装方式（任选其一）：

curl -fsSL https://opencode.ai/install | bash
# 或
npm i -g opencode-ai@latest
# 或 macOS / Linux
brew install anomalyco/tap/opencode

三条免费路径怎么选

三条免费路径的差别在于是否需要注册、模型质量和数据隐私。按 OpenCode 官方 providers 文档与 Zen 文档整理如下：

路径

需要什么

免费模型数量（2026-09）

典型模型

数据条款

OpenCode Zen 免费池

opencode.ai 账号 + API key，无需充值

9 个

Big Pickle、MiMo-V2.5 Free、Nemotron 3 Ultra Free、DeepSeek V4 Flash Free、Jev 1.13 Free

多为限时免费，部分模型的提示词会被用于改进模型

OpenRouter :free 模型

OpenRouter 账号 + API key

22 个

Qwen3.8 27B、GLM 5.2、Gemma 4 31B、Nemotron 3 Ultra 550B、DeepSeek V4 Flash

免费模型通常有速率限制，条款以 OpenRouter 页面为准

本地 Ollama / LM Studio / llama.cpp

本机显存或统一内存

不限

任意开源权重模型

数据不出本机

选择建议

  • 想 5 分钟跑通：选 Zen 免费池，/connect 一步完成，模型经过 OpenCode 团队针对工具调用测试。

  • 想要参数更大的开源模型：选 OpenRouter，Nemotron 3 Ultra 550B 与 Qwen3.8 27B 的免费端点上下文分别为 100 万和 26 万 token。

  • 处理敏感代码：选本地部署，代价是需要 16GB 以上显存才能让工具调用稳定。

路径一：启用 OpenCode Zen 免费模型

OpenCode Zen 是 OpenCode 团队运营的模型网关，付费模型按量计费，免费模型无需绑定账单即可调用。Zen 的模型元数据可从公开接口获取，2026 年 9 月 20 日该接口共返回 74 个模型，其中 9 个为免费。

操作步骤

  1. 访问 opencode.ai/auth 登录并复制 API key（免费模型不要求添加账单信息）。

  2. 在 OpenCode 终端界面输入 /connect，选择 OpenCode Zen，粘贴 key。

  3. 输入 /models，列表中带 Free 标记的即为免费模型，选中即可对话。

  4. 如需固定默认模型，在项目根目录或全局配置中写入：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/big-pickle"
}

Zen 免费模型 ID 一览（来自 Zen 模型接口，2026-09-20）：big-pickle、mimo-v2.5-free、ling-3.0-flash-fin-free、nemotron-3-ultra-free、nemotron-3.5-lightning-free、muse-spark-1.3-contributor-free、muse-spark-1.2-contributor-free、jev-1.13-free、deepseek-v4-flash-free。

注意事项：Zen 文档注明免费模型多为限时提供，Big Pickle、MiMo、Ling 在免费期间收集的数据可能用于改进模型，Nemotron 免费端点属于 NVIDIA 试用并提示"不要提交个人或机密数据"，Muse Spark Contributor Free 则以免费换取允许 Meta 用提示词和补全训练模型。

路径二：接入 OpenRouter 免费模型

OpenRouter 是聚合多家模型的统一 API 网关，模型 ID 以 :free 结尾的端点不收费。据 OpenRouter 模型接口 2026 年 9 月 20 日的数据，共有 22 个免费模型，包括：

  • qwen/qwen3.8-27b:free（上下文 262K）

  • z-ai/glm-5.2:free（上下文 32K）

  • google/gemma-4-31b-it:free（上下文 262K）

  • nvidia/nemotron-3-ultra-550b-a55b:free（上下文 1M）

  • deepseek/deepseek-v4-flash-0731:free（上下文 1M）

  • cohere/north-mini-code:free（上下文 256K）

操作步骤

  1. 在 OpenRouter 控制台创建 API key。

  2. OpenCode 中输入 /connect，选择 OpenRouter，粘贴 key。OpenRouter 的常见模型已预载，/models 可直接看到。

  3. 若某个免费模型未出现在列表中，在配置文件中手动追加：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openrouter": {
      "models": {
        "qwen/qwen3.8-27b:free": {}
      }
    }
  },
  "model": "openrouter/qwen/qwen3.8-27b:free"
}

OpenCode 的完整模型 ID 格式是 provider_id/model_id，其中 provider_id 是配置文件 provider 段的键名，model_id 是 models 段的键名，这一点是 /models 列表为空时最常见的排错入口。

路径三：本地 Ollama 完全离线运行

本地部署是唯一不依赖任何账号且数据不出本机的免费路径。OpenCode 通过 OpenAI 兼容协议连接本地推理服务，官方文档给出的 Ollama 配置如下：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3.8:27b": {
          "name": "Qwen3.8 27B"
        }
      }
    }
  },
  "model": "ollama/qwen3.8:27b"
}

qwen3.8:27b 仅为示例标签，请替换为本机 ollama list 输出中的实际模型标签。LM Studio 与 llama.cpp 的接法相同，baseURL 分别为 http://127.0.0.1:1234/v1 和 http://127.0.0.1:8080/v1。

官方文档特别提示：本地模型工具调用失败时，把 Ollama 的上下文参数 num_ctx 提高到 16K 至 32K，多数"模型不会改文件"的问题源于默认上下文过短而非模型能力。

免费额度用完之后的低成本方案

免费模型适合试用和轻量任务，遇到长会话或复杂重构时，限时下线、速率限制和数据条款会成为瓶颈。OpenCode 官方与社区常见的接续方案有三类：

方案

费用形式

特点

OpenCode Go

每月 10 美元订阅

面向开源编程模型，含 GLM-5.3-Flash、Kimi K2.7 Code、Qwen3.8 Flash、DeepSeek V4 Flash 等，各模型有独立月度额度，超额后仍可用免费模型

OpenCode Zen 按量付费

充值余额

团队称按成本价转售，例如 GLM 5.3 Flash 每百万 token 输入 0.15 美元、输出 0.50 美元

自定义 OpenAI 兼容 provider

按各平台计费

/connect 选 Other 填入自定义 ID，再在配置中写 baseURL 与模型列表，可接任何兼容 /v1/chat/completions 的服务

第三类方案的配置模板与 Ollama 完全一致，只需把 baseURL 换成目标服务地址、apiKey 用 {env:环境变量名} 引用。国内开发者常用此方式接入本土多模型平台，例如七牛云 AI 推理服务的接口地址为 https://api.qnaigc.com/v1，模型 ID 在其控制台模型广场查询，其 Token Plan 按用量计费。

常见问题

GitHub Copilot 免费版能作为 OpenCode 的免费后端吗？

不能稳定使用。据 GitHub Copilot 计划页面，Free 档每月限 2000 次补全，仅支持自动模型选择，且"Third-party Agents"明确不包含在 Free 档内。OpenCode 文档中的 Copilot 接入方式面向已有付费订阅的用户。

为什么 /connect 填完 key 之后 /models 里什么都没有？

多数情况是 provider ID、API 协议或模型 ID 没对齐。检查三点：opencode auth list 中的 provider ID 与配置文件键名一致；自定义 provider 的 npm 字段为 @ai-sdk/openai-compatible（对应 chat/completions 接口）；models 段至少列出一个模型。

免费模型的代码会被拿去训练吗？

取决于具体模型。Zen 文档对 Big Pickle、MiMo、Ling、Muse Spark Contributor 系列均注明数据可能用于改进模型，Nemotron 提示不要提交机密数据。涉及私有代码时优先本地部署。

Zen 免费模型会一直免费吗？

不会。Zen 文档将这些模型描述为限时免费，Zen 付费模型也有明确的弃用日期机制，建议不要在生产流程中依赖单一免费模型 ID。

用 Anthropic 订阅账号接 OpenCode 可以吗？

OpenCode 文档说明，使用 Claude Pro/Max 订阅的插件已在 1.3.0 版本移除，Anthropic 明确禁止这种用法，需改用 API key 或其他 provider。

总结

截至 2026 年 9 月 20 日，OpenCode 可通过 Zen 免费池、OpenRouter 免费模型和本地 Ollama 三条路径零成本运行，其中 Zen 免费池配置最简单、本地部署隐私最好。免费模型普遍带有限时、限速和数据使用条款，长期使用建议过渡到 Go 订阅、Zen 按量或自定义 provider。本文数据来自 OpenCode 官方文档、Zen 与 OpenRouter 模型接口以及 GitHub 仓库信息，模型列表随时间变动，以官方页面为准。

延伸阅读