[FEATURE] Allow customizing/swapping the Claude Code mascot icon
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
Claude Code shows a fixed mascot/icon in the corner of its interface (e.g. top-left of the app/session header), but there's no way to change it. Users who'd like to personalize their session or match a team/brand identity currently have no supported option to do so.
Proposed Solution
Let users swap the default Claude Code mascot for another icon from a small curated set (or a custom image), configurable via a setting in settings.json or a CLI flag, persisted across sessions.
Alternative Solutions
No built-in way exists today. The only "workaround" is manually editing extension/app icon assets on disk, which is unsupported and gets wiped out on every update.
Priority
Low - Nice to have
Feature Category
Configuration and settings
Use Case Example
Example scenario:
- I open Claude Code for a new session.
- I'd like the icon in the corner to reflect something other than the default mascot (a different character, or my team's branding).
- With this feature, I could pick/configure an alternate icon once and have it persist across sessions.
- This makes the tool feel more personalized without affecting functionality.
Additional Context
Related to #73842 ("Add optional character/avatar icons for Claude Code") — filing this separately to add a second, independent data point for the same underlying capability (customizable mascot/icon), since that request has been open with no engagement yet. Please consider merging/tracking together if that's more appropriate.