Claude Code 接入 OpenAI 兼容中转：从 Key 到第一次对话
Claude Code 接入 OpenAI 兼容中转的分阶段实操：准备 Key/Base URL/模型名三件套，环境变量直连快速验证，CC Switch 长期管理，以及模型列表与分组的关系。全部步骤在真实环境跑通，附真实返回结果。
TROUBLESHOOTING & INTEGRATION
知识库
AI API 报错串对照排查、状态码速查与常见客户端接入全流程，按可复核步骤整理。
CC Switch 切了没反应：一份生效排查清单
CC Switch 里明明切换了供应商，Claude Code / Codex 却还在走旧配置？按本清单逐项排查：环境变量残留、CLI 进程快照、配置文件写错位置、新供应商本身不可用，每步附验证命令，十分钟后要么修好、要么拿着证据去反馈。
Codex 报 insufficient_quota：3 种真实原因与自查顺序
Codex 报 insufficient_quota / You exceeded your current quota 的决策树排查：先分清官方订阅还是中转 API Key，再按余额、额度池、Base URL 指向、模型倍率四条叶子逐层定位，每步附核对方法。
Claude Code 连不上 API：6 个报错串对照排查
Claude Code 连接自定义 Base URL 时最常见的 6 个报错串：Invalid API key、401 authentication_error、404 model not found、Connection error、429 rate_limit、SSL 证书错误。每条给出真实原因、自查顺序和可直接复制的核对命令。
中转 API 常见 429/502/530 状态码速查表（附自检命令）
调用 AI API 中转时最常撞见的三个状态码：429（限流/额度）、502（网关上游异常）、530（边缘到源站中断）。每个码一屏讲清：责任在哪边、该等还是该查、附可直接复制的自检命令，另附 500/503/504/52x 速查行。