PanAPI PanAPI Docs

用 PanAPI 连接你的 AI 编程工具

PanAPI CC Switch 配置指南

CC Switch 可以统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等工具的 Provider。你只需要准备 PanAPI 的 API Key，把 Base URL 和模型填进去，然后切换到 PanAPI 即可使用。

Base URL https://www.panapi.xyz/v1
API Key 在 PanAPI 控制台创建令牌后复制
配置方式 在 CC Switch 新增 Provider 并切换

准备工作

  1. 登录 PanAPI 官网。
  2. 进入控制台，创建一个可用令牌，并复制 API Key。
  3. 确认账户余额充足，且令牌可访问你要使用的模型。
  4. 打开 CC Switch，选择你要管理的工具，例如 Claude Code、Codex 或 Gemini CLI。

快速配置

在 CC Switch 中新增一个 Provider，名称可以写成 PanAPI。不同版本的 CC Switch 界面略有差异，但核心字段基本一致。

Provider 名称 PanAPI
API Key 粘贴你在 PanAPI 控制台创建的令牌
Base URL https://www.panapi.xyz/v1
API 格式 按你要使用的工具选择。Claude Code 通常选择 Anthropic/Claude 兼容格式；Codex、OpenAI 兼容工具通常选择 OpenAI 兼容格式。
默认模型 填写 PanAPI 模型广场中显示的模型名称，例如 Claude、GPT、Image 相关模型。
保存后点击“切换”或“启用”当前 Provider。大多数 CLI 工具需要重新打开终端后才会读取新配置。

模型填写

模型名称请以 PanAPI 模型广场或控制台显示为准，不要自己猜模型名。常见写法示例：

claude-sonnet-4-5
claude-opus-4-5
gpt-5.5
image2.0

如果某个模型无法调用，优先检查令牌权限、账户余额、分组权限和模型名称是否完全一致。

验证是否生效

  1. 在 CC Switch 中确认当前 Provider 已切换到 PanAPI。
  2. 关闭并重新打开终端。
  3. 运行你的 CLI 工具，例如 claude、codex 或 gemini。
  4. 发送一个简短问题测试调用是否正常。
  5. 回到 PanAPI 控制台查看令牌用量，如果出现请求记录，说明配置已经生效。

常见问题

  • 401 或 invalid api key：重新复制 PanAPI 令牌，确认没有多余空格，也确认令牌没有被禁用。
  • 404 或 model not found：模型名填写不正确，回到模型广场复制真实模型名称。
  • 没有切换成功：保存 Provider 后重新打开终端；部分工具不会读取已经打开的旧会话配置。
  • 能连接但很慢：先测试其他模型；如果所有模型都慢，可能是本地网络、上游渠道或临时拥塞。
  • 余额消耗异常：在 PanAPI 控制台检查令牌用量和模型倍率，必要时重新创建单独令牌。