Skip to main content
Choose the page by client protocol. Do not mix protocol-specific base URLs: OpenAI-compatible apps usually use /v1, Claude Code and Gemini CLI use the gateway root, and Codex CLI uses /v1 with Responses.

Protocol quick reference

All API keys use the sk- format, but assigned groups control visible models, endpoints, and pricing. auto is a routing control value, not a fixed group; verify the client, model, and endpoint you plan to use.

Claude Code

Uses Claude Messages. Set ANTHROPIC_BASE_URL to https://api.aiohub.org.

Codex CLI

Uses OpenAI Responses. Configure a separate aiohub provider.

OpenCode

Configure an OpenCode provider and choose Chat Completions or Responses by model.

Gemini CLI

Uses the Gemini API. Set GOOGLE_GEMINI_BASE_URL to the gateway root.

VS Code

Use AIOHub in VS Code through the Claude Code and Codex extensions.

OpenAI-compatible apps

Use this for Cline, Cursor, Continue, Aider, Open WebUI, LibreChat, and similar apps.

Imagine

Use Imagine for image generation and editing.

Cherry Studio

Desktop chat client. Fill the provider fields in the app.

LobeHub

Use https://chat.aiohub.org and configure AIOHub in language model settings.

Claude Cowork 3P

Connect the Cowork and Code tabs in Claude Desktop to the AIOHub gateway.

Chatbox

Use an OpenAI-compatible custom provider on mobile, desktop, or web.

Writing SDK code or direct API calls

If you are writing code instead of configuring an existing app, start with API overview and Authentication. Client pages cover app fields and tool-specific setup.

Common setup symptoms