2.1.317・2.1.318 で運用に関わる変更

Claude Code 2.1.317 と 2.1.318 の changelog には、CLI、VS Code、クラウドセッション、self-hosted runner、Claude apps gateway など、複数の機能の更新が載っています。この記事では、サブエージェント、サインイン、権限に関わる変更を取り上げます。

変更バージョン影響を受ける利用者
バックグラウンドのサブエージェントのシェルコマンドを 3 分でバックグラウンドへ移す2.1.318サブエージェントを多用する人
claude.ai のサインイン期限を loginExpiresAt などに出し、10 日前から警告2.1.318無人で claude -p を回している人
deniedMcpServers の URL 指定が Anthropic 提供のサーバーにも及ぶ2.1.318MCP の拒否設定を管理する人
アカウントのメールアドレスをネットワークへ送る前に確認を出す2.1.317自動承認でツールを使う人
Agent SDK のフックに onFailure: "block" を追加2.1.317Agent SDK でフックを書いている人
Claude apps gateway の cost report API と assume_role を追加2.1.317・2.1.318gateway の管理者

内容は、2026 年 11 月 5 日に確認した Claude Code の公式 changelog に基づきます。前のバージョンの変更は Claude Code 2.1.311〜2.1.316 の記事 にまとめています。

サブエージェントに関わる変更

使用量の削減率は changelog に載っていない

2.1.317 と 2.1.318 の changelog には、サブエージェントの使用量が減るという記載も、削減率の数字もありません。この記事では、削減率を事実として書きません。changelog に載っている変更だけを、次に整理します。

2.1.318 のサブエージェントの変更

2.1.318 の changelog には、サブエージェントに関する次の項目があります。

変更
バックグラウンドのサブエージェントが、シェルコマンドを 3 分後にバックグラウンドへ移す。全プロバイダーが対象で、実行中にプロンプトキャッシュが切れるのを避ける
Bedrock・Vertex・Foundry、またはテレメトリを切った環境で、サブエージェントの進捗の要約は、プロンプトキャッシュが冷えていると、保留中の応答を最大 5 分待つ場合がある
「Switch models when a message is flagged」が「Ask each time」のとき、サブエージェントはモデルを切り替えず停止する
バックグラウンドのサブエージェントの実行中に、「Now using usage credits」の通知が約 30 秒ごとに再表示される問題を修正

3 分でバックグラウンドへ移す変更は、長いビルドやテストをサブエージェントに任せている環境で、更新の前後で挙動が変わります。3 分を超えたコマンドはバックグラウンドへ移るため、サブエージェントに任せる指示は、完了を待つ前提で書いていないかを見直してください。

2.1.317 のサブエージェントの変更

2.1.317 にも、次の変更があります。

  • SendMessage で実行中のバックグラウンドのエージェントへ送ったメッセージが、早く届く。実行中のコマンドは、止めずにバックグラウンドへ移る
  • 親と別のモデルで動くサブエージェントとチームメイトは、セッションの effort ではなく、そのモデルで保存された effort かデフォルト値を使う
  • auto mode の確認がサブエージェントのツール呼び出しに答えを出せないとき、通知を出す
  • 入力欄の文字を消す Ctrl+C で、実行中のバックグラウンドのエージェントがすべて止まる問題を修正

サブエージェントの設計の全体は サブエージェントの使い方の記事 を参照してください。

FIXITFIXIT

サブエージェントの使用量って、更新で減るの?

DodaiDodai

公式の changelog には、削減率の数字がありません。裏付けのない数字は、計画に使わないでください。

FIXITFIXIT

じゃあ、更新しても意味ないってこと?

DodaiDodai

そうではありません。更新の前後で、同じ作業の使用量を自分の環境で比べてください。

claude.ai のサインイン期限を確認する

2.1.318 で、保存されている claude.ai のサインインが終わる日を確認できるようになりました。

場所追加された内容
claude auth status期限の日付を loginExpiresAt として表示する
claude -p の JSON の結果期限の日付を credential_expires_at として含む
claude -p のテキスト出力期限の 10 日前から、stderr に 1 行の警告を出す

期限に達したときの失敗メッセージも直りました。サインインが期限に達したことを伝えるメッセージになり、claude -p では claude auth login と claude setup-token が案内されます。

期限が何日なのかは、changelog に書かれていません。自分のアカウントで claude auth status を実行し、表示された日付を確認してください。夜間のジョブや CI で claude -p を実行している場合は、警告が出る stderr をログに残しておくと、止まる前に気づけます。

権限と管理の変更

メールアドレスの送信前に確認が出る

2.1.317 で、Web のツールやシェルのツールを呼び出すとき、アカウントのメールアドレスをネットワークへ送る前に確認が出るようになりました。changelog に書かれているのは、確認が出るところまでです。どのコマンドが対象になるか、確認を無効にする設定があるかは載っていません。

Agent SDK のフックの onFailure: "block"

2.1.317 で、Agent SDK のフックのコールバックに onFailure: "block" が加わりました。コールバックが失敗したとき、処理をブロックします。

指定する場所や、指定しない場合のデフォルトの動作は、changelog に書かれていません。書き方は公式の Agent SDK のドキュメントで確認し、試してから使ってください。

deniedMcpServers の対象が広がる

2.1.318 で、deniedMcpServers の URL による指定が、次にも及ぶようになりました。

  • Anthropic 提供のサーバーのうち、上流の URL が一致するもの
  • クラウドセッションと self-hosted runner のコネクタのうち、セッションにコネクタ自身の URL が渡されるもの

それ以外のコネクタは、URL ではなく名前で拒否します。拒否の一覧に URL を入れている組織は、更新後に意図しないサーバーが止まっていないかを確認してください。権限設計の全体は Claude Code の権限と settings.json 設計 を参照してください。

Claude apps gateway の変更

Claude apps gateway には、次の追加があります。設定の詳細は確認していません。

  • 2.1.317: GET /v1/organizations/analytics/cost の cost report。過去の支出を、期間を指定して、合計・開発者ごと・日ごと・IdP のグループごとに読める
  • 2.1.317: admin: を設定した gateway で、開発者の IdP グループを毎日記録し、admin.identity_retention_days の期間だけ保持する
  • 2.1.318: mantle のアップストリームに assume_role を追加。別の AWS アカウントのロールを使え、開発者ごとの AWS のコストを割り当てられる

gateway を管理している場合は、公式ドキュメントの該当ページで、既存の設定への影響を確認してから更新してください。

更新の進め方

  1. claude -p を無人で実行しているなら、claude auth status で loginExpiresAt を確認し、期限をカレンダーかジョブの監視に載せる
  2. deniedMcpServers に URL を入れているなら、更新後に MCP の接続が意図どおりかを確認する
  3. サブエージェントに長いコマンドを任せているなら、3 分でバックグラウンドへ移ることを前提に、結果の受け取り方を見直す
  4. 使用量が気になるなら、同じ作業で更新の前後を比べて記録する

更新の確認を運用に載せる

changelog をバージョンごとに最初から読むより、止まると業務に影響が出るものを先に一覧にしておくほうが、更新の影響を早く確認できます。サインイン、権限の拒否設定、無人で実行するジョブを、チームごとに書いておけば、変更履歴の項目と照合できます。

Claude Code の更新を個人の判断ではなくチームの手順にしたい場合は、AI 開発ツール定着支援 をご覧ください。具体的な進め方は お問い合わせ からご相談いただけます。AI 駆動開発のクリエイティブスタジオとして、権限と更新運用の設計からお手伝いしています。

確認できなかったこと

公式の changelog を読みましたが、次の点は公開情報だけでは判断できませんでした。

  • サブエージェントの使用量の削減率 (changelog に記載が無い)
  • claude.ai のサインインの期限が何日か
  • メールアドレスの送信前確認の対象範囲と、無効にする設定
  • onFailure: "block" を指定する場所

利用環境に当てはまる項目は、更新後に実際の動作で確認してください。

まとめ

  • 2.1.318 は、バックグラウンドのサブエージェントのシェルコマンドを 3 分でバックグラウンドへ移す
  • サブエージェントの使用量の削減率は、changelog に載っていない。自分の環境で更新の前後を比べる
  • claude.ai のサインイン期限は、claude auth status の loginExpiresAt で確認できる。claude -p は期限の 10 日前から警告する
  • 2.1.317 は、メールアドレスをネットワークへ送る前に確認を出す。Agent SDK のフックには onFailure: "block" が加わった
  • deniedMcpServers の URL 指定は、Anthropic 提供のサーバーとクラウドセッションのコネクタにも及ぶ