Appearance
Claude Code / Codex / Gemini 切换
本页按 Portdan / Sub2 的真实接入方式整理。结论先写清楚:Key 不加后缀;不同工具使用不同 Base URL。
开始前先准备好
- 已购买额度。
- 已创建 API Key。
- 已给 API Key 绑定正确分组。
- 已确认 Key 原样复制,没有任何协议后缀。
地址总表
| 工具 | 地址字段 | 填写值 | 说明 |
|---|---|---|---|
| CC Switch 导入 Codex | Endpoint / 请求地址 | https://portdan.com | 导入逻辑使用根地址 |
| Codex 手动配置 | base_url | https://portdan.com | Sub2 提供 /responses 别名 |
| Claude Code | ANTHROPIC_BASE_URL | https://portdan.com | Claude Code 自行拼 /v1/messages |
| Gemini CLI | GOOGLE_GEMINI_BASE_URL | https://portdan.com | Gemini CLI 自行拼 /v1beta |
| Antigravity Claude | ANTHROPIC_BASE_URL | https://portdan.com/antigravity | 专用根路径 |
| Antigravity Gemini CLI | GOOGLE_GEMINI_BASE_URL | https://portdan.com/antigravity | 专用根路径 |
| OpenCode OpenAI provider | baseURL | https://portdan.com/v1 | OpenCode provider 配置使用 /v1 |
| OpenCode Gemini provider | baseURL | https://portdan.com/v1beta | OpenCode provider 配置使用 /v1beta |
CC Switch 导入
在 Portdan 控制台点击「导入到 CC Switch」时,生产根地址应是:
text
https://portdan.com不同分组平台会导入到不同 app:
| Key 分组平台 | CC Switch app | Endpoint |
|---|---|---|
| OpenAI | Codex | https://portdan.com |
| Claude / Anthropic | Claude | https://portdan.com |
| Gemini | Gemini | https://portdan.com |
| Antigravity | Claude 或 Gemini | https://portdan.com/antigravity |
导入时 API Key 仍然是控制台原始 Key,不要加后缀。
Codex 手动配置
~/.codex/config.toml:
toml
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://portdan.com"
wire_api = "responses"
requires_openai_auth = true
[features]
goals = true~/.codex/auth.json:
json
{
"OPENAI_API_KEY": "sk-your-api-key"
}Windows 路径通常是 %userprofile%\.codex\config.toml 和 %userprofile%\.codex\auth.json。
Claude Code
macOS / Linux:
bash
export ANTHROPIC_BASE_URL="https://portdan.com"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1Windows CMD:
bat
set ANTHROPIC_BASE_URL=https://portdan.com
set ANTHROPIC_AUTH_TOKEN=sk-your-api-key
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1PowerShell:
powershell
$env:ANTHROPIC_BASE_URL="https://portdan.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"VSCode Claude Code 的 ~/.claude/settings.json 可写:
json
{
"env": {
"ANTHROPIC_BASE_URL": "https://portdan.com",
"ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}Gemini CLI
macOS / Linux:
bash
export GOOGLE_GEMINI_BASE_URL="https://portdan.com"
export GEMINI_API_KEY="sk-your-api-key"
export GEMINI_MODEL="gemini-2.0-flash"Windows CMD:
bat
set GOOGLE_GEMINI_BASE_URL=https://portdan.com
set GEMINI_API_KEY=sk-your-api-key
set GEMINI_MODEL=gemini-2.0-flashPowerShell:
powershell
$env:GOOGLE_GEMINI_BASE_URL="https://portdan.com"
$env:GEMINI_API_KEY="sk-your-api-key"
$env:GEMINI_MODEL="gemini-2.0-flash"Antigravity
Claude Code:
bash
export ANTHROPIC_BASE_URL="https://portdan.com/antigravity"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1Gemini CLI:
bash
export GOOGLE_GEMINI_BASE_URL="https://portdan.com/antigravity"
export GEMINI_API_KEY="sk-your-api-key"
export GEMINI_MODEL="gemini-2.5-flash"常见问题
是否要像某些文档那样给 Key 加后缀
不要。Portdan / Sub2 后端按收到的 Key 字符串精确查询。任何后缀都会导致 Key 变成另一个字符串。
Codex 为什么不是 https://portdan.com/v1
普通 OpenAI SDK 填 https://portdan.com/v1。Codex / CC Switch 这类工具常使用 Responses 根路径,Portdan 后端也提供了不带 /v1 的 /responses 别名,所以按控制台导入逻辑使用 https://portdan.com。
Claude Code 为什么不是 https://portdan.com/v1
Claude Code 走 Anthropic Messages,工具会调用 /v1/messages。所以 ANTHROPIC_BASE_URL 应填 https://portdan.com,不能填完整的 https://portdan.com/v1/messages。
Gemini CLI 为什么不是 https://portdan.com/v1beta
Gemini CLI 的 Base URL 用根地址,CLI 会自行拼 /v1beta。直接 HTTP 请求或 OpenCode Gemini provider 才使用 https://portdan.com/v1beta。
