用 opencode 免费模型，某天开局直接收到这么一段：
三句话，逐句翻译：
下面就是正题：两步换 key。
图 1：控制台登录页，谷歌、GitHub、邮件三种登录方式任选
登录后进入 Settings → Service accounts，点 Add API Key，填个名字、选好权限，Expiry date 个人账户可以直接选 never（永不过期，这次改完下次就不用再来了）。
新 key 以
图 2：弹窗里别点 Continue in the browser，点红箭头指的 Use API key，把刚复制的 oc_sk_ 新 key 粘进去
这里有个容易点错的地方：
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.- 这把 key 过期了；
- 去 OpenCode Console 新建一把，替换掉客户端里的旧的；
- 重新登录不会让它续期。
先分清：这是过期，不是限流
很多人看到 401 就当成"限流"去等，等一上午也不会好。认准错误码：| 报错 | 意思 | 该干嘛 |
|---|---|---|
401 + api_key_expired / This API key has expired |
key 到期 | 换新 key，等没用 |
401 + Invalid credential |
key 抄错/无效 | 检查粘贴是否完整 |
429 + Rate limit exceeded |
限流 | 换个模型或等一会儿 |
第一步：登录官网控制台，申请一把新 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。
顺手改：如果你的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 没粘对（检查首尾有没有漏字符），或者改的不是实际生效的那份配置。
三个最常见的坑
- 点错按钮：在弹窗里点了 Continue in the browser 重新登录，以为重登能救——不能，报错文案原文写死了。
- 只换 key 不重启：手改配置文件的话，改完要重启 opencode 或重连 provider 才生效。
- 把过期限流当限流：
api_key_expired是到期，429 才是限流，前者等多久都不会自己好。
一句话总结
OpenCode 报 This API key has expired，就去控制台新建一把oc_sk_ key，回到设置 → 提供商 → OpenCode → Use API key 粘进去，发一句 say hello 验证。重登不续期，换 key 才是唯一解。 © 版权声明
文章版权归作者所有，未经允许请勿转载。
相关文章
暂无评论，欢迎留下你的看法。