Installation

Multiple installation methods for Antigravity Claude Proxy including npm, npx, and git clone.

Prerequisites

Before installing, ensure you have the following:

• Node.js 18.0.0 or later (download here)
• npm (comes with Node.js) or your preferred package manager
• Antigravity app (optional, for single-account mode) OR Google account(s) for multi-account mode

Check your Node.js version with node --version. If you need to upgrade, use nvm (macOS/Linux) or download from nodejs.org (Windows).

Installation methods

Option 1: npm global install (recommended)

Install the package globally to use the acc command from anywhere:

npm install -g antigravity-claude-proxy@latest

Verify the installation:

acc --version

This method provides:

• The acc command available system-wide
• Easy updates with npm update -g antigravity-claude-proxy
• Automatic dependency management

Option 2: npx (no install required)

Run the proxy without installing it globally:

npx antigravity-claude-proxy@latest start

This method:

• Downloads and runs the latest version automatically
• Useful for trying the proxy before installing
• No global installation required
• Always uses the latest version

With npx, you’ll need to use the full command npx antigravity-claude-proxy@latest instead of the acc shorthand.

Option 3: git clone (for development)

Clone the repository for local development or to contribute:

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

Verify the installation:

node src/index.js --version

This method provides:

• Access to the latest development code
• Ability to make local modifications
• Direct access to source files and tests

The npm install command automatically builds the required CSS via the prepare hook, so you don’t need to run a separate build command.

Platform-specific notes

macOS

No additional setup required. The proxy works out of the box after installation.

If you encounter permission issues with global npm installs, consider using nvm to manage Node.js versions without requiring sudo:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
nvm use 18

Linux

For global npm installs, you may need to configure npm to avoid using sudo:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Windows

Run the installation command in an elevated PowerShell or Command Prompt (as Administrator) if you encounter permission issues.

On Windows, make sure to restart your terminal after installation to ensure the acc command is available in your PATH.

Verification steps

After installation, verify that everything is working correctly:

1. Check version

   Confirm the proxy is installed:

   npm global

   acc --version
   
2. View help

   Display available commands:

   npm global

   acc --help
   
3. Start the server

   Launch the proxy to test it’s working:

   npm global

   acc start
   

   You should see output indicating the proxy has launched successfully.

4. Check server health

   In a new terminal, verify the server is responding:

   curl http://localhost:8080/health
   

   Expected response:

   {"status":"ok","version":"2.7.7"}
   

Updating

npm global install

Update to the latest version:

npm update -g antigravity-claude-proxy

npx

No update needed - npx always uses the latest version when you specify @latest.

git clone

Pull the latest changes and reinstall dependencies:

cd antigravity-claude-proxy
git pull origin main
npm install

Uninstalling

npm global install

npm uninstall -g antigravity-claude-proxy

git clone

Simply delete the cloned directory:

rm -rf antigravity-claude-proxy

Uninstalling the proxy does not remove your account configuration. Account data is stored in ~/.config/antigravity-proxy/accounts.json and persists after uninstallation.

Next steps

Quickstart

Follow the quickstart guide to configure and start using the proxy.

Account management

Learn how to add and manage Google accounts for the proxy.