> 发布日期：2026-11-10 ｜ 适用版本：OpenCode v1.19.x / v2 安装通道

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安装订阅免费模型接入-20261110-img1.png](https://developer.qcloudimg.com/http-save/yehe-12049964/6545b96d1697d0a3946d96916a8a284b.png)

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

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

| 路径 | 费用 | 适合谁 | 在 TUI 里怎么连 |
|------|------|--------|----------------|
| 限时免费模型 | 0 元 | 尝鲜、个人小项目 | 默认可见，`/models` 直接选 |
| 复用已有订阅 | 已付的 ChatGPT / Copilot 月费 | 已经有这两类订阅的人 | `/connect` → OpenAI 选 Sign in with ChatGPT，或选 GitHub Copilot |
| OpenCode Go 订阅 | 10 / 40 美元每月，团队 20 美元每人每月 | 想要固定月费、主用开源模型 | `/connect` → OpenCode Go |
| Console 按量付费 / 自定义 provider | 按 token 计费 | 需要特定模型或企业统一采购 | `/connect` 或写 `opencode.jsonc` |

下面逐个展开。

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

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

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

```bash
# 一键脚本（安装到 $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
```

几个细节：

- **Windows 用户**：官方文档写明不支持 Windows 包管理器，需要按官方文档下载 `opencode-windows-x64.zip` 独立二进制（ARM 设备选 `opencode-windows-arm64.zip`），或到 opencode.ai/download 装桌面版 `opencode-desktop-win-x64.exe`。
- **桌面版**：macOS 可用 `brew install --cask opencode-desktop`，目前仍是 Beta。
- **老版本残留**：README 提示安装前先删掉 0.1.x 之前的旧版本。

装好后在项目目录执行 `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 系列等。

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

- **零保留、不用于训练**：GLM-5.3-Flash Free、DeepSeek V4.1 Flash Free；LongCat 2.5 Free 同样零保留，但每天限 100 次请求。
- **数据可能用于改进模型**：Big Pickle、Iceman Free（两款"隐身"模型）、MiMo-V2.6-Flash Free，Flint 40B Free 保留 30 天。
- **数据会被记录**：Nemotron 三款按 NVIDIA 试用条款，官方明确提醒不要提交个人或机密数据。

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

![OpenCode安装订阅免费模型接入-20261110-img2.png](https://developer.qcloudimg.com/http-save/yehe-12049964/0ae8d4f9432c4ed30bbd53b739d15c6a.png)

## 第三步：订阅 OpenCode Go，还是按量付费？

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

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

- 5 小时窗口内最多用掉该模型月额度的 20%；
- 一周内最多 50%；
- 一个月 100%。

以 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>`。

**怎么选**：每天固定写几个小时代码、主力用开源模型，Go 的固定月费更省心；偶尔用、或者必须用某个特定商业模型，就走 Console 按量付费。Console 本身不加价，但每次充值另收"4.6% + 0.31 美元"的手续费。

## 第四步：接入自定义模型（v2 配置字段已改）

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

这里是最容易出错的地方：**新版字段名已经变了**，老教程里的 `provider`、`npm`、`options` 分别对应现在的 `providers`、`package`、`settings`。

以国内团队常见的企业订阅为例。七牛云 Token Plan 提供 OpenAI 兼容接口，地址为 `https://api.qnaigc.com/v1`，订阅内是 DeepSeek、Kimi、GLM、MiniMax 4 家厂商共 16 个模型，通过一个订阅专用 API Key 调用。按 OpenCode 当前文档的格式，配置如下：

```jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "qiniu": {
      "name": "Qiniu",
      "env": ["QINIU_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://api.qnaigc.com/v1",
      },
      "models": {
        "z-ai/glm-5.3": { "name": "GLM 5.3" },
        "deepseek/deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash" },
        "moonshotai/kimi-k3": { "name": "Kimi K3" },
      },
    },
  },
  "model": "qiniu/z-ai/glm-5.3",
}
```

然后在终端设置 Key 再启动：

```bash
export QINIU_API_KEY="<你的订阅专用 API Key>"
opencode
```

进入后用 `/models` 就能看到 qiniu 下的三个模型。模型 ID 以控制台模型广场显示为准。

这类企业订阅的计费规则和 OpenCode Go 不同，选型时值得对照看：Token Plan 月付 2,999 元起，按积分扣减、每周刷新一次额度；每天 08:00–18:00 以外的闲时调用按 0.3 倍折算积分，官网标注叠加包年折扣后最低 1.2 折；超出额度的请求直接被拒绝，不会产生额外扣费，月度成本是封顶的。前提是它面向企业与团队，个人用户用 Go 或免费模型更合适。

![OpenCode安装订阅免费模型接入-20261110-img3.png](https://developer.qcloudimg.com/http-save/yehe-12049964/c7dbed132aac8a91f55ca01e73467405.png)

## 常见问题

**OpenCode 能用本地模型吗？**
可以。本机运行 Ollama 时，OpenCode 会自动探测 `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 订阅控制成本，团队可以接入自己采购的 OpenAI 兼容服务统一管理。本文信息依据 OpenCode 官方文档（opencode.ai/docs）与 GitHub 仓库 anomalyco/opencode，截至 2026 年 11 月 10 日；免费模型名单和订阅额度变化较快，以官方页面为准。


发布日期：2026-11-10 ｜ 适用版本：OpenCode v1.19.x / v2 安装通道

OpenCode 2026 上手全记录：安装、订阅、免费模型和自定义模型接入一次讲清

开发工具

人工智能

编程语言

OpenCode v1.19.5终端AI编程智能体安装配置指南：支持免费模型、ChatGPT/Copilot订阅复用、OpenCodeGo月付及自定义OpenAI兼容接口。详解v2新版安装命令与配置字段，避开旧教程报错陷阱，附企业订阅接入方案与数据安全提示。

代码解释

包管理器

智能体

DeepSeek

AI编程

ChatGPT

Windows

GitHub

Linux

MacOS

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenCode 2026 上手全记录：安装、订阅、免费模型和自定义模型接入一次讲清-腾讯云开发者社区-腾讯云

OpenCode 2026 上手全记录：安装、订阅、免费模型和自定义模型接入一次讲清

OpenCode 2026 上手全记录：安装、订阅、免费模型和自定义模型接入一次讲清

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐