greygung/grokbuild-proxy — explained in plain English
Analysis updated 2026-05-18
Route Claude Code requests through your own Grok Build account instead of Anthropic directly.
Connect OpenAI compatible tools to a Grok backend through a local translation layer.
Manage a pool of multiple accounts with automatic failover and rate limit cooldowns.
Run the proxy in Docker with an admin web UI for credential and key management.
| greygung/grokbuild-proxy | caddyserver/replace-response | vadimsemenykv/saboteur | |
|---|---|---|---|
| Stars | 156 | 156 | 157 |
| Language | Go | Go | Go |
| Last pushed | — | 2025-06-18 | — |
| Maintenance | — | Stale | — |
| Setup difficulty | moderate | moderate | easy |
| Complexity | 4/5 | 2/5 | 3/5 |
| Audience | developer | ops devops | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires a legally owned Grok Build account, Go or Docker to run, and setting environment variables to redirect clients to the local proxy.
grokbuild-proxy is a self hosted proxy server that lets someone use their own Grok Build account with tools built for Claude Code and other clients that expect Anthropic or OpenAI style APIs. It translates requests between these different API formats so that a coding tool built to talk to Claude can instead send its requests through to Grok, and get a response back in the format it expects. The project supports streaming responses, function calling by tools, structured output formats, and Grok's own web search feature mapped into the Anthropic style API. It also handles account related tasks like OAuth based browser login, managing a pool of multiple accounts with automatic failover if one hits a rate limit or cooldown, and storing credentials locally in JSON files with file locking and backups. Setup can be done with a one line install script for Linux, macOS, or Windows, by building from source with Go, or by running it through Docker Compose. Once running, it exposes a local web based admin interface where you log in with your Grok account, import credentials, manage the account pool, and create or revoke API keys for client applications. To use it with Claude Code, you point the CLI's base URL and auth token environment variables at the local proxy instead of Anthropic's servers directly. The README is explicit that this is an unofficial, community maintained project for technical learning and protocol interoperability research, with no affiliation to xAI, Grok, Anthropic, or OpenAI. It warns that using it may violate the terms of service of the underlying account and that all risk falls on the user, and instructs that only accounts you legally own and are permitted to automate should be used with it. The project is released under the MIT license.
A self hosted proxy that lets you connect your own Grok Build account to Claude Code or OpenAI style clients by translating between the different API formats.
Mainly Go. The stack also includes Go, Docker, Anthropic API.
MIT license: you can use, copy, modify, and distribute this freely, including commercially, as long as you keep the copyright notice.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.