[DOCS] Feature request: Document recommended terminal font for Unicode UI characters

Resolved 💬 2 comments Opened Jan 13, 2026 by MikeWise2718 Closed Feb 26, 2026

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

  1. Document which Unicode code points Claude Code uses in its UI
  2. Test and officially recommend a specific font that renders all of them
  3. 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

View original on GitHub ↗

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