智码Code

OpenAI 兼容 Base URL

OpenAI 兼容 Base URL 怎么填

中转站配置失败，最常见原因不是 Key 错，而是 Base URL 和协议不匹配。这个页面把不同工具该填哪个入口讲清楚，帮助用户在第一次配置时少走弯路。

查看接入文档查看套餐价格

先看关键事实

Codex / SDK使用 OpenAI 兼容 /v1 入口
Claude Code使用 Claude / Anthropic 兼容入口
Cursor按自定义 OpenAI 兼容 API 配置
常见错误重复拼 /v1、把 Claude 入口填到 OpenAI SDK、Key 前后多空格

怎么接入

  1. 1

    先确认客户端协议

    看工具文档里要求的是 OpenAI compatible 还是 Anthropic / Claude compatible。协议不同，Base URL 不能互换。

  2. 2

    复制控制台给出的完整地址

    尽量直接复制智码 Code 控制台展示的入口，避免手动拼路径时多写或少写 /v1。

  3. 3

    用日志反查请求

    请求失败时，先看控制台是否出现调用记录。没有记录通常是本地配置未打到智码 Code；有记录再看模型和额度。

常见问题

Base URL 后面要不要加 /v1？

OpenAI 兼容入口通常包含 /v1，Claude 兼容入口不一定相同。最稳妥是复制控制台里的完整地址。

为什么同一个 Key 在 Claude Code 和 Codex 配置不一样？

Key 可以相同，但协议入口不同。Claude Code 和 Codex 使用的 API 形状不一样，所以 Base URL 要按工具区分。

404 或 405 是什么原因？

多半是路径或协议不匹配。检查是否把 OpenAI SDK 请求打到了 Claude 入口，或者手动拼错了路径。