先看关键事实
Codex / SDK使用 OpenAI 兼容 /v1 入口
Claude Code原生 Claude 模型经 原生客户端配置；第三方模型由安装器配置 Messages 入口
Cursor按自定义 OpenAI 兼容 API 配置
常见错误重复拼 /v1、把 Claude 入口填到 OpenAI SDK、Key 前后多空格
怎么接入
- 1
先确认客户端协议
CLI 用户在 /dashboard/access-docs 选择客户端和模型并运行统一安装器。SDK 用户按所需的 OpenAI 或 Anthropic 协议选择入口，避免混用。
- 2
复制控制台给出的完整地址
尽量直接复制智码 Code 控制台展示的入口，避免手动拼路径时多写或少写 /v1。
- 3
用日志反查请求
请求失败时，先看控制台是否出现调用记录。没有记录通常是本地配置未打到智码 Code；有记录再看模型和额度。
常见问题
Base URL 后面要不要加 /v1？
OpenAI 兼容入口通常包含 /v1，Claude 兼容入口不一定相同。最稳妥是复制控制台里的完整地址。
为什么同一个 Key 在 Claude Code 和 Codex 配置不一样？
Codex 使用 ck_ Key，原生 Claude Code 的所有模型使用自己的有效 ck_ Key。Claude Code 调用 GPT、Grok 等第三方模型时使用 ck_ Key，但协议与 Codex 不同；统一安装器会写入对应入口。
404 或 405 是什么原因？
多半是路径或协议不匹配。检查是否把 OpenAI SDK 请求打到了 Claude 入口，或者手动拼错了路径。