antigravity-claude-proxy README

The project's README from github.com/badrisnarayanan/antigravity-claude-proxy. As one markdown file: README.md.

Antigravity Claude Proxy

npm version npm downloads License: MIT

A proxy server that exposes an Anthropic-compatible API backed by Antigravity's Cloud Code, letting you use Claude and Gemini models with Claude Code CLI and OpenClaw / ClawdBot.

Antigravity Claude Proxy Banner

⚠️ WARNING: Google has been issuing ToS violation bans on accounts connected to this proxy. Use at your own risk.

⚠️ Terms of Service Warning — Read Before Installing

[!CAUTION] Using this proxy may violate Google's Terms of Service. A small number of users have reported their Google accounts being banned or shadow-banned (restricted access without explicit notification).

By using this proxy, you acknowledge:

  • This is an unofficial tool not endorsed by Google
  • Your account may be suspended or permanently banned
  • You assume all risks associated with using this proxy

Recommendation: Do not use your main account. Use a burner account instead, and optionally add it to your main account's family plan if needed.

How It Works

┌──────────────────┐     ┌─────────────────────┐     ┌────────────────────────────┐
│   Claude Code    │────▶│  This Proxy Server  │────▶│  Antigravity Cloud Code    │
│   (Anthropic     │     │  (Anthropic → Google│     │  (daily-cloudcode-pa.      │
│    API format)   │     │   Generative AI)    │     │   sandbox.googleapis.com)  │
└──────────────────┘     └─────────────────────┘     └────────────────────────────┘
  1. Receives requests in Anthropic Messages API format
  2. Uses OAuth tokens from added Google accounts (or Antigravity's local database)
  3. Transforms to Google Generative AI format with Cloud Code wrapping
  4. Sends to Antigravity's Cloud Code API
  5. Converts responses back to Anthropic format with full thinking/streaming support

Prerequisites

Installation

# Run directly with npx (no install needed)
npx antigravity-claude-proxy@latest start

# Or install globally
npm install -g antigravity-claude-proxy@latest
antigravity-claude-proxy start

Option 2: Clone Repository

git clone https://github.com/badri-s2001/antigravity-claude-proxy.git
cd antigravity-claude-proxy
npm install
npm start

Quick Start

1. Start the Proxy Server

# If installed globally
acc start
# or: antigravity-claude-proxy start

# If using npx
npx antigravity-claude-proxy@latest start

# If cloned locally
npm start

The server launches as a background process on http://localhost:8080 by default and survives terminal closure.

Command Description
acc start Launch proxy in the background
acc stop Shut down the proxy
acc restart Restart the proxy
acc status Check proxy health and PID
acc ui Open the web dashboard
acc start --log Run in foreground with visible logs

Choose one of the following methods to authorize the proxy:

  1. With the proxy running, open http://localhost:8080 in your browser.
  2. Navigate to the Accounts tab and click Add Account.
  3. Complete the Google OAuth authorization in the popup window.

Headless/Remote Servers: If running on a server without a browser, the WebUI supports a "Manual Authorization" mode. After clicking "Add Account", you can copy the OAuth URL, complete authorization on your local machine, and paste the authorization code back.

Method B: CLI (Desktop or Headless)

If you prefer the terminal or are on a remote server:

# Desktop (opens browser)
antigravity-claude-proxy accounts add

# Headless (Docker/SSH)
antigravity-claude-proxy accounts add --no-browser

For full CLI account management options, run antigravity-claude-proxy accounts --help.

Method C: Automatic (Antigravity Users)

If you have the Antigravity app installed and logged in, the proxy will automatically detect your local session. No additional setup is required.

To use a custom port:

PORT=3001 antigravity-claude-proxy start

3. Verify It's Working

# Health check
curl http://localhost:8080/health

# Check account status and quota limits
curl "http://localhost:8080/account-limits?format=table"

Using with Claude Code CLI

Configure Claude Code

You can configure these settings in two ways:

  1. Open the WebUI at http://localhost:8080.
  2. Go to Settings → Claude CLI.
  3. Use the Connection Mode toggle to switch between:
    • Proxy Mode: Uses the local proxy server (Antigravity Cloud Code). Configure models, base URL, and presets here.
    • Paid Mode: Uses the official Anthropic Credits directly (requires your own subscription). This hides proxy settings to prevent accidental misconfiguration.
  4. Click Apply to Claude CLI to save your changes.

[!TIP] > Configuration Precedence: System environment variables (set in shell profile like .zshrc) take precedence over the settings.json file. If you use the Web Console to manage settings, ensure you haven't manually exported conflicting variables in your terminal.

Manual Configuration

Create or edit the Claude Code settings file:

macOS: ~/.claude/settings.json Linux: ~/.claude/settings.json Windows: %USERPROFILE%\.claude\settings.json

Add this configuration:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "test",
    "ANTHROPIC_BASE_URL": "http://localhost:8080",
    "ANTHROPIC_MODEL": "claude-opus-4-6-thinking",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6-thinking",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-4-6",
    "ENABLE_EXPERIMENTAL_MCP_CLI": "true"
  }
}

Or to use Gemini models:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "test",
    "ANTHROPIC_BASE_URL": "http://localhost:8080",
    "ANTHROPIC_MODEL": "gemini-3.1-pro-low",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "gemini-3.1-pro-low",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gemini-3.5-flash-low",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "gemini-3.5-flash-low",
    "CLAUDE_CODE_SUBAGENT_MODEL": "gemini-3.5-flash-low",
    "ENABLE_EXPERIMENTAL_MCP_CLI": "true"
  }
}

Load Environment Variables

Add the proxy settings to your shell profile:

macOS / Linux:

echo 'export ANTHROPIC_BASE_URL="http://localhost:8080"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="test"' >> ~/.zshrc
source ~/.zshrc

For Bash users, replace ~/.zshrc with ~/.bashrc

Windows (PowerShell):

Add-Content $PROFILE "`n`$env:ANTHROPIC_BASE_URL = 'http://localhost:8080'"
Add-Content $PROFILE "`$env:ANTHROPIC_AUTH_TOKEN = 'test'"
. $PROFILE

Windows (Command Prompt):

setx ANTHROPIC_BASE_URL "http://localhost:8080"
setx ANTHROPIC_AUTH_TOKEN "test"

Restart your terminal for changes to take effect.

Run Claude Code

# Make sure the proxy is running first
antigravity-claude-proxy start

# In another terminal, run Claude Code
claude

Note: If Claude Code asks you to select a login method, add "hasCompletedOnboarding": true to ~/.claude.json (macOS/Linux) or %USERPROFILE%\.claude.json (Windows), then restart your terminal and try again.

Proxy Mode vs. Paid Mode

Toggle in Settings → Claude CLI:

Feature 🔌 Proxy Mode 💳 Paid Mode
Backend Local Server (Antigravity) Official Anthropic Credits
Cost Free (Google Cloud) Paid (Anthropic Credits)
Models Claude + Gemini Claude Only

Paid Mode automatically clears proxy settings so you can use your official Anthropic account directly.

Multiple Claude Code Instances (Optional)

To run both the official Claude Code and Antigravity version simultaneously, add this alias:

macOS / Linux:

# Add to ~/.zshrc or ~/.bashrc
alias claude-antigravity='CLAUDE_CONFIG_DIR=~/.claude-account-antigravity ANTHROPIC_BASE_URL="http://localhost:8080" ANTHROPIC_AUTH_TOKEN="test" command claude'

Windows (PowerShell):

# Add to $PROFILE
function claude-antigravity {
    $env:CLAUDE_CONFIG_DIR = "$env:USERPROFILE\.claude-account-antigravity"
    $env:ANTHROPIC_BASE_URL = "http://localhost:8080"
    $env:ANTHROPIC_AUTH_TOKEN = "test"
    claude
}

Then run claude for official API or claude-antigravity for this proxy.

Running as a System Service (systemd)

When running as a systemd service, the proxy runs under a different user (e.g. root), so it can't find your Claude CLI settings at ~/.claude/settings.json. Set CLAUDE_CONFIG_PATH to point to the real user's .claude directory:

# /etc/systemd/system/antigravity-proxy.service
[Service]
Environment=CLAUDE_CONFIG_PATH=/home/youruser/.claude
ExecStart=/usr/bin/node /path/to/antigravity-claude-proxy/src/index.js

Without this, the WebUI's Claude CLI tab won't be able to read or write your Claude Code configuration.

Documentation

Credits

This project is based on insights and code from:

License

MIT

Buy Me A Coffee

Star History

Star History Chart

antigravity-claude-proxy (badrisnarayanan/antigravity-claude-proxy)

Searching Database…

4K ·GitHub
Antigravity-claude-proxy
Что это?Это прокси-сервер, который открывает доступ к моделям Claude и Gemini из Antigravity через Anthropic-совместимый API, чтобы вы могли использовать их внутри Claude Code CLI и OpenClaw/ClawdBot.
Это библиотека для импорта или отдельный сервер для запуска?Это отдельный локальный сервер, работающий как фоновый процесс и управляемый CLI-командами вроде 'acc start', 'acc stop' и 'acc status', плюс веб-панель для управления аккаунтами.
Как запустить прокси в работу?Установите его через npm или клонированием репозитория, выполните 'acc start' для запуска в фоне, привяжите Google-аккаунт через веб-панель или CLI, затем направьте settings.json в Claude Code на URL локального прокси.
Для него нужно приложение Antigravity или Google-аккаунт?Нужен Node.js 18 или новее, плюс либо установленное десктопное приложение Antigravity (режим одного аккаунта, определяется автоматически), либо один или несколько Google-аккаунтов (режим нескольких аккаунтов).
Безопасно ли подключать свой основной Google-аккаунт?Нет — Google раздаёт баны за нарушение ToS и теневые баны аккаунтам, привязанным к этому прокси, поэтому авторы советуют использовать одноразовый аккаунт вместо основного.
Он работает на Windows так же, как на macOS и Linux?Да, там есть инструкции по настройке и пути к конфигурационным файлам для macOS, Linux и Windows (PowerShell и Command Prompt), включая поддержку службы systemd на Linux.
В чём разница между Proxy Mode и Paid Mode?Proxy Mode направляет запросы через бесплатный бэкенд Antigravity на Google Cloud и поддерживает модели и Claude, и Gemini, а Paid Mode использует ваши собственные официальные кредиты Anthropic и поддерживает только Claude.
Можно привязать больше одного Google-аккаунта?Да, поддерживается режим нескольких аккаунтов с балансировкой нагрузки между привязанными к прокси Google-аккаунтами.
Можно запустить это как фоновую системную службу?Да, он может работать под systemd; поскольку служба тогда выполняется от другого пользователя ОС, нужно задать CLAUDECONFIGPATH так, чтобы он указывал на каталог .claude реального пользователя, — тогда WebUI сможет читать и писать настройки Claude Code.
Автор строил это с нуля?Нет, он построен на идеях и коде 'opencode-antigravity-auth' (плагин OAuth Antigravity для OpenCode) и 'claude-code-proxy' (прокси Anthropic API на базе LiteLLM).
What are similar projects?9router, gpt-load, casbin-gateway, tokscale, OpenClawChineseTranslation, OmniRoute, context-mode, claude-relay-service
Which topics is it in?clawdbot, systemd, claude-ai, load-balancer, antigravity, express, gemini-cli, openclaw, tailwindcss, oauth, gemini, sqlite
Creator
badrisnarayanan
Size
12.6 MB
Stars
4K
Updated
CommitOct 13Releasev2.8.7Oct 13
Age
9mo
Commits · 90 Days