CC逆引きリファレンス

動作が遅いのを解決したい

15. トラブルシューティング

コマンド / 機能

パフォーマンス最適化

Claude Code の動作を高速化

概要

Claude Code の動作が遅い場合の原因特定と最適化方法です。コンテキストサイズ、ネットワーク、システムリソースなど様々な要因に対処できます。

設定例

# コンテキストサイズを確認
/status
# Context: 180,000 / 200,000 tokens (90%) ← 大きすぎる

# コンテキストを圧縮
/compact

# 不要なファイルの読み込みを避ける
# .claudeignore を設定
echo "node_modules/" >> .claudeignore
echo "dist/" >> .claudeignore
echo "*.log" >> .claudeignore

# 大きなリポジトリでの最適化
# CLAUDE.md でプロジェクト構造を説明
# → Claude が全ファイルを読む必要がなくなる

# ネットワーク速度を確認
curl -o /dev/null -w "Time: %{time_total}s\n" https://api.anthropic.com

# システムリソースを確認
# メモリ使用量
free -h  # Linux
vm_stat  # macOS

# Node.js のメモリ制限を増やす
export NODE_OPTIONS="--max-old-space-size=4096"
claude

# 軽量モデルを使用(速度優先の場合)
claude --model claude-sonnet-4-20250514

こんな時に使う

  • レスポンスが遅い時
  • 大きなプロジェクトで使う時

使い方

  1. 1/status でコンテキストサイズを確認
  2. 2大きすぎる場合は /compact で圧縮
  3. 3.claudeignore で不要ファイルを除外
  4. 4CLAUDE.md でプロジェクト情報を提供

Tips

  • コンテキストが大きいほどレスポンスが遅くなる
  • node_modules などは .claudeignore で除外
  • 速度重視なら Sonnet モデルを検討