地址与鉴权

选择客户端

按客户端选择地址

按软件复制对应 Base URL，不要自己拼路径。

Codex / CC Switch：https://portdan.com

OpenAI Compatible：https://portdan.com/v1

Claude / Anthropic：https://portdan.com

Gemini CLI：https://portdan.com

Gemini HTTP / OpenCode Gemini：https://portdan.com/v1beta

Antigravity Claude / Gemini CLI：https://portdan.com/antigravity

Antigravity OpenAI：https://portdan.com/antigravity/v1

Antigravity Gemini HTTP / OpenCode Gemini：https://portdan.com/antigravity/v1beta

填好地址先保存并完全重启客户端。404 先检查是不是重复追加了接口路径，401 再检查 Key 是否完整有效。排查时一次只改一项。

复制地址

场景	软件里常见字段名	填写地址	备注
Codex / CC Switch	API Request URL / Base URL	https://portdan.com	不带 /v1。
ChatBox / Cherry Studio / Cursor / Cline / Continue	OpenAI Base URL / API Base URL	https://portdan.com/v1	OpenAI Compatible 客户端通常要带 /v1。
OpenAI Chat Completions	Endpoint 前缀	https://portdan.com/v1	实际路径是 /chat/completions。
OpenAI Responses / SDK	Endpoint 前缀	https://portdan.com/v1	实际路径是 /responses。
Claude Desktop / Claude Code / Anthropic Messages	Base URL / 请求地址	https://portdan.com	客户端会请求 /v1/messages；地址末尾别加 /。
Gemini CLI	Base URL	https://portdan.com	CLI 场景用根地址，CLI 会拼 /v1beta。
OpenCode 的 Gemini Provider	Base URL	https://portdan.com/v1beta	走 Gemini v1beta 兼容地址。
Antigravity Claude	Base URL	https://portdan.com/antigravity	Antigravity 专用 Claude 入口。
Antigravity OpenAI Compatible	Base URL	https://portdan.com/antigravity/v1	Antigravity 专用 OpenAI 兼容前缀。
Antigravity Gemini HTTP / OpenCode Gemini	Base URL	https://portdan.com/antigravity/v1beta	Antigravity 专用 Gemini 前缀。
Embeddings	Endpoint 前缀	https://portdan.com/v1	实际路径是 /embeddings。

OpenAI 路线按场景选地址

普通 OpenAI 兼容客户端（ChatBox、Cherry Studio、Cursor 等）填 https://portdan.com/v1。Codex / CC Switch 填根地址 https://portdan.com；Antigravity OpenAI Compatible 单独填 https://portdan.com/antigravity/v1。

区分 Base URL 和接口路径

客户端配置页填写 Base URL

比如 ChatBox 的 Base URL 填 https://portdan.com/v1，软件会自己拼 /chat/completions。

自己写 curl / SDK填写完整路径

比如 curl 请求模型列表写 https://portdan.com/v1/models，别把 /models 写进客户端 Base URL。

填写 Key

多数客户端有 API Key 输入框，直接粘贴完整 Key，不加引号，也不加 Bearer 前缀。

场景	Key 写法	别这样写
软件 API Key 输入框	完整 Key 原文	添加 Bearer 、引号或其他字符
OpenAI / Anthropic curl 请求	Authorization: Bearer sk-...	少写 Bearer 或把 Key 放进 URL
Gemini curl 请求	x-goog-api-key: sk-...	把 Key 写到公开截图里

自己写 HTTP 请求：

curl https://portdan.com/v1/models \
  -H "Authorization: Bearer $PORTDAN_API_KEY"

手写 Gemini v1beta 请求用 x-goog-api-key：

curl "https://portdan.com/v1beta/models" \
  -H "x-goog-api-key: $PORTDAN_API_KEY"

检查斜杠

你看到的字段	填	别填
Base URL / API Base	基础地址；一般末尾别加 /	完整接口路径，例如 /chat/completions
Endpoint / URL	文档给出的完整接口	少一段路径或多一段路径
API Key	完整 Key	缺少字符或带有额外文字

发送测试请求

模型名先从当前分组复制，下面写死的模型名只是兜底示例。

OpenAI Compatible：

curl https://portdan.com/v1/chat/completions \
  -H "Authorization: Bearer $PORTDAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"请只回复 OK"}]}'

Codex 配置好后不用写 curl，直接在对话里发送：

请只回复 OK

看到完整报错或状态码时先查报错手册。没有使用记录时，再按问题排查清单检查网络和配置。