Run Claude Code with just
your token — on Windows.
clauda launches Claude Code
against its built-in, token-billed endpoint — without ever touching your subscription login.
Type clauda, paste your token once, and you're in. Every session is fully isolated.
1Install clauda
Open PowerShell and run this one line. It checks for Claude Code, installs it first if
it is missing (via the official installer), then installs clauda and adds it to your PATH.
# installs Claude Code (if needed) + clauda
irm https://clauda-install.pages.dev/install.ps1 | iexclauda help and claude --version.
irm https://claude.ai/install.ps1 | iex.
2Run it — give your token once
Open a new terminal and just run clauda. The first time, it asks for your
API token (input hidden) and saves it. Plain claude stays on your
subscription — untouched.
clauda # first run asks for your token, then starts a session
clauda -p "explain this repo" # one-shot; args pass through to claudeCLAUDE_CONFIG_DIR, so your ~/.claude
subscription login is never mixed with token sessions — and you never get the
“API key vs subscription” conflict prompt.
Commands
| Command | What it does |
|---|---|
clauda [args…] | Start Claude Code against the default endpoint (args pass through) |
clauda login | Enter / replace the saved token |
clauda logout | Delete the saved token |
clauda help | Show help |
Where things live
| Path | What |
|---|---|
%USERPROFILE%\.config\clauda\token | Your saved token (readable only by you) |
%USERPROFILE%\.config\clauda\claude-config | Isolated Claude Code config for clauda sessions |
%LOCALAPPDATA%\Programs\clauda | The clauda program itself |
Need a different token later? Run clauda login to replace it, or
clauda logout to remove it.
Uninstall
Remove-Item "$env:LOCALAPPDATA\Programs\clauda" -Recurse -ForceDelete %USERPROFILE%\.config\clauda too if you want to remove your saved token and
config. Claude Code itself is not removed.