HoofoxHoofox API 接入指南
CCSwitch 首选 CCSwitch 接入

第一次接 API，照着做就能用

不用先理解请求头和接口参数。准备一个 Hoofox 密钥，用 CCSwitch 配置 Claude Code，完成你的第一次 AI 对话。

开始 CCSwitch 教程前往 CCSwitch 官方下载
第 1 步注册并充值
第 2 步创建密钥
第 3 步配置 CCSwitch
第 4 步开始使用

预计 5～10 分钟。CCSwitch 是配置管理工具，真正与你对话的是 Claude Code、Codex 等 AI 应用。

开始前准备

你只需要准备 Hoofox 账户、少量余额，以及要使用的 AI 应用。

Claude Code 推荐新手跟随下方主教程，使用 Claude 模型
Codex使用 GPT 模型，配置见后文
Gemini CLI使用 Gemini 模型，配置见后文
还没有安装 AI 应用？
CCSwitch 只负责保存和切换配置。使用 Claude Code 前，需要先安装 Node.js 18 或更高版本，然后在终端运行下方命令。
npm install -g @anthropic-ai/claude-code

macOS 也可以运行 brew install claude-code。CCSwitch 支持 Windows 10+、macOS 12+ 和常见 Linux 发行版。

创建 Hoofox API Key

1

登录 Hoofox

进入控制台。如果还没有余额，先完成充值；API 调用会按模型实际用量扣费。

打开钱包 →
2

创建密钥

控制台›API 密钥›创建密钥

名称可以填写“我的电脑”或“CCSwitch”。创建后复制以 sk- 开头的密钥。

前往 API 密钥页面 →
密钥相当于账户密码。
不要发给别人，不要放进公开截图或代码仓库。怀疑泄露时，立即删除旧密钥并新建一个。

用 CCSwitch 接入 Claude Code

这是推荐的新手路径。CCSwitch 官方下载地址为 ccswitch.io，不要从要求付费或索取账号密码的网站下载。

1

安装并打开 CCSwitch

  • Windows：下载 Windows.msi，双击安装。
  • macOS：运行 brew install --cask cc-switch，或下载 macOS.dmg。
  • 启动后，在左侧选择 Claude Code。
2

添加 Hoofox 供应商

Claude Code›右上角 +›应用专属供应商›自定义

如果你的版本直接显示输入框，按下面填写；如果显示 JSON 编辑器，使用下一段配置。

名称
Hoofox API
API Key
粘贴你自己的 sk-... 密钥
端点地址
https://www.hoofox.com
模型
claude-sonnet-4-6
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴你的 Hoofox API Key",
    "ANTHROPIC_BASE_URL": "https://www.hoofox.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}
3

保存并启用

点击“添加”或“保存”，回到供应商列表，找到 Hoofox API，点击“启用”。卡片显示“使用中”即代表配置已切换。

为什么 Claude 地址不带 /v1？
Claude Code 会自动补上 Messages API 路径，所以这里填写 https://www.hoofox.com。Codex 使用 OpenAI 兼容接口，才填写 https://www.hoofox.com/v1。

完成第一次运行

打开新的终端窗口，运行：

claude

进入 Claude Code 后输入：

请只回复：Hoofox 接入成功
  • 看到模型正常回复，说明接口地址、密钥和模型均可用。
  • 回到 Hoofox“使用日志”，可以看到刚才的请求和费用。
  • 以后需要更换线路，只需在 CCSwitch 中切换供应商。
查看 Hoofox 使用日志 →

在 CCSwitch 中接入 Codex

已经安装 Codex 的用户，在 CCSwitch 左侧选择 Codex，添加“自定义”供应商。关键配置如下：

名称
Hoofox API
API Key
你的 Hoofox sk-... 密钥
Base URL
https://www.hoofox.com/v1
Wire API
responses
模型
从模型广场复制准确名称

保存后点击“启用”，再打开新的终端运行 codex。若模型不支持 Responses 协议，请换用模型广场中适用于 Codex 的 GPT 模型。

在 CCSwitch 中接入 Gemini CLI

选择 Gemini，添加“自定义”供应商。不同 CCSwitch 版本可能显示表单或 JSON 编辑器：

{
  "env": {
    "GEMINI_API_KEY": "粘贴你的 Hoofox API Key",
    "GOOGLE_GEMINI_BASE_URL": "https://www.hoofox.com",
    "GEMINI_MODEL": "gemini-3-flash"
  }
}

模型名称可能随供应渠道变化，请以 Hoofox 模型广场当前显示为准。

怎样判断接入成功

  • CCSwitch 中 Hoofox 供应商显示“使用中”。
  • Claude Code、Codex 或 Gemini CLI 能返回正常文字，而不是登录提示。
  • Hoofox 控制台的“使用日志”出现一条新记录。
  • 账户余额产生与模型用量对应的小额变化。

常见错误，直接这样处理

401 / Unauthorized

密钥错误、已删除或粘贴不完整。重新复制 Hoofox API Key，并确认前后没有空格。

模型不存在

模型名填写错误或密钥分组无权限。到模型广场复制完整模型名，不要凭记忆输入。

402 / 余额不足

账户余额不足，或密钥额度已用完。先充值，并检查密钥是否设置了额度上限。

429 / 请求过多

短时间请求太频繁或上游限流。稍等片刻再试，不要连续重复发送。

404 / Not Found

通常是端点写错。Claude 填站点根地址；Codex 填 /v1 地址。

5xx / 上游错误

模型线路暂时异常。稍后重试，或在 CCSwitch 中切换另一个 Hoofox 模型。

开发者：手动调用 API

只有自己写程序时才需要这一节。Hoofox 提供 OpenAI 兼容接口。

基础地址

https://www.hoofox.com/v1

cURL 测试

curl https://www.hoofox.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "请替换为模型广场中的模型名",
    "messages": [{"role": "user", "content": "你好"}]
  }'

Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.hoofox.com/v1",
)

response = client.chat.completions.create(
    model="请替换为模型广场中的模型名",
    messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)

密钥与计费提醒

  • 不同项目使用不同密钥，方便查看用量和单独停用。
  • 不要把 API Key 写入网页前端、公开仓库、聊天记录或截图。
  • 模型的输入、输出、缓存和多模态内容可能采用不同价格。
  • 实际模型、倍率和费用以模型广场及账户账单为准。