把 Claude Code / Codex / OpenAI SDK 从官方地址迁到 OpenAI-compatible 入口前，用这份清单过一遍，比迁完再救火省事。

迁移检查清单

• [ ] /models 或健康检查返回 200

• [ ] 最小 chat/completions 非流式成功

• [ ] 流式 SSE 逐片到达（代理未整包缓冲）

• [ ] 401/403 时错误体可区分「key 错」还是「模型未开通」

• [ ] 目标 model id 与文档一致（别用官方展示名硬套）

• [ ] 超时 ≥ 长任务（代码改写 / 多文件）

• [ ] 日志脱敏：不打印完整 key

• [ ] 回滚开关：环境变量可一键切回官方

# 冒烟
export OPENAI_BASE_URL=https://59api.com/v1
export OPENAI_API_KEY=sk-xxx
curl -sS "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4.1-mini","messages":[{"role":"user","content":"ping"}]}'

工具分头验收

1. OpenAI SDK：单测里 mock 关掉，打真实最小请求

2. Codex：短 prompt + 只读权限，看 auth 与 tool call

3. Claude Code：打开一个小仓库做 explain，再试 edit

任一步失败就停，不要「先全员切换再看」。

计费与限流

兼容入口常按 token 或按次 与官方不同。团队若混用 Claude / GPT，建议入口侧带 项目标签，否则月末对账会对不上。

备注

清单与域名无关；我本地验证兼容性时 base 写过 https://59api.com。迁移动作本身是工程问题，不是安利文。