【続報】Claude Code 2.1.312、hookの同時実行は24本まで

米Anthropicは、コーディングエージェント「Claude Code」の2.1.312を10月27日（米国時間）に出した。変更履歴によると、promptとagentのhookは1つのセッションで同時に24本までしか動かなくなり、クラウドで動くroutineは作る時にeffort（考える深さ）を選べるようになった。追加が4件、変更が9件、改善が4件、不具合の直しが22件の版で、hookやroutineで作業を自動で回している人ほど影響が大きい。

hookは同時に24本まで

hookは、Claude Codeが道具を使う前後やメッセージを受けた時などに、利用者が決めた処理を差し込む仕組みだ。今回の版から、promptとagentのhookは1つのセッションで同時に24本までしか動かない。サブエージェントが起こしたhookも同じ数に入る。

これとは別に、イベントごとのタイムアウトより長く待っているhookを12本まで認める。タイムアウトを1秒未満に設定していたhookは、1秒として扱われるようになった。

hookを多く仕込み、サブエージェントを何本も並べて動かしている人は、これまで一斉に走っていたhookが順番待ちになる場合がある。hookの中で時間を測って判定している人や、ごく短いタイムアウトで止めるつもりだった人は、手元で一度動きを確かめた方がよい。

サブエージェントの設定では、autoCompactWindowで、環境変数CLAUDE_CODE_AUTO_COMPACT_WINDOWが決めた会話の要約の区切りを小さくできるようになった。これまでは設定しても効かなかった。大きくすることはできない。

routineでeffortを選べる

クラウドで動くroutineを作る時や直す時に、モデルを選ぶ欄でeffortも選べるようになった。決まった集計のように軽い仕事は低いeffortで回し、設計の相談のように深く考えてほしい仕事は高いeffortで回す、といった分け方ができる。

クラウド環境の設定では、セットアップのスクリプトを書く欄が、色分けと行番号、コピーのボタンが付いた編集画面になった。routineのメニューの「Edit」を押しても編集の画面が開かなかった不具合や、送り直したメッセージが2回実行されることがあった不具合も直した。

クラウドのセッションでWebFetchが名前を引けないホストに当たった時は、許可したネットワークの外にあるかもしれないと説明するようになった。Claudeが許可すべきホストの名前を示すので、ネットワークを絞った環境で原因を探しやすくなる。

使用量の表示とそのほかの変更

使用量の上限の知らせでは、5時間ごとの枠の呼び方を「session limit」から「5-hour limit」に改めた。VS Codeの拡張では、上限が戻る時刻を「Resets at 3:10 PM」のように時計の時刻で示す。

作業の途中でeffortを変えた時の表示も直した。変えたeffortは次のメッセージから効く場合があると示し、実際に効いているeffortを表示するようになった。

Amazon BedrockやGoogle CloudのVertex AIなどで、Claude Codeが知らないモデル名（独自に付けたデプロイ名など）を使っている場合は、短いシステムプロンプトを使うようになった。中身がSonnetやHaikuでも同じで、元の長いプロンプトを使いたい時は環境変数CLAUDE_CODE_SIMPLE_SYSTEM_PROMPTを0にする。

不具合の直しには、サブディレクトリにあるとても大きなCLAUDE.mdやルールのファイルを、Claudeが冒頭だけ見て上書きしてしまうことがあった問題も入っている。今後は全体を読むか、その場で編集するよう促す。Code Reviewは、GitHubからpushの知らせが遅れて届いた時に古いcommitを見ていた問題を直し、プルリクエストの今のcommitを見るようにした。

編集部の見方

routineやhookでClaude Codeを自動で回している人ほど、今回の変更の影響を受ける。hookの数に上限ができたので、hookを並べすぎて手元の機械が詰まる心配は減るが、その分、待ち時間が生まれうる。routineは仕事の重さに合わせてeffortを分けられるようになった。使用量を抑えたい人は、まず毎日回しているroutineのeffortを見直し、軽い仕事から下げてみるとよい。