SQST Docs

Claude Code setup

Run Claude Code in your terminal against Claude models served by Google Cloud (Vertex AI) in SquareShift's own project. Setup takes about 5 minutes on a Mac or Windows PC.

Before you start

1. Install Claude Code

Mac — open Terminal and run:
curl -fsSL https://claude.ai/install.sh | bash
Windows — open PowerShell (not as Administrator) and run:
irm https://claude.ai/install.ps1 | iex

The installer shows no progress while it downloads. When it finishes, open a new terminal window and run claude --version. It should print a version number. If it says claude is not found, close every terminal window and open a new one.

2. Connect it to SQST

Claude Code reads one settings file in your home folder. Open it in a text editor:

Mac (Terminal):
mkdir -p ~/.claude && touch ~/.claude/settings.json && open -e ~/.claude/settings.json
Windows (PowerShell; if Notepad asks to create the file, choose Yes):
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude" | Out-Null; notepad "$env:USERPROFILE\.claude\settings.json"

Paste this in, replace PASTE-YOUR-KEY-HERE with your key, and save. If the file already has settings in it, ask an admin to help merge them instead of replacing them.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://llm.squareshift.dev",
    "ANTHROPIC_AUTH_TOKEN": "PASTE-YOUR-KEY-HERE",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "skipWebFetchPreflight": true
}

The first two lines send everything to our gateway with your key. The model lines pick our three Claude models, with Sonnet as the default. The last two stop Claude Code from sending usage data and website checks to Anthropic. That also turns off automatic updates, so run claude update about once a month.

3. Check it works

Open a new terminal in any project folder and run claude. Type /status and check that Anthropic base URL shows https://llm.squareshift.dev. Then ask anything, for example Reply with exactly: ready. A normal answer means you are set up.

If Claude Code asks you to log in, or warns that two credentials are set, type /logout and start claude again.

Using it

CommandWhat it does
/modelChoose Sonnet (default), Opus (hardest problems, twice the price) or Haiku (quick, cheap edits)
/clearStart fresh for a new task: long sessions cost more
/compactShrink a long session but keep going
EscStop the current reply
Ctrl+C twiceQuit

Your monthly budget

You can spend $50 of Claude each month. It resets on the 1st (UTC). To see what you have used, run this with your key and look at spend and max_budget:

Mac:
curl -s https://llm.squareshift.dev/key/info -H "x-api-key: PASTE-YOUR-KEY-HERE"
Windows:
(Invoke-RestMethod https://llm.squareshift.dev/key/info -Headers @{ "x-api-key" = "PASTE-YOUR-KEY-HERE" }).info | Select-Object spend, max_budget, budget_reset_at

If something goes wrong

ErrorFix
401Your key is wrong, missing or revoked. Check the key in your settings file, or ask an admin for a new one.
403 naming a modelUse /model to pick Sonnet, Opus or Haiku; other models are not available.
422 budget_exceededYou have used this month's $50. Ask an admin if you need more.
429Too many requests. Wait a minute and try again.
Asks you to log inCheck the settings file was saved in the right place, then run /logout and start claude again.
Fast mode unavailableExpected: fast mode is not offered through our gateway.
Anything elseSend an admin the error message and the time. Never send your key.

Updated 17 November 2026.