Claude UUID: How to Find Your Claude Buddy UUID
Find your Claude UUID or Claude account UUID to use the Buddy Checker. Located in ~/.claude.json - here is exactly how to get it.
Step-by-Step
Open your terminal
Use Terminal.app on macOS, or any terminal emulator on Linux.
Run this command
$ grep accountUuid ~/.claude.jsonCopy the Claude UUID value
Prefer oauthAccount.accountUuid when you need your Claude UUID. If you only see userID, that works too.
Paste into the Checker
Head to the Buddy Checker and paste your UUID to preview your buddy.
Important Note
Team or Pro users should prefer accountUuid over userID. Using the wrong ID will show a different buddy than what you see in Claude Code. If you don't have a buddy yet, check our setup guide to hatch your first pet.
Troubleshooting
Can't find ~/.claude.json
Make sure you have Claude Code installed and have launched it at least once. The file is created on first launch.
No accountUuid or Claude UUID field
Older versions may not label the value as accountUuid. Try grep userID ~/.claude.json as a fallback. If neither exists, update Claude Code to the latest version.
Checker result doesn't match
Common cause: using userID instead of accountUuid (Team/Pro accounts must use accountUuid), or a reroll tool changed the salt.