Claude Code v2.1.327 — /statusが設定の不具合を一覧し、権限の確認が増える
Claude Code v2.1.327は/statusに壊れた設定ファイルやsandboxの不具合を並べ、claude mcp add-jsonが標準入力を読めます。.mcp.jsonを消す不具合と、作業ディレクトリ外の判定も変わります。
このリリースで何ができるようになるか
Claude Code v2.1.327の追加は、ターミナル向けが8件、VS Code拡張向けが1件です。残りの大半は修正と挙動の変更で、前のv2.1.326に続いて権限まわりの確認が増えています。
v2.1.327のchangelog内訳
項目の合計
173
VS Code向け10件を含む
Fixed
94
VS Code向けを除く
Changed
35
権限・worktree・artifact
Added
8
ターミナル向け
読者に直接効く点は4つです。
/statusに、壊れた設定ファイルやsandboxの不具合などを並べる一覧が加わったclaude mcp add-json <name> -で、サーバーのJSONを標準入力から渡せるclaude mcp addとclaude mcp removeが、プロジェクトの.mcp.jsonの他のキーを消す不具合が直った/exportが既存のファイルを確認なしに上書きしなくなった
設定を共有リポジトリで管理しているチームは、3つ目が先に効きます。前のリリースの権限まわりの流れはv2.1.326の解説にあります。
あなたの開発フローはどう変わるか
設定が効いていない理由を探すとき
/status は、バージョン・モデル・アカウント・接続状況を出すコマンドです。v2.1.327では、そこに次の問題をまとめた一覧が加わりました。
- 壊れたエージェント・スキル・コマンド・出力スタイルのファイル
- キーバインドのエラー
- 使えないサンドボックス
- 無視された権限設定
- 一致する相手がいないフックのマッチャー
「フックを書いたのに動かない」「権限ルールが効かない」という場面で、原因の候補が1か所に出ます。見方の基本は/statusコマンドの見方で扱っています。
/config にも、他の設定に上書きされている行へ注記が付きました。どのファイルが勝っているかを探す手間が減ります。/config などの設定変更が保存に失敗したときは、プロンプトの下に1行出るようになりました。以前は何も出ませんでした。
MCPサーバーを登録するとき
claude mcp add-json は、JSONを引数に渡す形が公式のMCP解説の例です。
claude mcp add-json events-server \
'{"type":"ws","url":"wss://mcp.example.com/socket","headers":{"Authorization":"Bearer YOUR_TOKEN"}}'この書き方だと、トークンがコマンドラインに残ります。v2.1.327では、名前の後ろに - を置くと標準入力からJSONを読みます。トークンをコマンドラインに出さずに済みます。Claude Codeのセッションの中では使えません。
次の形は、changelogの記述に沿って組んだ例です。JSONを置くファイルのパスは任意で、サーバーの内容は例です。
claude mcp add-json events-server - < ./events-server.json登録の基本はclaude mcp add-jsonの手順にあります。公式のMCP解説は、この - の書き方をまだ載せていません。
もう1つ、プロジェクトスコープの登録で事故が直りました。claude mcp add と claude mcp remove が、.mcp.json の $schema や他のツールの servers といった最上位のキーを消すことがありました。チームでこのファイルを共有している場合は、コミット前の差分を一度見ておくと安心です。
claude mcp add --scope project は、.mcp.json が mcpServers キーなしで最上位にサーバーを並べているとき、上書きせずに止まるようになりました。
権限の確認が増えるとき
権限まわりは、確認が増える変更が続きます。
| 対象 | 変更内容 |
|---|---|
| 作業ディレクトリの判定 | 変更内容何を作業ディレクトリの内側とみなすかが変わり、一部のパスで確認が出る |
| シンボリックリンク | 変更内容パスの確認が、一部のリンクを拒否する |
permissions.blockReadsOutsideWorkingDirectories | 変更内容bypassとautoの各モードで、確認の出るBashコマンドが増え、autoでは一部が拒否される。ReadまたはEditのdenyルールに挙がったパスを含むBashコマンドも、確認でなく拒否になる場合がある |
| auto mode | 変更内容Bash(pnpm dlx *) のようにパッケージを実行する許可ルールを、さらに多く無視する。/usr/bin/npm run:* のようなパス付きの形も対象 |
| PowerShellツール | 変更内容さらに1つのコマンドで、そのコマンドを指定したルール(PowerShell(コマンド名 *) の形)があっても確認を出す。応答する人がいなければ拒否される(素の PowerShell のようにツール全体を対象にしたルール、auto mode、bypass permissionsモードが許可する場合を除く) |
ExitWorktree | 変更内容未保存の作業を含むかもしれないworktreeを消す前に確認する。don't-askモードや答える人がいない実行では拒否される(allowルール、auto mode、bypass permissionsモードが許可する場合を除く) |
| 変数を含むBash | 変更内容変数が非常に長い文字列に展開されるコマンドを拒否する |
| 権限プロンプトの矢印キー | 変更内容先頭から末尾へ回り込まず、「No」で止まる |
blockReadsOutsideWorkingDirectoriesの設定解説の対象の設定が、今回さらに厳しくなった形です。
無人で回しているジョブでは、確認が増えた分は、答える人がいなければ拒否として現れます。更新後の最初の数回のログを見れば、拒否が出ているかが分かります。
直近3バージョンで、権限まわりは次のように動いてきました。
| バージョン | 権限まわりの主な変更 |
|---|---|
| v2.1.325 | 権限まわりの主な変更サンドボックス内のBashコマンドが、既定で通常の権限の流れに従うようになった。プロンプトなしで動かし続けるには sandbox.autoAllowBashIfSandboxed: true を設定する |
| v2.1.326 | 権限まわりの主な変更以前は動いていたmacOSのBashコマンドの一部が、確認か拒否になった。bypass permissionsモードでも、一部のツール呼び出しが確認になり、答える人がいなければ拒否される |
| v2.1.327 | 権限まわりの主な変更作業ディレクトリの内側とみなす範囲が変わり、一部のパスで確認が出る。permissions.blockReadsOutsideWorkingDirectories の対象も広がった |
worktreeを使うとき
--worktree と相対パスの --add-dir を組み合わせた起動で、Bashのsandboxに渡るフォルダーが変わりました。
- 起動フォルダーの隣を指す相対パスの
--add-dirでは、worktreeの隣でなく、そのフォルダーがsandboxに渡る ..のように起動フォルダーより上を指す場合は、sandboxと--bgセッションにworktreeだけが渡る
Remote Controlでは、worktreeモードでサーバーを止めると、実行中のセッションの .env のようなgit管理外のファイルが消える不具合が直りました。
別の修正として、終了時にworktreeを残したことが表示されない不具合も直っています。
自己ホストのRunnerやゲートウェイ経由で使うとき
--use-anthropic-git-proxy を付けた自己ホストのRunnerが、環境変数 GIT_CONFIG_GLOBAL の指す空でないディレクトリを起動時に削除する不具合が直りました。いまはそのディレクトリを残し、変数を無視して警告します。
ゲートウェイ向けには2点あります。
- ゲートウェイのヒントヘッダーに
x-claude-code-managed-settings-checksumが加わった。管理設定でCLAUDE_CODE_GATEWAY_HINT_HEADERS=1を指定している環境で送られる attributionProjectの設定で、セッションの課金グループに名前を付けられる。admin.billing_group_tagを設定したClaudeアプリのゲートウェイ向け
独自のベースURLを使う構成では、ヒントヘッダーは既定でオフです。受け取るには CLAUDE_CODE_GATEWAY_HINT_HEADERS=1 を設定します。0 にすると、すべての接続で止まります。
主な変更点
設定とコマンド
/install-github-appが、リポジトリを変更する前に確認を出す。リポジトリ・シークレット・APIキーの各ステップは、標準の一覧とキー操作に統一された。導入の流れはClaude GitHub Appのインストール手順にある/tui classicが、フルスクリーンでない描画の名前として加わった。/tui defaultも使える。公式のコマンド一覧の表には、まだ/tui [default|fullscreen]の形しか載っていない/exportが、既存のファイルを確認なしに上書きしなくなった。ダイアログで尋ねる。/export <name>はファイルを残し、/exportを実行するよう案内する。コマンドの仕様は/exportの解説にある/sandboxと、ほとんどの/configの値の一覧は、スクリーンリーダーモード以外で番号なしになった。矢印キーとEnterで選ぶ/hooksが、--settingsで渡したフックを一覧から落とさなくなった/mcpが、セッション中に追加したサーバーや断ったサーバーを「設定なし」と表示する問題が直った。するべきことを案内する
費用とリクエストに関わる変更
- サブエージェントの進捗要約は、Amazon Bedrock・Google Vertex AI・Microsoft Foundryのターミナルセッションで、会話全体でなく短いメモから書かれる。使うトークンが大きく減る
- 非対話の
-pモードは、最初のリクエストの前に動かすgitコマンドを減らした - 最初のBashコマンドの速度を上げるため、シェルの起動ファイルが、承認される前に動くことがある。拒否されるコマンドでも動く。止めるには
CLAUDE_CODE_DISABLE_SHELL_HEAD_START=1を設定する - 認識されないモデルで、32,000出力トークンで切れた返信は、128,000の上限で続きを出す
- auto modeが課金される分類器リクエストに切り替わるときの通知に、この切り替えが近いリリースでなくなる旨が加わった。切り替えがなくなった後は、分類器が確認するはずだった行動は、確認か拒否のどちらかになる
セッションの復元
再開まわりの修正が目立ちます。
- 前の会話が読み込めないとき、再開したセッションに1行出る
- 同じUUIDのメッセージが、プロセスを止めた後に再送されると、ヘッドレスセッションが保存済みのメッセージを失う不具合を修正した
- 空の返信や止めたコマンドの後に再開すると、回答が消えたり、巻き戻したプロンプトが戻ったりする不具合があった。別のクラッシュの後や、バックグラウンドへ移した後の再開でも、これが起きなくなった
- 出力トークンの上限で切れた返信の直後に圧縮すると、その返信のツール呼び出しと結果が消える不具合を修正した
- 長いセッションの再開では、トランスクリプトの読み取りが途中で終わったとき、1回だけやり直す
/rewindが、一部のファイルを戻せなかったときに何も表示せず閉じていたのが直った
ツールの修正
- Editが、圧縮後に、プロジェクトの外にある読み込み済みで未変更のファイルに対して「File has not been read yet」で拒否する問題を修正した
- Grepが、
head_limitとoffsetでページ送りすると結果が重複や欠落する問題が直り、内容と件数の結果は、ファイルパス順に並ぶようになった - WebFetchは、2,000字を超えるURLを、権限の確認より前に拒否する
- 1メッセージに数千の
@メンションがあると返信が止まっていた問題が直り、最初の100件だけがファイルとして調べられる - Readが、種類不明の出力を含むJupyter notebookで失敗する問題を修正した。NotebookEditがファイル末尾の改行を消す問題も直った
artifactまわり
artifactを使う環境向けの変更が、承認と公開の両面で入りました。
- artifactの公開が、「承認から公開までにソースファイルが変わった」で失敗する問題を修正した。同期フォルダーや、実体がリモートにあるフォルダーで、タイムスタンプだけが変わった場合
- 新規artifactごとに承認が要る組織で、承認済みのartifactが、クラウドのスケジュールタスクやAgent SDK製アプリから拒否される問題を修正した
- そうした組織で、プラグインだけが作った、または許可したartifactが拒否されることがある。答える人がいないセッションは、権限の確認なしで新規artifactを拒否する
- 設定でArtifactsを切った後は、すでに動いているセッションでもArtifactツールが呼び出しを拒否する
VS Code拡張
エクスプローラーの右クリックメニューに「Claude Code: Add to Chat」が加わりました。選んだファイルやフォルダーを、チャットで @ メンションします。PreToolUseフックが確認を求めたときの理由が、権限プロンプトに出ない問題も直っています。rg がPATHにある大きなワークスペースで、@ メンションのファイル検索が速くなりました。Escapeでフィードバックのダイアログや@メンションのメニューなどを閉じたとき、Claudeの応答まで止まる不具合も直りました。IDE接続からは、openFile・saveDocument・getOpenEditors などの未使用ツールが外れています。
/statusは設定の不調を一覧する入口に変わるか
今回の /status の変更は、機能の追加より、調べ方の変更に近いものです。これまで、壊れたスキルのファイルやキーバインドのエラーは、症状から原因をたどる必要がありました。v2.1.327では、症状の側から /status を開けば、候補が一覧に集まります。上の5種類については、原因探しの出発点が /status になります。
問題がないときの表示は、changelogに記載がありません。「何も出ない」ことを設定が正しい証拠とみなす前に、/config の注記や claude mcp get <name> と併せて見る方法があります。
利用形態ごとの影響
| 使い方 | 影響 | 理由 |
|---|---|---|
.mcp.json をチームで共有している | 影響明確な恩恵あり | 理由claude mcp add と remove が他のキーを消す不具合が直った |
| 無人・CIでauto modeやBypassを使う | 影響条件次第 | 理由確認や拒否が増え、答える人がいないと拒否になる |
| 自己ホストのRunner | 影響条件次第 | 理由GIT_CONFIG_GLOBAL の不具合が直る。ゲートウェイを併用する場合はヘッダーにも注意する |
| ゲートウェイ経由の管理環境 | 影響条件次第 | 理由ヒントヘッダーと課金グループの設定が加わる。使うかは構成による |
| artifactの承認を必須にしている組織 | 影響明確な恩恵あり | 理由承認済みなのに拒否される経路が直る |
| VS Code拡張が中心 | 影響条件次第 | 理由@ メンション検索やEscapeの扱いなど、細かい修正が中心 |
まとめ
今回の中心は、設定を直す手間を減らすことです。/status の一覧、/config の注記、保存失敗の表示で、気づきにくかった不具合が表に出ます。MCPの登録でトークンを標準入力で渡せるのも、運用で使いやすい変更です。
更新前に確かめたいのは、権限の確認が増える点です。無人のジョブでauto modeやbypass permissionsを使っているなら、更新直後の数回の実行ログに、拒否された呼び出しが出ていないかを確かめられます。
関連ガイド
このバージョン単体の位置づけや前後の版とのつながりは、Claude Codeの全体像でまとめて確認できます。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。