Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.raziel.fun/llms.txt

Use this file to discover all available pages before exploring further.

Raziel Router cuts your Claude Code costs by routing requests through a marketplace of spot-priced providers. This guide walks you from a fresh machine to a running Claude Code session — you only need Node.js and Claude Code installed.
1

Install the CLI and authenticate

Run the setup command once. Your browser opens to sign in; after you authorize, your API key is saved locally — no manual copy-paste required.
npx @raziel.fun/cli setup
The key is written to ~/.config/raziel/config.json. If you already have a key, you can paste it manually when prompted instead.
2

Issue an API key

The setup command creates a key automatically when you sign in. If you prefer to manage keys yourself, go to Customer → API Keys in the dashboard and click Issue key.
Copy the full key immediately after issuing it. It is shown only once. If you lose it, revoke the key and issue a new one.
Keys start with rz_live_. You can issue multiple keys (for example, one per machine or project) and revoke them individually at any time.
3

Deposit credits

Go to Customer → Deposit in the dashboard. Your current balance and a top-up link are shown on that page. Credits appear within seconds of a completed checkout.
Check your remaining balance at any time on the dashboard. Usage is metered per token and balances update after each request, so you can top up at any time without interrupting a session.
Requests are forwarded only when your balance is $0.05 or above. If a request is rejected with a 402 error, your balance has dropped below the minimum — top up and retry.
4

Launch Claude Code

Start Claude Code through the Raziel proxy with one command:
razi claude
This starts a local proxy on localhost:3099, then spawns Claude Code with ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN already set. No shell configuration changes are needed — the environment is injected only for the child process.All arguments after claude pass through directly to Claude Code:
razi claude --model claude-opus-4-7
You should see a short banner confirming the proxy port and key prefix before Claude Code’s interface appears.
Manual setup (advanced): If you prefer to set environment variables directly without the CLI, export the following before running claude:
export ANTHROPIC_BASE_URL=https://raziel.fun/gateway
export ANTHROPIC_AUTH_TOKEN=rz_live_xxxxxxxxxxxx
unset ANTHROPIC_API_KEY
claude logout  # only needed if you're signed in via claude.ai OAuth
Use ANTHROPIC_AUTH_TOKEN, not ANTHROPIC_API_KEY. The ANTHROPIC_API_KEY variable triggers a connectivity check against Anthropic’s servers, which will fail because you are pointing at the Raziel gateway instead.

Router overview

Learn how the gateway routes requests, what models are available, and how spot pricing works.

Teams overview

Spin up a persistent agent VM with Hermes, Claude Code, and integrations preinstalled for $40/mo.