Claude / GPT / Codex

FoxHub API 接入与调用文档

推荐使用 CC-Switch 集中管理供应商、API Key、请求地址和本地代理。按下面步骤配置后，即可在 Claude Code、Codex 或支持 OpenAI 兼容接口的客户端中使用。

Claude / Anthropic 地址 https://foxhub.cn
OpenAI / Codex Base URL https://foxhub.cn/v1
Anthropic Claude Code 使用，分组选择 Claude。
OpenAI GPT / Codex 使用，分组选择 OpenAI。
独立 Key 不同客户端建议创建不同 API Key，方便排查和统计。
!

渠道类型不要选错

ClaudeCode 类型选择 Anthropic，GPT / Codex 类型选择 OpenAI。

#

请求地址不要重复加 /v1

Claude 地址通常不带 /v1，OpenAI / Codex Base URL 通常填写到 /v1。

A

兑换与创建 API Key

先登录 FoxHub，在兑换页面完成余额兑换，再到 API 密钥页面创建对应分组的 API Key。

1

登录 FoxHub

打开 foxhub.cn，登录你的账号。

2

进入兑换余额

在左侧菜单进入兑换页面，填入激活码或兑换码。

3

创建 API Key

在 API 密钥页面创建对应分组的 API Key。具体可用分组和倍率以 FoxHub 后台显示为准。

创建密钥时选择 Claude 或 OpenAI 分组
创建密钥时先选择与客户端接口匹配的分组：Claude Code 选 Anthropic 兼容分组，GPT / Codex 选 OpenAI 兼容分组。

B

支持模型

Claude 系列
GPT 系列
Codex 系列
图片模型

模型名称以后台显示为准。配置客户端时请复制完整模型名，不要自行添加后缀。

1

下载 CC-Switch

CC-Switch 官方下载入口在 GitHub Releases。进入后按自己的系统选择 Windows、macOS 或 Linux 安装包。

下载 CC-Switch 最新版 查看开源仓库

已安装 CC-Switch？直接导入

登录 FoxHub 后，在 API 密钥页面点击对应密钥的“导入到 CCS”，选择 Claude、Codex 或 Gemini 以及模型，确认后会直接打开 CC-Switch。

去 API 密钥页导入到 CCS 查看手动配置

如果提示“CC-Switch 未安装或协议处理程序未注册”，先安装并启动 CC-Switch；仍无法打开时，可按下面步骤复制 API Key 和地址手动配置。

Windows

下载 .msi 安装包。

适合 Windows 电脑。

macOS

下载 macOS 包。

首次打开如果被拦截，请在系统设置里允许。

Linux

按系统架构选择对应包。

不确定架构时优先查看 Releases 说明。

2

配置 CC-Switch Claude 使用

Claude 这一栏用于 Claude Code。请求地址填写 FoxHub Claude 地址，不要在末尾再追加路径。

准备信息

  • API 请求地址：https://foxhub.cn
  • API Key：登录 FoxHub 后，在 API 密钥页面生成 Anthropic 兼容分组密钥。
  • API 格式：选择 Anthropic Messages（原生） 或客户端推荐的 Anthropic 格式。

操作步骤

  1. 打开 CC-Switch，选择顶部第一个 Claude 图标。
  2. 点击右上角加号，添加一个 Claude 供应商。
  3. 供应商名称可随便填写，API Key 填网站生成的令牌。
  4. 请求地址填 https://foxhub.cn，保存后启用。
  5. 切换 Key 前建议先关闭所有 Claude Code 进程，再重新打开 Claude Code。
CC-Switch Claude 页面选择第一个并点击加号
选择顶部第一个 Claude 图标，然后点击右上角加号。
CC-Switch Claude 编辑供应商页面
填入 API Key、请求地址和模型名称，保存后即可使用。

3

配置 CC-Switch Codex 使用

Codex 这一栏使用 OpenAI 兼容格式。Base URL 推荐填写到 https://foxhub.cn/v1。

  1. 打开 CC-Switch，切换到 Codex / OpenAI 页面。
  2. 点击右上角加号，新增一个供应商。
  3. 预设供应商保持“自定义配置”，然后向下填写配置。
  4. API Key 填 FoxHub 生成的 OpenAI 兼容分组令牌。
  5. API 请求地址填 https://foxhub.cn/v1。
  6. 模型名称可填后台显示的模型名；不确定时可以点击“获取模型列表”。
  7. 保存后回到主界面，启用配置并点击测试按钮，看到运行正常提示即可。
CC-Switch Codex 页面点击加号
先切换到 Codex / OpenAI 页面，再点击添加配置。
保持自定义配置
预设供应商保持“自定义配置”，然后继续向下填写。
填写 Codex API Key、请求地址和模型名称
填入名称、API Key、API 请求地址和模型名称。
CC-Switch 测试配置成功
启用后点击测试按钮，出现运行正常提示说明配置成功。

4

常见问题

遇到调用失败时，先检查 API 地址、API Key、模型名称、账号余额和客户端接口类型。

400 Bad Request

请求参数有问题，服务无法正常处理。

  • 检查模型名称和 API 地址。
  • 减少上下文内容后重新发送。
  • 删除不必要的自定义参数。
  • 使用最小测试请求重新验证。

401 Unauthorized

身份验证失败，请求没有通过认证。

  • 重新复制 API Key。
  • 确认没有多余空格、换行或引号。
  • 确认 API Key 填写位置正确。
  • 仍失败时重新创建一个 API Key。

403 Forbidden

当前账号没有权限完成本次请求。

  • 检查账号余额是否充足。
  • 确认套餐是否支持所选模型。
  • 尝试切换其他可用模型。
  • 持续失败时联系管理员处理。

404 Not Found

请求地址不存在。

  • 检查 Base URL 是否填写正确。
  • 不要重复添加 /v1。
  • 不要在地址末尾添加多余斜杠。
  • 确认客户端接口类型正确。

429 Rate Limit

请求过于频繁，触发频率限制。

  • 降低请求频率和并发数量。
  • 避免多个设备共用同一个 API Key。
  • 等待一段时间后再重试。
  • 经常出现时建议升级套餐或降低客户端并发。

503 Service Unavailable

当前服务暂时无法完成请求。

  • 稍后重新尝试。
  • 切换其他可用模型测试。
  • 降低请求频率。
  • 长时间持续出现时联系管理员并提供错误信息。

stream disconnected before completion

流式输出过程中连接被中断。

  • 先关闭流式输出测试。
  • 减少单次请求内容和输出长度。
  • 更换网络环境。
  • 客户端支持时适当调高超时时间。

model not found

模型名称无法识别。

  • 复制后台显示的完整模型名称。
  • 不要自行添加后缀。
  • 确认大小写和符号完全一致。
  • 确认当前账号支持该模型。

No available model

当前所选模型暂时不可用。

  • 先切换其他模型测试。
  • 稍后重新尝试。
  • 检查账号余额和套餐权限。
  • 多个模型都不可用时联系管理员处理。