Quickstart

Get up and running with Antigravity Claude Proxy in under 5 minutes.

This guide will walk you through installing, configuring, and verifying the proxy server.

1. Install the proxy

   Choose your preferred installation method:

   npm (global)

   npm install -g antigravity-claude-proxy@latest
   

   The npm install command automatically builds the required CSS via the prepare hook.

2. Start the proxy server

   Launch the proxy as a background process:

   npm (global)

   acc start
   # or: antigravity-claude-proxy start
   

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

   Use acc start --log to run in foreground mode with visible logs, or PORT=3001 acc start to use a custom port.

   Available commands

   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

3. Add a Google account

   Choose one of the following methods to authorize the proxy:

   Method A: Web dashboard (recommended)

   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
   

   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.

4. Verify it's working

   Check that the proxy is running and accounts are connected:

   Health check

   curl http://localhost:8080/health
   

   Check account status and quota limits

   curl "http://localhost:8080/account-limits?format=table"
   

   You should see your connected accounts with their quota information displayed in a table format.

5. Configure Claude Code CLI

   Create or edit the Claude Code settings file:

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

   Add this configuration:

   Claude models

   {
     "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-5-thinking",
       "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-5",
       "CLAUDE_CODE_SUBAGENT_MODEL": "claude-sonnet-4-5-thinking",
       "ENABLE_EXPERIMENTAL_MCP_CLI": "true"
     }
   }
   

   You can also use the Web Console to configure these settings. Open http://localhost:8080, go to Settings → Claude CLI, and click Apply to Claude CLI to save your changes.

   Load environment variables

   Add the proxy settings to your shell profile:

   macOS/Linux (zsh)

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

   Restart your terminal for changes to take effect.

6. Run Claude Code

   With the proxy running and configured, start using Claude Code:

   # Make sure the proxy is running first
   antigravity-claude-proxy start
   
   # In another terminal, run Claude Code
   claude
   

   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.

Next steps

Available models

Explore the full list of Claude and Gemini models supported by the proxy.

Load balancing

Learn about the three account selection strategies and how to configure them.

Web console

Discover the features of the web management interface.

Advanced configuration

Customize the proxy with environment variables and command-line flags.