OpenCode 报「This API key has expired」怎么办？重新申请一把 key 填进去就好（附控制台图解）

用 opencode 免费模型，某天开局直接收到这么一段：

This API key has expired. Create a new API key in OpenCode Console
and replace it in your client or secret store. Signing in again will not renew this key.

三句话，逐句翻译：

1. 这把 key 过期了；
2. 去 OpenCode Console 新建一把，替换掉客户端里的旧的；
3. 重新登录不会让它续期。

前两句按字面照做就行，第三句是专门堵"退了重登一下"这条直觉路的——官方在报错文案里就写死了：Signing in again will not renew this key。别在旧 key 上耗，换一把新的才是唯一解。

先分清：这是过期，不是限流

很多人看到 401 就当成"限流"去等，等一上午也不会好。认准错误码：

下面就是正题：两步换 key。

第一步：登录官网控制台，申请一把新 key

打开 OpenCode 控制台登录页（opencode.ai/auth），支持谷歌 / GitHub / 邮件三种方式，没有账号就点底部「创建账户」：

图 1：控制台登录页，谷歌、GitHub、邮件三种登录方式任选

登录后进入 Settings → Service accounts，点 Add API Key，填个名字、选好权限，Expiry date 个人账户可以直接选 never（永不过期，这次改完下次就不用再来了）。

新 key 以 oc_sk_ 开头，形如 oc_sk_xxxxxxxxxx——复制下来，先别关页面。

第二步：回到 opencode，把新 key 填进「Use API key」

路径：设置 → 提供商 → OpenCode，会弹出「连接 OpenCode Console」窗口：

图 2：弹窗里别点 Continue in the browser，点红箭头指的 Use API key，把刚复制的 oc_sk_ 新 key 粘进去

这里有个容易点错的地方：

• Continue in the browser = 走浏览器重新登录授权——对过期的 key 没用（就是报错里说的 "Signing in again will not renew this key"）；
• Use API key = 直接填 key —— 点这个，粘贴第一步复制的 oc_sk_ 新 key。

粘贴保存，provider 重连成功，问题就解决了。

顺手改：如果你的 opencode.json / opencode.jsonc 里 baseURL 还写着旧的 /zen/v1，趁这次一并改成 https://opencode.ai/inference/v1。推理端点已迁到新结构（模型目录 /inference/v1/models，chat 走 /inference/openai/v1/chat/completions），旧地址目前只是别名还活着，官方文档已全部切到新地址。

第三步：验证

切到 OpenCode 的模型，随便发一句 say hello：

• 正常回话 → 新 key 生效，收工；
• 还是 401 → key 没粘对（检查首尾有没有漏字符），或者改的不是实际生效的那份配置。

三个最常见的坑

1. 点错按钮：在弹窗里点了 Continue in the browser 重新登录，以为重登能救——不能，报错文案原文写死了。
2. 只换 key 不重启：手改配置文件的话，改完要重启 opencode 或重连 provider 才生效。
3. 把过期限流当限流：api_key_expired 是到期，429 才是限流，前者等多久都不会自己好。

一句话总结

OpenCode 报 This API key has expired，就去控制台新建一把 oc_sk_ key，回到设置 → 提供商 → OpenCode → Use API key 粘进去，发一句 say hello 验证。重登不续期，换 key 才是唯一解。