PDH API 文档

使用 CC Switch
三分钟接入 Pdh API

下载 CC Switch 立即注册 已有账号，去登录

1. 注册并登录 Pdh API

第一次使用先创建账号。注册完成后登录控制台，再继续创建 API 令牌。

立即注册 前往登录
注册或登录遇到问题时，请先确认邮箱、验证码和密码是否填写正确。仍无法进入时再联系售后。

2. 下载并安装 CC Switch

本教程通过 CC Switch 快速导入 Pdh API 配置。请先安装工具，再继续创建令牌和选择模型。

前往官方下载 查看官方项目
选择系统版本

在 Releases 页面下载适合 Windows、macOS 或 Linux 的安装包。

完成安装并启动

首次启动后保持 CC Switch 在本地运行，后续网页才能自动唤起导入。

允许浏览器打开应用

浏览器弹出“打开 CC Switch”提示时，请选择允许或打开。

先安装 CC Switch，再点击控制台令牌菜单里的 CC Switch。没有安装时，浏览器无法完成自动导入。

3. 创建 API 令牌

进入控制台的令牌管理页面，点击添加令牌。名称可以填写 `Claude Code` 或 `Codex`，分组请选择与你购买线路对应的分组。

前往创建令牌
进入 Pdh API 令牌管理
第一步：进入控制台，在左侧选择“令牌管理”。
点击添加令牌
第二步：点击页面上方的“添加令牌”。

4. 快速配置 Claude Code

Claude 和 Kiro 分组都可以按下面流程配置。请选择 Claude 类型，不要混用 GPT 分组和 GPT 模型。

创建 Claude 分组令牌
1. 选择分组：填写令牌名称，选择 Claude 或 Kiro 等包含 Claude 模型的分组。
令牌菜单选择 CC Switch
2. 打开导入菜单：令牌创建成功后，在右侧下拉菜单中选择 CC Switch。
选择 Claude 模式与模型
3. 选择 Claude：按需要选择主模型、Haiku、Sonnet 和 Opus，不要把所有位置都设置为同一个模型。
浏览器确认打开 CC Switch
4. 浏览器确认：页面弹出提示后，允许浏览器打开本地 CC Switch。
导入 Claude 供应商配置
5. 确认导入：检查 Claude 地址、密钥掩码和模型信息，然后点击导入。
在 CC Switch 中选择 Claude CLI
6. 区分客户端：选择 Claude CLI 配置；旁边的 Claude Desktop 是桌面客户端配置。
编辑 Claude 供应商
7. 进入编辑：导入完成后点击编辑，准备测试模型列表。
获取 Claude 模型列表
8. 获取模型：点击“获取模型列表”，确认能够读取当前分组可用模型。
保存 Claude 模型映射
9. 保存映射：按实际需要配置 Sonnet、Opus、Fable 和 Haiku，最后点击保存。

5. 快速配置 Codex

Codex 使用 GPT 分组令牌。请选择 GPT 分组中的可用模型，不要在同一个令牌里混用 Claude 模型。

创建 GPT 分组令牌
1. 选择 GPT 分组：填写名称并选择对应 GPT 分组，确认分组价格和可用模型。
令牌菜单选择 CC Switch
2. 选择 CC Switch：令牌创建后，在右侧下拉菜单中点击 CC Switch。
选择 Codex 和 GPT 模型
3. 选择 Codex：应用类型选 Codex，并选择该 GPT 分组下可用的模型。
浏览器确认打开 CC Switch
4. 浏览器确认：允许网页打开本地 CC Switch。
导入 Codex 配置
5. 点击导入：检查 API 端点包含 `/v1`，密钥已正确填入，然后导入。
CC Switch Codex 供应商列表
6. 进入编辑：导入成功后，在供应商列表中找到新配置并点击编辑。
Codex 获取模型列表并保存
7. 测试并保存：点击获取模型列表，成功获取后保存配置即可使用 Codex。

6. 快速配置 Gemini CLI

Gemini CLI 使用 Gemini 分组令牌。创建令牌后通过 CC Switch 导入，确认 Gemini 类型并获取当前分组可用模型。

创建 Gemini 分组令牌
1. 选择 Gemini 分组：填写令牌名称，选择包含 Gemini 模型的分组后提交。
Gemini 令牌选择 CC Switch
2. 选择 CC Switch：令牌创建成功后，在右侧下拉菜单中点击 CC Switch。
选择 Gemini 模型
3. 选择 Gemini：应用类型选择 Gemini，并选择该分组下需要使用的主模型。
浏览器确认打开 CC Switch
4. 浏览器确认：允许网页打开本地 CC Switch。
导入 Gemini 供应商配置
5. 点击导入：检查地址、密钥掩码和模型信息，确认无误后点击导入。
CC Switch 中确认 Gemini 配置
6. 确认客户端：切换到 Gemini 分类，找到新导入的配置并点击编辑。
Gemini 获取模型列表并保存
7. 获取模型并保存：点击获取模型列表，选择需要的 Gemini 模型，然后保存配置。

7. 发送消息并检查日志

启用配置后，打开 Claude Code、Codex 或 Gemini CLI 发送一条简单消息。如果正常收到回复，说明配置已经完成。

查看使用日志
使用日志中能看到请求模型、令牌名称和消耗记录，就代表请求已经成功到达 Pdh API。

常见问题

无法获取模型列表

先检查令牌分组是否正确。需要自动获取模型时，一个令牌不要同时选择多个不相关分组。

提示 401 或认证失败

重新复制完整令牌，确认令牌已启用，再核对 API 请求地址是否正确。

API Connect Error

检查本地网络与代理是否正常，尝试访问其他网站或更换代理节点后重试。

提示 400

通常是上下文过大或历史对话被异常内容污染。新建一个对话，再发送简单消息测试。

保存后仍然没有生效

完全退出并重新打开客户端，同时检查本地是否存在旧环境变量覆盖 CC Switch 配置。

历史会话无法恢复

Claude Code 或 Codex 历史会话异常时，可使用下方推荐的 CC Sessions 工具辅助修复。

快速排障流程

不确定问题出在哪里时，请按顺序检查，不要同时修改多个配置。

检查账户与余额

确认账号可以正常登录，余额充足，没有账户状态提示。

检查令牌

确认令牌已启用、复制完整，并选择了正确分组。

检查 API 地址

Claude 与 Gemini 通常使用主地址；Codex 配置需要确认是否包含 `/v1`。

重新获取模型

在 CC Switch 编辑供应商，重新点击获取模型列表并保存。

重启客户端

完全退出 CC Switch 和正在使用的客户端，再重新打开测试。

检查使用日志

请求到达 Pdh API 后，使用日志应显示模型、令牌和消耗记录。

联系售后

提供报错截图、使用工具、模型名称、令牌名称和发生时间。

其他工具推荐

快速教程优先使用 CC Switch。下面工具适合桌面聊天、多模型管理或历史会话修复，可按需要选用。

CC
CC Switch管理 Claude Code、Codex 和 Gemini CLI 配置。
官方项目
CS
Cherry Studio适合桌面聊天和多模型供应商管理。
官方网站
AI
AionUI支持多种模型和本地桌面使用场景。
官方项目
DC
DeepChat开源桌面 AI 客户端，可配置兼容接口。
官方项目
SS
CC Sessions辅助修复 Claude Code 与 Codex 历史会话。
官方项目

需要帮助

将报错截图、使用工具、模型名称和大致发生时间发给售后，我们可以更快定位问题。

加入售后群 发送邮件