[FEATURE] Allow custom avatar/icon in CLI header
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
--- It would be nice to customize the orange pixel art avatar shown in the Claude Code CLI header with a custom image or icon.
Current behavior
The orange pixel art icon is hardcoded and cannot be changed.
Expected behavior
Users can set a custom avatar that replaces the default icon in the CLI header.
Proposed Solution
Allow configuration via ~/.claude/settings.json or a dedicated file (e.g. ~/.claude/avatar.png):
{ "avatar": "~/.claude/my-avatar.png"}
Or support a set of built-in alternative icons to choose from.
Alternative Solutions
_No response_
Priority
Low - Nice to have
Feature Category
CLI commands and flags
Use Case Example
Use case
- Personalize the CLI experience — especially useful for teams where multiple devs use Claude Code and want to distinguish their sessions visually.
Additional Context
_No response_
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗