API 地址要不要加 /v1？Codex、Claude Code 与 SDK 的区别
区分 Base URL 和完整请求端点，解释 Codex、Claude Code、OpenAI SDK 的 /v1 配置与 404 排查。
答案取决于客户端如何拼接路径
API 地址是否需要加 /v1，取决于客户端会自动补上哪一段路径。先确认设置项要的是服务根地址、API 前缀还是完整请求端点，再填写地址。只看域名是否相同，无法判断配置是否正确。
Base URL 是客户端构造请求的起点；完整端点是某一种 API 的实际请求路径。把完整端点填进 Base URL，容易出现路径重复。
照着图，先找到你使用的客户端
| 使用方式 | 填写地址 | 请求路径示例 |
|---|---|---|
| Codex CLI，Responses 协议 | https://huigen.xyz/v1 | /v1/responses |
| Claude Code CLI | https://huigen.xyz | /v1/messages |
| OpenAI SDK，自定义 base_url | https://huigen.xyz/v1 | 调用 Responses 时为 /v1/responses |
| 直接发送 HTTP 请求 | 完整请求端点 | 例如 https://huigen.xyz/v1/responses |
表格按本站配置助手及常见官方 SDK 行为编写。其他软件的“API 地址”字段可能有额外拼接逻辑，应优先查该客户端文档，不能只按软件是否兼容 OpenAI 来猜测。
实际操作：从错误路径改回正确地址
1. 记录当前客户端和字段名称
打开客户端配置，先记下软件名称，以及设置项写的是 Base URL、API URL 还是完整端点。编辑前备份现有文件。
完成后检查：确认你改的是正在启动的客户端实际读取的那份配置。
2. 按上图填写对应地址
Codex 的 base_url 填 https://huigen.xyz/v1；Claude Code 的 ANTHROPIC_BASE_URL 填 https://huigen.xyz。其他客户端先查其说明。
完成后检查：不要在 Codex 的 Base URL 后面手写 /responses，也不要在 Claude Code 的根地址后面多写 /v1。
3. 重新启动并做一个小请求
保存修改，退出旧客户端进程，从应用了新配置的终端重新启动，再发送一句简单问题。若仍报 404，查看去掉认证信息的实际请求路径。
完成后检查：路径中没有 /v1/v1 或 /responses/responses。若路径正确仍失败，继续核对响应正文和模型。
404 先看路径，再看模型与协议
典型错误包括 /v1/v1/messages、/v1/responses/responses，或客户端向服务不支持的协议端点发请求。先在客户端日志中查看去掉认证头的实际请求 URL，确认路径只拼接了一次。
路径正确后，再检查请求方式、请求体和模型对应协议。HTTP 404 也可能来自模型或路由问题，不能仅凭状态码认定是地址错误；需要结合响应正文。401 通常指向认证问题，429 可能与额度或限流相关，也要按服务端返回说明处理。
改地址时同时核对三个关联项
- 协议：客户端使用 Responses、Messages，还是其他 API？
- 认证：令牌是否由当前服务签发，是否位于对应分组？
- 模型：请求中的标识是否被当前分组支持？
详细操作参见Codex 配置教程和Claude Code 配置教程。使用慧根时，也可以直接从配置助手开始，减少手动拼接错误。