/v1,Claude Code CLI 不带。 请按下面的客户端和服务商模式选择;macOS、Windows、Linux 使用相同的服务地址。
填根地址:不带 /v1
复制这个地址,末尾不加斜杠:填基础地址:保留 /v1
复制这个地址;不再追加/responses 或 /chat/completions:
Windsurf 原生 Cascade 暂未确认可配置任意网关地址。 不要随意填上述任一地址;在编辑器终端使用独立 Codex / Claude Code CLI 时,按对应客户端的规则,见 Windsurf 说明。
填好地址后,按对应客户端指南继续设置 Key 和模型,再发一条消息验证。
FAQ:为什么不能统一填一个地址?
Codex 与 Claude Code 为什么不同?
Codex 与 Claude Code 为什么不同?
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。
换 Claude / GPT 模型后,要不要改地址?
换 Claude / GPT 模型后,要不要改地址?
不要仅因为模型品牌改变地址。地址由客户端选中的 provider / 协议适配器决定。例如 Codex 使用支持 Responses 的 Claude 模型,仍填写带
/v1 的 Codex base_url。本站渠道还需支持相应协议转换及工具调用;地址正确不代表所有模型功能都兼容。怎么核对最终请求,避免多一段或少一段?
怎么核对最终请求,避免多一段或少一段?
优先查看客户端的 API Example、脱敏网络日志或网关调用记录。典型文本请求路径为
/v1/messages、/v1/responses、/v1/chat/completions;模型列表为 /v1/models。不要填文档地址、/docs、登录页,也不要将完整请求路径填入基础地址字段。复制时保留大小写和路径,不带多余空格。某些客户端会自动纠正地址,另一些按原样拼接;能在一个客户端使用的写法,不一定能直接复制给另一个。不要为了确认路径发出大量请求,也不要把含真实 Key 的完整日志分享出来。其他错误见统一排错。资料来源与核对范围
资料来源与核对范围
核对日期:2026-09-10。逐项依据官方文档、官方仓库地址拼接实现与官方支持说明;每个客户端页末尾列出对应来源。
- Codex 自定义 provider 与 openai_base_url
- Claude Code LLM 网关
- Claude 桌面第三方推理网关
- Cherry Studio 官方仓库
- Chatbox 官方仓库
- OpenCode provider 与 baseURL
- Cursor 官方支持:中转地址带 /v1