git404hub

what is grokbuild-proxy fr?

greygung/grokbuild-proxy — explained in plain English

Analysis updated 2026-05-18

156GoAudience · developerComplexity · 4/5LicenseSetup · moderate

tl;dr

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.

vibe map

mindmap
  root((grokbuild-proxy))
    What it does
      Translates API requests
      Connects Grok to Claude Code
      Manages account pools
    Tech stack
      Go
      Docker
      Anthropic and OpenAI APIs
    Use cases
      Use Grok via Claude Code
      Connect OpenAI style clients
      Manage multiple accounts
    Audience
      Developers
      Self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Route Claude Code requests through your own Grok Build account instead of Anthropic directly.

VIBE 2

Connect OpenAI compatible tools to a Grok backend through a local translation layer.

VIBE 3

Manage a pool of multiple accounts with automatic failover and rate limit cooldowns.

VIBE 4

Run the proxy in Docker with an admin web UI for credential and key management.

what's the stack?

GoDockerAnthropic APIOpenAI API

how it stacks up fr

greygung/grokbuild-proxycaddyserver/replace-responsevadimsemenykv/saboteur
Stars156156157
LanguageGoGoGo
Last pushed2025-06-18
MaintenanceStale
Setup difficultymoderatemoderateeasy
Complexity4/52/53/5
Audiencedeveloperops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires a legally owned Grok Build account, Go or Docker to run, and setting environment variables to redirect clients to the local proxy.

MIT license: you can use, copy, modify, and distribute this freely, including commercially, as long as you keep the copyright notice.

in plain english

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.

prompts (copy fr)

prompt 1
Help me install and run grokbuild-proxy locally using the install script.
prompt 2
Explain how to configure Claude Code to route requests through this proxy.
prompt 3
Show me how to set up the admin UI and import Grok account credentials.
prompt 4
Walk me through the config.yaml options for account pooling and failover.

Frequently asked questions

what is grokbuild-proxy fr?

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.

What language is grokbuild-proxy written in?

Mainly Go. The stack also includes Go, Docker, Anthropic API.

What license does grokbuild-proxy use?

MIT license: you can use, copy, modify, and distribute this freely, including commercially, as long as you keep the copyright notice.

How hard is grokbuild-proxy to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is grokbuild-proxy for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.