OpenAI Responses / Codex

Codex / CC Switch 填根地址；SDK 或手写 HTTP 用 OpenAI Compatible 前缀。

场景	配置页填	实际请求路径
OpenAI SDK / 手写 HTTP	https://portdan.com/v1	https://portdan.com/v1/responses
Codex / CC Switch	https://portdan.com	Codex 自动请求 /responses
Codex direct 兼容路径	https://portdan.com	https://portdan.com/backend-api/codex/responses

填写 Codex 基础地址

Codex / CC Switch 的 API 请求地址填：

https://portdan.com

别填 https://portdan.com/v1。CC Switch 导入 OpenAI 分组时，基础地址同样填根地址。

发送 Responses 请求

在终端或 PowerShell 执行。模型名先从当前分组复制，示例里写死的模型名只是兜底。把 sk-your-api-key 换成完整 Key。

curl https://portdan.com/v1/responses \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "请只回复 OK"
  }'

手动配置 Codex

默认配置文件是 ~/.codex/config.toml；用 profile 启动的，改对应的 ~/.codex/<profile-name>.toml。改之前先备份。provider 和地址别写进项目目录的 .codex/config.toml。model 和 review_model 先用当前分组的模型。

model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
openai_base_url = "https://portdan.com"
windows_wsl_setup_acknowledged = true

改地址用的是 Codex 内置 OpenAI provider 的 openai_base_url 覆盖项。别写成 [model_providers.OpenAI]，内置名覆盖不生效。

已经在用自定义 provider

只有原配置本来就在用自定义 provider 时，才沿用这种写法。顶层 model_provider 必须和 [model_providers.<id>] 的 <id> 完全一致：

model_provider = "portdan"
model = "gpt-5.6-sol"
review_model = "gpt-5.6-sol"

[model_providers.portdan]
name = "Portdan"
base_url = "https://portdan.com"
wire_api = "responses"
requires_openai_auth = true

portdan 只是这个示例使用的 provider ID，不要求写成 custom。如果你的原配置使用别的 ID， 顶层和方括号里的 ID 要一起保留。修改前备份文件，只改目标 provider；不要覆盖 MCP、权限、 Hooks、Profile 或其他供应商。

API Key 交给 Codex 登录流程写入，别手写 auth.json。裸 codex login 会打开浏览器走 ChatGPT 账号登录，不是填 Key 的入口。写入 Key 用官方的 stdin 方式，命令在终端或 PowerShell 执行，别写进配置文件。

macOS / Linux：

read -rsp "Portdan API Key: " PORTDAN_API_KEY
echo
printf '%s' "$PORTDAN_API_KEY" | codex login --with-api-key
unset PORTDAN_API_KEY

Windows PowerShell：

$key = Read-Host "Portdan API Key"
$key | codex login --with-api-key

写入后执行 codex login status 确认已登录。

选择接口

场景	使用
Codex / CC Switch Codex	Responses，API 请求地址用 https://portdan.com。
ChatBox / Cherry Studio / Cursor	Chat Completions，Base URL 用 https://portdan.com/v1。
新项目 SDK 且需要 Responses 能力	Responses，Base URL 用 https://portdan.com/v1。