Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

macOS Terminal.appなど、同期出力（synchronized output）をサポートしていないターミナルでの起動時に画面表示が乱れる（garbled）問題を修正しました。

原文（英語） ​

Fixed garbled startup rendering in macOS Terminal.app and other terminals that don't support synchronized output.

概要 ​

Claude Code v2.1.110では、macOS標準のTerminal.appなどsynchronized output（同期出力）機能をサポートしていないターミナルエミュレーターで起動時に画面表示が崩れる（文字が乱れる、レイアウトが壊れる）問題が修正されました。Synchronized outputは複数行のUI描画を一度にフラッシュするための最適化機能ですが、非対応のターミナルでは起動時の描画処理に問題を起こしていました。今回の修正でより多くのターミナルエミュレーターで正常に表示されるようになります。

基本的な使い方 ​

この修正はバグフィックスのため、v2.1.110へのアップデートで自動的に改善されます。特別な設定変更は不要です。

bash
# macOS Terminal.app でも正常に起動するようになった
# Terminal.app を開いて claude コマンドを実行するだけ
claude

実践例 ​

ユースケース1: macOS Terminal.app での使用 ​

// macOS Terminal.app で claude を起動する場合

// 修正前の動作:
// ╔═══════════════════════════════╗  ← 文字化け・レイアウト崩れ
// ║ ^[[?2026h Claude Code v2.1.1  ← エスケープシーケンスが表示される
// ║ ...

// 修正後の動作:
// ╔═══════════════════════════════╗
// ║ Claude Code v2.1.110          ║
// ║ > 入力してください...         ║
// ╚═══════════════════════════════╝

ユースケース2: 各種ターミナルエミュレーターとの互換性 ​

// 影響を受けていたターミナル（修正後は正常に動作）:
// - macOS Terminal.app
// - Linux の一部のターミナルエミュレーター
// - Synchronized output 非対応のターミナル全般

// Synchronized output 対応ターミナル（元から正常）:
// - iTerm2
// - Kitty
// - WezTerm
// - Alacritty（一部バージョン）

ユースケース3: ターミナルの確認と選択 ​

bash
# 現在使用しているターミナルを確認
echo $TERM_PROGRAM

# Terminal.app の場合
# Apple_Terminal が表示される

# iTerm2 の場合
# iTerm.app が表示される

# 修正後はどのターミナルでも正常に動作する

ユースケース4: 環境変数での動作調整 ​

bash
# Synchronized output を明示的に無効化（デバッグ用）
TERM_PROGRAM=Apple_Terminal claude

# または設定ファイルで調整
# .claude/settings.json
{
  "ui": {
    "synchronizedOutput": false
  }
}

ユースケース5: 表示に問題が続く場合のトラブルシューティング ​

bash
# ターミナルの設定を確認
echo $COLORTERM     # truecolor or 24bit
echo $TERM          # xterm-256color など
echo $TERM_PROGRAM  # ターミナルアプリの名前

# Claude Code の診断
claude doctor

# 代替ターミナルの試用（iTerm2 は Synchronized output 対応）
# brew install --cask iterm2

注意点 ​

  • 影響を受けていたターミナル — macOS Terminal.appを含む、Synchronized outputをサポートしていないターミナルエミュレーター全般に影響していました。
  • Synchronized output とは — 複数行のUI更新を原子的に画面に描画するための仕組みです（ANSI エスケープシーケンスの \e[?2026h/\e[?2026l）。
  • アップデートで解消 — v2.1.110にアップデートするだけで修正されます。ターミナルの設定変更は不要です。
  • macOS ユーザーへの推奨 — Terminal.appが引き続き使用できますが、iTerm2やWezTermなどの高機能ターミナルもオプションとして検討できます。

関連情報 ​