先看错误信息
auth.json config errorOpenCode auth.json config error 先分清凭据存储与 Provider 配置，检查 JSON 结构和当前 Provider 是否读取该凭据。备份文件、保留其他入口，按实际配置的鉴权方式修复，再新开会话验证。
正在打开页面…
正在加载内容，请稍候。
- 保留现场
记录状态码、错误正文和请求时间
- 缩小范围
按下方检查项逐个排除，不同时修改多项
- 最小复测
用同一请求验证，再回到原工具测试
选出你的现象，查看下一步
只需选择错误类型，无需粘贴密钥或完整日志。本页不会发送 API 请求，也不会自动判定连接成功。
先取得错误详情，暂时不能确定原因
- 展开错误详情，记录时间、HTTP 状态、错误码和最终请求路径。不要只截最外层提示。
- 核对服务商协议、模型 ID、API 地址；然后按对应教程进行同条件终端检查。
启动新会话先测试短文本，核对实际 endpoint 和 provider；随后在测试目录授权读取 README，分别记录两项结果。
查看 OpenCode 完整配置教程记录仅在浏览器中生成；下载后可补充脱敏结果，便于对照复测或提交客服。
常见表现
- 明明填了 Key 仍提示未登录
- auth.json 修改后不生效
- JSON parse error
这个报错是什么意思
auth.json config error 需要结合错误正文定位。Base URL 为 https://api.apizt.com/v1；@ai-sdk/openai-compatible 使用 Chat Completions，@ai-sdk/openai 的 Responses 用法需要服务端支持 Responses；不能仅改模型 ID 就切换协议。
先判断是哪一类问题
对照请求链路定位失败阶段
判断 01
Base URL 为 https://api.apizt.com/v1；@ai-sdk/openai-compatible 使用 Chat Completions，@ai-sdk/openai 的 Responses 用法需要服务端支持 Responses；不能仅改模型 ID 就切换协议。
判断 02
provider package error 先查依赖和配置加载；请求尚未发出时更换 API Key 没有帮助。
判断 03
AI_APICallError 是外层错误，需展开 HTTP 状态和正文；auth.json 存有凭据不等于当前 provider 正在使用它。
按顺序修复
01
检查 ~/.config/opencode/auth.json
02
确保 JSON 合法
03
只保留一个有效 apizt Key
04
重启终端
详细修复步骤
Step 01
找到实际生效的配置
先运行 opencode --version，按该版本 schema 检查配置。使用 provider/npm/options 的配置，不混入其他版本字段。
Step 02
核对协议与凭据
核对 provider ID、SDK 包、options.baseURL 和 models 键；当前模型引用使用 provider ID/模型 ID。
Step 03
回到新会话验证
检查全局、项目配置及 OPENCODE_CONFIG_CONTENT 的覆盖关系，保留备份，仅修改实际生效的条目。
正确配置
Base URL 为 https://api.apizt.com/v1；@ai-sdk/openai-compatible 使用 Chat Completions，@ai-sdk/openai 的 Responses 用法需要服务端支持 Responses；不能仅改模型 ID 就切换协议。
模型 ID：从当前平台授权列表复制，不能用显示名称代替。
API Key：在客户端安全输入；本页无需提供。
成功判据：启动新会话先测试短文本，核对实际 endpoint 和 provider；随后在测试目录授权读取 README，分别记录两项结果。常见原因
- auth.json 不在 ~/.config/opencode
- JSON 多了注释或尾逗号
- 字段名写错
- 权限导致文件不可读
怎么确认已经修好
- 启动新会话先测试短文本，核对实际 endpoint 和 provider；随后在测试目录授权读取 README，分别记录两项结果。
- 记录客户端版本、请求时间、模型 ID、HTTP 状态和请求 ID。文字成功后再测试所需工具、图片或长上下文功能。
- 页面提供配置核对与复测步骤，没有连接你的客户端；本页未提供该客户端的真实付费调用验证结果。
避免下次再报错
- 团队内统一一份 Base URL 和模型名，不要让每个人从不同教程复制配置。
- 给生产任务和个人调试任务分开 API Key，方便定位是谁触发了限流或余额消耗。
- 工具升级后先保留旧配置备份，再用一个短 prompt 验证连通性。
- 把正确配置写进团队文档，尤其标明 Claude Code 和 OpenAI 兼容工具的 Base URL 差异。
仍未解决？这样提供排查信息
记录报错时间、工具版本、模型 ID 和 HTTP 状态码，附上脱敏后的错误正文。
说明问题是否稳定复现，以及同一配置的最小请求是否成功。
可以提供请求 ID 或控制台日志编号，不要发送完整 API Key、密码或个人业务数据。
先区分配置、权限、额度与上游服务问题；不要通过重复充值或高频重试来排查。
排查完成后，再开始接入
先按上文检查地址、鉴权与协议，并完成复测。确认要使用 apizt 后，再创建 API Key、选择模型并配置工具；充值不能修复配置错误。
创建 API Key
在控制台创建令牌，选择需要使用的模型权限。
填写接入配置
按工具要求填写 API Key、接口地址与模型 ID。
发起第一次调用
确认收到有效结果，再到控制台查看用量与费用。
FAQ
OpenCode auth.json 有 Key 为什么仍认证失败？
存在凭据不代表当前 Provider 正在使用它。检查 Provider ID、环境变量引用和实际生效的配置，确认 Key 与目标地址匹配，并查看请求返回的状态码。
OpenCode 修复 auth.json 可以覆盖整个文件吗？
先备份并只修改相关凭据或格式错误，保留其他 Provider。不要把教程示例直接覆盖所有认证数据；分享错误信息前移除真实 Key。
OpenCode 应该填写哪个 API 地址？
Base URL 为 https://api.apizt.com/v1；@ai-sdk/openai-compatible 使用 Chat Completions，@ai-sdk/openai 的 Responses 用法需要服务端支持 Responses；不能仅改模型 ID 就切换协议。
终端请求成功，为什么客户端仍然失败？
provider package error 先查依赖和配置加载；请求尚未发出时更换 API Key 没有帮助。 AI_APICallError 是外层错误，需展开 HTTP 状态和正文；auth.json 存有凭据不等于当前 provider 正在使用它。 终端结果只有在同一 Key、模型、端点和实际运行网络下才具有可比性。
本页是否代表已经实测全部功能？
不是。本页为配置核对与排错指南，依据官方文档及现有教程整理。客户端版本和真实调用结果需要按步骤记录；网页检查通过不能替代客户端实测。