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
- Your key. Ask an admin for your personal SQST key. It starts with
sk-. Keep it private, like a password, and never put it in a project's files. - What stays private. Your prompts and code go only to
https://llm.squareshift.dev, our gateway inside SquareShift's Google Cloud project. It forwards them to Claude on Google Cloud (Vertex AI). Anthropic's own API is never used, and the settings below turn off Claude Code's other traffic to Anthropic. - Windows only: install Git for Windows first. Claude Code works without it, but runs shell commands better with it.
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
| Command | What it does |
|---|---|
/model | Choose Sonnet (default), Opus (hardest problems, twice the price) or Haiku (quick, cheap edits) |
/clear | Start fresh for a new task: long sessions cost more |
/compact | Shrink a long session but keep going |
Esc | Stop the current reply |
Ctrl+C twice | Quit |
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:
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
| Error | Fix |
|---|---|
401 | Your key is wrong, missing or revoked. Check the key in your settings file, or ask an admin for a new one. |
403 naming a model | Use /model to pick Sonnet, Opus or Haiku; other models are not available. |
422 budget_exceeded | You have used this month's $50. Ask an admin if you need more. |
429 | Too many requests. Wait a minute and try again. |
| Asks you to log in | Check the settings file was saved in the right place, then run /logout and start claude again. |
| Fast mode unavailable | Expected: fast mode is not offered through our gateway. |
| Anything else | Send an admin the error message and the time. Never send your key. |