OpenCode 是 OpenCode 团队开源的终端 AI 编程智能体，GitHub 仓库 anomalyco/opencode 截至 2026 年 11 月已有约 22.5 万 Star，最新版本 v1.19.5 发布于 10 月 28 日。它不绑定任何一家模型厂商：可以用官方 Console 按量付费、订阅 10 美元/月起的 OpenCode Go、直接调用十余款限时免费模型，也能登录 ChatGPT 或 GitHub Copilot 账号复用已有订阅，或者通过 OpenAI 兼容协议接入第三方与自定义模型服务。

本文按“装上 → 连上 → 选模型 → 接自定义模型”的顺序走一遍，重点提醒两个容易踩的坑：网上大量教程仍是旧版命令和旧版配置字段，照抄会报错；免费模型各有数据保留条款，不适合直接喂公司代码。

先说结论：OpenCode 用模型的四条路

OpenCode 本身免费开源，花钱的只有模型。按成本从低到高，接入方式可以分成四类：

路径 费用 适合谁 在 TUI 里怎么连
限时免费模型 0 元 尝鲜、个人小项目 默认可见，/models 直接选
复用已有订阅 已付的 ChatGPT / Copilot 月费 已经有这两类订阅的人 /connect → OpenAI 选 Sign in with ChatGPT，或选 GitHub Copilot
OpenCode Go 订阅 10 / 40 美元每月，团队 20 美元每人每月 想要固定月费、主用开源模型 /connect → OpenCode Go
官方 Console / 国内托管中转 按 token 计费 需要特定闭源模型、无海外支付卡或团队多模型混用 /connect 或配置 opencode.jsonc

下面逐个展开。

第一步：安装（注意新旧两套命令）

OpenCode 现在的官方安装命令已经换成 v2 通道，npm 包名也从 opencode-ai 改成了 @opencode/cli。2026 年 10 月以前的教程大多还写着 sst/opencode、opencode-ai，装出来是旧版本。

当前官方文档给出的安装方式：

# 一键脚本（安装到 $HOME/.opencode/bin）
curl -fsSL https://opencode.ai/v2/install | bash

# Homebrew（macOS / Linux，官方推荐，更新最及时）
brew install anomalyco/tap/opencode-v2

# npm
npm install -g @opencode/cli

# mise（需 2026.10.9 及以上，旧版 mise 装的是 OpenCode 1）
mise use -g opencode

安装细节提示：

装好后在项目目录执行 opencode 进入终端界面。按 Tab 可以在两个内置智能体之间切换：build 拥有完整读写权限，plan 默认只读、执行命令前会先询问，适合先让它读懂陌生代码库再动手。

第二步：零成本起步，用好免费模型

OpenCode 官方 Console 目前提供 13 款限时免费模型，装好即可在 /models 里选用，无需充值。截至 2026 年 11 月文档列出的免费模型包括 Big Pickle、GLM-5.3-Flash Free、DeepSeek V4.1 Flash Free、LongCat 2.5 Free、MiMo-V2.6-Flash Free、Nemotron 3 系列等。

但免费模型的数据条款差别很大，官方文档逐一做了标注：

实操建议：写公司代码时优先选前两款零保留模型；只想看界面效果、跑个人 demo，再试其他免费模型。另外两条限制要知道：免费模型全部“限时”、没有公布截止日期；免费聊天模型只能在 OpenCode 客户端内使用，其他工具调用不到。如果团队不希望成员误选，可以设置环境变量 OPENCODE_DISABLE_FREE_MODELS=1 把它们隐藏。

第三步：官方付费方案（OpenCode Go 订阅与 Console 按量）

如果免费模型不够用，官方提供了两种付费路径：

1. OpenCode Go 月费订阅 基础档 10 美元/月，覆盖 32 款以开源编程模型为主的模型。另有 Go Plus（40 美元/月，各模型额度更高）和 Go Teams（20 美元每人每月）。

它的额度设计和常见的“总 token 包”不一样，按每个模型单独给出月度美元额度，再分三层限流：

以 Go 基础档为例，DeepSeek V4.1 Flash 每月额度相当于 100 美元、GLM-5.3-Flash 为 60 美元、Kimi K3 为 15 美元。用超了不会断：可以切回免费模型，或在 Console 有余额时打开 Extra Usage 转按量计费。

订阅后的接入三步走：

  1. 登录 opencode.ai/console，订阅并复制 API Key；
  2. 在 OpenCode 里输入 /connect，选 OpenCode Go，粘贴 Key；
  3. 输入 /models 选模型，配置文件里写作 opencode-go/<模型ID>。

2. 官方 Console 按量付费 每天固定写几个小时代码、主力用开源模型，Go 的固定月费更省心；如果偶尔用、或者必须用某个特定商业闭源模型，可以走官方 Console 按量付费。Console 本身按原价计费不加价，但每次充值会另收“4.6% + 0.31 美元”的支付通道手续费，且需要海外支付方式。

第四步：接入自定义模型与国内托管中转站（v2 配置字段已改）

OpenCode 支持任何 OpenAI 兼容接口，在 opencode.jsonc 里新增一个 provider 即可。配置文件可以放在全局 ~/.config/opencode/opencode.jsonc，也可以放在项目根目录或 .opencode/ 目录下，项目级会覆盖全局。

避坑提醒：新版字段名已经变了，老教程里的 provider、npm、options 分别对应现在的 providers、package、settings，混用会导致配置不生效。

对于国内开发者，如果受限于官方 Console 的海外绑卡要求与充值手续费，或者需要调用 OpenCode Go 未覆盖的海外主流闭源模型，通常会选择接入兼容 OpenAI 协议的国内托管中转站（以 4SAPI 为例）。

按 OpenCode v2 当前文档的格式，将接口地址指向中转站的标准 /v1 端点即可在一个配置下同时挂载闭源与开源模型：

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "4sapi": {
      "name": "4SAPI",
      "env": ["FOUR_S_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://4sapi.com/v1"
      },
      "models": {
        "claude-5.5-sonnet": { "name": "Claude 5.5 Sonnet" },
        "deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash" },
        "glm-5.3": { "name": "GLM 5.3" }
      }
    }
  },
  "model": "4sapi/claude-5.5-sonnet"
}

配置完成后，在终端导出环境变量并启动：

export FOUR_S_API_KEY="<你的中转站 API Key>"
opencode

进入界面后输入 /models 就能直接切换 4sapi 节点下的各个模型（具体模型 ID 以中转站后台列表为准）。

在选型上，使用这类国内托管中转站主要是为了解决三个工程层面的实际问题：

常见问题（FAQ）

OpenCode 能用本地模型吗？ 可以。本机运行 Ollama 时，OpenCode 会自动探测 [http://127.0.0.1:11434](http://127.0.0.1:11434) 并列出模型，无需 /connect。只有具备 completion 能力的模型才会显示；连接远程 Ollama 时需在 settings.baseURL 里写完整地址并带上 /v1。

为什么照着教程配置后 provider 不生效？ 最常见的原因是用了旧版字段。v2 文档里顶层键是 providers（复数），包名字段是 package，接口地址写在 settings.baseURL 里。另外请检查 env 里声明的环境变量名称是否已经在当前终端会话中正确 export。

ChatGPT Plus 订阅接进 OpenCode 有什么限制？ 在 /connect 里选 OpenAI → Sign in with ChatGPT 后，用量计入订阅计划、界面不显示费用。OpenCode 默认会给这类模型的上下文窗口设上限，需要时可在配置中关闭。

小结

OpenCode 的核心价值是“客户端开源、模型自由选”：个人开发者用零保留的免费模型即可起步，高频开源模型用户用 10 美元/月的 Go 订阅控制成本，需要跨厂商调用闭源模型或寻求省心网络环境的开发者则可以通过 4SAPI 等兼容 OpenAI 协议的服务快速接入。本文信息依据 OpenCode 官方文档（opencode.ai/docs）与 GitHub 仓库 anomalyco/opencode，截至 2026 年 11 月；免费模型名单和订阅额度变化较快，建议以官方页面为准。

延伸阅读