先检查这几项
- 先运行 opencode --version，按该版本 schema 检查配置。使用 provider/npm/options 的配置，不混入其他版本字段。
- 核对 provider ID、SDK 包、options.baseURL 和 models 键；当前模型引用使用 provider ID/模型 ID。
- 检查全局、项目配置及 OPENCODE_CONFIG_CONTENT 的覆盖关系，保留备份，仅修改实际生效的条目。
正在打开页面…
正在加载内容，请稍候。
常见错误与配置项
AI_APICallError
继续展开：状态码、responseBody、请求路径、provider/model
ProviderInitError 则先检查配置或依赖加载OpenCode AI_APICallErrorOpenCode AI_APICallError 是 Key 错误吗？provider package errorOpenCode provider package errorOpenCode openai-compatible 和 openai Provider 怎样选？auth.json config errorOpenCode auth.json config errorOpenCode auth.json 有 Key 为什么仍认证失败？model not foundOpenCode model not foundOpenCode models 里的 name 就是 API 模型 ID 吗？
按失败位置逐项排查
报错检查与修复步骤
OpenCode AI_APICallError：状态码、Provider 与协议
OpenCode AI_APICallError 是外层错误名称，先展开状态码、responseBody、请求路径和 provider/model。根据底层原因修复鉴权、协议或参数；短文本成功后再验证读取文件、修改与测试，不把它写成全部 Agent 功能通过。
查看报错修复快速判断
- 启动时 provider 加载失败或找不到模型
- 聊天请求得到 401、400、404、429 或上游错误
OpenCode provider package error：依赖加载与 API 协议
OpenCode provider package error 先看包名、加载日志和当前配置。确认 npm Provider 与实际 Chat Completions 或 Responses 协议一致；请求尚未发出时更换 API Key 没有帮助，依赖调整后重新验证最小请求。
查看报错修复快速判断
- 启动时 provider 加载失败
- 未发起模型请求
OpenCode auth.json config error：凭据与 Provider 对应
OpenCode auth.json config error 先分清凭据存储与 Provider 配置，检查 JSON 结构和当前 Provider 是否读取该凭据。备份文件、保留其他入口，按实际配置的鉴权方式修复，再新开会话验证。
查看报错修复快速判断
- 明明填了 Key 仍提示未登录
- auth.json 修改后不生效
OpenCode model not found：Provider ID 与模型映射
OpenCode model not found 检查 provider/model 选择、配置中的 models 键以及目标服务授权的准确 ID。展示名称不能替代真实模型键，其他平台前缀也不能直接沿用；确认协议后在新会话发最小请求。
查看报错修复快速判断
- 认证成功但模型调用失败
- 只在某个项目目录失败
opencode 报错怎么转成可用配置
不要只看错误码本身。先确认请求是否进入 apizt 后台，再按 API Key、Base URL、模型名、provider 类型排查。 这几个页面分别覆盖认证失败、连接失败、模型不存在、限流和工具配置覆盖问题。