gpt2giga CLI
Прокси от ai-forever, который отдает GigaChat через API OpenAI, Anthropic и Gemini, чтобы запускать на нем Claude Code, Codex и Gemini CLI
Широкий доступ
Почему такой уровень
- Хранит учетные данные GigaChat и отправляет в GigaChat код и контекст сессии агента
- Авторизация клиентов по ключу по умолчанию выключена, а режим DEV открывает /docs и журналы /logs
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/gpt2gigaОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Хранит учетные данные GigaChat и отправляет в GigaChat код и контекст сессии агента
- Авторизация клиентов по ключу по умолчанию выключена, а режим DEV открывает /docs и журналы /logs
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
gpt2giga — сервер на FastAPI, который принимает запросы в форматах OpenAI, Anthropic и Gemini и переводит их в вызовы GigaChat API. Для OpenAI он отдает /chat/completions, /responses, /embeddings и список моделей, для Anthropic — /messages и /messages/count_tokens, для Gemini — generateContent, streamGenerateContent, countTokens и embedContent. Прокси переносит вызовы инструментов, structured output, изображения и SSE-стриминг, отбрасывает неподдерживаемые необязательные поля и держит ключ клиента отдельно от учетных данных GigaChat. По умолчанию слушает http://localhost:8090, путь /v1 или /v2 выбирает контракт GigaChat v1 или v2.
Для кого. Для разработчиков и команд, которым нужно запускать Claude Code, Codex, Gemini CLI или свой код на SDK OpenAI и Anthropic на модели GigaChat.
Подходит, если
- Нужно запустить Claude Code или Codex на GigaChat-2-Max или GigaChat-3-Ultra
- Готовый код на SDK OpenAI, Anthropic или Gemini надо переключить на GigaChat сменой base_url
- Нужен общий шлюз к GigaChat для команды с отдельным API-ключом и закрытой документацией в режиме PROD
Не подходит, если
- Нужны Files API или Batches API OpenAI, Anthropic и Gemini: в прокси они отключены до поддержки в GigaChat
- Нужны аудио, генерация и редактирование изображений, дообучение или Assistants: это вне задач проекта
Пример запроса к агенту
Запусти gpt2giga с моим ключом GigaChat и подключи к нему Claude Code на модели GigaChat-2-MaxОграничения
Нужны учетные данные GigaChat (GIGACHAT_CREDENTIALS) и scope аккаунта, например GIGACHAT_API_PERS. Python 3.10–3.14. Авторизация клиентов по ключу по умолчанию выключена (GPT2GIGA_ENABLE_API_KEY_AUTH=False) и обязательна только в режиме PROD, а режим DEV открывает /docs и /logs. Датированные проверки в репозитории есть для Codex 0.142.1, Claude Code 2.1.187 и Gemini CLI 0.46.0, для Claude Desktop запись помечена как бета, руководства для Cursor, Aider, OpenHands и Qwen Code пока без такой проверки.
Как отключить. Остановите процесс gpt2giga, уберите ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY из окружения или провайдер gpt2giga из ~/.codex/config.toml, а пакет удалите командой uv tool uninstall gpt2giga.
Частые вопросы
Нужен ли ключ Anthropic для Claude Code?
Нет. Запросы уходят в GigaChat, в ANTHROPIC_API_KEY подойдет любое непустое значение, а при включенной авторизации прокси — значение GPT2GIGA_API_KEY.
Чем отличаются адреса /v1 и /v2?
Путь /v1 всегда выбирает контракт GigaChat v1, путь /v2 — v2. Для Codex со встроенными инструментами GigaChat, например web_search, руководство советует /v2.
Можно ли передавать учетные данные GigaChat с каждого клиента?
Да, с GPT2GIGA_PASS_TOKEN=True прокси принимает их в заголовке Authorization, но документация советует держать учетные данные на сервере.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
GigaChat — все инструментыЛокальный прокси, который отдает GigaChat через OpenAI- и Anthropic-совместимый API, чтобы подключать его к Claude Code, aider и другим агентам
Скиллы GigaChat
GigaChat Skills
Восемь скиллов для кода на GigaChat API: выбор слоя интеграции, настройка доступа, SDK, LangChain, gpt2giga и Deep Agents
MCP Gateway для GigaChat и YandexGPT
MCP Gateway
Шлюз MCP к GigaChat и YandexGPT с автопереключением между ними и анонимизацией персональных данных по 152-ФЗ
MCP-сервер для API GigaChat
GigaChat API
Небольшой Python MCP-сервер для API GigaChat от Сбера: авторизация по Basic-ключу и обращение к моделям прямо из агента, проверялся на OpenCode под Windows
Скилл миграции с OpenAI на GigaChat
migrate-to-gigachat-skill
Скилл для Cursor: переводит проекты на Python, JS или TS с OpenAI на GigaChat, определяет стек, выбирает адаптер и проверяет тестами запуск
Интеграция Home Assistant, которая ставит GigaChat, YandexGPT или другую LLM за голосового ассистента умного дома
Коротко о README
README начинает с того, что GigaChat нельзя подставить вместо OpenAI или Anthropic без переделки клиента, и перечисляет все поддержанные эндпоинты трех API. Дальше идут установка через uv, pip и Docker Compose, запуск, переменные GIGACHAT_* и GPT2GIGA_*, примеры на SDK OpenAI и Anthropic и список того, что отключено. Документация на GitHub Pages разбирает конфигурацию, развертывание с reverse proxy и пошаговые интеграции с Claude Code, Codex, Gemini CLI, Cursor и другими клиентами.