ClaudeHub

Appearance

通用配置教程 ​

本教程适用于所有支持自定义 API 地址的应用。无论你使用什么工具，只要能自定义 API 地址，都可以接入 ClaudeHub。

核心配置 ​

找到你的应用中 自定义 API 地址 的设置项，填写以下信息：

配置项值
API 地址（国内）https://api.qinzhiai.com
API 地址（海外）https://qinzhiai.com
API Keysk-你的APIKey（获取教程）

API 格式说明 ​

ClaudeHub 支持多种 API 格式，请根据你使用的模型和分组选择合适的格式：

OpenAI 格式（通用） ​

适用场景：大多数应用默认支持，兼容性最好

接口地址：https://api.qinzhiai.com/v1/chat/completions

bash
curl https://api.qinzhiai.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

注意

OpenAI 格式的 API 地址需要 /v1 后缀！

Claude 原生格式（推荐 Claude 模型） ​

适用场景：使用 Claude 系列模型时优先选择

接口地址：https://api.qinzhiai.com/v1/messages

bash
curl https://api.qinzhiai.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-你的APIKey" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Claude 格式特点

  • 请求头使用 x-api-key 而不是 Authorization: Bearer
  • 需要添加 anthropic-version 头
  • 必须指定 max_tokens

Gemini 原生格式 ​

适用场景：使用 Gemini 官方分组时

接口地址：https://api.qinzhiai.com/v1beta/models/{model}:generateContent

bash
curl "https://api.qinzhiai.com/v1beta/models/gemini-2.0-flash:generateContent?key=sk-你的APIKey" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Hello!"}]}]
  }'

Codex 格式（Responses API） ​

适用场景：Codex 分组专用

接口地址：https://api.qinzhiai.com/v1/responses

bash
curl https://api.qinzhiai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-你的APIKey" \
  -d '{
    "model": "gpt-4o",
    "input": "Hello!"
  }'

Codex 分组限制

Codex 分组只接受 Responses 格式，不支持 chat/completions 格式！

分组与格式对照表 ​

分组支持的格式推荐格式
Claude_codeOpenAI、Claude 原生Claude 原生
Claude_code_1OpenAI、Claude 原生Claude 原生
claude_freeOpenAI、Claude 原生Claude 原生
claudeOpenAI、Claude 原生Claude 原生
azOpenAIOpenAI
codexResponsesResponses
geminiOpenAI、Gemini 原生Gemini 原生
fast_forwardOpenAIOpenAI

如何选择格式？ ​

使用 Claude 模型？
  ├─ 是 → 优先使用 Claude 原生格式
  │        （功能更完整，支持缓存等特性）
  └─ 否 → 继续判断

使用 Gemini 模型 + gemini 分组？
  ├─ 是 → 使用 Gemini 原生格式
  └─ 否 → 继续判断

使用 codex 分组？
  ├─ 是 → 必须使用 Responses 格式
  └─ 否 → 使用 OpenAI 格式（chat/completions）

应用配置示例 ​

支持自定义 API 的应用 ​

应用填写位置格式选择
ChatBox设置 → AI 提供商 → 添加OpenAI 兼容
Cherry Studio设置 → 模型服务 → 添加提供商OpenAI 类型
LobeChat设置 → 语言模型OpenAI 或 Anthropic
NextChat设置 → API 配置OpenAI
Cline设置 → API ProviderAnthropic 或 OpenAI Compatible
CursorModels → OpenAIOpenAI（Override Base URL）

通用配置步骤 ​

  1. 找到 API 设置：通常在"设置"、"偏好设置"或"模型配置"中
  2. 选择提供商类型：选择 OpenAI、Anthropic 或自定义
  3. 填写 API 地址：
    • OpenAI 格式：https://api.qinzhiai.com/v1
    • Claude 格式：https://api.qinzhiai.com
  4. 填写 API Key：sk-你的APIKey
  5. 选择模型：输入模型名称或从列表选择
  6. 测试连接：发送测试消息验证

常见问题 ​

应该用哪个 API 地址？ ​

  • OpenAI 格式：https://api.qinzhiai.com/v1（带 /v1）
  • Claude 格式：https://api.qinzhiai.com（不带 /v1）
  • Gemini 格式：https://api.qinzhiai.com（不带 /v1）

模型名称怎么填？ ​

直接填写模型 ID，例如：

  • claude-sonnet-4-20250514
  • gpt-4o
  • gemini-2.0-flash
  • deepseek-chat

完整模型列表：模型定价页面

报错 "Unsupported API format" ​

检查你的分组是否支持当前使用的 API 格式，参考上方的分组与格式对照表。

更多资源 ​