
Claude Code v2.1.327 の主要アップデート - MCP 設定の標準入力対応と権限チェックの厳格化
クラウド事業統括本部の石川です。Claude Code の v2.1.327(2026-11-17)のアップデートをご紹介します。MCP サーバーの登録方法が増えたほか、今の設定のままでは動作が変わる変更も含まれます。今回は claude mcp add-json で、標準入力から JSON を渡して MCP サーバーを登録できることを確認しました。
前回のアップデート記事はこちらです。
アップデートサマリー
v2.1.327 の CHANGELOG の記載は 173 件です。本記事の分類では修正 99 件、改善 20 件、セキュリティ 18 件、開発者体験 10 件、パフォーマンス 10 件、新機能 8 件、破壊的変更 6 件、非推奨 1 件、内部変更 1 件です。権限チェックに関する項目が多く、作業ディレクトリ外の読み取りや auto mode の allow ルールなどで、確認や拒否の対象が増える変更が含まれています。ファイルや設定キーが意図せず削除される不具合の修正も入っています。
ここ数日間、Code Mode が注目を集めており、Claude Code 公式の X でも紹介しています。
私も 先日のブログで、agent teams を有効にしたまま Code Mode を試しています ので、ご興味があればご覧ください。
注目のアップデート
claude mcp add-json が JSON を標準入力から読めるように
claude mcp add-json <name> - のように JSON の代わりに - を渡すと、MCP サーバーの JSON を標準入力から読み込むようになりました。トークンをコマンドラインに書かずに MCP サーバーを登録できます。Claude Code のセッション内では使えません。
MCP サーバーの設定をスクリプトで配っている方や、トークンをシェルの履歴に残したくない方は、標準入力での登録に切り替えることをご検討ください。
/status に壊れた設定ファイルや効いていない設定の一覧を表示
/status に、壊れたエージェント・スキル・コマンド・出力スタイルのファイル、キーバインドのエラー、利用できないサンドボックス、無視された権限設定、一度も一致しないフックの matcher の一覧が表示されるようになりました。
スキルやフックを自作している方は、アップデート後に一度 /status を開き、壊れたファイルや効いていない設定がないかを確認しておくのがよいと感じます。
.env などのファイルや .mcp.json のキーが削除される不具合を修正
次の 3 件の不具合が修正されました。
- Remote Control の worktree モードでサーバーを停止すると、実行中のセッションの Git の無視対象ファイル(
.envなど)が削除されていた --use-anthropic-git-proxy付きのセルフホストランナーが、起動時にGIT_CONFIG_GLOBALで指定された空でないディレクトリを削除していた。ランナーはディレクトリを残し、変数を無視して警告するようになりました- project スコープの
claude mcp addとclaude mcp removeが、.mcp.jsonの他のトップレベルキー($schemaや他のツールのserversなど)を削除していた
Remote Control の worktree モード、--use-anthropic-git-proxy 付きのセルフホストランナー、project スコープの .mcp.json のいずれかを使っている方は、早めにアップデートする価値があると感じます。
作業ディレクトリの判定とシンボリックリンクのチェックを厳格化
パスのチェックで一部のシンボリックリンクを拒否するようになりました。また、作業ディレクトリ内とみなす判定が変わり、一部のパスで権限の確認が求められるようになりました。
permissions.blockReadsOutsideWorkingDirectories を有効にしている場合は、bypass permissions mode と auto mode でより多くの Bash コマンドが確認の対象になり、auto mode では一部が拒否されます。Read や Edit の deny ルールの配下のパスを指定する Bash コマンドも、これまで確認を求めていたものの一部が拒否されるようになりました。CHANGELOG には、対象となるシンボリックリンクやパスの条件は記載されていません。
permissions.blockReadsOutsideWorkingDirectories を有効にしている方や、シンボリックリンク経由で作業ディレクトリ外のファイルを扱っている方は、アップデート後に確認や拒否が増えていないかを見ておくのがよいと感じます。
セッション最初の Bash コマンドの高速化とシェルの起動ファイルの実行
セッション最初の Bash コマンドが速くなりました。あわせて、シェルの起動ファイルがそのコマンドの承認前に実行される場合があり、そのコマンドを拒否しても実行されることがあります。CLAUDE_CODE_DISABLE_SHELL_HEAD_START=1 を設定すると、この動作をオフにできます。
.zshrc などの起動ファイルに、ファイルの書き込みなど副作用のある処理を書いている方は、この動作を把握したうえで、必要に応じて CLAUDE_CODE_DISABLE_SHELL_HEAD_START=1 を設定するのがよいと感じます。
Claude in Chrome が一部の認証情報ファイルのアップロードを拒否
Claude in Chrome が一部の認証情報ファイルのアップロードを拒否するようになりました。それらのファイルは自分でページに添付します。CHANGELOG には、対象のファイルは記載されていません。
Claude in Chrome にページへのファイルの添付を任せている方は、認証情報ファイルは自分で添付する前提で手順を見直すのがよいと感じます。
アップデート内容
新機能
注目のアップデートで紹介した claude mcp add-json の標準入力対応と /status の一覧のほかに、次の機能が追加されました。
/install-github-appがリポジトリを変更する前に確認を求めるようになりました/configで、他の設定によって上書きされている行に注記が表示されるようになりましたattributionProject設定で、セッションの課金グループの名前を指定できるようになりました。admin.billing_group_tagを設定した Claude apps ゲートウェイ向けです- ゲートウェイ向けのヒントヘッダーに
x-claude-code-managed-settings-checksumが追加されました。マネージド設定でCLAUDE_CODE_GATEWAY_HINT_HEADERS=1を設定している環境で送信されます - 非フルスクリーンのレンダラーの名前として
/tui classicが追加されました。/tui defaultも引き続き使えます
VS Code 拡張機能の新機能は「VS Code 拡張機能」で紹介します。
セキュリティ
注目のアップデートで紹介した項目のほかに、次の変更と修正があります。
- 変数の展開で非常に長いテキストになる Bash コマンドが拒否されるようになりました。短い値かファイルを使うよう案内されます
- PowerShell ツールで、そのコマンドを指定するルールがあっても確認を求めるコマンドが 1 つ増えました。応答がない場合は、ツール全体のルール、auto mode、bypass permissions mode で許可されていない限り拒否されます。CHANGELOG には、対象のコマンドは記載されていません
- 兄弟のサブエージェントのメッセージで再開したサブエージェントが、セッションの権限設定に従うようになりました。確認を求めたり、応答できる人がいない場面では拒否されたりする場合があります
- 括弧を含む一部の
--disallowedToolsルールの不具合が修正されました - 新しいモデルと PowerShell でのコミットで、シークレットを含む可能性が高いファイルをコミットしないよう Claude に指示するようになりました
- MCP サーバーのログに、elicitation のリクエストとフックの回答の全内容ではなく、モード・アクション・フィールド名だけを記録するようになりました
- Anthropic がホストするクラウドセッションで、リポジトリのフラグとプラグインの配信設定を無視する範囲が広がりました。リポジトリの
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICは最大でもDISABLE_TELEMETRY相当として扱われます - サブエージェントの中や、バックグラウンドタスクの結果・他の人のメッセージ・コンパクションの後では、Artifact の公開の確認に「don't ask again」が表示されなくなりました
- このほか、新規の Artifact ごとに承認が必要な組織での Artifact の拒否の条件、設定で Artifacts をオフにしたときの Artifact ツールの拒否、
claude plugin evalでの deny ルールの優先、サンドボックスの対象外のコマンドがサンドボックス内に残ったことの Claude への通知などの変更があります
改善
- 認識されないモデルで、出力 32,000 トークンで途切れた長い応答が、上限 128,000 トークンで続行されるようになりました
- Amazon Bedrock・Google Vertex AI・Microsoft Foundry のターミナルセッションで、サブエージェントの進捗サマリーが会話全体ではなく短いメモから作られるようになり、使用するトークンが大幅に減りました
- モデルを指定せずに起動したサブエージェントが、再開したとき(
/modelの後を含む)に起動時のモデルのままになりました - ツール呼び出しをフックする mod がインストールされていても、Code Mode が起動を拒否しなくなりました。管理者はマネージド設定で Code Mode をオフのままにできます
- 多くの権限プロンプトで、矢印キーが折り返さず No で止まるようになりました。最後の選択肢より大きい数字を押すと No に移動します
- Windows では、PowerShell ツールが 1 コマンドあたり最大約 0.5 秒速くなりました。Git Bash と
pwshが PATH にない環境の起動時間も改善され、System32 のpowershell.exeが PATH 上で先に見つかるpowershell.exeより優先されるようになりました - このほか、トランスクリプト検索の対象(編集内容と書き込んだファイル)、非対話(
-p)モードで最初のリクエストの前に実行する git コマンドの削減、/mcpの MCP サーバーのページのレイアウト、狭い端末での表示、/install-github-appと/desktopの操作などが改善・変更されています。/mcp・/sandbox・多くの/configの値の一覧では、スクリーンリーダーモード以外で番号が表示されなくなり、矢印キーと Enter で操作します
修正
注目のアップデートで紹介した 3 件のほかに、主な修正は次のとおりです。
/exportが既存のファイルを確認せずに上書きしていた問題が修正されました。ダイアログで確認するようになり、/export <name>はファイルを残して/exportの実行を案内します- 出力トークンの上限で途切れた応答の直後にコンパクションが実行されると、その応答のツール呼び出しと結果が失われていた問題が修正されました
/configなどからの設定の変更が警告なしに保存に失敗していた問題が修正されました。プロンプトの下に保存に失敗した旨の行が表示されます--agentsで渡したエージェントがプラグインの読み込み・再読み込みの後に失われていた問題が修正されましたhttps_proxyまたはHTTPS_PROXYがhost:portの形式で、入力と出力のどちらも端末でない場合(デスクトップアプリ、SDK、cron)に Claude Code が起動しなかった問題が修正されました- モデルの設定の取得がプロキシなどで止まると、
claude -pが最初のリクエストの前に止まっていた問題が修正されました。10 秒後に設定なしで続行します - VPN の切断のような長めの障害の後、リモートの MCP サーバーが切断されたままになっていた問題が修正されました。ホスト名と https で接続する他のマシン上のサーバーの多くは、バックグラウンドで約 1 日再試行されます
- コンパクションの後、全文を読み込み済みで変更されていないプロジェクト外のファイルに対して、Edit が「File has not been read yet」で拒否していた問題が修正されました
head_limitとoffsetでページングすると Grep の結果が重複・欠落していた問題が修正されました。content と count の結果はファイルパス順に並びます- リーダーと異なるモデルで動くインプロセスのエージェントのチームメイトが、リーダーのコンテキストの上限と誤ったモデルでコンパクションしていた問題が修正されました。自身の上限とモデル(そのモデルの料金)を使います
- バックグラウンドのエージェントの SubagentStop、
/clearと/resumeでの SessionEnd、フルスクリーンでの CwdChanged と FileChanged のフックが失敗しても、何も表示されなかった問題が修正されました - プロジェクトの
.claude/settings.jsonでANTHROPIC_BASE_URLに LLM ゲートウェイを設定すると、一部のターミナルセッションで/modelが誤ったモデルを一覧表示していた問題が修正されました - このほか、セッションの再開とメッセージの保存、バックグラウンドのエージェントと Remote Control の通知、端末の表示(Ghostty、tmux、Windows Terminal など)、
/plugin・/mcp・/resumeなどの画面の操作、Artifact の公開と承認など、多数の細かな不具合が修正されています
VS Code 拡張機能
- エクスプローラーの右クリックメニューに「Claude Code: Add to Chat」が追加されました。選択したファイルやフォルダをチャットで @ メンションします
rgが PATH にある大規模なワークスペースで、@ メンションのファイル検索が速くなりました。結果の順位はターミナルに近くなり、タイプミスの許容度は下がっています- 同じウィンドウのターミナルセッションがプロンプトを送った場合も、チャットの編集の差分が開いたまま承認を求め続けるようになりました
- IDE 接続から、未使用のツール(openFile、saveDocument、getOpenEditors など)が削除されました
- このほか、PreToolUse フックが確認を求める際の理由が権限プロンプトに表示されない問題(anthropics/claude-code#85950)、権限プロンプトのタイトルで長い名前が切れる問題、Escape でポップアップを閉じると Claude の応答も止まる問題などの修正と、連続した編集と起動の速度の改善があります
破壊的変更・非推奨
本記事では、既存の設定・コマンド・運用の結果が変わり、対応が必要になる可能性がある変更を破壊的変更として扱っています(CHANGELOG に破壊的変更という分類はありません)。以下の設定例・コマンド例は CHANGELOG の記載をもとに作成した例です。
auto mode で無視される allow ルールの拡大
変更前(〜v2.1.326): 次のような allow ルールは auto mode でも無視の対象ではありませんでした。以下は設定例です(~/.claude/settings.json)。
{
"permissions": {
"defaultMode": "auto",
"allow": ["Bash(pnpm dlx *)", "Bash(/usr/bin/npm run:*)"]
}
}
変更後(v2.1.327〜): 同じ設定でも、auto mode では任意のパッケージを実行するルール(Bash(pnpm dlx *) など)と、すでに無視されていたルールのパスやバージョンを含む形(/usr/bin/npm run:*)が無視され、安全チェックで判定されます。公式ドキュメント(permission-modes)によると、auto mode で外されたルールは、auto mode を抜けると元に戻ります。
ExitWorktree による worktree の削除
変更前(〜v2.1.326): ExitWorktree は未保存の作業を含む可能性のある worktree を削除する前に確認を求めていませんでした。以下は設定例です。
{
"permissions": {
"defaultMode": "dontAsk"
}
}
変更後(v2.1.327〜): 削除の前に確認を求めます。don't-ask mode や応答できる人がいない場合、この削除は allow ルール、auto mode、bypass permissions mode で許可されていない限り拒否されます。以下は allow ルールで許可する場合の設定例です(ルールの書き方は例です)。
{
"permissions": {
"defaultMode": "dontAsk",
"allow": ["ExitWorktree"]
}
}
mcpServers キーのない .mcp.json への claude mcp add --scope project
変更前(〜v2.1.326): .mcp.json が mcpServers キーなしでトップレベルにサーバーを並べている場合、claude mcp add --scope project はファイルを上書きしていました。以下は .mcp.json とコマンドの例です(値は公式ドキュメント(MCP)の例です)。
{
"weather-api": {
"type": "http",
"url": "https://api.weather.com/mcp"
}
}
% claude mcp add --scope project --transport http notion https://mcp.notion.com/mcp
変更後(v2.1.327〜): 同じ .mcp.json に対して、claude mcp add --scope project はファイルを上書きせずに停止します。公式ドキュメント(MCP)の .mcp.json の形式では、サーバーは mcpServers の下に置きます。
{
"mcpServers": {
"weather-api": {
"type": "http",
"url": "https://api.weather.com/mcp"
}
}
}
--worktree と相対パスの --add-dir
変更前(〜v2.1.326): 起動フォルダの隣にあるフォルダを相対パスで --add-dir に指定すると、Bash サンドボックスには worktree の隣のフォルダが与えられていました。以下はコマンドの例です(フォルダ名は仮のものです)。
% cd ~/work/app
% claude --worktree feature-x --add-dir ../shared
変更後(v2.1.327〜): 同じコマンドで、Bash サンドボックスには起動フォルダ(~/work/app)の隣の ~/work/shared が与えられます。
また、.. のように起動フォルダより上を指す相対パスを --add-dir に指定した一部の起動では、Bash サンドボックスと --bg のセッションには worktree だけが与えられるようになりました。CHANGELOG には、どの起動が対象かは記載されていません。
% cd ~/work/app
% claude --worktree feature-x --add-dir ..
ネストした claude と CLAUDE_CODE_OAUTH_SCOPES
変更前(〜v2.1.326): 独自のトークンを持つネストした claude が、forceLoginOrgUUID で拒否されることがありました。また、セッションのトークンを受け取らないコマンドにも、セッションの CLAUDE_CODE_OAUTH_SCOPES が渡されていました。
変更後(v2.1.327〜): この問題が修正され、セッションのトークンを受け取らないコマンドには CLAUDE_CODE_OAUTH_SCOPES が渡されなくなりました。必要なコマンドには個別に設定します。以下は例です(スコープとコマンドはプレースホルダーです)。
% CLAUDE_CODE_OAUTH_SCOPES="<必要なスコープ>" <コマンド>
非推奨: auto mode の課金される分類器リクエストへのフォールバック
auto mode が課金される分類器リクエストにフォールバックしたときの通知で、今後のリリースでこのフォールバックを廃止することが示されるようになりました。廃止後は、このフォールバックでチェックされるはずだった各操作が、確認または拒否の対象になります。
公式ドキュメント(permission-modes)によると、このフォールバックは、LLM ゲートウェイやプロキシがレビューのリクエストや結果を落とす場合など、サーバー側で auto mode のレビューが行われないセッションで使われ、分類器のリクエストが課金されるアカウントで通知が表示されます。
| 時期 | サーバー側のレビューが行われないセッションでの auto mode の判定 |
|---|---|
| v2.1.327 | Claude Code 自身の分類器リクエストで判定する(公式ドキュメントの記載)。課金されるアカウントで表示される通知に、今後のリリースでフォールバックを廃止することが示される |
| 廃止後 | フォールバックでチェックされるはずだった各操作は、確認または拒否の対象になる |
動作が変わる変更の一覧
破壊的変更として扱った 6 件と非推奨の 1 件に、セキュリティや修正に分類した項目のうち動作が変わるものを加えた一覧です。CHANGELOG に変更前の動作の記載がない項目は「—」としています。
| 対象 | 変更前 | 変更後・必要な対応 |
|---|---|---|
auto mode の、任意のパッケージを実行する allow ルール(Bash(pnpm dlx *) など)と、すでに無視されていたルールのパスやバージョンを含む形(/usr/bin/npm run:*) |
無視の対象ではなかった | 無視され、安全チェックで判定される |
ExitWorktree による、未保存の作業を含む可能性のある worktree の削除 |
確認を求めない | 確認を求める。don't-ask mode や応答できる人がいない場合は、allow ルール、auto mode、bypass permissions mode で許可されていない限り拒否される |
mcpServers キーのない .mcp.json への claude mcp add --scope project |
ファイルを上書き | 上書きせずに停止する |
--worktree と、起動フォルダの隣のフォルダを指す相対パスの --add-dir |
worktree の隣のフォルダ | 起動フォルダの隣のフォルダ |
--worktree と、.. など起動フォルダより上を指す相対パスの --add-dir(一部の起動) |
— | Bash サンドボックスと --bg のセッションには worktree だけを与える |
セッションのトークンを受け取らないコマンドの CLAUDE_CODE_OAUTH_SCOPES |
渡されていた | 渡されない。必要なコマンドには個別に設定する |
| パスのチェックでの一部のシンボリックリンク | — | 拒否される |
| 作業ディレクトリ内とみなす判定 | — | 一部のパスで権限の確認が求められる |
permissions.blockReadsOutsideWorkingDirectories を有効にしたときの Bash コマンド |
— | bypass permissions mode と auto mode で確認の対象が増え、auto mode では一部が拒否される。Read・Edit の deny ルールの配下のパスを指定するものの一部は、確認から拒否に変わる |
| 変数の展開で非常に長いテキストになる Bash コマンド | — | 拒否される。短い値かファイルを使う |
| PowerShell ツールの 1 つのコマンド | — | そのコマンドを指定するルールがあっても確認を求める。応答がない場合は、ツール全体のルール、auto mode、bypass permissions mode で許可されていない限り拒否される |
| 兄弟のサブエージェントのメッセージで再開したサブエージェント | — | セッションの権限設定に従う。確認を求めたり、応答できる人がいない場面では拒否されたりする場合がある |
Anthropic がホストするクラウドセッションでの、リポジトリの CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC |
— | 最大でも DISABLE_TELEMETRY 相当として扱われる |
| Claude in Chrome での一部の認証情報ファイルのアップロード | — | 拒否される。自分でページに添付する |
| WebFetch の 2,000 文字を超える URL | — | 権限プロンプトの前に拒否される |
@ メンションを大量に含むメッセージ |
— | ファイルとして参照するのは先頭の 100 件だけ |
mod の $.model.complete・$.model.classify の呼び出しが利用上限に達した場合 |
ターンが止まっていた | API のエラーをすぐに受け取る。mod 側でエラーを処理する |
| auto mode の課金される分類器リクエストへのフォールバック(非推奨) | — | 今後のリリースで廃止予定。廃止後は確認または拒否の対象になる |
claude mcp add-json の標準入力対応を試してみた
claude mcp add-json の標準入力対応を、ヘルプの表示と、Claude Code のセッションの外・内での実行で確認しました。
検証環境
検証環境は macOS(Darwin 25.6.0、arm64)、Claude Code v2.1.327 です。
% claude --version
2.1.327 (Claude Code)
ヘルプを確認する
% claude mcp add-json --help
Usage: claude mcp add-json [options] <name> <json>
Add an MCP server (stdio, SSE, HTTP, or WebSocket) with a JSON string, or - to
read it from stdin
Options:
--client-secret Prompt for OAuth client secret (or set MCP_CLIENT_SECRET
env var)
-h, --help Display help for command
-s, --scope <scope> Configuration scope (local, user, or project) (default:
"local")
説明に「or - to read it from stdin」とあり、<json> の位置に - を渡すと JSON を標準入力から読み込みます。オプションの --scope では local(既定)・user・project を指定できます。
なお、執筆時点の公式ドキュメント(MCP)の「Add MCP servers from JSON configuration」の例は、JSON を引数で渡す形のみでした。
セッションの外で標準入力から登録する
CHANGELOG では Claude Code のセッション内では使えないとされているため、Claude Code を起動していないターミナルで実行しました。検証用のフォルダを作り、公式ドキュメント(MCP)の例の値で server.json を作成します。トークンの値(Bearer token)はドキュメントのダミーです。
% mkdir mcp-stdin-test && cd mcp-stdin-test
% printf '%s\n' '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}' > server.json
今回は server.json を printf で作成したため、このコマンドにはトークンが含まれています。トークンをシェルの履歴に残さないために標準入力での登録を使う場合は、エディタで作成するなど、コマンドラインにトークンを書かない方法でファイルを用意します。
<json> の位置に - を指定し、server.json の内容を標準入力から渡します。
% claude mcp add-json --scope project weather-api - < server.json
✔ Added http MCP server weather-api to project config
% cat .mcp.json
{
"mcpServers": {
"weather-api": {
"type": "http",
"url": "https://api.weather.com/mcp",
"headers": {
"Authorization": "Bearer token"
}
}
}
}
登録に成功し、フォルダの .mcp.json の mcpServers の下に、標準入力から渡した内容が書き込まれました。headers の値も .mcp.json にそのまま保存されます。
続けて、登録したサーバーを削除しました。
% claude mcp remove --scope project weather-api
✔ Removed MCP server weather-api from project config
File modified: ~/workspaces/cc/blog/20261118-v2.1.327/mcp-stdin-test/.mcp.json
% cat .mcp.json
{
"mcpServers": {}
}
削除後の .mcp.json には空の mcpServers が残りました。今回は $schema などの他のトップレベルキーを追加していないため、v2.1.327 で修正された、他のトップレベルキーが削除される問題は確認していません。
Claude Code のセッション内で実行した場合
参考として、同じ登録のコマンドを Claude Code のセッション内(Claude が実行する Bash)から実行しました。CHANGELOG の記載どおり拒否され、終了コードは 1 でした。.mcp.json は作成されていません。
% claude mcp add-json --scope project weather-api - < server.json
Reading the JSON from stdin is refused inside a Claude Code session, because its permission prompt would not show the server. Run the command outside the session.
メッセージによると、セッション内では権限プロンプトにサーバーが表示されないため、標準入力からの読み込みを拒否しています。
ヘルプの説明から、JSON の代わりに - を渡すと標準入力から読み込むことを確認できました。トークンを含む JSON をファイルから標準入力で渡せるため、シェルの履歴にトークンを残したくない方には使いやすい変更と感じます。
最後に
v2.1.327 は 173 件の多くが修正ですが、作業ディレクトリの判定、シンボリックリンク、auto mode の allow ルールなど、権限チェックで確認や拒否が増える変更が含まれていると感じます。無人実行や CI で使っている方は、アップデート後に一度動作を確認し、必要な allow ルールや設定を見直しておくのがよいと感じます。
権限まわりの設定を確認したうえで、アップデートして試してみてはいかがでしょうか。
参考文献







