
Claude Code v2.1.329 の主要アップデート - 信頼ダイアログのフック警告と Code Mode のフック失敗時の挙動変更
クラウド事業統括本部の石川です。Claude Code の v2.1.329 が 2026 年 11 月 19 日に公開されました。今回の変更には信頼ダイアログでのフックの警告や、Code Mode でのフックのエラー時の挙動変更など、フックの設定に関わるものが含まれています。
前回のアップデート記事はこちらです。
アップデートサマリー
v2.1.329 では 130 件の変更が入りました。本記事の分類では修正 89 件、改善 18 件、セキュリティ 6 件、パフォーマンス 6 件、破壊的変更・既定動作の変更 6 件、新機能 5 件です。
領域別に見ると、Code Mode に関する変更が 17 件、VS Code 拡張に関する変更が 17 件、MCP に関する変更が 15 件、self-hosted runner に関する変更が 8 件あります。
注目のアップデート
信頼ダイアログにフックの宣言場所を表示
信頼ダイアログは、信頼していないフォルダで Claude Code の対話セッションを起動したときに、そのフォルダを信頼するかを確認する画面です。信頼するまでは、設定ファイルのフックなどが実行されません。フォルダの信頼ダイアログに、そのフォルダのフックがどこで宣言されているかを示す警告が追加されました。VS Code 拡張でも、信頼プロンプトを拒否した後にメッセージボックスの上へ行が表示され、「Review trust」からウィンドウを再読み込みせずにプロンプトを再表示できるようになっています。
チームや外部のリポジトリを clone して開くことが多い方は、信頼する前にフックの宣言元を確認する手順を組み込みやすくなります。
Code Mode の PreToolUse フックのエラー時の挙動変更
Code Mode で、PreToolUse フックがエラーになったとき(フックが起動しない、強制終了される、タイムアウトするなど)に、スクリプトからのツール呼び出しを拒否しなくなりました。Code Mode を使わない通常のセッションでは、フックがエラーになってもツール呼び出しはそのまま実行されます。今回の変更で、Code Mode もこの扱いにそろいました。エラー時にツール呼び出しを止めたい command・HTTP・MCP tool のフックには "onFailure": "block" を設定します。なお、公式ドキュメントでは Code Mode は実験的な機能と位置付けられています。
Code Mode を試していて、PreToolUse フックで危険なコマンドを止めている方は、フックが失敗したときにも止まるよう onFailure の設定を確認しておく必要があります。
/tasks の表示対象の拡大
/tasks に、このセッションのスケジュールタスク、/loop のウェイクアップ、ゴール(goal)、この会話のフォークが表示されるようになりました。x キーを押すと、確認の後に停止できます。あわせて、/tasks のヘッダーとフッターのバックグラウンド件数が、シェル・モニター・MCP 呼び出し・エージェント・ワークフロー・スケジュールタスクをまとめた 1 つの数値になりました。
/loop やスケジュールタスクを併用している方は、セッション内で動いているものを /tasks でまとめて確認して止められるため、止め忘れに気づきやすくなります。
~/.claude.json が初期値にリセットされる問題を修正
ネットワークの停止やファイルロックで ~/.claude.json が読めなくなり、保存時に内容が消えて初期値にリセットされることがある問題が修正されました。
~/.claude.json の内容が突然初期値に戻った経験がある方には、アップデートする理由になる修正です。
VS Code 拡張の IME 入力に関する修正
VS Code 拡張で、IME の変換中に押したキーが権限プロンプトのフォーカス移動や拒否、メニュー行の実行、ダイアログを閉じる操作として処理される問題が修正されました。あわせて、IME の Enter でプランコメントの送信・セッション名変更の確定・@ メンションのファイル選択が行われる問題と、変換中に上キーを押すと変換中のテキストが以前のメッセージで上書きされる問題も修正されています。
日本語入力で VS Code 拡張を使っている方は、変換中のキー操作が権限プロンプトやメニューに渡ることを気にせずに入力できるようになります。
/code-review のプルリクエスト指定時の修正
/code-review <pr number> が、プルリクエストではなくチェックアウト中のブランチを断りなくレビューすることがある問題が修正されました。gh pr diff でプルリクエストを読み込み、読めない場合はその旨を表示します。また、/code-review <pr number> --fix と、プルリクエストの URL を渡した /code-review は、gh pr diff が拒否された場合や失敗した場合にレビューせずに停止するようになりました。
プルリクエスト番号を指定してレビューしている方は、意図しないブランチのレビュー結果を受け取る心配が減ります。
保存済みスケジュールタスク、max_tokens エラー時の自動リトライ、Stop フックの background_tasks などの変更は、既存の設定や運用に影響します。後述の「破壊的変更・既定動作の変更」で変更前後を比較します。
アップデート内容
新機能
/tasksに、このセッションのスケジュールタスク、/loopのウェイクアップ、ゴール(goal)、この会話のフォークが表示されるようになりました。xキーで確認の後に停止できます/mcpのサーバーページに「Server message」行が追加されました。接続を拒否したリモート HTTP MCP サーバーの JSON-RPC エラーメッセージを表示します/statusに「Marketplace auto-update」行が追加されました。自動更新されない managed マーケットプレイスとその理由を表示します- OpenTelemetry のイベントとメトリクスを有効にしたまま、Code Mode をオンにできるようになりました。コードが行う各ツール呼び出しがイベントを送信します。トレーシング(tracing)が有効な場合は、引き続き Code Mode はオフになります
- [VS Code] 信頼プロンプトを拒否した後、メッセージボックスの上に行が表示されるようになりました。「Review trust」で、ウィンドウを再読み込みせずにプロンプトを再表示できます
セキュリティ
- フォルダの信頼ダイアログに、そのフォルダのフックがどこで宣言されているかを示す警告が追加されました
- managed settings のフックの読み込みに失敗したとき、Claude Desktop などの非対話ホストで、会話内に警告を表示するようになりました
- トークンのリフレッシュ中に MCP サーバーの認証をクリアすると、再びサインインされてしまう問題が修正されました
- Linux の
/sandboxで、allowUnixSocketsのエントリが許可済みとして表示される問題が修正されました。Linux ではこれらのエントリで対象のソケットへのアクセスは許可されないため、/sandboxがその旨を表示します - macOS の computer use が新しい安全ルールに更新されました。一部の操作が拒否され、一部のアプリへのアクセスが制限されます
- Claude apps gateway(
claude gateway)で、access_control.allow_cidrsが空の間に起動時に表示していた警告が、毎回の起動時に表示する通知に変わりました。テキストログでは枠で囲んで表示し、gateway をパブリックインターネットに公開しないよう伝えます
改善・パフォーマンス
Code Mode(公式ドキュメントでは実験的機能と位置付けられています)
- テレメトリー、必須でない通信、フィーチャーフラグがオフの場合でも起動するようになりました。管理者は managed settings で Code Mode をオフのままにできます
- 独自の
log・preview・sleepを宣言したスクリプトを、拒否せずに実行するようになりました - 256 MiB を超える行範囲の読み込みを拒否するようになりました(数 GB のメモリを使うことがありました)。非常に長い行の読み込みがタイムアウトする問題も修正されています
- スクリプトがツールを数千回呼び出した後に、ターミナルが固まる時間を大幅に短縮しました
- サブエージェントを開始した後に、Code Mode を使わない通常のセッションと同じ、待機に関するガイダンスを Claude が受け取るようになりました
/code-review と auto mode
- 多くのモデルで、対象を指定しない
/code-reviewがブランチ全体をデフォルトブランチと比較してレビューするようになりました。複数コミットのブランチで差分を失う問題も修正されています /code-review <pr number> --fixと、プルリクエストの URL を渡した/code-reviewが、gh pr diffが拒否された場合や失敗した場合に、レビューせずに停止するようになりました- auto mode が
git statusを実行する頻度を下げ、大きなリポジトリで多くのリクエストの待ち時間が短くなりました。変更を破棄する git コマンドは、作業ツリーの確認が済むまでブロックされることがあります - テレメトリーがオフの場合、Anthropic API へのゲートウェイ経由の場合、Microsoft Foundry の場合に、Claude の質問への「yes」などの短い返答に対する auto mode の扱いを改善しました
タスクとセッション
- 「Exit and stop tasks」で、このセッションのスケジュールタスクも終了し、再開時に再実行されないようになりました(Claude の応答中に終了した場合を除く)
/tasksのヘッダーとフッターのバックグラウンド件数が、シェル・モニター・MCP 呼び出し・エージェント・ワークフロー・スケジュールタスクをまとめた 1 つの数値になりました/tuiなどのその場での再起動で、ログインのリフレッシュを短時間待つようになり、サインアウトされにくくなりました- managed settings があるコンピューターで、古いセッションの自動クリーンアップを改善しました
- クラウドセッションで、起動時にダウンロードに失敗したプラグインを再試行するようになりました
メモリと応答速度
- 多くのファイルを編集する長いセッションと、大きな MCP ツール結果が多い macOS / Linux の長い Claude Desktop セッションで、メモリ使用量を改善しました
- 長いターンの後のアイドル状態の Claude Desktop / SDK セッションと、スクリーンショットや大きなツール結果を含むセッションを
--resume/--continueした後のメモリ使用量を改善しました - Windows で、Claude Code の検索プログラムの起動が遅い PC での起動と最初の検索を改善しました
- Remote Control がオンの Claude Desktop の Code セッションで、回答後に次のメッセージを受け付けられるまでの時間を短縮しました
macOS・VS Code・self-hosted runner
- macOS の computer use で、30 秒経っても完了しないアプリの起動を打ち切るようになりました
- macOS のログイン更新で、
Claude Code-write-check項目を使って Keychain をテストするようになりました - [VS Code] 権限プロンプトで下キーを押したとき、最後の項目で止まり、「Yes」に戻らなくなりました
- [VS Code] コマンド出力で、通常の色以外の隠し文字や制御シーケンスを記号で表示するようになりました。このため、ペルシア語・クメール語・ラオ語・シンハラ語・マラヤーラム語のテキストが崩れたり、順序が乱れて見えたりすることがあります
- Self-hosted runner で、同じ owner/name の 2 つ目のホスト名のクローンを、ベースフォルダの
_repos/clones/<host>/配下に置くようになりました。既存のクローンは移動しません - Self-hosted runner の
--repository-folderが、--capacity 1のときにベースフォルダ内のほとんどのフォルダを受け付けるようになりました。1 より大きい場合、ベースフォルダ内のフォルダを指定すると起動が停止します。重なる別リポジトリのセッションは拒否されます
修正
~/.claude.jsonが初期値にリセットされる問題を修正: ネットワークの停止やファイルロックで~/.claude.jsonが読めなくなり、保存時に内容が消えて初期値にリセットされることがありました- macOS で繰り返しサインアウトされる問題を修正: Keychain の読み取りはできるが書き込みができない場合に発生していました。該当セッションは有効期限で停止して理由を表示し、他のセッションはサインインを維持します
/code-review <pr number>が別のブランチをレビューする問題を修正: プルリクエストではなくチェックアウト中のブランチを断りなくレビューすることがありました。gh pr diffでプルリクエストを読み込み、読めない場合はその旨を表示します- [VS Code] IME の変換中のキー操作の問題を修正: 変換中に押したキーが権限プロンプトのフォーカス移動や拒否、メニュー行の実行、ダイアログを閉じる操作として処理されていました(anthropics/claude-code#106358)。変換中の上キーで変換中のテキストが以前のメッセージで上書きされる問題(anthropics/claude-code#101294)と、IME の Enter でプランコメントの送信・セッション名変更の確定・@ メンションのファイル選択が行われる問題も修正されています
/terminal-setupが VS Code の設定ファイルを壊す問題を修正: ブロックコメント周辺で VS Code の設定ファイルやキーバインドファイルを壊していました。keybindings.json に閉じていない文字列がある場合に、Shift+Enter のバインドを失ったまま成功と報告する問題も修正されています- IDE の差分で承認したファイルの末尾の改行と BOM が失われる問題を修正: IDE の差分で承認したファイルが末尾の改行なしで保存されていました。VS Code で差分を保存して編集を承認した際に、バイトオーダーマーク(BOM)が失われる問題も修正されています
- ステータスラインスクリプトでプロンプトが固まる問題を修正: 出力を止めずに出し続けるステータスラインスクリプトで、プロンプトが固まり、数 GB のメモリを消費していました
- バックグラウンドの MCP タスクが停止したままになる問題を修正: 遅い再接続の後に発生していました。古いプロトコルバージョンのまま残った HTTP MCP サーバーの多くに、Claude Code が自動で再接続します
- PDF や画像が .bin として保存される問題を修正: MCP サーバーや Web サイトが
application/octet-streamとして送る PDF・画像・.docx・.xlsx・.pptxが .bin として保存され、Claude が PDF や画像を読めませんでした - Bedrock 上の Claude Desktop セッションの Stop でリクエストが終了しない問題を修正: Amazon Bedrock 上の Claude Desktop セッションで、応答しない AWS の credential_process やサインイン呼び出しを待っている間に、Stop でリクエストを終了できませんでした
- self-hosted runner でセッションのブランチが削除される問題を修正:
--push-outcome-on-releaseが、git ホスト上のセッションのブランチを削除することがありました - [VS Code] すべてのウィンドウでサインアウトされる問題を修正: サインインサーバーが拡張機能のトークンリフレッシュに 10〜30 秒かかった場合に、すべてのウィンドウとターミナルで Claude Code からサインアウトされていました
- 地味に嬉しい修正: パイプで他のプログラムに渡した
claude --helpの出力が途中で切れる問題が修正されました。grep でオプションを探しやすくなりました。 - このほか、Code Mode、self-hosted runner、Remote Control とクラウドセッション、MCP、ターミナルの表示とキー操作など、多数の細かな不具合が修正されています。
破壊的変更・既定動作の変更
既存の設定や運用に影響する変更です。以下の変更前後の例は CHANGELOG と公式ドキュメントの記載をもとに作成した例です。
Code Mode の PreToolUse フックのエラー時の扱い
Code Mode で、PreToolUse フックがエラーになったとき(フックが起動しない、強制終了される、タイムアウトするなど)に、スクリプトからのツール呼び出しを拒否しなくなりました。Code Mode を使わない通常のセッションと同じ扱いです。エラー時にツール呼び出しを止めたい command・HTTP・MCP tool のフックには "onFailure": "block" を設定します。
変更前(〜v2.1.328):
Code Mode のスクリプトのツール呼び出し × PreToolUse フックがエラー
→ ツール呼び出しを拒否(onFailure を設定していない場合も)
→ Code Mode を使わない通常のセッションでは、同じ条件でもツール呼び出しを実行
変更後(v2.1.329〜):
Code Mode のスクリプトのツール呼び出し × PreToolUse フックがエラー
→ フックのエラーではツール呼び出しを拒否しない(Code Mode を使わない通常のセッションと同じ扱い)
→ エラー時に拒否させるフックには "onFailure": "block" を設定
以下は settings.json の設定例です。書式は公式ドキュメントの hooks リファレンスに基づきます。./check-command.sh は例です。
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "./check-command.sh",
"onFailure": "block"
}
]
}
]
}
}
max_tokens エラー時の自動リトライの削除
2.1.326 で入った、max_tokens エラーに示された上限での自動リトライが削除されました。出力トークン数の上限が小さいモデルを使う gateway 経由の場合は、CLAUDE_CODE_MAX_OUTPUT_TOKENS にその上限を設定します。
変更前(v2.1.326〜v2.1.328):
max_tokens エラー
→ エラーに示された上限で自動リトライ
変更後(v2.1.329〜):
max_tokens エラー
→ エラーに示された上限での自動リトライを行わない
→ gateway の背後のモデルの上限を CLAUDE_CODE_MAX_OUTPUT_TOKENS に設定
以下は設定例です。8192 は例で、gateway の背後のモデルの出力上限に合わせて設定します。
% export CLAUDE_CODE_MAX_OUTPUT_TOKENS=8192
% claude
保存済みスケジュールタスクの再スケジュール
サインイン済みの新しいセッションでは、以前のバージョンで保存したスケジュールタスクの多くを、再度スケジュールする必要があります。そのタスクを保存したセッションを --resume した場合は、引き続き実行されます。CHANGELOG には変更前の挙動の詳細が書かれていないため、以下では対象となる条件を示します。
変更前(〜v2.1.328):
スケジュールタスクを保存
変更後(v2.1.329〜):
〜v2.1.328 で保存したスケジュールタスク
→ サインイン済みの新しいセッション: 多くは再度スケジュールが必要
→ 保存したセッションを --resume: 引き続き実行
Stop / SubagentStop フックの background_tasks
Stop / SubagentStop フックの background_tasks で、Monitor のスクリプトが shell ではなく monitor として列挙されるようになりました。type が shell のタスクだけを対象にしているフックでは、Monitor のスクリプトが対象から外れます。
以下は Stop フックの入力の一部の例です。フィールド名は公式ドキュメントの hooks リファレンスの記載に基づきます。
変更前(〜v2.1.328): Monitor のスクリプト
"background_tasks": [
{ "id": "task-001", "type": "shell", "status": "running" }
]
変更後(v2.1.329〜): Monitor のスクリプト
"background_tasks": [
{ "id": "task-001", "type": "monitor", "status": "running" }
]
一部のチームメイトのペインの起動方法
一部のチームメイトのペインが /bin/sh 経由で起動するようになりました。そのため、シェルの起動ファイルを読み込まない場合があります。
変更前(〜v2.1.328):
一部のチームメイトのペイン
→ /bin/sh 経由ではない起動
変更後(v2.1.329〜):
一部のチームメイトのペイン
→ /bin/sh 経由で起動
→ シェルの起動ファイルを読み込まない場合がある
self-hosted runner のクローン先フォルダ
Self-hosted runner で、アドレスのパスに特殊な文字を含むリポジトリを、新しいフォルダに改めてクローンするようになりました。
変更前(〜v2.1.328):
アドレスのパスに特殊な文字を含むリポジトリ
→ 既存のフォルダにクローン
変更後(v2.1.329〜):
アドレスのパスに特殊な文字を含むリポジトリ
→ 新しいフォルダに改めてクローン
→ 古いフォルダを指定したルールやボリュームは適用されない
→ 古いクローンはそのまま残る
信頼ダイアログのフック警告を試してみた
信頼ダイアログは Claude Code を初めて開くフォルダで起動したときに、「このフォルダを信頼するか」を確認する画面です。信頼したフォルダのフックは確認なしでコマンドを実行します。clone したリポジトリを開いたとき、そのリポジトリにそうしたフックがあることをダイアログの時点で知れます。
フックを宣言したフォルダと宣言していないフォルダで claude を起動し、信頼ダイアログの表示を比べました。検証環境は macOS 上の Claude Code v2.1.329 です。
検証用のフォルダを用意する
.claude/settings.json に PreToolUse フック、.claude/settings.local.json に SessionStart フックを宣言したフォルダ hooks-trust-demo を用意しました。フックの中身は文字列を出力するだけの echo です。比較用に、.claude フォルダを置かない no-hooks-demo も用意しています。
以下は hooks-trust-demo で実行した結果です。
% claude --version
2.1.329 (Claude Code)
% find .claude -type f
.claude/settings.json
.claude/settings.local.json
% cat .claude/settings.json
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{ "type": "command", "command": "echo pre-tool-use" }
]
}
]
}
}
% cat .claude/settings.local.json
{
"hooks": {
"SessionStart": [
{
"hooks": [
{ "type": "command", "command": "echo session-start" }
]
}
]
}
}
既存の信頼設定の影響を受けない状態で起動する
筆者の環境では ~/.claude.json でルート(/)が信頼済みになっており、そのまま claude を起動すると信頼ダイアログが表示されず、セッションが始まりました。そこで、CLAUDE_CONFIG_DIR に空の設定ディレクトリを指定し、信頼済みのフォルダがない状態で起動しました。空の設定ではログインが必要になるため、CLAUDE_CODE_USE_BEDROCK=1 で Amazon Bedrock を指定してログインを経由しないようにしています。
% cd hooks-trust-demo
% CLAUDE_CONFIG_DIR=$WORK/cc-config-fresh CLAUDE_CODE_USE_BEDROCK=1 AWS_REGION=ap-northeast-1 claude
$WORK は検証用の作業ディレクトリです。Claude Code のセッション内から tmux 経由で起動したため、実際には Claude Code が子プロセスに設定する環境変数 CLAUDECODE を外して実行し、画面を tmux capture-pane で取得しました。初回起動時のテーマ選択とセキュリティの注意を Enter で進めると、信頼ダイアログが表示されます。
実行結果
フックを宣言したフォルダ(hooks-trust-demo)では、次の信頼ダイアログが表示されました。
────────────────────────────────────────────────────────────────────────────────────────────────────
Accessing workspace:
/private/tmp/claude-501/-Users-ishikawa-satoru-workspaces-cc-blog-20261120-v2-1-329/a9fd2f03-bc27-
42ca-b78d-5769355f4af4/scratchpad/hooks-trust-demo
Quick safety check: Is this a project you created or one you trust? (Like your own code, a
well-known open source project, or work from your team). If not, take a moment to review what's in
this folder first.
Claude Code'll be able to read, edit, and execute files here.
⚠ This folder configures hooks that can run commands without asking, declared in
.claude/settings.json and .claude/settings.local.json
Trusting this folder loads .claude/settings.json (runs commands) and .claude/settings.local.json
(runs commands).
Security guide
❯ No, exit
Yes, I trust this folder
Enter to confirm · Esc to cancel
フックのないフォルダ(no-hooks-demo)では、次のとおりです。
────────────────────────────────────────────────────────────────────────────────────────────────────
Accessing workspace:
/private/tmp/claude-501/-Users-ishikawa-satoru-workspaces-cc-blog-20261120-v2-1-329/a9fd2f03-bc27-
42ca-b78d-5769355f4af4/scratchpad/no-hooks-demo
Quick safety check: Is this a project you created or one you trust? (Like your own code, a
well-known open source project, or work from your team). If not, take a moment to review what's in
this folder first.
Claude Code'll be able to read, edit, and execute files here.
Security guide
❯ No, exit
Yes, I trust this folder
Enter to confirm · Esc to cancel
フックを宣言したフォルダでは、⚠ で始まる行に、フックを宣言したファイルとして .claude/settings.json と .claude/settings.local.json が表示されました。この行と、続く「Trusting this folder loads …」の行は、フックのないフォルダでは表示されていません。選択肢の初期位置は「No, exit」で、そのまま Enter を押すと Claude Code が終了しました。
フックのないフォルダと比べると、警告の有無で違いがすぐに分かりました。初めて開くリポジトリで、フックの宣言元を確認する手がかりになります。
最後に
設定の保持やサインイン、VS Code 拡張の IME 操作など、日常の利用に関わる不具合の修正が多い点が印象に残ったリリースです。
フックや Code Mode、VS Code 拡張を使っている方は、「破壊的変更・既定動作の変更」の内容を確認したうえで、アップデートして試してみてはいかがでしょうか。
参考文献





