Codex CLI 要带 /v1,Claude Code CLI 不带。 请按下面的客户端和服务商模式选择;macOS、Windows、Linux 使用相同的服务地址。

填根地址:不带 /v1

复制这个地址,末尾不加斜杠:

填基础地址:保留 /v1

复制这个地址;不再追加 /responses/chat/completions
Windsurf 原生 Cascade 暂未确认可配置任意网关地址。 不要随意填上述任一地址;在编辑器终端使用独立 Codex / Claude Code CLI 时,按对应客户端的规则,见 Windsurf 说明 填好地址后,按对应客户端指南继续设置 Key 和模型,再发一条消息验证。

FAQ:为什么不能统一填一个地址?

Base URL 是软件用来拼接请求的起点,不一定是域名,也不是完整请求地址。Codex 少填 /v1 可能请求到 /responses;Claude Code 多填 /v1 可能请求到 /v1/v1/messages。以最终请求路径排查,不能只凭 404 判断地址错误;模型或渠道不可用也可能返回错误。
要。上表只对应明确列出的接入模式。
  • Chatbox:本站教程使用自定义 OpenAI API Compatible,显式填写 API Path 后,要自己在 API Host 保留 /v1;内置 OpenAI 的自动补路径行为不同。
  • Cherry Studio:内置 New API 会处理版本前缀。推荐直接填根地址;# 是特殊地址语法,不能随意加。按模型选择的协议还可能使用 Gemini 的 /v1beta,不是所有模型都走 Chat Completions。
  • AionUI:本站的 /v1 示例用于普通 Base URL 模式;“完整 URL / Full URL”要求完整操作地址,不能把两种字段语义混用。
  • OpenCode@ai-sdk/anthropic 适配器的 baseURL 也需要 /v1,随后追加 /messages。它与 Claude Code 的 ANTHROPIC_BASE_URL 不同,即使都使用 Anthropic Messages。
其他 provider、transport、代理前缀和高级开关,按各客户端页的 FAQ 核对。
不要仅因为模型品牌改变地址。地址由客户端选中的 provider / 协议适配器决定。例如 Codex 使用支持 Responses 的 Claude 模型,仍填写带 /v1 的 Codex base_url。本站渠道还需支持相应协议转换及工具调用;地址正确不代表所有模型功能都兼容。
优先查看客户端的 API Example、脱敏网络日志或网关调用记录。典型文本请求路径为 /v1/messages/v1/responses/v1/chat/completions;模型列表为 /v1/models不要填文档地址、/docs、登录页,也不要将完整请求路径填入基础地址字段。复制时保留大小写和路径,不带多余空格。某些客户端会自动纠正地址,另一些按原样拼接;能在一个客户端使用的写法,不一定能直接复制给另一个。不要为了确认路径发出大量请求,也不要把含真实 Key 的完整日志分享出来。其他错误见统一排错
核对日期:2026-09-10。逐项依据官方文档、官方仓库地址拼接实现与官方支持说明;每个客户端页末尾列出对应来源。已核对配置字段和路径处理;尚未完成全部客户端、全部版本在三系统上使用本站真实 Key 的联调。查看某个地址是否返回网页,不能代替客户端的实际请求验证。