Skip to content

原文(日本語に翻訳)

レイアウト変更後のメインスクリーンターミナルでのレンダリングアーティファクトを修正しました。

原文(英語)

Fixed rendering artifacts on main-screen terminals after layout shifts

概要

ターミナルウィンドウのサイズ変更やペインの分割・統合など、レイアウトが変化した際に、Claude Codeを表示しているメインスクリーンのターミナルに文字の残留や表示の乱れ(レンダリングアーティファクト)が発生するバグが修正されました。特にウィンドウのリサイズ直後に文字化けや不要な文字が残る問題でした。

基本的な使い方

bash
# ターミナルでのClaude Code使用中にレイアウトを変更する操作
# 1. ターミナルウィンドウをリサイズ
# 2. tmuxでペインを分割・統合
# 3. ウィンドウをフルスクリーンに切り替え

# 修正後: これらの操作後もClaude Codeの表示が正常に保たれる

実践例

ターミナルリサイズ後の確認

bash
# macOS ターミナルでのリサイズテスト
# 1. Claude Code を起動
# 2. ターミナルウィンドウを縮小・拡大
# 3. 修正後: 表示が乱れない

# tmux でのペイン分割
tmux split-window -h  # 水平分割
# または Ctrl+B % で縦分割
# または Ctrl+B " で横分割
# 修正後: 分割後もClaude Codeが正常に表示される

様々なターミナルエミュレータでの動作

bash
# iTerm2 でのテスト
# ターミナルタブの切り替えやペイン操作後
# 修正後: レンダリングアーティファクトが発生しない

# Alacritty でのテスト
# ウィンドウリサイズ後
# 修正後: 表示が正常に更新される

# Terminal.app (macOS標準) でのテスト
# ウィンドウサイズ変更後
# 修正後: 文字の残留なく正しく表示される

tmux内でのClaude Code使用

bash
# tmux セッションでClaude Codeを使用する一般的な設定
tmux new-session -s claude-work
claude

# ペインの追加と削除
# Ctrl+B c で新しいウィンドウ
# Ctrl+B x でペインを閉じる
# 修正後: これらの操作後も表示が安定している

注意点

  • この問題は「メインスクリーン」ターミナル(通常のターミナル、tmuxのメインバッファなど)で発生していました
  • オルタネートスクリーン(lessなどで使用)とは異なります
  • ターミナルのリサイズはSIGWINCHシグナルを通じて通知されますが、その処理タイミングに問題がありました
  • 特定のターミナルエミュレータでより顕著に発生していた可能性があります

関連情報