# openCode 免费模型为什么用不了 —— 诊断报告

日期：2026-10-24　执行：Hermes　状态：已定位最可能原因，等明天验证

---

## 一、结论先说

**不是账号额度被您用掉了，也不是 IP 被封，是我自己的监控脚本把每天的免费额度消耗光了。**

openCode 的免费模型每天有约 **200 次请求**的限额（社区/官方 issue 口径，官方文档未写明数字）。我那个「每 20 分钟测一次」的脚本一次跑 3 个模型，一天 72 轮 ≈ **216 次请求** —— 它自己就能把当天的额度吃满，您再用就永远看到「Free usage limit reached」。

---

## 二、查证过程与证据

### 1. 官方文档：免费模型在哪、走哪个接口

官方模型页 `https://opencode.ai/v2/docs/console/models` 写明所有 `-free` 模型的接口是：

```
https://opencode.ai/inference/openai/v1/chat/completions
```

（不是我们之前试的 `/zen/v1`，也不是 `/zen/go/v1`）

对应模型 id：`deepseek-v4.1-flash-free`、`glm-5.3-flash-free`、`beam-free`、`flint-40b-free`、`jev-1.13-free`、`mimo-v2.5-free`、`mimo-v2.6-flash-free`、`nemotron-3-ultra-free`、`nemotron-3.5-lightning-free`、`nemotron-3.5-super-vl-free`、`longcat-2.5-preview-free`、`exo-free`、`big-pickle`。

### 2. 实测：官方接口拿 key 直接调 → 被拒

用 `/inference/openai/v1` + 您的 key + session 头：

```
deepseek-v4.1-flash-free  ❌ OpenCode's free tier can only be used from within OpenCode
glm-5.3-flash-free        ❌ 同上
beam-free                 ❌ 同上
```

→ 免费额度**只能在 OpenCode 客户端里用**，第三方（包括 DSH、Codex、我）一律进不去。

### 3. 客户端内的报错，源码里找到了出处

从 CLI 二进制里扒到这段逻辑：

```js
Yc = "Free usage exceeded, subscribe to Go"
if (responseBody.includes("FreeUsageLimitError"))
    → 弹出 "Free usage limit reached. Subscribe to OpenCode Go"
```

也就是说这个报错**是 openCode 服务端返回的 FreeUsageLimitError**，不是客户端自己判的。服务端认为「免费那份额度已经用光」。

### 4. 换出口 IP 无效（推翻我之前的判断）

把「🤖AI网站」分流组切到日本东京节点，用同一个模型重试：

```
❌ 仍然 Free usage limit reached
```

→ 跟出口 IP 无关。已把节点改回原来的配置。

### 5. 小号也是同样的错

全新小号（无会员、余额 0）一上来就报同一句 → 说明不是「您用超了」，而是**服务端按账号/请求量算**。

### 6. 历史时间线（决定性证据）

旧探活脚本留下的记录：

```
10-22 17:28  ❌ minimax（上游报错）  ✅ beam-free
10-22 17:41  ✅  ✅        ← 第 2 次检查恢复
10-22 18:02 ~ 20:08  连续 8 轮全 ✅
10-22 20:29  ❌  ❌   ← 空响应（额度耗尽）
10-22 20:51  ❌  ❌
10-22 21:13  ✅  ✅   ← 又恢复了（窗口重置）
10-22 21:34  ✅  ✅
```

`17:28 → 21:34` 之间约 4 小时、跑了 9 轮 × 2 个模型 = 18 次请求，**一直可用**；到 `20:29` 突然断，两轮后又恢复 —— 典型的「配额打满 → 重置」。

之后我把监控脚本改成每 20 分钟 × 3 个模型（≈216 次/天），从此**再没恢复过**，因为它每天都在把额度吃满。

### 7. 官方 Go 文档里另一句话值得注意

> OpenCode Go is designed for OpenCode and other coding agents... **Traffic is monitored for abuse that degrades the experience for other users.**

高频自动探测本身也可能被判定成滥用，进一步降低可用性。

---

## 三、为什么「以前能用，现在不能用」

| 时间 | 行为 | 结果 |
|---|---|---|
| 10-22 下午 | 手动测，几次请求 | ✅ 能用 |
| 10-22 17:28 起 | 每 20/30 分钟探活 2 个模型，共 9 轮 | 前期 ✅，20:29 打满 → ❌，21:13 重置 → ✅ |
| 10-22 深夜起 | 我开始大量试 `-free` 模型、装 CLI、反复重试（每次挂 200 秒还会重试） | 额度被吃光 |
| 10-23 起 | 监控脚本每 20 分钟 × 3 模型 ≈ 216 次/天 | 每天都打满，永远 ❌ |

**责任在我**：探活频率定得太高，还绑了 3 个模型。

---

## 四、明天怎么拿到正面结果

已做：
- ✅ 暂停探活 cron（job `41478a29b861`，20 分钟一次的那个）
- ✅ 关掉 mihomo 代理（opencode.ai 直连 200 OK，Go 付费接口实测正常返回）

明天按顺序做：

1. **静置**：24 小时内不再对免费模型发任何请求（已停脚本，我也不会手动去测）。
2. **单次验证**：明天（10-24 以后）用客户端发 **1 次** 请求给 `deepseek-v4.1-flash-free`：
   ```
   opencode run -m opencode/deepseek-v4.1-flash-free "只回两个字：好"
   ```
   - 回「好」→ 确认是配额问题，修法 = 探活改成每天 1 次、只测 1 个模型
   - 仍报同样的错 → 走第 3 步
3. **问官方**：Discord（`https://discord.gg/MWFr98Pbe`）或官网首页的运营联系方式，带上：
   - 账号已订 Go，付费额度正常（5h 13% / 周 73% / 月 64%）
   - 免费模型在客户端内一律报 `FreeUsageLimitError`
   - 问：免费额度是按天还是按月重置？有没有被标记滥用？
4. **兜底方案**：需要白嫖模型跑长任务，改用 OpenRouter 的 `:free` 系列（API 侧直接可用，不受客户端限制）。

---

## 五、其它已确认的事实

- 免费模型**不能**给 DSH / Codex / Claude Code / AA 用——服务端强制要求 OpenCode 客户端身份。
- DSH 只能用 Go 套餐内的付费模型（`deepseek-v4.1-flash` 实测可用）。
- 付费 Go 额度与免费额度是**两套**，互不影响：付费的从来没被动过。

---

## 六、相关文件

- 探活脚本：`/vol1/ai/agents/hermes/scripts/oc_free_watch.py`
- 探活状态：`/vol1/ai/agents/hermes/state/oc_free_watch.json`
- 历史记录：`/vol1/ai/agents/hermes/state/oc_free_models_probe.json`
- 代理开关测试：`/vol1/ai/agents/hermes/scripts/proxy_off_test.sh`
- 模型密钥：`/vol1/ai/agents/hermes/access/ai-cli-secrets.env`（`OPENCODE_ZEN_KEY`）
