Skip to content

clustercode login

Terminal window
clustercode login

Opens your default browser for a secure OAuth sign-in. After authenticating, the CLI stores your API key in ~/.clustercode/credentials.json.

If you’re already logged in, the CLI asks whether to keep the current session or log in with a different account.

FlagDescription
--no-browserToken-based login (for headless/SSH environments)

For servers or environments without a browser:

Terminal window
clustercode login --no-browser

This prompts you to paste an API token and your email address. Generate a token from your orchestrator’s settings page.

The CLI also auto-detects headless environments (SSH sessions, display-less Linux) and switches to token-based login automatically.

Terminal window
clustercode status

Shows your authenticated email and connection state.

Getting Started Concepts Guides CLI Self-Hosting Reference Links