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.

The razi CLI is the fastest way to use Raziel with Claude Code. It handles authentication, starts a local proxy, and launches Claude Code with the right environment already configured — no manual shell exports needed. The binary is also available as raziel (an alias for razi).

​
Installation

npx @raziel.fun/cli setup
After a global install, both razi and raziel are available in your PATH.

​
razi setup

Authenticates your machine and saves your API key locally. 
razi setup
1

Browser sign-in

The CLI opens your browser to the Raziel sign-in page. Complete the OAuth flow there.
2

Key saved

Once authorized, your key is written to ~/.config/raziel/config.json. The full key value is stored locally — keep this file protected.
If you prefer not to use the browser flow, you can paste a key manually when the CLI prompts you. Keys start with rz_live_ and are issued from Customer → API Keys in the dashboard.
Run razi setup again any time to replace your stored key with a new one.

​
razi claude

Starts a local proxy and launches Claude Code with the correct environment pre-configured. 
razi claude [args...]

​
What it does

  1. Reads your key from ~/.config/raziel/config.json.
  2. Starts a local HTTP proxy on localhost:3099.
  3. Spawns claude with ANTHROPIC_BASE_URL=http://localhost:3099 and ANTHROPIC_AUTH_TOKEN=<your key> set automatically — no shell config changes required.
  4. Exits when Claude Code exits, shutting down the proxy cleanly.

​
Passing arguments to Claude Code

Any arguments after claude are forwarded directly to the claude binary: 
razi claude
Claude Code must be installed for this command to work. Download it at https://claude.ai/download. If claude is not found in your PATH, the command will exit with an error.

​
Manual setup (advanced)

If you prefer to set environment variables yourself without the CLI: 
export ANTHROPIC_BASE_URL=https://raziel.fun/gateway
export ANTHROPIC_AUTH_TOKEN=rz_live_xxxxxxxxxxxx
unset ANTHROPIC_API_KEY
claude logout  # if signed in via claude.ai OAuth
Use ANTHROPIC_AUTH_TOKEN, not ANTHROPIC_API_KEY — the latter triggers a connectivity check against Anthropic’s servers.

​
razi shell

Lists your teams or opens an interactive PTY shell into a specific team’s server. 
razi shell [team]

​
List teams

Run with no argument to see all teams on your account with their status: 
razi shell
Each team is shown with a status indicator:
  • Green dot — active, shellable
  • Grey dot — not currently running

​
Open a shell

Pass a team slug or partial name to connect: 
razi shell blue-fox-1234
The CLI opens a full PTY session into the team’s VM. Your terminal size is forwarded automatically and kept in sync on resize. Exit the shell with exit or Ctrl-D. Ctrl-C is forwarded to the remote shell as usual (it does not disconnect you).
Only active (running) teams accept shell connections. If the team is stopped or still starting, the command will exit with an error. Check the status with razi shell (no argument) first.

​
razi status

Shows your current CLI configuration. Reads from the local config file — makes no network requests. 
razi status
Example output: 
  ▲ razi

  Key:     rz_live_abcd…
  Added:   2025-01-15
  Gateway: https://raziel.fun/gateway

​
Configuration file

The CLI stores your key at: 
~/.config/raziel/config.json
The file contains: 
{
  "apiKey": "rz_live_xxxxxxxxxxxx",
  "keyPrefix": "rz_live_abcd",
  "addedAt": "2025-01-15T10:00:00.000Z"
}
This file contains your full API key in plaintext. Restrict its permissions and do not commit it to version control.