Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

ターミナル出力キャッシュによる長期セッションのメモリ増大を削減

原文（英語） ​

Reduced long-session memory growth from terminal output cache

概要 ​

Claude Codeを長時間使い続けると、ターミナル出力のキャッシュがメモリを蓄積し続ける問題が修正されました。この改善により、長期セッションでのメモリ使用量の増大が抑制され、数時間の連続使用でも安定したパフォーマンスを維持できるようになります。

基本的な使い方 ​

この改善は自動的に適用されます。ユーザー側での設定変更は不要です。

bash
# 長時間セッションでの使用
claude

# 数時間後も
# 改善前: メモリが増大し続け、動作が重くなることがあった
# 改善後: メモリ使用量が安定し、パフォーマンスが維持される

実践例 ​

終日の開発セッション ​

bash
# 朝から夕方まで継続して使用する場合
claude  # 起動

# 午前中: コードレビュー、ファイル編集...
# 午後: 大量のターミナル出力を伴うテスト実行...
# 夕方: ドキュメント生成...

# 改善前: 大量のターミナル出力後にメモリが膨れ上がることがあった
# 改善後: メモリが安定して維持される

大量出力を伴うコマンドの実行後 ​

bash
# 大量の出力を生成するコマンド
find / -name "*.log" 2>/dev/null | head -1000

# 大きなログファイルの内容確認
cat /var/log/large-application.log

# 改善前: このような大量出力がキャッシュされ続けてメモリを圧迫
# 改善後: キャッシュが適切に管理され、メモリを圧迫しない

バックグラウンドエージェントの長期実行 ​

bash
# 長時間動作するバックグラウンドエージェント
claude "このリポジトリ全体を分析してレポートを作成してください"

# 大量のファイル読み取り・出力を伴う処理でも
# 改善後: メモリ使用量が安定する

技術的な背景 ​

ターミナル出力キャッシュは、スクロールバックや再表示のために必要ですが、適切な上限なしに蓄積し続けるとメモリリークと同様の問題が起きます。今回の修正でキャッシュの管理が改善され、古い出力データが適切に解放されるようになりました。

注意点 ​

  • この改善により、非常に古いターミナル出力へのスクロールバックが制限される場合があります（キャッシュが解放されるため）。
  • メモリ使用量の改善はセッション時間が長くなるほど顕著になります。短いセッションでは差が見えにくい場合があります。
  • 依然として非常に長い会話やコンテキストの場合は /clear や /compact でコンテキストを整理することをお勧めします。

関連情報 ​

  • 関連改善: ストリーミング応答のCPU使用率削減（同バージョン）
  • 関連コマンド: /clear（コンテキストのクリア）、/compact（コンテキストの圧縮）
  • Claude Code ドキュメント