[FEATURE] Allow custom avatar/icon in CLI header

Resolved 💬 2 comments Opened Apr 20, 2026 by GrimonprezAlexis Closed May 27, 2026

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_

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗