报错字典 / claude-code / HTTP 404

接入后立刻返回 404

Base URL 的 /v1 前缀写反了,两个客户端的规则正好相反。

原始报错

2026-11-05
APIError: 404 Not Found

原因

两个客户端拼接路径的规则相反,这是最高频的一个坑:

  • Claude Code 自己拼 <base>/v1/messages,所以 Base URL 不带 /v1;
  • Codex CLI 自己拼 <base>/responses,所以 base_url 必须带 /v1。

反了就是 404,而且报错信息不提示路径问题。

解法

  1. Claude Code:ANTHROPIC_BASE_URL=https://api.example.com(无 /v1)
  2. Codex CLI:base_url = "https://api.example.com/v1"
  3. 先用 curl 验证再启动客户端:curl -X POST <base>/v1/messages -H "content-type: application/json" -d '{"model":"...","max_tokens":1,"messages":[{"role":"user","content":"hi"}]}'