Claude Code ガイド

Appearance

Mac スリープ解除後の「Stream idle timeout」エラーを修正 ​

原文（日本語に翻訳） ​

Macをスリープから復帰させたリクエスト中に発生していた「Stream idle timeout」エラーを修正しました。

原文（英語） ​

Fixed "Stream idle timeout" error after waking Mac from sleep mid-request

概要 ​

Macがリクエスト処理中にスリープ状態になり、その後復帰した際に「Stream idle timeout」エラーが発生してセッションが中断される問題が修正されました。長時間かかる処理中にMacがスリープしても、復帰後に自動的に接続を回復して処理を継続できるようになります。

基本的な使い方 ​

bash
# 長い処理をリクエスト中にMacがスリープしても大丈夫
claude "この大きなコードベースを分析してリファクタリング計画を作成して"

# v2.1.126以前:
# → Macがスリープ → 復帰後に "Stream idle timeout" エラー

# v2.1.126以降:
# → Macがスリープ → 復帰後に自動復旧して処理継続

実践例 ​

長時間処理でのスリープ対策 ​

bash
# 以前はスリープを防ぐためにcaffeinate等を使う必要があった
caffeinate -i claude "大きなコードベースを分析して"

# v2.1.126以降: caffeinate不要（スリープからの自動復旧）
claude "大きなコードベースを分析して"

バックグラウンドタスクでの安定性向上 ​

bash
# 夜間に実行する長いバッチ処理でも安心
# Macがスリープから復帰しても処理が中断されない
claude --print "全テストファイルのレビューと改善提案を作成して" \
  > review-report.md

注意点 ​

  • 非常に長いスリープ後（数時間以上）は、APIセッションの有効期限切れで再接続が必要になる場合があります
  • スリープ中の処理は一時停止しており、復帰後に再開されます
  • バッテリー節約のためにMacがスリープすることは正常な動作です

関連情報 ​