Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

  • 自動モード（auto mode）がOpus 4.8を有効化していない組織のFable 5で失敗していた問題を修正しました。分類器（classifier）は利用可能な最良のOpusモデルにフォールバックするようになりました。
  • Read/Edit/Write ツールのパスに対するフック（hook）の if 条件を修正しました。Edit(src/**)、Read(~/.ssh/**)、Read(.env) のようなドキュメント記載のパターンが正しくマッチするようになりました。
  • .claude/settings.json が絶対パスをターゲットとするシンボリックリンクの場合に、Linuxサンドボックスの起動に失敗する問題を修正しました。
  • tmux上のSSH接続環境で /copy やマウス選択によるコピーがシステムのクリップボードに届かない問題と、tmux 3.2より古いバージョンでペーストバッファが読み込まれない問題を修正しました。
  • Web/モバイルからのRemote Control接続が、セッションのモデルを無断で切り替えてしまう問題を修正しました。
  • Remote Controlの切断通知が、人間が読める理由ではなく数値コードだけを表示する問題と、接続失敗時に会話トランスクリプトへ重複行が追加される問題を修正しました。
  • 別のアカウントにサインインしたときにRemote Controlセッションが切断されない問題を修正しました。
  • /cd やワークツリーの移動後も、セッションが移動前のディレクトリのgitブランチを報告し続ける問題を修正しました。
  • claude agents で、あるウィンドウで「戻る」を押すと、同じセッションにアタッチしている他のウィンドウまでデタッチされてしまう問題を修正しました。
  • ターン途中で /bg を実行しても継続すべき処理が残っていない場合に、バックグラウンドセッションが「Working」のまま固まる問題を修正しました。
  • PR URLによるバックグラウンドエージェント検索を修正しました。スケジュールされた起動（wakeup）中やジョブがブロックされている間に開かれたPRが、claude agents の検索に表示されるようになりました。
  • Windowsでエージェントビューの入力欄にテキストカーソルが表示されない問題を修正しました。
  • claude --bg -cn <name> がセッション名を初期設定（seed）しない問題を修正しました。
  • バックグラウンドセッションについて、再起動（respawn）前に永続化された状態のWindowsネットワークパスを無害化するよう修正しました。
  • 破損した状態ファイルから不正な形式のレジュームIDが渡された場合に、バックグラウンドセッションの再起動が拒否される問題を修正しました。
  • ~/.claude/daemon に ReadOnly 属性が設定されている場合に、Windowsのバックグラウンドサービスデーモンが起動しない問題を修正しました。
  • クラウドセッションが、クレーム（claim）される前にアイドル状態が長く続くと「Could not resolve authentication method」で失敗する問題を修正しました。
  • 自動アップデートをまたいで開いたままのウィンドウが返信を送信できない場合に、より分かりやすいガイダンスを表示するようにしました。また claude daemon status がバージョンの食い違い（version-skew）時の挙動を説明するようになりました。

原文（英語） ​

  • Fixed auto mode failing on Fable 5 for organizations without Opus 4.8 enabled — the classifier now falls back to the best available Opus model
  • Fixed hook if conditions for Read/Edit/Write tool paths: documented patterns like Edit(src/**), Read(~/.ssh/**), and Read(.env) now match correctly
  • Fixed Linux sandbox failing to start when .claude/settings.json is a symlink with an absolute target
  • Fixed /copy and mouse-selection copy not reaching the system clipboard inside tmux over SSH, and tmux paste buffer not loading on versions older than 3.2
  • Fixed Remote Control connecting from web/mobile silently switching the session's model
  • Fixed Remote Control disconnect notifications showing a bare numeric code instead of a human-readable reason, and connection failures adding a duplicate line to the conversation transcript
  • Fixed Remote Control sessions not disconnecting when you sign in to a different account
  • Fixed /cd and worktree moves leaving the session reporting the previous directory's git branch
  • Fixed claude agents: pressing back in one window no longer detaches other windows attached to the same session
  • Fixed backgrounded sessions showing "Working" forever when /bg mid-turn had nothing left to continue
  • Fixed background agent search by PR URL: PRs opened during scheduled wakeups or while a job was blocked now appear in claude agents search
  • Fixed the agents view input showing no text cursor on Windows
  • Fixed claude --bg -cn <name> not seeding the session name
  • Fixed background sessions to neutralize Windows network paths in persisted state before respawn
  • Fixed background-session respawn rejecting malformed resume IDs from corrupted state files
  • Fixed the Windows background-service daemon not starting when ~/.claude/daemon has the ReadOnly attribute set
  • Fixed cloud sessions failing with "Could not resolve authentication method" when idle for too long before being claimed
  • Background sessions now show clearer guidance when a window left open across an auto-update can't submit a reply, and claude daemon status explains version-skew behavior

概要 ​

2.1.176では、機能追加・改善のほかに多数のバグ修正が行われました。特にRemote Control（Web/モバイルからの遠隔操作）、バックグラウンドセッション、LinuxサンドボックスやWindowsデーモンといったプラットフォーム固有の問題が広く修正されています。この記事では、それらの修正をカテゴリ別にまとめて紹介します。

主な修正点 ​

Remote Control 関連 ​

Web/モバイルからのRemote Control周りで複数の問題が修正されました。

  • Web/モバイルから接続した際にセッションのモデルが無断で切り替わる問題が解消されました。意図したモデルが維持されます。
  • 切断通知が数値コードだけだったのが、人間が読める理由を表示するようになりました。
  • 接続失敗時に会話トランスクリプトへ重複行が追加される問題が解消されました。
  • 別のアカウントにサインインしたときに、Remote Controlセッションが正しく切断されるようになりました。

バックグラウンドセッション / claude agents 関連 ​

バックグラウンドで動作するセッションとエージェントビューに関する修正です。

  • ターン途中で /bg を実行しても継続処理が残っていない場合に、セッションが「Working」のまま固まる問題を修正。
  • claude agents で、あるウィンドウで「戻る」を押すと同じセッションにアタッチした他ウィンドウまでデタッチされる問題を修正。
  • スケジュール起動中やジョブがブロック中に開かれたPRが、PR URL検索で表示されるようになりました。
  • claude --bg -cn <name> がセッション名を初期設定するようになりました。
  • 破損した状態ファイルからの不正なレジュームIDで再起動が拒否される問題、およびWindowsネットワークパスの無害化を修正。

プラットフォーム固有（Linux / Windows / tmux） ​

  • Linux: .claude/settings.json が絶対パスをターゲットとするシンボリックリンクの場合に、サンドボックスが起動に失敗する問題を修正。
  • Windows: エージェントビューの入力欄にテキストカーソルが表示されない問題を修正。
  • Windows: ~/.claude/daemon に ReadOnly 属性が設定されているとバックグラウンドサービスデーモンが起動しない問題を修正。
  • tmux + SSH: /copy やマウス選択コピーがシステムクリップボードに届かない問題、tmux 3.2より古いバージョンでペーストバッファが読み込まれない問題を修正。

フック条件・モデル・認証 ​

  • フックの if 条件: Edit(src/**)、Read(~/.ssh/**)、Read(.env) のようなパスパターンが正しくマッチするようになりました。
  • 自動モード: Opus 4.8 を有効化していない組織のFable 5で失敗していた問題を修正。分類器が利用可能な最良のOpusモデルにフォールバックします。
  • /cd やワークツリー移動後に、移動前ディレクトリのgitブランチを報告し続ける問題を修正。
  • クラウドセッションが、クレームされる前に長くアイドルすると「Could not resolve authentication method」で失敗する問題を修正。
  • 自動アップデートをまたいだウィンドウが返信できない場合のガイダンスを改善し、claude daemon status がバージョン食い違い時の挙動を説明するようになりました。

注意点 ​

  • フックの if 条件を使っている場合、Edit(src/**) や Read(.env) のようなパターンがこれまで意図通りにマッチしていなかった可能性があります。修正後の挙動でフック設定を再確認してください。
  • Remote Controlでモデルが無断切り替えされていた問題が直ったため、これまでの挙動を前提にしていた場合は表示モデルを確認してください。
  • tmux環境でコピーが効かなかった場合は、tmuxを3.2以降に更新することでペーストバッファ関連の挙動も改善します。

関連情報 ​