Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

  • 長時間実行セッションでのメモリ使用量を改善：使用後に API ストリームバッファ、エージェントコンテキスト、スキル状態を解放するようにしました。
  • SessionStart フックの実行を遅延させることで起動パフォーマンスを改善し、インタラクティブになるまでの時間を約 500ms 短縮しました。
  • @ ファイルメンション のパフォーマンスを改善：起動時にインデックスをプリウォームし、バックグラウンド更新付きのセッションベースキャッシュを使用することで、ファイル候補の表示が高速化されました。
  • エージェントタスクメッセージ履歴をタスク完了後にトリミングすることでメモリ使用量を改善しました。
  • プログレス更新における O(n²) のメッセージ蓄積を解消することで、長時間エージェントセッション中のメモリ使用量を改善しました。

原文（英語） ​

  • Improved memory usage in long-running sessions by releasing API stream buffers, agent context, and skill state after use.
  • Improved startup performance by deferring SessionStart hook execution, reducing time-to-interactive by ~500ms.
  • Improved performance of @ file mentions - file suggestions now appear faster by pre-warming the index on startup and using session-based caching with background refresh.
  • Improved memory usage by trimming agent task message history after tasks complete.
  • Improved memory usage during long agent sessions by eliminating O(n²) message accumulation in progress updates.

概要 ​

v2.1.47 では複数のパフォーマンス改善が同時に実施されました。メモリ使用量に関しては、長時間のセッションやマルチエージェント使用時に発生していたメモリの肥大化を防ぐための改善が加えられました。起動時間は約 500ms 短縮され、@ ファイルメンション機能もインデックスのプリウォームにより高速化されています。大規模なプロジェクトや長時間の作業セッションでの体験が向上します。

基本的な使い方 ​

これらの改善はすべて自動的に適用されます。特別な設定や操作は不要です。ただし、効果を実感しやすいシナリオを理解しておくと役立ちます。

bash
# 起動時間の改善：claude コマンドで起動するとより素早くプロンプトが表示される
claude

# @ファイルメンション：ファイル名の補完がより素早く表示される
# 入力例（Claude Codeのチャット内で）
@src/components/Button.tsx

実践例 ​

長時間セッションでのメモリ節約 ​

以前は長時間使い続けるとメモリ消費が増大していましたが、今回の改善で緩和されています：

作業パターン（改善前）:
- 朝からコーディング開始
- 数時間後：メモリ使用量が増加、レスポンスが遅くなる
- ターミナルが重くなりリスタートが必要なことも

作業パターン（改善後）:
- 朝からコーディング開始
- 使用後にバッファが解放される
- 長時間でも安定したパフォーマンスを維持

マルチエージェント使用時のメモリ効率 ​

複数のエージェントを並行して使う際の影響：

# 複数エージェントの並行実行（Claude Code のマルチエージェント機能）
# 以前は各エージェントのコンテキストがメモリに残り続けた
# 改善後はタスク完了後に自動クリーンアップ

エージェント1: テスト実行 → 完了後メモリ解放
エージェント2: ドキュメント生成 → 完了後メモリ解放
エージェント3: コードレビュー → 完了後メモリ解放

起動時間の短縮効果 ​

bash
# SessionStart フックを使用している場合
# 以前：フック実行を待ってからインタラクティブに
# 現在：フック実行を遅延させ、まずインタラクティブに

# ~/.claude/settings.json に SessionStart フックが設定されている場合でも
# Claude Code が素早く応答できるようになりました
{
  "hooks": {
    "SessionStart": [...]  // このフックの実行が遅延される
  }
}

@ファイルメンションのパフォーマンス向上 ​

# 大規模プロジェクトでの効果が顕著
プロジェクト構造:
src/
  components/    (100+ ファイル)
  services/      (50+ ファイル)
  utils/         (30+ ファイル)

# 以前: @src/ と入力後、候補表示まで数秒かかることがある
# 改善後: 起動時にインデックスをプリウォームするため即座に候補表示

注意点 ​

  • 自動適用：すべてのパフォーマンス改善は自動的に有効になります。設定変更は不要です。
  • 効果の程度：改善効果はプロジェクトの規模、セッションの長さ、使用するエージェント数によって異なります。小規模プロジェクトでは体感しにくい場合もあります。
  • SessionStart フックの遅延：起動時の SessionStart フックが遅延実行になったことで、フックが実行される前に Claude が操作可能になります。フックが実行されるまでの間に Claude に指示を出しても問題ありません。
  • O(n²) 問題の解消：長時間のエージェントセッション（数十回のやりとりを超えるもの）で特に改善効果が大きいです。

関連情報 ​