はじめに
Claude Code v2.1.316 がリリースされました。今回は Opus 4.8 の fast mode 非推奨化(2026-11-30 に削除) と、セキュリティに関わる修正が2件あるため、アップデートの優先度が高いリリースです。
📌 影響を受ける人
- Opus 4.8 の fast mode を設定・スクリプト・CI で使っている人
--restrictedセッションを使っている人- Claude apps gateway で
availableModels/deniedModels/modelsを運用している管理者- Team / Enterprise でサーバー管理設定を配布している管理者
この記事では、対応が必要な変更(high)を中心に整理し、新しい環境変数や gateway の新機能も紹介します。
変更の全体像
fast mode の期限は次のとおりです。
変更内容
1. Opus 4.8 の fast mode を非推奨化(high・要対応)
| 項目 | 内容 |
|---|---|
| 非推奨日 | 2026-10-30 |
| 削除日 | 2026-11-30 |
| 削除後の挙動 | fast mode で Opus 4.8 を呼ぶとエラー |
| 自動フォールバック | なし(通常の Opus 4.8 には切り替わらない) |
| 推奨 | 高速化を続けるなら Opus 5.5 へ移行 |
⚠️ Breaking Change
削除後は、通常版の Opus 4.8 に落ちるのではなくエラーで止まります。CI やバッチ処理に fast mode + Opus 4.8 が残っていると、期限日に突然失敗します。
2. --restricted セッションのファイル流出を修正(high・セキュリティ)
--restricted は作業ディレクトリ内に範囲を限定するモードです。しかし Read の許可ルールが作業ディレクトリ外のファイルにも当てはまる場合、それらのファイルがアップロードされていました。意図しない情報流出につながる可能性があったため、v2.1.316 で修正されています。
3. Claude apps gateway のモデル照合漏れを修正(high)
gateway は、リクエストに含まれるモデルの一部しか availableModels / deniedModels / models と照合していませんでした。修正後は、ブロック対象のモデルを1つでも含むリクエストに、該当フィールド名を示した 400 エラーが返ります。
⚠️ Breaking Change(挙動変更)
これまで通っていたリクエストが 400 で拒否される可能性があります。許可・拒否リストの設定が意図どおりか確認してください。
4. サーバー管理設定が承認プロンプトなしで適用(high・Team/Enterprise)
Team / Enterprise でログインしている場合、Anthropic の API から取得したサーバー管理設定が承認プロンプトなしで適用されます。ローカルに保存されたコピーが検証に通らない場合、そのコピーは使われません。
- 管理者が配布した設定がすぐ反映される
- 改ざんされたコピーは使われなくなる
5. 新しい環境変数
| 環境変数 | 役割 |
|---|---|
CLAUDE_CODE_SUBAGENT_EFFORT |
サブエージェントの effort が他のどこにも指定されていない場合の既定値。これまではセッションの effort を引き継いでいた |
CLAUDE_CODE_DISABLE_ULTRATHINK |
ultrathink キーワードを無効化。組織でコストを管理したい場合に有効 |
CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP |
プライベート CA のループした相互証明書を取り除かずに残す。社内 CA 環境で TLS 接続に失敗する場合の対処 |
CLAUDE_CODE_SUBAGENT_EFFORT を使うと、メインセッションは高 effort のまま、サブエージェントだけ低めにしてコストや速度を調整できます。ほかに effort の指定がない場合だけ使われます。
VSCode では、ultrathink を含むターンが xhigh effort で動き、入力欄で虹色に表示されます。ターミナル版と同じ挙動です。
6. Claude apps gateway の新機能
| 機能 | 内容 |
|---|---|
| pooled budget | グループで共有する月間予算。個人の上限とは別に適用。spend limits 管理 API の pooled_budget で設定 |
managed.policy_mode: layered |
当てはまるポリシーをすべて適用。各ポリシーはリストで下にあるものの上に重ねてマージされる |
guardrail.input_tagging |
上流が Amazon Bedrock の場合、guardrail の prompt attacks フィルターが必要とする入力タグでプロンプトを囲む。all_messages_and_system でシステムプロンプトも対象 |
layered を使うと、全社共通の設定に部署別の設定を重ねる階層型の管理ができます。
サインイン面では、VSCode のチャットパネルからターミナルなしで gateway にサインインできるようになりました。管理設定で gateway が必須の環境で claude auth login が実行を拒否していた問題も修正されています。
7. 主な不具合修正(medium)
-
PowerShell の hook:型キャスト、
param、using、属性で始まる hook が、終了コード 2 を返してもブロックしていませんでした。hook をガードレールにしていた場合は、守れていなかった可能性があります。 - サブエージェントのモデル:親のサブエージェントからモデルを引き継いだサブエージェントが、バックグラウンドジョブやメッセージで再開されるとメインのモデルに戻っていました。コストや品質に影響していた可能性があります。
-
Bash ツール:改行を含むエイリアスや、ダッシュで始まる名前の関数が崩れる問題、
SHELLOPTSを export していると bash スクリプトが最初のコマンドで止まる問題を修正しました。Windows の Git Bash でエイリアスと関数が失われる問題も修正されています。 - 終了時の後始末:macOS / Linux で、認証情報の拒否やクラウドセッションのアーカイブなど Claude Code が自分で終了するとき、実行中のシェルコマンドが残る問題を修正しました。
-
auto mode:
"$defaults"を含まないautoMode.allowでも、スケジュールタスク向けの組み込みルールは消えなくなりました。管理設定のリストに組み込みの例外が戻る問題と、ターン停止時の状態表示・通知の問題、CLAUDE_CODE_AUTO_MODE_SERVER=1が無視される問題も修正されています。 -
Vertex AI / Bedrock:最新モデルがアカウントやリージョンでまだ使えないとき、
sonnet/opus/haikuのエイリアスがセッション途中でエラーを出さず、古いモデルに切り替わるようになりました。 - ネットワーク / 検索:圧縮レスポンスが壊れていると一部のネットワークリクエストが止まる問題と、Windows で Grep / Glob が終わらなくなる問題を修正しました。
-
プラグイン MCP:
headersHelperに壊れたCLAUDE_PLUGIN_ROOTとサーバー URL が渡る問題を修正しました。 - クラウドセッション:MCP サーバーが求めるフォームに、入力するか断るかを選べるようになりました。復帰時には「Catching up…」が表示され、Enterprise メンバーはネットワークシークレットを追加・削除できます。
low の変更には、/code-review の findings カード表示、/diff の高速化、SSL 証明書エラーの原因と対処の表示、Code Review 分析ページの重要度別カード、Claude Tag(Slack 連携)の参加設定変更、VSCode 拡張や self-hosted runner の細かな修正があります。
影響と対応
移行の判断フローです。
チェックリスト
- 全員:v2.1.316 以降に更新する
- fast mode 利用者:設定ファイル、シェルスクリプト、CI の定義を検索し、Opus 4.8 + fast mode の組み合わせを 11/30 までに Opus 5.5 へ切り替える
-
--restricted利用者:Read の許可ルールが作業ディレクトリ外を含んでいないか確認する -
gateway 管理者:
availableModels/deniedModels/modelsを見直す。400 エラーが出たら、エラーに示されたフィールド名から原因を特定する - PowerShell hook 利用者:該当する書き出しの hook がガードレールとして働いていたか、過去の挙動を振り返る
-
コスト管理をしたい組織:
CLAUDE_CODE_SUBAGENT_EFFORTやCLAUDE_CODE_DISABLE_ULTRATHINKの導入を検討する
💡 Tips
期限は今日から約1か月先です。リポジトリ全体をfastとopus-4-8相当の文字列で grep しておくと、取りこぼしを減らせます。
コード例
CLAUDE.md の更新例
チームの CLAUDE.md に、モデル選定ルールとして次のような記述を追記しておくと、運用の抜けを防げます。
Before
## モデル選定 / fast mode
- 高速化が必要なときは Opus 4.8 の fast mode を使う
After
## モデル選定 / fast mode
- Opus 4.8 の fast mode は 2026-11-30 に削除される。削除後はエラーになり、通常版にも切り替わらない
- fast mode を使うときは Opus 5.5 を指定する
## サブエージェント / effort 設定
- effort の決定順:他の指定 → CLAUDE_CODE_SUBAGENT_EFFORT(ほかに指定がない場合の既定値)→ セッションからの引き継ぎ
環境変数の設定例
# サブエージェントの既定 effort を決める(値は利用可能な effort レベルから選ぶ)
export CLAUDE_CODE_SUBAGENT_EFFORT=low
# ultrathink キーワードを無効化(組織のコスト管理向け)
export CLAUDE_CODE_DISABLE_ULTRATHINK=1
# 社内 CA でループした相互証明書が必要な場合
export CLAUDE_CODE_DISABLE_LOOPED_CROSS_CERT_DROP=1
💡 Tips
上記の設定値は一例です。有効な値の書式は公式のリリースノートとドキュメントで確認してください。
まとめ
- 最優先:Opus 4.8 の fast mode は 2026-11-30 に削除。削除後はエラーで、通常版にも切り替わらない。Opus 5.5 へ移行する
-
セキュリティ:
--restrictedが作業ディレクトリ外のファイルをアップロードしていた問題と、gateway のモデル照合漏れが修正された - 挙動変更:gateway では、ブロック対象モデルを含むリクエストが 400 で拒否される。サーバー管理設定は承認プロンプトなしで適用される
- 新機能:サブエージェント effort の既定値、ultrathink の無効化、gateway の共有予算・階層ポリシー・Bedrock guardrail 対応が加わった
- 安定性:Bash、PowerShell hook、auto mode、サブエージェントのモデル引き継ぎなど、多数の不具合が修正された
まずはアップデートして、fast mode の残存箇所を洗い出すところから始めましょう。