Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [FEATURE] Allow custom avatar/icon in CLI header

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Code Example

{ "avatar": "~/.claude/my-avatar.png"}
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing requests and this feature hasn't been requested yet
  • 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

extent analysis

TL;DR

To customize the orange pixel art avatar in the Claude Code CLI header, consider adding support for a configurable avatar setting via a JSON file or a dedicated image file.

Guidance

  • Introduce a new configuration option in ~/.claude/settings.json to specify a custom avatar image path, as proposed in the issue.
  • Update the CLI header rendering logic to load and display the custom avatar image if the configuration option is set.
  • Consider adding validation for the custom avatar image path to ensure it exists and is a valid image file.
  • Evaluate the feasibility of supporting a set of built-in alternative icons as a fallback or additional option.

Example

{
  "avatar": "~/.claude/my-avatar.png"
}

This example shows how the custom avatar setting could be configured in the settings.json file.

Notes

The implementation details of the custom avatar feature will depend on the specific requirements and constraints of the Claude Code project. This guidance provides a general direction for implementing the feature.

Recommendation

Apply workaround: Introduce a configurable avatar setting via a JSON file or a dedicated image file, as this allows for a flexible and user-friendly solution for customizing the CLI header avatar.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#GPU setup#container setup#orchestration issue#cache issue#memory leak

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [FEATURE] Allow custom avatar/icon in CLI header