【結論】解決策 / 実行コマンド
Claude Codeの記号が四角形や疑問符になる場合、原因はClaude Code本体より、ターミナルの文字コード、ロケール、フォント、Unicode幅設定であることが一般的です。
まずUTF-8ロケールとUnicode対応フォントを確認します。
# ターミナルで実行:現在のロケールを確認
locale
# ターミナルで実行:端末種別を確認
printf 'TERM=%s\nCOLORTERM=%s\n' "$TERM" "$COLORTERM"
# macOS・Linuxで一時的にUTF-8ロケールを指定して起動
LC_ALL=C.UTF-8 LANG=C.UTF-8 claude
# ターミナルで実行:診断情報を確認
claude doctor
具体的な手順・設定方法
- ターミナル設定で日本語とUnicode記号を含む等幅フォントを選びます。
- SSH、tmux、WSLを使う場合は、ローカルとリモートの双方でUTF-8ロケールを揃えます。
- 古いターミナルやフォントを更新し、新しいセッションで再確認します。
実践プロンプト / 活用テクニック
# ターミナルで実行:Unicode表示テスト
printf 'ASCII: OK\nUnicode: ✓ → ─ │ ┌ ┐\n日本語: 表示確認\n'
# ターミナルで実行:Claude Codeを起動
claude
注意点・よくあるエラーと対処法
Nerd Fontは便利ですが必須とは限らず、一般的なUnicode対応等幅フォントで改善する場合があります。
en_US.UTF-8 が未生成のLinux環境では指定しても起動エラーになるため、C.UTF-8 など利用可能なロケールを確認してください。
文字化けと色崩れは別問題であり、色はTERM、テーマ、コントラスト設定も確認してください。