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

​
协议速查

客户端或场景协议Base URL常见分组
Claude CodeClaude Messageshttps://api.aiohub.organthropic、claude-bedrock、claude-kiro
Codex CLIOpenAI Responseshttps://api.aiohub.org/v1codex、codex-passthrough
OpenCodeOpenAI Chat Completions 或 OpenAI Responseshttps://api.aiohub.org/v1openai、codex、opensource
Gemini CLIGemini APIhttps://api.aiohub.orggemini
VS Code (Claude Code)Claude Messageshttps://api.aiohub.organthropic、claude-bedrock、claude-kiro
VS Code (Codex)OpenAI Responseshttps://api.aiohub.org/v1codex、codex-passthrough
OpenAI SDK / 通用应用OpenAI Chat Completionshttps://api.aiohub.org/v1openai
网站内嵌 GIPOpenAI Imageshttps://api.aiohub.orgopenai、codex*
自行部署 GIPOpenAI Imageshttps://api.aiohub.orgopenai、codex*
Claude Cowork 3PClaude Messageshttps://api.aiohub.organthropic、claude-bedrock、claude-kiro
ChatboxOpenAI Chat Completionshttps://api.aiohub.org/v1openai、auto
开源模型客户端OpenAI Chat Completions 或 Claude Messages按客户端协议选择opensource、opensource-discount、opensource-economy
所有 API 令牌都使用 sk- 格式，但关联分组会影响可见模型、端点和价格。auto 是路由控制值，不是固定具体分组；仍需验证当前客户端、模型和端点。
https://mintcdn.com/qyhfrankgmailcom/--B4GB7WTjd2TEz0/images/common/clients/logos/claude.svg?fit=max&auto=format&n=--B4GB7WTjd2TEz0&q=85&s=479726235c925d415c203874a908ea34

Claude Code

使用 Claude Messages API，ANTHROPIC_BASE_URL 填 https://api.aiohub.org。
https://mintcdn.com/qyhfrankgmailcom/--B4GB7WTjd2TEz0/images/common/clients/logos/openai.svg?fit=max&auto=format&n=--B4GB7WTjd2TEz0&q=85&s=19f4b841fced4e7e03466456edf9bea6

Codex CLI

使用 OpenAI Responses API，配置独立 aiohub provider。
https://mintcdn.com/qyhfrankgmailcom/--B4GB7WTjd2TEz0/images/common/clients/logos/opencode-logo.svg?fit=max&auto=format&n=--B4GB7WTjd2TEz0&q=85&s=e9644f7bb1c2d12342347a19656f82b1

OpenCode

使用 OpenCode 自定义模型服务商，按模型选择 Chat Completions 或 Responses。
https://mintcdn.com/qyhfrankgmailcom/--B4GB7WTjd2TEz0/images/common/clients/logos/gemini.svg?fit=max&auto=format&n=--B4GB7WTjd2TEz0&q=85&s=74855df7a8ecbc7faffc7175094fe3d2

Gemini CLI

使用 Gemini API，GOOGLE_GEMINI_BASE_URL 填网关根地址。
https://mintcdn.com/qyhfrankgmailcom/--B4GB7WTjd2TEz0/images/common/clients/logos/vscode.svg?fit=max&auto=format&n=--B4GB7WTjd2TEz0&q=85&s=f6255f57854fbbc576f36e32bdc609cf

VS Code

在 VS Code 中通过 Claude Code 和 Codex 扩展接入 AIOHub。

OpenAI 兼容应用

适用于 Cline、Cursor、Continue、Aider、Open WebUI、LibreChat 等。

网站内嵌 GIP

打开 AIOHub 内嵌页面，使用 API 令牌生成和编辑图片。

自行部署 GIP

部署你自己的 GPT Image Playground，并连接到 AIOHub 图片接口。

Cherry Studio

桌面聊天客户端，按应用内模型服务商字段填写。

LobeHub

访问 https://chat.aiohub.org，在语言模型设置里配置 AIOHub。

Claude Cowork 3P

将 Claude Desktop 的 Cowork 和 Code 标签页接入 AIOHub 网关。

Chatbox

在移动设备、桌面或网页端使用 OpenAI 兼容自定义服务商。

​
写 SDK 或直接调用 API

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

​
常见配置症状

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