OpenAI Python SDK 遇到 502/503 或超时时，不要在 SDK 外再盲目套重试。本文锁定 openai 2.48.0，以本地 fixture 实测默认两次自动重试后成功、max_retries=0 首次 503 即失败、失败 request_id 回读和 APITimeoutError，并给出避免重试放大的排查顺序。

Claude Code 配自定义 Anthropic 端点遇到 404 时，先确认请求路径，再换模型或 Key。对当前2.1.219，根 Base URL 会生成；Base URL 末尾再加/v1会生成，夹具返回 404。把配置收敛到一个 settings source，用做最小复现，并以访问日志中的真实路径作为成功信号，才能把路由错误和模型、认证问题分开。

Claude Code 配自定义 Anthropic 端点遇到 404 时，先确认请求路径，再换模型或 Key。对当前2.1.219，根 Base URL 会生成；Base URL 末尾再加/v1会生成，夹具返回 404。把配置收敛到一个 settings source，用做最小复现，并以访问日志中的真实路径作为成功信号，才能把路由错误和模型、认证问题分开。

Claude Code 接入自定义 Anthropic 兼容端点后报 model_not_found，不要只换 Key。本文按 settings.json 作用域、ANTHROPIC_BASE_URL、ANTHROPIC_MODEL 和默认模型映射逐层检查，并用 Claude Code 2.1.191 访问本地 loopback 夹具，复现错误模型 404 与正确模型 200 的分界。

同时使用 Cursor、Codex、Claude Code、Chatbox、Cherry Studio 等 AI 编程工具时，不要把同一个 API Key 复制到每个配置页。先把工具分成 OpenAI-compatible 和 Anthropic Messages 两类协议，再分别记录 Base URL、环境变量、模型 ID、预检命令和轮换方式。

Claude Code 已写入 settings.json 仍报 401 时，先确认变量是否放在 env、Base URL 是否指向 Anthropic Messages 根地址，再区分 ANTHROPIC_AUTH_TOKEN 的 Bearer 与 ANTHROPIC_API_KEY 的 X-Api-Key。本文以 Claude Code 2.1.219 访问本地 fixture，复现错误鉴权

Codex CLI 0.144.1 读取旧 config.toml 时，wire_api="chat" 会在联网前直接失败。本文给出用户级配置位置、最小 Responses 配置、删除字段使用默认值的替代修法，并用脱敏回环夹具实测两种有效配置都会 POST /v1/responses、stream=true，最终返回 CODEX_WIRE_OK。

Dify 的 OpenAI-API-compatible 插件保存自定义模型时报 model_not_found，问题常在界面模型名与 API endpoint 模型名没有对齐。本文基于官方插件 0.0.55 的字段和源码，先查 /models，再用 404/200 最小请求确认 Base URL 与精确模型 ID；本地实测不冒充完整 Dify 或线上模型调用。

Codex CLI 接入 OpenAI 兼容接口后返回 401，先别换 Key。本文用一个最小配置和 /v1/models 检查，把没读到配置、provider 选错、Base URL 拼错、环境变量为空、模型名不对拆成可验证的五步，并给出每一步的成功信号。

Cursor 接 OpenAI 兼容 API 后出现 401 时，先从当前版本设置页打开 settings.json，核对 Base URL 和模型 ID，再用 /v1/models 与最小对话请求区分认证、路径和模型问题。本文提供脱敏本地 401/200 对照。