claude_profile

Claude Code account credential management.

Files

Responsibility Table

Scope

In Scope:

• Account credential snapshots in $PRO/.persistent/claude/credential/ (or $HOME/.persistent/...)
• Token expiry detection from ~/.claude/.credentials.json
• All canonical ~/.claude/ paths via ClaudePaths
• Persistent user storage path resolution via PersistPaths ($PRO/$HOME)

Out of Scope:

• ❌ Claude Code process execution → claude_runner_core
• ❌ Continuation detection (session file existence) → claude_storage_core
• ❌ Session directory management → claude_runner_core::SessionManager
• ❌ Pulse keeping (periodic claude invocation) → caller + claude_runner
• ❌ Browser launch / xdg-open → caller
• ❌ OAuth HTTP token refresh → network dependency not allowed
• ❌ Server-side 5-hour subscription window → not locally observable

Account Management

use claude_profile::{ account, token, ClaudePaths, PersistPaths };

// Where are the files?
let claude = ClaudePaths::new().expect( "HOME must be set" );
let persist = PersistPaths::new().expect( "HOME must be set" );
let credential_store = persist.credential_store();
println!( "credentials:      {}", claude.credentials_file().display() );
println!( "credential_store: {}", credential_store.display() );
println!( "projects:         {}", claude.projects_dir().display() );

// Check active token status
match token::status().expect( "failed to read credentials" )
{
  token::TokenStatus::Valid { expires_in } =>
    println!( "ok — {}m remaining", expires_in.as_secs() / 60 ),
  token::TokenStatus::ExpiringSoon { expires_in } =>
    eprintln!( "expires in {}m — consider switching accounts", expires_in.as_secs() / 60 ),
  token::TokenStatus::Expired =>
    eprintln!( "token expired — run: claude auth login" ),
}

// List all stored accounts
for acct in account::list( &credential_store ).expect( "failed to list accounts" )
{
  let active = if acct.is_active { " ← active" } else { "" };
  println!( "{}{} ({})", acct.name, active, acct.subscription_type );
}

// Save current credentials as "work@acme.com"
account::save( "work@acme.com", &credential_store, &claude, true, None, None, None, None ).expect( "failed to save account" );

// Switch to "personal@home.com"
account::switch_account( "personal@home.com", &credential_store, &claude ).expect( "failed to switch" );

// Delete an old account
account::delete( "old@acme.com", &credential_store ).expect( "failed to delete" );

File Paths

use claude_profile::{ ClaudePaths, PersistPaths };

let p = ClaudePaths::new().expect( "HOME must be set" );
let persist = PersistPaths::new().expect( "HOME must be set" );
println!( "credentials:      {}", p.credentials_file().display() );
println!( "credential_store: {}", persist.credential_store().display() );
println!( "projects:         {}", p.projects_dir().display() );
println!( "stats:            {}", p.stats_file().display() );
println!( "settings:         {}", p.settings_file().display() );
println!( "session-env:      {}", p.session_env_dir().display() );
println!( "sessions:         {}", p.sessions_dir().display() );

Binary

Two names, same binary — both claude_profile and clp are installed:

clp .accounts              # list saved accounts
clp .usage                 # live rate-limit quota for all saved accounts
clp .paths                 # show ~/.claude/ canonical paths

Testing

Container (all tests — credentials required):

./verb/test

Container (offline — no credentials needed):

./verb/test offline

Container (interactive shell):

./verb/shell

Local (Docker-orchestrated):

./verb/test