gigachat-bridge
Локальный прокси, который отдает GigaChat через OpenAI- и Anthropic-совместимый API, чтобы подключать его к Claude Code, aider и другим агентам
Установка
.\run.ps1PowerShell. Первый запуск создает .venv, ставит зависимости и .env; впишите GIGACHAT_AUTH_KEY и запустите скрипт снова.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Прокси поднимается на локальном порту и принимает запросы в форматах 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
- По умолчанию проверка TLS выключена
- Хранит ключ авторизации GigaChat в .env
Коротко о README
README объясняет, зачем нужен прокси: токен GigaChat быстро истекает, и агенты со статическим ключом ломаются. Дан быстрый старт через run.ps1, разобраны два хоста GigaChat с разными наборами моделей и примеры подключения openai SDK, aider, curl, Continue и Claude Code. Перечислены эндпоинты и все преобразования запроса. Отдельно описаны сертификаты, настройки через .env и смоук-тест на заглушке GigaChat.
Частые вопросы
Почему не работает модель 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 добавляет его сам.
Похожие
Открытый личный AI-ассистент на своем компьютере: отвечает в Telegram, Slack, Discord и WhatsApp, расширяется скиллами и плагинами
Самообучающийся агент от Nous Research: терминал, мессенджеры, cron-задачи и скиллы, которые он пишет сам
Открытый агент для программирования в терминале и на десктопе с режимами разработки и планирования
Агент Anthropic для терминала, IDE и GitHub: понимает кодовую базу, выполняет задачи и работает с git