DocsClaude Code

Claude Code

Connect your toolsBeginner5 min

Run Claude Code through Zukko: no Anthropic login, no subscription, billed from your balance.

You need: a fetch_... key (create one) and a balance from $1 (top up).

  1. 1
    Install Claude Code
    curl -fsSL https://claude.ai/install.sh | bash

    Already installed if claude --version works. If claude.ai returns 403, install with npm.

  2. 2
    Open the settings file
    mkdir -p ~/.claude && touch ~/.claude/settings.json && open -e ~/.claude/settings.json
  3. 3
    Paste the settings

    Replace fetch_... with your key and save the file:

    json
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.zukko.pro",
        "ANTHROPIC_AUTH_TOKEN": "fetch_...",
        "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
        "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
        "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5"
      }
    }
  4. 4
    Run it

    Open a new terminal window:

    bash
    cd path/to/project
    claude

    Type "Hi". If you get an answer, it works.

1Models

Slot in /modelModelWhen
Opusclaude-opus-5-5Hard tasks
Sonnetclaude-sonnet-5Everyday work
Haikuclaude-haiku-5-5Small background tasks

Switch slots with /model. To use another model, change the name in settings.json and restart claude. All models: Models and pricing.

2VS Code extension

  1. Install the Claude Code extension from the Marketplace.
  2. The ~/.claude/settings.json file from the steps above must exist — the extension reads the same file.
  3. In VS Code settings, turn on Claude Code: Disable Login Prompt.
  4. Ctrl/Cmd + Shift + P → Developer: Reload Window.

3If it doesn't work

What you seeWhat to do
Asks you to log in to AnthropicThe key goes in ANTHROPIC_AUTH_TOKEN, not ANTHROPIC_API_KEY. Check the commas in settings.json. Logged in to Anthropic before? Run /logout
401Typo in the key or it was revoked — create a new one
402Out of balance — top up, no restart needed
403 email_unverifiedVerify your email in the dashboard
404 on every requestRemove /v1: the address is exactly https://api.zukko.pro
404 model_not_found or 503 model_disabledPick a model from the list
Windows: claude is not recognizedClose PowerShell and open it again

Other errors: Something went wrong: what to do.

Claude Code · Zukko Docs