Skip to main content
This guide will walk you through installing, configuring, and verifying the proxy server.
1

Install the proxy

Choose your preferred installation method:
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:
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

CommandDescription
acc startLaunch proxy in the background
acc stopShut down the proxy
acc restartRestart the proxy
acc statusCheck proxy health and PID
acc uiOpen the web dashboard
acc start --logRun in foreground with visible logs
3

Add a Google account

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:
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.jsonAdd 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:
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.

Build docs developers (and LLMs) love

Get started for freeTalk to us