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.319 2026年11月——企業ゲートウェイ対応が必要な変更5点

1
Posted at

大企業のAI推進担当として、社内でClaude Codeをゲートウェイ経由で展開している。v2.1.317・318と続けて追ってきたが、v2.1.319には企業のカスタムLLMゲートウェイ経由の環境に影響する変更が1件含まれている。放置すると無人バッチのauto modeが止まる可能性があるため、今回は速報でまとめる。

対象読者

  • 社内のカスタムLLMゲートウェイ(Bedrock・Vertex AI・Azure AI Foundry以外)経由でClaude Codeを展開しているIT担当者・推進担当者
  • Claude Codeのバッチ・CIスクリプトを管理している方
  • Claude apps gateway(企業向けアクセス管理レイヤー)を運用している管理者

Claude Code単体(カスタムゲートウェイなし)で使っている方には、「2. permissions.denyInsteadOfPrompting」「5. CIスクリプトへのexitコード変更」が関係します。

この記事で分かること:

  • LLMゲートウェイ環境でのauto mode変更と対応手順(環境変数1行)
  • 無人実行で活用できる permissions.denyInsteadOfPrompting 設定
  • MCPタスクのバックグラウンド化と停止方法
  • Claude apps gateway管理者向け3つの新機能
  • CIスクリプトに影響するexit codeの変更

v2.1.319は2026年11月7日(日本時間)に公開された。リリースノートには30件超の変更が載っている。

1. LLMゲートウェイ経由のauto mode動作変更(要対応)

影響を受ける環境:Bedrock・Vertex AI・Azure AI Foundry以外のカスタムLLMゲートウェイ経由でClaude Codeを運用している

これが今回で一番大きな変更だ。

v2.1.318までは、テレメトリがOFF(CLAUDE_CODE_DISABLE_TELEMETRY=1)になっている環境や、カスタムLLMゲートウェイを経由している環境でも、サーバーサイドチェックが届かない呼び出しは内蔵クラシファイア(Claude Codeのローカル判定)で処理され、auto modeが継続していた。

v2.1.319からこの動作が変わる。サーバーサイドチェックが通らない呼び出しは拒否されるか、Claude(アシスタント)への確認になる。内蔵クラシファイアへのフォールバックはなくなった。

状況 v2.1.318まで v2.1.319から
カスタムゲートウェイ経由でサーバーサイドチェックが届かない 内蔵クラシファイアで判定 → auto mode継続 拒否またはアシスタントへの確認
Bedrock・Vertex AI・Azure AI Foundry経由 変化なし 変化なし

従来の動作(内蔵クラシファイアにフォールバック)に戻すには、次の環境変数を設定する:

export CLAUDE_CODE_AUTO_MODE_SERVER=0

常に0にしたくない場合は、企業内のゲートウェイをv2.1.319以降にアップデートしてサーバーサイドチェックを通す構成に変更することでも対応できる。

マネージドSettingsを配布している場合の追加注意:CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASを管理設定で配布している場合、あわせてCLAUDE_CODE_AUTO_MODE_SERVER=1も設定しないと、ゲートウェイのサーバーサイドチェックが有効にならない。管理者側でCLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASを設定しているなら、CLAUDE_CODE_AUTO_MODE_SERVER=1の設定有無を確認してほしい。

Bedrock・Vertex AI・Azure AI Foundryはこの変更の対象外であることは、公式リリースノートに明記されている。自社でカスタムゲートウェイを設けている組織は見落としやすいため、展開担当者への周知が重要だ。

2. 無人実行で使える permissions.denyInsteadOfPrompting

ターミナルセッション・サブエージェント・チームメート共通で使える新しい設定が追加された。

{
  "permissions": {
    "denyInsteadOfPrompting": true
  }
}

これを有効にすると、permissionプロンプトが発生するはずだったツール呼び出しは「拒否」になり、ターンが続行する。

cronやWindowsタスクスケジューラで無人実行しているバッチで「permissionプロンプト待ちになって止まる」という問題が起きている環境に使える。当方でも深夜の自動実行がpermissionプロンプトに引っかかって朝まで止まっているケースがあった。allowedToolsを広げる対応が基本だが、このdenyInsteadOfPromptingを組み合わせると止まらずに済む場面が増える。

ただし、プロンプトが出るはずだった操作がすべて無言で拒否される。ログを確認して意図しない拒否が出ていないかを確認する必要がある。全操作を無条件に進めたい場合は、allowedToolsやpermissions.allowで具体的に許可する設定の方が安全だ。

3. MCPタスクのバックグラウンド化

v2.1.319から、MCPサーバーがツール呼び出しをタスクとして実行する場合、Claude Codeは即座にそれをバックグラウンドへ移し、完了時に結果をClaudeへ返す。これにより長時間のMCPタスクが走っている間も、Claudeが他の処理を進められる。

ブロッキングで待ちたい場合は次の環境変数で従来の動作に戻せる:

export CLAUDE_CODE_DISABLE_MCP_TASK_BACKGROUND=1

ツールの完了順序に依存する処理がある場合や、MCPタスクの並列実行が設計上想定されていない場合に使う。通常の開発用途ではバックグラウンド化してClaudeが別の処理を進める方が全体のスループットは上がる。

4. Claude apps gateway管理者向けの3つの新機能

Claude apps gateway(企業向けのアクセス管理・予算管理レイヤー)に複数の機能が追加された。

4a. 費用確認(今日・今週・今月)

ゲートウェイを通じている開発者のうち費用上限なしの場合、/usageコマンドで今日・今週・今月の費用が確認できるようになった。ゲートウェイ側もv2.1.319以降を実行している必要がある。これまでは/usageに表示される情報が限定的で、費用の推移はゲートウェイ側の集計に頼るしかなかった。

4b. プールグループの優先順位設定

複数のプールグループに属している開発者の予算消費順序を設定できる2つの設定が追加された:

  • admin.pooled_conflict_rule:複数グループに属す開発者のうち、どのグループ予算を先に使うかのルール
  • admin.pooled_priority_order:優先順位の順番

部門別・プロジェクト別に予算プールを管理している場合に、消費順序のコントロールができる。

4c. ログのJSON形式出力

CLAUDE_GATEWAY_LOG_FORMAT=json

operationalログがJSON形式(severity・time・messageフィールド)で出力される。fluentd・Datadog・Cloud Logging・Azure Monitor等でレベルフィールドをキーに集計している環境に使える。

その他のgateway新機能:login_notice設定でゲートウェイのブラウザ認証ページとClaude Codeのサインイン画面に任意のメッセージを表示できる。desktopHome未設定でcoworkTabEnabled: falseまたはchatSessionRetentionDaysに依存するポリシーに対し、2026年11月10日のClaude Desktop変更に先立ち起動時の警告が出るようになった。

5. バグ修正(企業運用に関わるもの)

今回のリリースには30件超のバグ修正が含まれる。企業運用で関わりやすいものを抜粋する。

CIスクリプトへのexit code変更(要確認)

claude -pをauto modeで実行し、actions refusedになった場合(安全チェックが通らなかった場合)、これまでexit code 0を返していた不具合が修正された。v2.1.319以降はexit code 1を返す。exit codeでエラー判定しているCIスクリプトは動作が変わる可能性がある。exit code 0でも正常に進んでいたパイプラインは、actions refusedが発生した際に止まるようになる。

NFSマウント環境でのファイルリスト問題

NFS・SMB・Lustre等のネットワークファイルシステム上にあるプロジェクトをLinuxで開いたとき、Claude Codeが起動時にプロジェクト全ファイルをリストアップしていた不具合が修正された。大規模なプロジェクトをNFSマウント上に置いている環境では、起動時間の改善が期待できる。

HEAD名のファイル・フォルダがある場合のdiff問題

プロジェクト最上位にHEADという名前のファイルまたはフォルダがある場合、gitのHEAD参照と混同されて/diffが「Diff unavailable」になっていた不具合が修正された。claude.aiやモバイルアプリのセッションのdiff読み込み失敗も同じ原因で修正された。

401ループの修正

リクエストが繰り返し401で失敗し、毎回ログイン更新が走り、同一組織内の他のセッションにも401が連鎖して発生していた不具合が修正された。セッションが1つ認証エラーになると他まで連鎖する問題が解消される。

セッションの64ターン超えで/diffが空白

セッションで64ターン以上ファイルを編集した後、/diffの表示が空白になる不具合が修正された。長いセッションで作業している場合に再現していた問題だ。

その他の主なバグ修正

修正内容 影響
--resumeでプロンプト指定時にMCPサーバーが見つからない場合の扱い exit code 1で終了・保留中の呼び出しを維持
MCPサーバーが古いhandshakeを使っている場合の接続失敗・空結果 旧バージョンのMCPサーバーとの互換性改善
auto modeのリクエストが連続したときの誤拒否 auto mode継続性の改善
/status が「Auto mode server: Enabled」と誤表示するケース 状態表示の正確性改善
セッションのdiff失敗(claude.ai・モバイルアプリ) HEAD名ファイル起因のdiff読み込み改善
設定ファイルへの書き込み直後に変更が無視されるケース 設定ファイルの書き込み/読み込みタイミング改善

今回わかったこと

v2.1.319で企業のカスタムLLMゲートウェイ経由の環境に影響が大きいのは、auto modeのサーバーサイドチェック必須化だ。Bedrock・Vertex AI・Azure AI Foundryは影響を受けないが、カスタムゲートウェイ経由の場合はCLAUDE_CODE_AUTO_MODE_SERVER=0の設定を確認してほしい。

permissions.denyInsteadOfPromptingとCIのexit code変更も合わせて確認しておくと、次の更新でつまずかずに済む。

リリースサイクルが速く、v2.1.317→318→319と1週間で3本のリリースがあった。企業展開で管理しているIT担当者は、ゲートウェイ側のバージョンと合わせて変更管理の仕組みが必要になってきている。正直なところ、追うだけで手がいっぱいになってきた。

出典:Claude Code v2.1.319 リリースノート https://github.com/anthropics/claude-code/releases/tag/v2.1.319(2026-11-06 公開)


Copilot・Power Automate・AIツールの導入・活用のご相談は、ココナラで受け付けています。

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?