遇到报错，先别同时改所有参数
按照错误类型，优先检查对应的部分，可以更快定位问题。
401 / 403认证与权限检查 API Key 是否正确、是否有访问权限。404地址、路径与模型检查 Base URL、接口路径和模型名称是否正确。429频率、额度与归属检查请求频率、账户额度和服务归属。Timeout / Stream网络、路由与上游检查网络连接、代理设置和上游服务状态。
进入完整排错中心 1
先选你现在的情况
不同入口解决不同问题，选择最接近你当前配置状态。
2
四步完成配置
建议按顺序从认识工具到验证成功，按顺序完成可以更快解决问题。
3
按阶段找到对应教程
从基础到实战，选择你需要的内容开始学习。
认识工具
先理解各工具是什么、分别解决什么问题。
安装客户端
完成环境准备、客户端安装与命令检查。
配置 API
选择手动配置或 CC Switch，再按客户端核对 API Key、Base URL、协议和配置文件。
Codex / Claude Code 手动配置 API 教程不用配置工具，分别完成 Codex config.toml 与 Claude Code 环境变量配置，填写 API Key、Base URL、协议和模型后再验证。新手必看用 CC Switch 配置 Codex / Claude Code 教程下载安装 CC Switch，从控制台导入 API 配置，分别为 Codex 与 Claude Code 启用供应商，并处理切换后未生效问题。进阶Codex 配置第三方 API 教程Codex 配置第三方 API：填写 API Key、Base URL 与模型，并用最小任务验证配置是否生效。进阶Codex config.toml 配置文件路径找到 Codex 实际读取的 config.toml，确认 provider、模型和接口地址的生效范围。进阶Claude Code API 网关配置区分凭证请求头、Base URL 与 /status 验证，确认客户端确实走到目标网关。进阶
验证与排错
完成最小请求，并按状态码、配置来源和真实链路定位失败原因。
没有找到匹配教程，可以换一个字段或错误码。
第二次验证怎么做
完成配置后，建议先进行简单的验证，确认一切正常。
- 1确认当前 Provider
检查所使用的 API 服务商（如小贺AI、OpenAI 等）。
- 2运行只读小任务
例如：让 AI 回答一个简单问题，确认能正常返回结果。
- 3核对请求记录
在控制台或日志中确认请求是否来自你的账户。
- 4再进入真实项目
验证通过后，再把你的实际项目交给它使用。
配置成功后，进一步学习怎么真正使用
安装、API 和报错留在本页；项目规则、任务拆解、文件修改、测试验收和长任务交接进入 AI 知识库。
6
配置完成后，再扩展工作流
当你成功完成基础配置后，可以进一步探索更多功能，提升效率。
还没有适合 Codex 或 Claude Code 的 API？
先查看当前实时的模型、接口协议、计费方式与服务说明，再决定是否使用。
查看小贺API接入说明 已有账户？进入控制台 小贺API为独立第三方服务，请以当前控制台和服务说明为准。