OpenCode
OpenCode 返回 401 或 API Key 无效怎么处理
401 通常集中在本机环境变量、Provider 或凭证状态；不要把真实 Key 写入网页、URL 或 Git。
先做这几项判断
请求已到达服务端，但身份验证失败。
- OpenCode 返回 401、Unauthorized 或 Invalid API Key。
- API Key 不完整或已失效
- 从 AI Code With 重新复制完整 API Key
401Unauthorized01
确认请求已到达服务端
401 或 Unauthorized 表示请求已到达服务端，应先检查凭证和 Provider，而不是修改模型名称。
02
检查环境变量和 Provider
确认启动 OpenCode 的终端已设置 AICODEWITH_API_KEY，并且配置中的 apiKey 仍引用该环境变量。
- 1从 AI Code With 重新复制完整 API Key
- 2在启动 OpenCode 的同一终端设置 AICODEWITH_API_KEY
03
重新验证
保存配置并重新打开 OpenCode，运行 /models 后发送短消息；不再出现 401 表示凭证链路已恢复。
- 1在启动 OpenCode 的同一终端设置 AICODEWITH_API_KEY
- 2确认 Provider ID 与页面生成值一致
仍没解决时，继续看
资料来源
重新配置
返回接入中心，继续处理对应的配置步骤。
回到相关配置步骤同类问题
/models 找不到模型或提示 Model Not Found · 模型出现但请求没有正常完成 · Base URL 错误、404 或无法连接 · 找不到 opencode 命令 · 请求频率限制或返回 429 · 后台已有用量记录，但 OpenCode 没显示回复 · reasoning part/text part not found 或 summaryParts 解析异常 · opencode.json 格式错误 · 返回 403 Forbidden · BunInstallFailedError 或 models.dev 下载失败