> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/badrisnarayanan/antigravity-claude-proxy/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

<Steps>
  <Step title="Install the proxy">
    Choose your preferred installation method:

    <CodeGroup>
      ```bash npm (global) theme={null}
      npm install -g antigravity-claude-proxy@latest
      ```

      ```bash npx (no install) theme={null}
      # Run directly without installing
      npx antigravity-claude-proxy@latest start
      ```

      ```bash git clone theme={null}
      git clone https://github.com/badri-s2001/antigravity-claude-proxy.git
      cd antigravity-claude-proxy
      npm install
      ```
    </CodeGroup>

    <Note>
      The `npm install` command automatically builds the required CSS via the prepare hook.
    </Note>
  </Step>

  <Step title="Start the proxy server">
    Launch the proxy as a background process:

    <CodeGroup>
      ```bash npm (global) theme={null}
      acc start
      # or: antigravity-claude-proxy start
      ```

      ```bash npx theme={null}
      npx antigravity-claude-proxy@latest start
      ```

      ```bash git clone theme={null}
      npm start
      ```
    </CodeGroup>

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

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

    ### 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 |
  </Step>

  <Step title="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

    <Note>
      **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.
    </Note>

    ### Method B: CLI (desktop or headless)

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

    <CodeGroup>
      ```bash Desktop (opens browser) theme={null}
      antigravity-claude-proxy accounts add
      ```

      ```bash Headless (Docker/SSH) theme={null}
      antigravity-claude-proxy accounts add --no-browser
      ```
    </CodeGroup>

    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.
  </Step>

  <Step title="Verify it's working">
    Check that the proxy is running and accounts are connected:

    ```bash Health check theme={null}
    curl http://localhost:8080/health
    ```

    ```bash Check account status and quota limits theme={null}
    curl "http://localhost:8080/account-limits?format=table"
    ```

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

  <Step title="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:

    ```json Claude models theme={null}
    {
      "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"
      }
    }
    ```

    <Tip>
      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.
    </Tip>

    ### Load environment variables

    Add the proxy settings to your shell profile:

    <CodeGroup>
      ```bash macOS/Linux (zsh) theme={null}
      echo 'export ANTHROPIC_BASE_URL="http://localhost:8080"' >> ~/.zshrc
      echo 'export ANTHROPIC_AUTH_TOKEN="test"' >> ~/.zshrc
      source ~/.zshrc
      ```

      ```bash macOS/Linux (bash) theme={null}
      echo 'export ANTHROPIC_BASE_URL="http://localhost:8080"' >> ~/.bashrc
      echo 'export ANTHROPIC_AUTH_TOKEN="test"' >> ~/.bashrc
      source ~/.bashrc
      ```

      ```powershell Windows (PowerShell) theme={null}
      Add-Content $PROFILE "`n`$env:ANTHROPIC_BASE_URL = 'http://localhost:8080'"
      Add-Content $PROFILE "`$env:ANTHROPIC_AUTH_TOKEN = 'test'"
      . $PROFILE
      ```

      ```cmd Windows (Command Prompt) theme={null}
      setx ANTHROPIC_BASE_URL "http://localhost:8080"
      setx ANTHROPIC_AUTH_TOKEN "test"
      ```
    </CodeGroup>

    Restart your terminal for changes to take effect.
  </Step>

  <Step title="Run Claude Code">
    With the proxy running and configured, start using Claude Code:

    ```bash theme={null}
    # 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.
    </Note>
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Available models" icon="microchip" href="/configuration/models">
    Explore the full list of Claude and Gemini models supported by the proxy.
  </Card>

  <Card title="Load balancing" icon="scale-balanced" href="/guides/load-balancing">
    Learn about the three account selection strategies and how to configure them.
  </Card>

  <Card title="Web console" icon="display" href="/guides/web-console">
    Discover the features of the web management interface.
  </Card>

  <Card title="Advanced configuration" icon="gears" href="/configuration/advanced-config">
    Customize the proxy with environment variables and command-line flags.
  </Card>
</CardGroup>