OpenCode

OpenCode 返回 401 或 API Key 无效怎么处理

401 通常集中在本机环境变量、Provider 或凭证状态;不要把真实 Key 写入网页、URL 或 Git。

先做这几项判断

请求已到达服务端,但身份验证失败。

  • OpenCode 返回 401、Unauthorized 或 Invalid API Key。
  • API Key 不完整或已失效
  • 从 AI Code With 重新复制完整 API Key
401Unauthorized

01

确认请求已到达服务端

401 或 Unauthorized 表示请求已到达服务端,应先检查凭证和 Provider,而不是修改模型名称。

02

检查环境变量和 Provider

确认启动 OpenCode 的终端已设置 AICODEWITH_API_KEY,并且配置中的 apiKey 仍引用该环境变量。

  1. 1从 AI Code With 重新复制完整 API Key
  2. 2在启动 OpenCode 的同一终端设置 AICODEWITH_API_KEY

03

重新验证

保存配置并重新打开 OpenCode,运行 /models 后发送短消息;不再出现 401 表示凭证链路已恢复。

  1. 1在启动 OpenCode 的同一终端设置 AICODEWITH_API_KEY
  2. 2确认 Provider ID 与页面生成值一致

仍没解决时,继续看

资料来源

重新配置

返回接入中心,继续处理对应的配置步骤。

回到相关配置步骤