1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code v2.1.316 解説:Opus 4.8 fast mode 11/30削除とセキュリティ修正

1
Posted at

はじめに

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 の細かな修正があります。

影響と対応

移行の判断フローです。

チェックリスト

  1. 全員:v2.1.316 以降に更新する
  2. fast mode 利用者:設定ファイル、シェルスクリプト、CI の定義を検索し、Opus 4.8 + fast mode の組み合わせを 11/30 までに Opus 5.5 へ切り替える
  3. --restricted 利用者:Read の許可ルールが作業ディレクトリ外を含んでいないか確認する
  4. gateway 管理者:availableModels / deniedModels / models を見直す。400 エラーが出たら、エラーに示されたフィールド名から原因を特定する
  5. PowerShell hook 利用者:該当する書き出しの hook がガードレールとして働いていたか、過去の挙動を振り返る
  6. コスト管理をしたい組織: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 の残存箇所を洗い出すところから始めましょう。

参考:Claude Code v2.1.316 リリースノート

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?