Адреса и совместимость

На этой странице собраны базовые адреса для клиентов AIPass.

OpenAI-compatible base URL

https://s1.aipass.shop

Используй его для:

Codex CLI
Codex Desktop
VS Code Codex
Cursor
OpenCode
API и собственных SDK-клиентов
любых других OpenAI-compatible сценариев, где не указан отдельный маршрут

Anthropic-compatible base URL

Для Claude CLI base URL отличается:

https://s1.aipass.shop

Claude Code сам добавляет нужный путь к корневому адресу. Не добавляй /v1 в значение ANTHROPIC_BASE_URL.

Versioned routes

GET https://s1.aipass.shop/v1/models
POST https://s1.aipass.shop/v1/chat/completions
POST https://s1.aipass.shop/v1/responses
POST https://s1.aipass.shop/v1/messages
POST https://s1.aipass.shop/v1/images/generations
GET https://s1.aipass.shop/v1/usage

Bare routes

GET https://s1.aipass.shop/models
POST https://s1.aipass.shop/chat/completions
POST https://s1.aipass.shop/responses
POST https://s1.aipass.shop/messages
POST https://s1.aipass.shop/images/generations
GET https://s1.aipass.shop/usage

Gateway переписывает bare routes в соответствующие /v1/... routes. В клиентских настройках при этом сохраняется корневой base URL https://s1.aipass.shop.

Какой verify использовать первым

Codex CLI, Codex Desktop, VS Code Codex, Cursor, OpenCode и API/SDK обычно проще всего проверять через GET https://s1.aipass.shop/v1/models
Claude CLI в первую очередь проверяй через рабочий POST https://s1.aipass.shop/v1/messages
Claude CLI может использовать GET https://s1.aipass.shop/v1/models только как дополнительный live-check, если реально включен CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

Что используют клиенты Codex

Codex CLI использует ~/.codex/config.toml
Codex Desktop использует тот же user-level каталог ~/.codex/
ключ для Codex CLI, Codex Desktop и VS Code Codex лежит в ~/.codex/auth.json
provider id: aipass
для Codex нужен wire_api = "responses"
для Codex нужен requires_openai_auth = true
supports_websockets = false

Что использует каждый клиент

Codex CLI -> ~/.codex/config.toml + ~/.codex/auth.json + base URL https://s1.aipass.shop
Codex CLI -> модель по умолчанию gpt-5.6-sol
Codex Desktop -> тот же shared Codex config, что и у CLI
VS Code Codex -> тот же shared Codex config, что и у CLI
Claude CLI -> ~/.claude/settings.json + ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL=https://s1.aipass.shop
Claude CLI -> основной скрипт оставляет обычные Claude slots и не пинит versioned claude-* ID по умолчанию
Claude CLI -> отдельный claude-cli-gpt скрипт маппит opus -> gpt-5.6-sol, sonnet -> gpt-5.4, haiku -> gpt-5.4-mini
Claude CLI -> основной verify идет через messages, а не через models
Cursor -> OpenAI-compatible UI setup с base URL https://s1.aipass.shop
OpenCode -> provider config с baseURL = "https://s1.aipass.shop"
API/SDK -> OpenAI-compatible клиент с base URL https://s1.aipass.shop

Важное правило

Все примеры и запросы должны обращаться в s1.aipass.shop, а не в docs.aipass.shop
docs.aipass.shop нужен только для страниц документации и скриптов настройки

Резервный адрес для РФ

https://ru.aipass.shop зарезервирован как альтернативный root base URL. Он пока не активирован и не должен использоваться в рабочем config. После активации его можно будет передать installers через AIPASS_BASE_URL, --base-url или -BaseUrl; автоматического переключения нет.

Быстрая диагностика

`401 Invalid token`

Обычно это означает:

домен и маршрут правильные
сам ключ неверный, пустой или не подставился

`Invalid URL`