推荐通过 CCSwitch 配置Hoofox API 接入指南
以 Codex 为首选客户端，通过标准 OpenAI 兼容接口接入 Hoofox API。本文涵盖密钥创建、CCSwitch 配置、连接验证及常见问题处理。
CCSwitch 用于集中管理客户端与服务商配置；模型请求与用量结算由 Hoofox API 提供。
接入准备
开始配置前，请准备有效的 Hoofox 账户、可用余额和目标客户端。
CCSwitch 负责配置管理，不替代 Codex 客户端。请先安装 Node.js 18 或更高版本，再安装 Codex。
npm install -g @openai/codex
macOS 用户也可以使用 brew install codex。CCSwitch 支持 Windows 10+、macOS 12+ 及常见 Linux 发行版。
创建 Hoofox API Key
API Key 是账户调用凭证，不应通过截图、公开仓库或即时通信工具对外披露。若怀疑泄露，请立即停用原密钥并创建新密钥。
通过 CCSwitch 配置 Codex
CCSwitch 可统一管理 Codex 的认证信息、模型与接口端点。请仅从 CCSwitch 官方网站或其 GitHub Releases 获取安装包。
安装 CCSwitch
- Windows：下载并运行
Windows.msi安装包。 - macOS：运行
brew install --cask cc-switch，或安装macOS.dmg。 - 启动 CCSwitch，在应用列表中选择 Codex。
添加 Hoofox 供应商
在供应商配置中填写以下参数。模型名称须与 Hoofox 模型广场显示的标识完全一致。
sk-... 密钥https://www.hoofox.com/v1responsesgpt-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
保存并启用
保存配置后，在供应商列表中启用 Hoofox API。状态显示“使用中”时，新启动的 Codex 会话将使用该配置。
Codex 使用 OpenAI 兼容端点，Base URL 应填写
https://www.hoofox.com/v1。请勿省略 /v1。验证 Codex 配置
关闭已经运行的 Codex 会话，打开新的终端窗口并执行：
codex
进入 Codex 后发送一条简短测试指令。收到正常响应后，可在 Hoofox 使用日志中核对模型、Token 用量和费用。
配置 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 / UnauthorizedAPI 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 客户端调用。
基础地址
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 不应写入网页前端、公开代码仓库、聊天记录或截图。
- 输入、输出、缓存及多模态内容可能采用不同计费标准。
- 可用模型、倍率和最终费用以模型广场及账户账单为准。