OpenAI Base URL
Codex、Cursor、OpenAI SDK、curl
Universal Setup
快速开始
所有新用户先走这条线。先把账号、Key 和 CC Switch 打通，再去配置具体工具。手工 Base URL 只作为排障和高级配置时的参考。
1
登录控制台
进入 Wang 2API 控制台，确认可以看到仪表盘和 API Key 菜单。
成功标志：能进入控制台，并能打开 API Key 管理页面。
2
创建一个 API Key
打开 API Key 页面，创建一条用于 CC Switch 的密钥，例如 cc-switch-main。
如果你想区分不同设备或用途，也可以后续再拆分多条 Key。
成功标志：页面里已经能看到一条新的密钥记录。
3
安装 CC Switch
CC Switch 是推荐的新手入口，它可以统一管理多个客户端，避免手动改很多配置文件。
- 下载并安装 CC Switch
- 第一次打开保持默认设置即可
- 下一步会把刚创建的 Key 一键导进去
4
把 API Key 导入到 CCS
回到 Wang 2API 的 API Key 页面，在目标密钥右侧点击导入到 CCS。
只要 CC Switch 已经安装并打开，配置会自动写入。Claude 供应商使用根地址，OpenAI / Codex / Cursor 供应商使用 /v1 地址。
成功标志：CC Switch 里已经出现 Wang 2API 配置项。
5
选择你要使用的工具
共用准备完成后，直接按工具分支继续配置：
- 想在终端或 IDE 内使用 Claude，切到上方 Claude Code
- 想使用 OpenAI Codex，切到上方 Codex
- 想给 Cursor 配置自定义 API，切到上方 Cursor
- 想写脚本或服务端调用，切到上方 API 调用
Claude Workflow
Claude Code
完成快速开始后，API Key 已经通过导入到 CCS 写进 CC Switch。Claude / Anthropic 兼容配置使用根地址：https://api.pkqu.top。
1
安装 Claude Code
已安装可以跳过。新机器安装后运行 claude --version 确认命令可用。
macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash claude --version
2
在 CC Switch 里确认 Claude 已切到 Wang 2API
打开 CC Switch，切到 Claude / Claude Code，确认当前使用的是 Wang 2API 对应配置。需要手工排障时，再检查 Base URL 是否是下面这个根地址。
Claude Base URL
https://api.pkqu.top
这里不要加
/v1。如果 Claude 客户端要求 Anthropic Base URL，就使用根地址。
3
重启客户端并验证
切换配置后关闭终端或 IDE，再重新打开，避免旧进程继续使用旧环境变量。
bash
claude -p "hi"
成功标志：终端或 IDE 正常回复，同时 2API 控制台出现调用记录。
OpenAI Codex
Codex
完成快速开始后，优先在 CC Switch 里切到 Wang 2API 的 Codex 配置。Codex 走 OpenAI 兼容端点，所以 Base URL 使用 https://api.pkqu.top/v1。
1
确认 Codex 可用
终端运行 codex --version，IDE 用户确认已安装 Codex 扩展，并且当前打开的是项目目录。
2
在 CC Switch 里切到 Codex 配置
打开 CC Switch，切到 Codex，找到 Wang 2API 条目后进入配置并设为当前使用。需要手工排障时，再检查 ~/.codex/config.toml 是否指向 2API 的 OpenAI 端点。
~/.codex/config.toml
model_provider = "custom" model = "把这里替换成后台可用模型名" model_reasoning_effort = "medium" [model_providers.custom] name = "custom" wire_api = "responses" requires_openai_auth = true base_url = "https://api.pkqu.top/v1"
如果之前登录过官方账号或其他网关，切换 CC Switch 配置后重启 Codex，再确认请求记录是否出现在 2API 控制台。
3
验证请求链路
在 Codex 里发 hi。如果有回复但控制台没有记录，说明当前请求没有走 2API，要回头检查配置文件、登录态和当前进程。
Cursor BYOK
Cursor
完成快速开始后，Cursor 也优先通过 CC Switch 管理配置；需要手工填 OpenAI 自定义 Key 时，Base URL 使用 https://api.pkqu.top/v1。
1
先在 CC Switch 选择 Cursor 配置
优先在 CC Switch 中导入或选择 Wang 2API 的 Cursor 配置，再重启 Cursor。这样比手工维护多个配置项更稳。
2
手工模式填写 Override OpenAI Base URL
OpenAI Base URL
https://api.pkqu.top/v1
3
选择模型并验证
模型名按后台实际可用配置填写。保存后重启 Cursor，先发短请求，确认控制台出现调用记录。
如果 Cursor 内置模型突然不可用，先关闭 Override OpenAI Base URL 验证内置模型是否恢复。
OpenAI Compatible
API 调用
普通脚本和服务端接入 OpenAI SDK 时，Base URL 使用 https://api.pkqu.top/v1。真实 Key 用环境变量传入。
C
curl 验证
curl
curl https://api.pkqu.top/v1/chat/completions \
-H "Authorization: Bearer $WANG_2API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "把这里替换成后台可用模型名",
"messages": [{ "role": "user", "content": "hi" }]
}'
JS
Node.js 示例
node
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.WANG_2API_KEY,
baseURL: "https://api.pkqu.top/v1",
});
const result = await client.chat.completions.create({
model: "把这里替换成后台可用模型名",
messages: [{ role: "user", content: "hi" }],
});
console.log(result.choices[0]?.message?.content);
PY
Python 示例
python
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["WANG_2API_KEY"],
base_url="https://api.pkqu.top/v1",
)
result = client.chat.completions.create(
model="把这里替换成后台可用模型名",
messages=[{"role": "user", "content": "hi"}],
)
print(result.choices[0].message.content)
FAQ
常见问题
先看端点是否选对，再看 Key 和客户端缓存。大部分接入问题都能按这个顺序定位。
OpenAI 和 Claude 的 Base URL 到底怎么区分？
OpenAI 兼容工具使用
https://api.pkqu.top/v1；Claude / Anthropic 兼容工具使用 https://api.pkqu.top。前者带 /v1，后者不带。
客户端有回复，但 2API 控制台没有记录？
请求没有走 2API。检查 Base URL、登录态、CC Switch 当前供应商、Codex 的
model_provider 和 base_url、Cursor 的 Override OpenAI Base URL，并重启客户端。
401 / Unauthorized 怎么查？
先确认 Key 没复制少、没有多余空格、环境变量名正确；再确认请求头是
Authorization: Bearer sk-...。如果 Key 被禁用或额度不足，也会在控制台侧体现。
model not found 怎么查？
模型名按后台实际可用配置填写，保持大小写、点号和连字符不变。很多客户端会缓存配置，改完后需要重启或刷新。
能不能把 API Key 写到网页里？
不要。公开网页、前端包、截图和仓库都不应该包含真实 Key。浏览器端应用需要自己的后端代理，或者只用于本地临时测试。