gigachat-bridge CLI
A local proxy exposing GigaChat through OpenAI- and Anthropic-compatible APIs so it can drive Claude Code, aider and other agents
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- All code and agent session context is sent to GigaChat
- TLS verification is off by default
- Stores the GigaChat authorization key in .env
Install
- Works in
- Services
Manual install
.\run.ps1PowerShell. The first run creates .venv, installs dependencies and .env; add GIGACHAT_AUTH_KEY and run the script again.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- All code and agent session context is sent to GigaChat
- TLS verification is off by default
- Stores the GigaChat authorization key in .env
This is third-party code. Review the repository files before installing.
What it does
The proxy runs on a local port, accepts OpenAI Chat Completions and Anthropic Messages requests and forwards them to GigaChat. It fetches the access token, which GigaChat expires after 30 minutes, refreshes it early and retries once on 401. Unsupported fields are dropped, foreign model names are mapped to the chosen GigaChat model, and tool calls are translated to GigaChat functions and back, including streaming. It also serves model listing, embeddings and token counting endpoints.
Who it is for. For developers who need to run CLI agents on Sber's GigaChat model.
Good fit when
- You need to run Claude Code or aider on GigaChat
- An agent with a static key breaks when the GigaChat token expires
- You need an OpenAI-compatible GigaChat endpoint for your code or Continue
Not a fit when
- You need long multi-step agent tasks: the author notes GigaChat fails more often there
- You need images or documents: the proxy does not pass them through
Example request
Start gigachat-bridge and run Claude Code on the GigaChat-2-Max modelLimitations
Requires a GigaChat project authorization key from developers.sber.ru. Quick start and certificate scripts are PowerShell for Windows. TLS verification is off by default; for safe use, build the Russian root certificate bundle and enable GIGACHAT_VERIFY_SSL. Thinking blocks are dropped. The repository has no license.
How to disable. Stop the proxy process and unset ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL or OPENAI_BASE_URL.
FAQ
Why does GigaChat-3-Ultra not work?
It is only on the api.giga.chat host. Set GIGACHAT_API_BASE=https://api.giga.chat/v1 and GIGACHAT_MODEL=GigaChat-3-Ultra.
Should ANTHROPIC_BASE_URL include /v1?
No, Claude Code appends it itself.
Discussion
No questions or reviews yet.
Related
All GigaChat toolsAn ai-forever proxy that serves GigaChat through OpenAI, Anthropic and Gemini APIs so Claude Code, Codex and Gemini CLI can run on it
Eight skills for coding against the GigaChat API: choosing a layer, access setup, SDK, LangChain, gpt2giga and Deep Agents
MCP Gateway for GigaChat and YandexGPT
MCP Gateway
An MCP gateway to GigaChat and YandexGPT with automatic failover between them and 152-FZ personal-data anonymization
MCP server for the GigaChat API
GigaChat API
A small Python MCP server for Sber's GigaChat API: authorizes with a Basic key and calls the models directly from an agent, tested on OpenCode under Windows
OpenAI to GigaChat migration skill
migrate-to-gigachat-skill
A Cursor skill that migrates Python, JS or TS projects from OpenAI to GigaChat: detects the stack, picks an adapter, and verifies with tests it still starts
A Home Assistant integration that puts GigaChat, YandexGPT or another LLM behind your smart-home voice assistant
README in short
The README explains the need: GigaChat tokens expire quickly and static-key agents break. It gives a run.ps1 quick start, compares the two GigaChat hosts with different model sets, and shows connection examples for the openai SDK, aider, curl, Continue and Claude Code. It lists endpoints and every request transformation, and covers certificates, .env settings and a smoke test against a fake GigaChat.