HoofoxHoofox API 接入指南
CCSwitch 推荐通过 CCSwitch 配置

Hoofox API 接入指南

以 Codex 为首选客户端,通过标准 OpenAI 兼容接口接入 Hoofox API。本文涵盖密钥创建、CCSwitch 配置、连接验证及常见问题处理。

01准备账户
02创建 API Key
03配置 Codex
04验证连接

CCSwitch 用于集中管理客户端与服务商配置;模型请求与用量结算由 Hoofox API 提供。

接入准备

开始配置前,请准备有效的 Hoofox 账户、可用余额和目标客户端。

Claude Code适用于 Claude 模型及长上下文任务
Gemini CLI适用于 Gemini 模型与多模态任务
客户端要求
CCSwitch 负责配置管理,不替代 Codex 客户端。请先安装 Node.js 18 或更高版本,再安装 Codex。
npm install -g @openai/codex

macOS 用户也可以使用 brew install codex。CCSwitch 支持 Windows 10+、macOS 12+ 及常见 Linux 发行版。

创建 Hoofox API Key

1

确认账户余额

登录 Hoofox 控制台并确认账户具有可用余额。API 请求将根据模型及实际 Token 用量计费。

访问钱包
2

创建独立密钥

控制台API 密钥创建密钥

建议将密钥命名为“Codex - 主设备”,便于后续识别调用来源、查看用量及单独停用。

访问 API 密钥管理
请妥善保管 API Key。
API Key 是账户调用凭证,不应通过截图、公开仓库或即时通信工具对外披露。若怀疑泄露,请立即停用原密钥并创建新密钥。

通过 CCSwitch 配置 Codex

CCSwitch 可统一管理 Codex 的认证信息、模型与接口端点。请仅从 CCSwitch 官方网站或其 GitHub Releases 获取安装包。

1

安装 CCSwitch

  • Windows:下载并运行 Windows.msi 安装包。
  • macOS:运行 brew install --cask cc-switch,或安装 macOS.dmg
  • 启动 CCSwitch,在应用列表中选择 Codex
2

添加 Hoofox 供应商

Codex添加供应商应用专属供应商自定义

在供应商配置中填写以下参数。模型名称须与 Hoofox 模型广场显示的标识完全一致。

名称
Hoofox API
API Key
粘贴 Hoofox sk-... 密钥
Base URL
https://www.hoofox.com/v1
Wire API
responses
模型
gpt-5.5,或从模型广场选择
model_provider = "hoofox"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.hoofox]
name = "Hoofox API"
base_url = "https://www.hoofox.com/v1"
wire_api = "responses"
requires_openai_auth = true
3

保存并启用

保存配置后,在供应商列表中启用 Hoofox API。状态显示“使用中”时,新启动的 Codex 会话将使用该配置。

端点格式
Codex 使用 OpenAI 兼容端点,Base URL 应填写 https://www.hoofox.com/v1。请勿省略 /v1

验证 Codex 配置

关闭已经运行的 Codex 会话,打开新的终端窗口并执行:

codex

进入 Codex 后发送一条简短测试指令。收到正常响应后,可在 Hoofox 使用日志中核对模型、Token 用量和费用。

请回复:Hoofox API 连接验证成功
访问使用日志

配置 Claude Code

在 CCSwitch 中选择 Claude Code,新增“自定义”供应商,并使用以下配置:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "粘贴你的 Hoofox API Key",
    "ANTHROPIC_BASE_URL": "https://www.hoofox.com",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

Claude Code 会自动补全 Messages API 路径,因此其 Base URL 使用站点根地址,不附加 /v1

配置 Gemini CLI

在 CCSwitch 中选择 Gemini,新增“自定义”供应商。不同版本可能提供表单或 JSON 编辑器,两种方式使用相同参数:

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

可用模型可能随供应渠道调整,请始终以 Hoofox 模型广场当前展示为准。

连接验证清单

  • CCSwitch 中 Hoofox 供应商状态为“使用中”。
  • Codex 能够完成测试指令,且未出现认证或登录提示。
  • Hoofox 控制台的使用日志中出现对应请求记录。
  • 日志所示模型、Token 用量及费用与本次测试一致。

常见错误与处理

401 / Unauthorized

API Key 无效、已停用或粘贴不完整。请重新复制密钥,并检查首尾是否包含空格。

Model not found

模型标识不正确,或当前密钥分组无访问权限。请从模型广场复制完整模型名称。

402 / Insufficient balance

账户余额不足,或密钥已达到额度上限。请检查账户余额及密钥额度设置。

429 / Too many requests

请求频率超过当前线路限制。请降低并发,并在短暂等待后重试。

404 / Not Found

通常由端点格式错误导致。Codex 使用带 /v1 的地址,Claude Code 使用站点根地址。

5xx / Upstream error

上游模型或线路暂时不可用。请稍后重试,或切换其他可用模型。

API 调用参考

Hoofox 提供 OpenAI 兼容接口,可使用标准 SDK 或 HTTP 客户端调用。

基础地址

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 不应写入网页前端、公开代码仓库、聊天记录或截图。
  • 输入、输出、缓存及多模态内容可能采用不同计费标准。
  • 可用模型、倍率和最终费用以模型广场及账户账单为准。