Authentication

agentty authenticates with your Claude Pro/Max OAuth subscription or an Anthropic API key. Both flow through the same login path.

OAuth (Claude Pro/Max)

The main path. On first launch the auth modal opens your browser; the callback writes the token to ~/.config/agentty/credentials.json at mode 0600. agentty picks the right header on relaunch automatically — no extra billing, the same account you already pay for.

API key

Paste an sk-ant-… token into the modal. Saved to the same credentials file.

Override order

Highest priority first:

1. -k <key> / --key <key> — single-session, never written to disk.
2. ANTHROPIC_API_KEY environment variable.
3. CLAUDE_CODE_OAUTH_TOKEN environment variable.
4. The on-disk credentials from the modal.

Non-interactive auth (over SSH)

agentty login     # complete auth without entering a thread
agentty logout    # clear stored credentials
agentty status    # show which auth source will be used⧉