← Home

How to Reroll Your Claude Code Buddy

Your buddy is deterministically generated from your user ID. To get a different buddy, you need to change the ID that Claude Code uses for the roll.

Prerequisites

  • Claude Code v2.1.89 or later
  • Access to your terminal
  • The reroll simulator to find a userID you like

Understanding the ID Priority

Claude Code picks the buddy seed using this priority:

accountUuid  →  userID  →  "anon"
(highest)       (fallback)  (default)

If accountUuid exists in your config, it overrides userID. To use a custom userID for your buddy, you must remove accountUuid.

Method 1: Direct userID Edit (Simplest)

Best if you just want to change your buddy quickly.

  1. Back up your config
    cp ~/.claude.json ~/.claude.json.bak
  2. Find a userID you like

    Use the reroll simulator to find a buddy you want, then copy the userID it gives you.

  3. Remove accountUuid and set new userID
    python3 -c "
    import json
    with open('$HOME/.claude.json', 'r') as f:
        data = json.load(f)
    # Remove accountUuid so userID takes priority
    if 'oauthAccount' in data and 'accountUuid' in data['oauthAccount']:
        del data['oauthAccount']['accountUuid']
    # Set your desired userID
    data['userID'] = 'PASTE_YOUR_DESIRED_USERID_HERE'
    with open('$HOME/.claude.json', 'w') as f:
        json.dump(data, f, indent=2)
    print('Done!')
    "
  4. Launch Claude Code and type /buddy

    Your new buddy should appear. The name and personality are generated by AI on first hatch, so they will be unique.

Method 2: OAuth Token Method

Uses the OAuth token environment variable to prevent accountUuid from being written.

  1. Get your OAuth token
    claude setup-token
  2. Reset config to minimal state
    cp ~/.claude.json ~/.claude.json.bak
    echo '{"hasCompletedOnboarding": true, "theme": "dark"}' > ~/.claude.json
  3. Set token and launch Claude
    export CLAUDE_CODE_OAUTH_TOKEN="your-token-here"
    claude

    Exit immediately — do NOT use /buddy yet.

  4. Set your desired userID in the generated config, then relaunch and use /buddy

Method 3: cc-buddy CLI Tool

An interactive npm tool that wraps the entire process.

npx cc-buddy

Select option 1 (Search) to find your desired buddy, or option 3 to customize name/personality.

Important Notes

  • Re-authenticating with OAuth may re-write accountUuid — you will need to remove it again.
  • The buddy name and personality are generated by AI on first hatch and stored separately from the visual traits.
  • Visual traits (species, rarity, stats) are always regenerated from the userID — they cannot be faked by editing the config.