Connect Claude Pro

Six steps. ~4 minutes. Your existing Claude Pro / Max subscription becomes the engine that powers your Aria workspace — no developer API key, no double-billing.

Where do these commands run? In your own computer's terminal — the macOS Terminal / iTerm app, or your Linux shell. Not inside Claude Code, and not in the Aria workspace.
Do I paste a token anywhere? No — you never copy a token by hand. claude login signs you in through your browser, and the runner token is exchanged automatically by the install command. When the runner connects, this page shows a button to open your workspace.

Step 1 of 6

Confirm: you pay Anthropic for Claude Pro or Max?

This path uses your $20 (Pro) or $100–$200 (Max) Anthropic subscription. If you only have a developer API key (sk-ant-...), close this and use the API key path instead.

Step 2 of 6

Detect Claude Code on your machine

Claude Code is Anthropic's official local CLI. It carries your Pro/Max auth and is what Aria talks to. Open your terminal and run:

which claude

Waiting for you to run the command and tell us what you saw…

Why: Aria can't reach into your terminal to check itself. We give you the command, you tell us what you saw.

Step 3 of 6

Install Claude Code (skip if already installed)

Official Anthropic installer. macOS / Linux / WSL2 — one command:

curl -fsSL https://claude.com/install.sh | bash

Why this command: the curl-bash pulls Anthropic's official installer (signed). It installs claude to ~/.local/bin or /usr/local/bin. Add that to PATH if it isn't already.

Step 4 of 6

Sign in to Anthropic

Run this in your terminal. It opens your browser; sign in with the same email you use for Claude Pro/Max, then return to your terminal — nothing to copy back out. The OAuth token is saved locally — Aria never sees it.

Why: this is Anthropic's own sign-in flow. The token stays on your machine. Aria just sees a session-id when calls route through.

Step 5 of 6

Register this machine with Aria

One click — we mint a runner token bound to your account. The token gives this machine permission to receive Aria's call envelopes and execute them through your local claude.

Two short lines so nothing wraps or mangles on paste — run line 1, then line 2 in the same terminal. It downloads the runner script, saves your token to ~/.aria/aria-runner.token (chmod 600), and installs an aria-runner wrapper into /usr/local/bin or ~/.local/bin.

Step 6 of 6

Start aria-runner and verify it comes online

After the install in Step 5 completes, run this:

aria-runner

Tip: run inside tmux or screen so it survives a closed terminal: tmux new -d -s aria-runner 'aria-runner'