gigachat-bridge CLI
Локальный прокси, который отдает GigaChat через OpenAI- и Anthropic-совместимый API, чтобы подключать его к Claude Code, aider и другим агентам
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Весь код и контекст сессии агента уходят в GigaChat
- По умолчанию проверка TLS выключена
- Хранит ключ авторизации GigaChat в .env
Установка
- Работает в
- Сервисы
Ручная установка
.\run.ps1PowerShell. Первый запуск создает .venv, ставит зависимости и .env; впишите GIGACHAT_AUTH_KEY и запустите скрипт снова.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Весь код и контекст сессии агента уходят в GigaChat
- По умолчанию проверка TLS выключена
- Хранит ключ авторизации GigaChat в .env
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Прокси поднимается на локальном порту и принимает запросы в форматах OpenAI Chat Completions и Anthropic Messages, пересылая их в GigaChat. Он сам получает токен доступа, который у GigaChat живет полчаса, обновляет его заранее и повторяет запрос при ответе 401. Неподдерживаемые поля отбрасываются, названия чужих моделей подменяются на выбранную модель GigaChat, а вызовы инструментов переводятся в формат функций GigaChat и обратно, включая стриминг. Есть эндпоинты для списка моделей, эмбеддингов и подсчета токенов.
Для кого. Для разработчиков, которым нужно запускать CLI-агентов на российской модели GigaChat.
Подходит, если
- Нужно запустить Claude Code или aider на GigaChat
- Агент со статическим ключом отваливается из-за истечения токена GigaChat
- Нужен OpenAI-совместимый эндпоинт GigaChat для своего кода или Continue
Не подходит, если
- Нужны длинные многошаговые агентские задачи: по словам автора, GigaChat в них заметно ошибается чаще
- Нужна работа с картинками и документами: прокси их не передает
Пример запроса к агенту
Подними gigachat-bridge и запусти Claude Code на модели GigaChat-2-MaxОграничения
Нужен ключ авторизации проекта GigaChat в developers.sber.ru. Скрипты быстрого старта и установки сертификатов написаны на PowerShell под Windows. По умолчанию проверка TLS выключена, для безопасной работы нужно собрать российский корневой сертификат и включить GIGACHAT_VERIFY_SSL. Блоки thinking отбрасываются. Лицензия в репозитории не указана.
Как отключить. Остановите процесс прокси и уберите переменные ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL или OPENAI_BASE_URL из окружения.
Частые вопросы
Почему не работает модель GigaChat-3-Ultra?
Она доступна только на хосте api.giga.chat. Задайте GIGACHAT_API_BASE=https://api.giga.chat/v1 и GIGACHAT_MODEL=GigaChat-3-Ultra.
Нужно ли добавлять /v1 в ANTHROPIC_BASE_URL?
Нет, Claude Code добавляет его сам.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
GigaChat — все инструментыПрокси от ai-forever, который отдает GigaChat через API OpenAI, Anthropic и Gemini, чтобы запускать на нем Claude Code, Codex и Gemini CLI
Скиллы 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 быстро истекает, и агенты со статическим ключом ломаются. Дан быстрый старт через run.ps1, разобраны два хоста GigaChat с разными наборами моделей и примеры подключения openai SDK, aider, curl, Continue и Claude Code. Перечислены эндпоинты и все преобразования запроса. Отдельно описаны сертификаты, настройки через .env и смоук-тест на заглушке GigaChat.