Meridian

Profiles

Manage Claude account profiles

Configured Profiles

Loading…
Add a profile

Setup Guide

How profiles work

Each profile is a separate Claude account with its own login credentials. Meridian stores them in isolated config directories and switches between them instantly.

Adding a new profile

  1. UI: Name it under Add a profile above, sign in, then paste the code Claude shows you — the whole callback URL works too
  2. CLI: meridian profile add <name>

Either way the profile gets its own config directory and is ready to use immediately. Only the CLI offers to adopt existing ~/.claude credentials as a profile; the UI always signs in fresh, so clicking Add can never quietly claim the account you are already logged in as on this machine.

⚠ Important for adding a second account: Before adding a different account, sign out of claude.ai in your browser first, then sign in with the other account. Claude’s OAuth reuses your browser session — if you’re already signed in, the login will silently use the same account.

Switching profiles

  1. UI: Click an account card on the home page, or the Switch button on this page
  2. CLI: meridian profile switch <name>
  3. Per-request: Send x-meridian-profile: <name> header

Re-authenticating a profile

  1. UI: Click Log in from browser on the profile card and sign in. Claude sends you back here and the login finishes itself. It is an ordinary link, so right-click it to open the sign-in in a private window or copy it into another browser — useful when this browser is already signed into a different Claude account.
  2. CLI: meridian profile login <name>

Claude will only redirect back to localhost or 127.0.0.1 — those are the addresses registered for this client. Browsing Meridian on any other hostname, the panel asks for the code instead; the bare code or the whole callback URL both work.

Other commands

meridian profile list — show all profiles and auth status
meridian profile login <name> — re-authenticate an expired profile
meridian profile rename <old> <new> — rename a profile (or use the pencil above)
meridian profile remove <name> — remove a profile

Renaming keeps the old name working: requests still naming it are served by the renamed profile, so nothing breaks mid-flight. That redirect is dropped as soon as the old name is taken again by a new profile.