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.318 | MCP の拒否設定を管理する人 |
| アカウントのメールアドレスをネットワークへ送る前に確認を出す | 2.1.317 | 自動承認でツールを使う人 |
Agent SDK のフックに onFailure: "block" を追加 | 2.1.317 | Agent SDK でフックを書いている人 |
Claude apps gateway の cost report API と assume_role を追加 | 2.1.317・2.1.318 | gateway の管理者 |
内容は、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 で、実行中のバックグラウンドのエージェントがすべて止まる問題を修正
サブエージェントの設計の全体は サブエージェントの使い方の記事 を参照してください。
FIXITサブエージェントの使用量って、更新で減るの?
Dodai公式の changelog には、削減率の数字がありません。裏付けのない数字は、計画に使わないでください。
FIXITじゃあ、更新しても意味ないってこと?
Dodaiそうではありません。更新の前後で、同じ作業の使用量を自分の環境で比べてください。
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 を管理している場合は、公式ドキュメントの該当ページで、既存の設定への影響を確認してから更新してください。
更新の進め方
claude -pを無人で実行しているなら、claude auth statusでloginExpiresAtを確認し、期限をカレンダーかジョブの監視に載せるdeniedMcpServersに URL を入れているなら、更新後に MCP の接続が意図どおりかを確認する- サブエージェントに長いコマンドを任せているなら、3 分でバックグラウンドへ移ることを前提に、結果の受け取り方を見直す
- 使用量が気になるなら、同じ作業で更新の前後を比べて記録する
更新の確認を運用に載せる
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 提供のサーバーとクラウドセッションのコネクタにも及ぶ



