[DOCS] Feature request: Document recommended terminal font for Unicode UI characters
Documentation Type
Missing documentation (feature not documented)
Documentation Location
_No response_
Section/Topic
Need font recommendations
Current Documentation
There seems to be no font recommendations - fonts that have a the characters that Claude Code uses
What's Wrong or Missing?
There seems to be no font recommendations - fonts that have a the characters that Claude Code uses
Suggested Improvement
There should be font recommendations - fonts that have a the characters that Claude Code uses
Impact
Medium - Makes feature difficult to understand
Additional Context
Title: Feature request: Document recommended terminal font for Unicode UI characters
Body:
## Summary
Claude Code uses various Unicode symbols in its terminal UI that don't render correctly with common default fonts on
Ubuntu/GNOME Terminal (and likely other Linux distributions). Rather than an ASCII-only fallback mode, please test and
document a recommended font that's verified to display all Claude Code UI characters correctly.
Note that this makes things like the /context graphical display unusable.
## Problem
Several Unicode characters used in Claude Code's UI render as boxes with hex codes or blank spaces:
- The indicator before "accept edits on"
- Context display symbols (⛁, ⛶, ⛝)
- Possibly others
This occurs even with:
- Ubuntu 22.04 + GNOME Terminal (default setup)
- Ubuntu 22.04 + Terminator
- JetBrains Mono Nerd Font installed
- Locale set to UTF-8
## Suggested Solution
- Document which Unicode code points Claude Code uses in its UI
- Test and officially recommend a specific font that renders all of them
- Add this to the installation/setup docs (e.g., "For best results on Linux, install X font")
This is preferable to ASCII-only mode because the Unicode symbols are useful - they just need to actually render.
## Environment
- OS: Ubuntu 22.04
- Kernel: 6.8.0-90-generic
- Terminal: GNOME Terminal, Terminator
- Claude Code version: (current)
- Fonts tested: Ubuntu Mono, JetBrains Mono Nerd Font
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗