OpenCode 免费额度用完怎么办：重置、换模型与付费
OpenCode 免费模型额度耗尽后，可等待额度重置、改用其他模型，或在控制台启用 Extra Usage 按量付费。
截至 2026 年 11 月 2 日，OpenCode 官网仍写着“OpenCode is 100% free to use”，并提供一组无需账号即可使用的免费模型；但免费模型不是无限额度。2026 年 10 月 24 日，社区已出现升级后免费额度“不再是日结”的询问，所以现在最需要弄清的不是重新安装客户端，而是区分：究竟用完的是哪一层额度、窗口何时重置，以及切换模型会不会仍走同一份额度。
下文把官方明确说明、GitHub issue 中的用户实测描述和社区讨论分开标注；命令均来自 OpenCode 官方仓库或官网，没有使用未经核实的“清缓存续额度”命令。
先分清 OpenCode 的三种额度
OpenCode 本身是开源 AI 编程代理，可以在终端、桌面应用或 IDE 扩展中使用，并接入 Claude、GPT、Gemini 等模型。根据OpenCode 官方首页 FAQ，OpenCode 软件本身免费，官方也提供免费模型；接入其他模型提供商时，模型调用可能另行收费。
“OpenCode 免费额度用完”通常指以下三种情况：
| 使用方式 | 额度耗尽后的典型状态 | 可执行方向 |
|---|---|---|
| OpenCode 免费模型 | 请求触发免费额度限制 | 等待对应窗口重置，或改选其他免费模型 |
| OpenCode Go 订阅 | 触发 Go 订阅额度限制 | 等待订阅窗口恢复，或转用按量付费余额 |
| 自己配置的模型提供商 | API 余额不足或服务商限流 | 充值、换提供商，或换本地模型 |
这是按官方功能边界做的分类，不是 OpenCode 公布的统一“额度表”。官方仓库 Issue #43194 中，一位提案者把当前机制描述为：免费层存在滚动窗口，Go 订阅也有固定窗口，Zen 则作为按量付费的后备方案。Issue 标题是“Optional quota multipliers”，讨论的是功能提案，因此其中的额度数字不能当成官方承诺；但 FreeUsageLimitError / 429、GoUsageLimitError 是排查时可对照的实际错误名称。
免费额度用完后，先执行这 4 步
1. 确认客户端确实安装成功
在终端或 IDE 的集成终端中执行：
npm i -g @opencode/cli@latest这是OpenCode 官方仓库 README “Installation” 部分给出的完整安装命令。需要先安装 Node.js 和 npm；没有 npm 时，可按官网首页 Installation 区域提供的命令执行：
curl -fsSL https://opencode.ai/v2/install | bashLinux 用户还可以选择 Homebrew：
brew install anomalyco/tap/opencode-v2不要同时用安装脚本、npm 和 Homebrew 装三份。选一种即可。官方仓库说明，脚本会把 OpenCode 安装到 $HOME/.opencode/bin；如果终端提示找不到命令，应先确认该目录是否已进入 PATH，而不是反复重装。
2. 看清楚错误属于免费层还是 Go
免费层常见提示是：
FreeUsageLimitError / 429Go 订阅额度耗尽时，Issue 中记录的名称是：
GoUsageLimitError429 通常表示请求被限流，但相同状态码也可能来自所接入的模型提供商。处理时先看错误名前半段：出现 FreeUsageLimitError，按免费模型路径处理；出现 GoUsageLimitError，按订阅窗口处理；只有服务商名称、余额不足或 API key 报错，则检查自己的提供商账户。
Issue 描述的免费层包含约每日 200 次请求，以及 5 小时、每周和每月限制；同一描述中的 Go 额度也涉及 5 小时滚动、每周和每月窗口。这里的“约每日 200 次”是 Issue 提案者写下的当时口径，不是来自定价页的稳定承诺，额度也可能调整，不能据此承诺今天仍是同一个数字。
3. 等重置，或换到另一条额度池
免费层没有查到一条可手动“刷新额度”的官方命令。可执行做法是：
- 记录本次报错发生时间，不删除缓存、不重复安装；
- 打开 OpenCode 官网，点击顶部 Models，选择另一个可用的免费模型；
- 新建会话后重新提交一个最小请求，例如先让它只读取一个文件；
- 如果仍报同一个
FreeUsageLimitError，等待报错对应的滚动窗口恢复后再试。
这里的“窗口”指额度重新补充的时间段。滚动窗口与固定自然日不同，Issue 描述也没有给出每个账户的统一重置时刻，因此不能写死“每天几点恢复”。最可靠的确认方式是查看账户或控制台显示的额度状态；官方首页顶部的 Console 入口就是管理账户的入口。
4. 需要连续使用时，启用 Extra Usage
2026 年 11 月 2 日发布的《别把 OpenCode Go 当无限量：三档订阅与模型额度拆解》援引官方说明：额度用完后，可以继续使用免费模型，也可以在控制台开启 Extra Usage，由按量付费余额继续扣费；Go Teams 默认开启 Extra Usage，个人版需要手动开启。
具体操作路径是：打开 OpenCode 官网 → 顶部 Console → 进入订阅或账单页面 → 找到 Extra Usage → 确认余额与计费方式 → 开启该开关 → 回到 OpenCode 发起一次最小请求。
这不是点击后永久免费的开关。启用前应先确认账户余额，因为 Agent 每轮会重新发送上下文和工具结果，高频修改代码可能比单次聊天消耗得更快。这里是基于模型调用机制做出的成本边界判断，不是官方给出的固定费用。
卡住时不要用这几招“续命”
社区讨论中有人建议换网络、切换 IPv6 地址或重新注册账号，但这些方法没有官方支持，也缺少可重复验证的配额规则。相关社区帖子里的回复甚至彼此矛盾：有人认为可换外部 IP，也有人报告更换后无效。更稳妥的做法是接自己的模型提供商；该帖建议使用 OpenRouter 带 :free 后缀的模型或按量付费 API，但这属于社区方案，不是 OpenCode 官方承诺。
常见卡点可这样处理：
- 仍然报
429：先确认新请求是否用了另一个模型；如果所有免费模型都报同类错误，等待对应窗口，不要连续重试。 - 报
GoUsageLimitError：在 Console 检查 Go 订阅状态；需要立即继续时再开启 Extra Usage，否则保留余额等待额度恢复。 - 普通 API 余额错误：进入自己配置的提供商后台检查余额、密钥和账单，而不是改 OpenCode 安装目录。
- 切换模型后仍走旧额度：在新会话中确认模型名称；如果 OpenCode 已登录且 Console 有订阅，可先在 Console 核对套餐和开关状态，再重新登录客户端。
怎么算处理成功
处理后，用一个不会修改文件的小请求验证即可。成功标志不是“界面不再显示红字”这么宽泛，而是：
- 请求不再返回
FreeUsageLimitError / 429或GoUsageLimitError； - Console 中额度状态恢复，或 Extra Usage 显示已开启且余额充足；
- 切换到其他免费模型时，新会话能正常得到回复；
- 没有因为反复重试产生额外按量费用。
如果只确认 OpenCode 能打开，却没确认请求成功，说明额度问题尚未解决。OpenCode 官方仓库的 README 还提供桌面应用、Homebrew、npm、mise 和 Nix 等安装方式；排查额度时应保持安装方式不变，把注意力放在模型、账户和计费窗口上。
参考来源
评论区
登录后可评论。