Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

長時間実行セッション中にtmuxウィンドウが削除またはリナンバーされた後、「Could not determine pane count」エラーでサブエージェントの起動が永続的に失敗する問題を修正しました

原文（英語） ​

Fixed subagent spawning permanently failing with "Could not determine pane count" after tmux windows are killed or renumbered during a long-running session

概要 ​

tmuxを使用した長時間セッション中に、ウィンドウを閉じたり番号が変わったりした後にサブエージェントが起動できなくなるバグが修正されました。このバグにより、tmuxユーザーがエージェントタスクを実行しようとすると「Could not determine pane count」エラーが発生し、セッションを再起動するまでサブエージェントが使用できなくなる問題がありました。

基本的な使い方 ​

この修正は自動的に適用されます。tmux環境でのClaude Codeが安定して動作するようになります：

bash
# tmux セッション内で Claude Code を起動
tmux new-session -s main
claude

# ウィンドウ操作後もサブエージェントが正常動作
# Ctrl+b c    → 新しいウィンドウを作成
# Ctrl+b x    → 現在のウィンドウを閉じる（リナンバーが発生）
# → 修正前: サブエージェント失敗
# → 修正後: サブエージェント正常動作

実践例 ​

長時間のバックグラウンドタスク実行 ​

bash
# tmux セッションでの安定した長時間作業
tmux new-session -d -s claude-work
tmux send-keys -t claude-work "claude" Enter

# 作業中にウィンドウを整理しても安全
# Ctrl+b , でウィンドウ名を変更
# Ctrl+b x でウィンドウを閉じる
# → サブエージェントは引き続き正常に動作

複数タスクの並行処理 ​

bash
# tmux で複数の Claude セッションを管理
tmux new-window -t main    # ウィンドウ追加
tmux kill-window -t main:2 # ウィンドウ削除（リナンバー発生）

# 修正後: リナンバー後もサブエージェントが正常起動
claude "複数のファイルを並行してリファクタリングしてください"
# → サブエージェントが正常に起動して並行処理

注意点 ​

  • tmux使用者向け: この修正はtmuxを使用している場合にのみ関連します
  • アップデートの確認: この修正を受けるにはv2.1.92以降に更新が必要です
  • エラーが出た場合: v2.1.92未満のバージョンで同様のエラーが発生する場合は、Claude Codeを最新版にアップデートしてください
bash
# バージョン確認
claude --version

# アップデート
npm update -g @anthropic-ai/claude-code

関連情報 ​