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
这是什么？这是一个代理服务器，通过 Anthropic 兼容 API 暴露 Antigravity 的 Claude 和 Gemini 模型，让你可以在 Claude Code CLI 和 OpenClaw/ClawdBot 中使用它们。
这是我要导入的库，还是我要运行的独立服务器？它是一个以后台进程形式运行的独立本地服务器，通过「acc start」「acc stop」「acc status」等 CLI 命令管理，另有用于账户管理的网页控制台。
怎么把代理服务器跑起来？通过 npm 安装或克隆仓库，运行「acc start」让它在后台启动，通过网页控制台或 CLI 绑定 Google 账户，然后把 Claude Code 的 settings.json 指向本地代理 URL。
使用它需要 Antigravity 应用或 Google 账户吗？你需要 Node.js 18 或更高版本，另外要么安装了 Antigravity 桌面应用（单账户模式，自动检测），要么有一个或多个 Google 账户（多账户模式）。
绑定我的主 Google 账户安全吗？不安全——Google 一直在对绑定此代理的账号发出违反服务条款的封禁和影子封禁，因此作者建议使用小号而不是主号。
它在 Windows 上能用吗，还是只有 macOS 和 Linux？可以，它为 macOS、Linux 和 Windows（PowerShell 和命令提示符）提供设置说明和配置文件路径，包括 Linux 上的 systemd 服务支持。
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」（OpenCode 的 Antigravity OAuth 插件）和「claude-code-proxy」（使用 LiteLLM 的 Anthropic API 代理）的思路和代码之上。
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