> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiohub.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 选择客户端

> 按工具类型选择正确的 AIOHub 客户端配置页面。

先根据客户端协议选择页面。不要把不同协议的 Base URL 混用：OpenAI 兼容应用通常填 `/v1`，Claude Code 和 Gemini CLI 填网关根地址，Codex CLI 使用 `/v1` + Responses。

## 协议速查

| 客户端或场景                | 协议                                         | Base URL                    | 常见分组                                                    |
| --------------------- | ------------------------------------------ | --------------------------- | ------------------------------------------------------- |
| Claude Code           | Claude Messages                            | `https://api.aiohub.org`    | `anthropic`、`claude-bedrock`、`claude-kiro`              |
| Codex CLI             | OpenAI Responses                           | `https://api.aiohub.org/v1` | `codex`、`codex-passthrough`                             |
| OpenCode              | OpenAI Chat Completions 或 OpenAI Responses | `https://api.aiohub.org/v1` | `openai`、`codex`、`opensource`                           |
| Gemini CLI            | Gemini API                                 | `https://api.aiohub.org`    | `gemini`                                                |
| VS Code (Claude Code) | Claude Messages                            | `https://api.aiohub.org`    | `anthropic`、`claude-bedrock`、`claude-kiro`              |
| VS Code (Codex)       | OpenAI Responses                           | `https://api.aiohub.org/v1` | `codex`、`codex-passthrough`                             |
| OpenAI SDK / 通用应用     | OpenAI Chat Completions                    | `https://api.aiohub.org/v1` | `openai`                                                |
| Imagine               | OpenAI Images                              | `https://api.aiohub.org`    | `openai`、`codex*`                                       |
| Claude Cowork 3P      | Claude Messages                            | `https://api.aiohub.org`    | `anthropic`、`claude-bedrock`、`claude-kiro`              |
| Chatbox               | OpenAI Chat Completions                    | `https://api.aiohub.org/v1` | `openai`、`auto`                                         |
| 开源模型客户端               | OpenAI Chat Completions 或 Claude Messages  | 按客户端协议选择                    | `opensource`、`opensource-discount`、`opensource-economy` |

<Note>所有 API 令牌都使用 `sk-` 格式，但关联分组会影响可见模型、端点和价格。`auto` 是路由控制值，不是固定具体分组；仍需验证当前客户端、模型和端点。</Note>

<Columns cols={2}>
  <Card title="Claude Code" icon="https://mintcdn.com/qyhfrankgmailcom/--B4GB7WTjd2TEz0/images/common/clients/logos/claude.svg?fit=max&auto=format&n=--B4GB7WTjd2TEz0&q=85&s=479726235c925d415c203874a908ea34" href="/cn/clients/claude-code" width="24" height="24" data-path="images/common/clients/logos/claude.svg">
    使用 Claude Messages API，`ANTHROPIC_BASE_URL` 填 `https://api.aiohub.org`。
  </Card>

  <Card title="Codex CLI" icon="https://mintcdn.com/qyhfrankgmailcom/--B4GB7WTjd2TEz0/images/common/clients/logos/openai.svg?fit=max&auto=format&n=--B4GB7WTjd2TEz0&q=85&s=19f4b841fced4e7e03466456edf9bea6" href="/cn/clients/codex" width="721" height="721" data-path="images/common/clients/logos/openai.svg">
    使用 OpenAI Responses API，配置独立 `aiohub` provider。
  </Card>

  <Card title="OpenCode" icon="https://mintcdn.com/qyhfrankgmailcom/--B4GB7WTjd2TEz0/images/common/clients/logos/opencode-logo.svg?fit=max&auto=format&n=--B4GB7WTjd2TEz0&q=85&s=e9644f7bb1c2d12342347a19656f82b1" href="/cn/clients/opencode" width="240" height="300" data-path="images/common/clients/logos/opencode-logo.svg">
    使用 OpenCode 自定义模型服务商，按模型选择 Chat Completions 或 Responses。
  </Card>

  <Card title="Gemini CLI" icon="https://mintcdn.com/qyhfrankgmailcom/--B4GB7WTjd2TEz0/images/common/clients/logos/gemini.svg?fit=max&auto=format&n=--B4GB7WTjd2TEz0&q=85&s=74855df7a8ecbc7faffc7175094fe3d2" href="/cn/clients/gemini-cli" width="65" height="65" data-path="images/common/clients/logos/gemini.svg">
    使用 Gemini API，`GOOGLE_GEMINI_BASE_URL` 填网关根地址。
  </Card>

  <Card title="VS Code" icon="https://mintcdn.com/qyhfrankgmailcom/--B4GB7WTjd2TEz0/images/common/clients/logos/vscode.svg?fit=max&auto=format&n=--B4GB7WTjd2TEz0&q=85&s=f6255f57854fbbc576f36e32bdc609cf" href="/cn/clients/vscode" width="100" height="100" data-path="images/common/clients/logos/vscode.svg">
    在 VS Code 中通过 Claude Code 和 Codex 扩展接入 AIOHub。
  </Card>

  <Card title="OpenAI 兼容应用" icon="plug" href="/cn/clients/api-compatible">
    适用于 Cline、Cursor、Continue、Aider、Open WebUI、LibreChat 等。
  </Card>

  <Card title="Imagine" icon="image" href="/cn/clients/imagine">
    打开 Imagine，使用 API 令牌生成和编辑图片。
  </Card>

  <Card title="Cherry Studio" icon="message-square" href="/cn/clients/cherry-studio">
    桌面聊天客户端，按应用内模型服务商字段填写。
  </Card>

  <Card title="LobeHub" icon="messages-square" href="/cn/clients/lobehub">
    访问 `https://chat.aiohub.org`，在语言模型设置里配置 AIOHub。
  </Card>

  <Card title="Claude Cowork 3P" icon="briefcase-business" href="/cn/clients/claude-cowork-3p">
    将 Claude Desktop 的 Cowork 和 Code 标签页接入 AIOHub 网关。
  </Card>

  <Card title="Chatbox" icon="message-circle" href="/cn/clients/chatbox">
    在移动设备、桌面或网页端使用 OpenAI 兼容自定义服务商。
  </Card>
</Columns>

## 写 SDK 或直接调用 API

如果你不是配置现成客户端，而是在代码里调用接口，先看 [API 概览](/cn/api/overview) 和 [鉴权](/cn/api/authentication)。客户端页面只覆盖应用内字段和工具专属配置。

## 常见配置症状

| 症状                         | 优先检查                |
| -------------------------- | ------------------- |
| 报错路径出现 `/v1/v1`            | Base URL 多填了 `/v1`  |
| 报错路径重复 `/chat/completions` | Base URL 填成了完整端点    |
| 模型不存在                      | 当前 API 令牌的分组是否包含该模型 |
| 客户端连接失败                    | 检查本地环境变量、代理和客户端配置   |
| 服务返回正常但客户端显示失败             | 检查客户端返回格式和重试设置      |