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.
- Back up your config
cp ~/.claude.json ~/.claude.json.bak
- Find a userID you like
Use the reroll simulator to find a buddy you want, then copy the userID it gives you.
- 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!') " - Launch Claude Code and type
/buddyYour 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.
- Get your OAuth token
claude setup-token
- Reset config to minimal state
cp ~/.claude.json ~/.claude.json.bak echo '{"hasCompletedOnboarding": true, "theme": "dark"}' > ~/.claude.json - Set token and launch Claude
export CLAUDE_CODE_OAUTH_TOKEN="your-token-here" claude
Exit immediately — do NOT use /buddy yet.
- 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.