Интеграции
gpt2giga рассчитан на клиентов, которые умеют указывать произвольный base URL для SDK и CLI, совместимых с OpenAI, Anthropic или Gemini.
Базовые адреса
Клиенты, совместимые с OpenAI, обычно используют:
http://localhost:8090/v1
Для возможностей GigaChat v2 можно явно указать:
http://localhost:8090/v2
Правило выбора бэкенда одинаково для всех совместимых клиентов: URL с /v1
принудительно идёт в контракт GigaChat v1, URL с /v2 — в контракт GigaChat v2.
Корневой URL без версии (http://localhost:8090) использует
GPT2GIGA_GIGACHAT_API_MODE=v1|v2.
Клиенты, совместимые с Anthropic, обычно используют:
http://localhost:8090
Клиенты, совместимые с Gemini, обычно используют корневой адрес:
http://localhost:8090
Официальные SDK/CLI Gemini при таком base URL сами добавляют путь в стиле Gemini,
например /v1beta/models/{model}:generateContent.
Если GPT2GIGA_ENABLE_API_KEY_AUTH=True, используйте GPT2GIGA_API_KEY как клиентский API-ключ. Для клиентов Gemini поддерживается также заголовок
x-goog-api-key.
Запускаемые примеры
- OpenAI examples: examples/openai/
- OpenAI Chat Completions: examples/openai/chat_completions/README.md
- OpenAI Responses: examples/openai/responses/README.md
- Anthropic examples: examples/anthropic/README.md
- Gemini examples: examples/gemini/README.md
- OpenAI Agents SDK: examples/openai/agents/weather_handoff.py
Руководства по интеграциям
| Инструмент / клиент | Руководство |
|---|---|
| OpenHands | integrations/openhands/README.md |
| OpenAI Codex | integrations/codex/README.md |
| Grok Build | integrations/grok-build/README.md |
| Aider | integrations/aider/README.md |
| Claude Code | integrations/claude-code/README.md |
| Claude Desktop App | integrations/claude-desktop/README.md |
| Gemini CLI | integrations/gemini/README.md |
| Cursor | integrations/cursor/README.md |
| Qwen Code | integrations/qwen-code/README.md |
| Xcode | integrations/xcode/README.md |
| nginx (обратный прокси) | integrations/nginx/README.md |
Записи о проверке
Слово «проверено» ниже означает, что в репозитории есть датированная ручная проверка конкретной версии по связанному руководству. Это не обещание совместимости с более новой версией клиента. После обновления клиента повторите проверку и обновите запись.
| Клиент | Зафиксированная версия | Дата | Протокол и пути | Статус |
|---|---|---|---|---|
| OpenAI Codex | codex-cli 0.142.1 | 2026-06-26 | OpenAI Chat, /v1 и /v2 | Проверено |
| Claude Code | 2.1.187 | 2026-06-26 | Anthropic Messages, /v1 и /v2 | Проверено |
| Gemini CLI | gemini 0.46.0 | 2026-06-26 | Gemini content API, /v1 и /v2 | Проверено |
| Claude Desktop | 1.12603.1 с Claude Code 2.1.170 | 2026-06-13 | Anthropic Messages через 3p gateway | Beta-проверка |
Страницы Grok Build, OpenHands, Aider, Cursor, Qwen Code, Xcode и nginx поддерживаются как инструкции по настройке, но пока не содержат актуальной датированной записи о сквозной проверке. Считайте их воспроизводимыми рецептами и при подтверждении или регрессии указывайте версию клиента и проверенный маршрут.
Каталог совместимости
Следующие клиенты и фреймворки потенциально можно подключить, потому что они принимают произвольный OpenAI-, Anthropic- или Gemini-совместимый base URL. Наличие в каталоге само по себе не означает, что интеграция проверена.
| Категория | Проекты |
|---|---|
| Агенты и редакторы | Grok Build, OpenCode, KiloCode, OpenHands, Zed, Cline, Codex, Gemini CLI, Aider, Claude Code, Cursor, Qwen Code, Xcode |
| Агентные фреймворки | Langflow, DeepAgents, CrewAI, Qwen Agent, PydanticAI, CAMEL, smolagents, OpenAI Agents SDK |
| SDK и desktop-клиенты | Anthropic Python SDK, Claude Desktop |
В полезном отчёте о проверке укажите версию клиента, ОС, версию gateway, настроенный base URL, режим backend GigaChat, минимальный prompt, использование streaming/tools и отредактированную ошибку или форму ответа.