3行でいうと
- 2.1.305(GitHub Releasesの表示で20 Oct)に、Linux用の
sandbox.allowNestedUserNamespacesが加わりました。サンドボックスの中のコマンドが、ユーザー名前空間を作れるようになります(Chromiumやrootlessのpodmanがchangelogにあるねらいです)。changelogは、これで「サンドボックスのファイル保護を回避できる」とも書いています。便利さと引き換えの設定です。 - 同じ2.1.305で、
allowedMcpServersの効き方が変わりました。managed-mcp.jsonの中の、stdioサーバーで${VAR}をenvにだけ使うものは、許可リストの対象から外れます。許可リストで外していたサーバーが、更新で読み込まれることがあります。止めるにはdeniedMcpServersを使います。 - 2.1.302で、
claude -pと Agent SDK の既定が変わる場合があります。権限モードを指定しない実行が、サードパーティのプロバイダーやテレメトリ無効の環境などで、オートモードではなく Manual(default)で始まります。承認が要る呼び出しは、許可ルールなどがないと拒否されます。自動実行や CI の人は、更新前に確かめる項目です。 - 「リトライとツール検索の改善」は、2.1.304で入った変更の不具合(回帰)を2.1.305で直した話です。ゲートウェイなどがツール検索を拒むと、全リクエストが失敗していました。2.1.305は、ツール検索なしで再試行します。
- 日付はchangelogのページに書かれていません。ここに書く日付は、GitHub Releasesの表示(年とタイムゾーンは表示なし)です。
この記事は、実際に使って確かめた記録ではありません。この記事は、公式のchangelogと公式ドキュメントを2026年10月22日に読んだ整理です。引用は短く、ほとんどは言い換えです。
先に結論
- この週の版は、2.1.302、2.1.303、2.1.304、2.1.305、2.1.306の5つです。2.1.303は「バグ修正と信頼性の改善」の1行だけで、中身は書かれていません。2.1.306は2件の修正だけです。
- 更新の前に見たい順は、次のとおりです。①
claude -pやSDKで権限モードを指定していないか(2.1.302)、②組織でmanaged-mcp.jsonとallowedMcpServersを併用していないか(2.1.305)、③Linuxでsandbox.allowNestedUserNamespacesを使う必要があるか、使うならなぜか(2.1.305)。 - ゲートウェイ越しに使っている人は、2.1.304だけを避ける、という読み方ができます。ツール検索の再試行の不具合は、2.1.304の回帰として2.1.305で直った、とchangelogにあります。ただし、この記事は、実際に使って確かめた記録ではありません。
- 「サンドボックスの設定が増えた」は、守りが強くなった話ではありません。ファイル保護を避けられる側の設定が増えた話です。使うかどうかは、自分の環境で決めます。
前提:用語をそろえる
- changelog(変更履歴):版ごとの変更を書いた公式の一覧です。Claude Codeのchangelogのページは、GitHubの
CHANGELOG.mdから作られる、と書かれています。このページには、版の見出しはあっても日付がありません。 - サンドボックス:Claudeが実行するシェルのコマンドが触れるファイルやネットワークを、OSの仕組みで囲う機能です。公式ドキュメントでは、LinuxとWSL2では
bubblewrapを使うと説明されています。ClaudeのRead・Editなどのファイル用ツールやMCPサーバー、フックは、サンドボックスの外で動きます。 - ユーザー名前空間(user namespace):Linuxの機能で、一般ユーザーが、自分用の「仮の管理者権限つきの小部屋」を作れるようにするものです。ブラウザのChromiumや、rootlessのpodman(管理者権限なしのコンテナ実行)が、中でさらに小部屋を作るのに使います。この一般的な説明は、公式ドキュメントでは確かめていません(changelogに書かれているのは、Chromiumとrootlessのpodmanがこの設定のねらいだ、という点です)。
- ツール検索(tool search):MCPなどのツール定義を最初に全部は送らず、Claudeが必要になったときに探して読み込む仕組みです。公式のMCPのページは、対応するモデルでは既定でオンと説明しています。
- 許可リストと禁止リスト:MCPサーバーでは、
allowedMcpServers(許可)とdeniedMcpServers(拒否)です。公式ページは、拒否リストに当たったものは、許可リストがあっても止まる、と書いています。 - managed-mcp.json:組織が、端末のシステム用の場所に置く、MCPサーバーの固定の一覧ファイルです。置くと、Claude Codeは、その中のサーバーなど、決まったものしか読み込みません。
- 管理設定(managed settings):組織が配る設定です。ユーザーの設定ファイルや
--settingsより優先されます。 - 権限モード / オートモード:Claudeが、どこまで聞かずに実行するかの段階です。オートモード(auto mode)では、人の代わりに、分類器という別のモデルが操作を見ます。
- 非対話実行(claude -p):画面なしで、1回の依頼を実行して終わる使い方です。CIや自動化で使います。
- フック:ツール実行の前後などに、自分のスクリプトを差し込む仕組みです。
- 回帰(リグレッション)/ 破壊的変更:以前は動いていたものが、更新で動かなくなる不具合が回帰です。使い方を変えないと困る変更が、破壊的変更です。
- 確かさの書き方:「文書に書かれている」は、公式のchangelogや公式ドキュメントに、その文があること。「書かれていない」は、読んだ範囲に、その情報がないこと。「確認できず」は、探したが見つからなかったことです。
変更点を、使う人への影響で分ける
版の日付は、GitHub Releasesの表示です(2.1.302は16 Oct、2.1.303は18 Oct、2.1.304は19 Oct、2.1.305は20 Oct、2.1.306は21 Oct)。年とタイムゾーンは表示されていません。「影響を受ける人」は、初心者(設定を触らず対話で使う人)、ふつうに使う人(毎日使い、許可ルールなどは少し触る人)、設定をいじる人(設定ファイル、CI、組織の管理をする人)の3つで考えます。
| 版 | 変更(言い換え) | 影響を受ける人 | 権限・安全・料金に関わるか | 確かさ |
|---|---|---|---|---|
| 2.1.305 | Linuxで、サンドボックス内のコマンドがユーザー名前空間を作れる設定 sandbox.allowNestedUserNamespaces を追加。changelogは、これでコマンドがサンドボックスのファイル保護を避けられる、と書く |
設定をいじる人(Linux) | 安全に関わる(保護が弱まる側の設定) | 文書に書かれている(changelogのみ)。初期値は書かれていない。公式のサンドボックスのページと設定の一覧では、僕らが読めた範囲に項目が見つからなかった |
| 2.1.305 | allowedMcpServers が、managed-mcp.json のstdioサーバーのうち ${VAR} を env にだけ使うものを、絞り込まなくなった。許可リストで外していたものが、更新で読み込まれる。止めるには deniedMcpServers |
設定をいじる人(組織の管理者) | 権限・安全に関わる | 文書に書かれている(changelog)。公式の管理ページは command・args・env・URL・headers のどれかで ${VAR} を使うと確認される、と書いていて、この変更より前の記述に見える。どちらが新しいかは書かれていない |
| 2.1.305 | 管理設定で allowManagedPermissionRulesOnly が有効なとき、Claude Desktopがパスでマウントするプラグインは、allowed-tools を持ち続けなくなった |
設定をいじる人 | 権限に関わる | 文書に書かれている(changelog)。設定の一覧に allowManagedPermissionRulesOnly の項目はあり、スキルの allowed-tools の制限はv2.1.282以降に効く、とある。この変更そのものの記述は、僕らの読めた範囲になかった |
| 2.1.305 | Vertex・Bedrockなどのプロバイダーやゲートウェイがツール検索を拒むと、全リクエストが失敗した不具合(2.1.304の回帰)を修正。ツール検索なしで再試行する | ふつうに使う人(ゲートウェイ、クラウドのプロバイダー経由) | 安全には関わらない。使えなくなる不具合 | 文書に書かれている(changelog) |
| 2.1.304 | カスタムの ANTHROPIC_BASE_URL の先でも、ツール検索が既定でオン。ゲートウェイが400か422を返すと、ツール検索なしで再試行 |
設定をいじる人(ゲートウェイ) | 挙動の変更。料金への影響は書かれていない | 文書に書かれている(changelog)。公式のMCPのページは、ゲートウェイでの扱いは別の節を見るよう案内しており、その節は読めていない |
| 2.1.302 | claude -p とAgent SDKで権限モードを指定しない実行が、サードパーティのプロバイダー、テレメトリ無効、新規インストールでは、default(Manual)で始まる。--permission-mode auto を付けると、auto のまま |
設定をいじる人(CI・自動実行) | 権限に関わる。破壊的変更になりうる | 文書に書かれている(changelogと公式の権限モードのページ。ページは「v2.1.302以降」と明記) |
| 2.1.302 | 非対話実行で、承認が要る呼び出しは、許可ルール、フック、canUseTool コールバック、--permission-prompt-tool がないと拒否される |
設定をいじる人 | 権限に関わる | 文書に書かれている(公式の権限モードのページ) |
| 2.1.302 | クライアント側のオートモード分類器のモデルを選ぶ CLAUDE_CODE_AUTO_MODE_MODEL を追加。サーバー側のオートモードのモデルは変えない |
設定をいじる人 | 権限に関わる。分類器の呼び出しがトークン使用量に数えられるアカウントがある、と公式ページにある | 文書に書かれている(changelogと権限モードのページ) |
| 2.1.302 | サーバー側の分類器を使うオートモードで、会話が長すぎて安全確認に入らないとき、すべての呼び出しを拒否せず、圧縮して続ける | ふつうに使う人 | 権限に関わる | 文書に書かれている(changelog) |
| 2.1.302 | プロンプトとエージェントのフックは、同じイベントで同時に最大12まで。残りは順番を待つ | 設定をいじる人 | 安全に関わりうる(フックの実行が遅れる) | 文書に書かれている(changelog) |
| 2.1.302 | フォークしたサブエージェントが、claude -p・SDK・デスクトップ・VS Codeでも既定でオン。デスクトップとVS Codeでは、メイン会話のサブエージェントは常にバックグラウンドで動く。CLAUDE_CODE_FORK_SUBAGENT=0 でオフ |
ふつうに使う人、設定をいじる人 | 使用量への影響は書かれていない | 文書に書かれている(changelog) |
| 2.1.302 | プランではクレジットでしか払えないモデルで、クレジット請求の返信のあとは、プロンプト提案(先回りの候補)を出さない。提案のためにクレジットを使わないようにする変更 | ふつうに使う人 | 料金に関わる | 文書に書かれている(changelog) |
| 2.1.302 | /config に「アイドル圧縮」の行を追加(オフにできる)。圧縮後の通知にも、止め方が出る |
ふつうに使う人 | 使用量に関わりうる | 文書に書かれている(changelog。アイドル圧縮そのものは公式のプロンプトキャッシュのページにも説明あり) |
| 2.1.304 | rm -r が、マウントしたドライブや最上位のフォルダ(/Volumes、/media、WSLの /mnt/c)に向くとき、rm -rf /Applications と同じ安全確認が出る |
全員 | 安全に関わる | 文書に書かれている(changelog) |
| 2.1.304 | sandbox.filesystem.denyRead のglobに、文字クラスでない角かっこ(例:[user-id] というルートのフォルダ)が入ると、Linuxでサンドボックスのコマンドが起動に失敗した不具合を修正 |
設定をいじる人(Linux) | 安全に関わる | 文書に書かれている(changelog) |
| 2.1.304 | claude --worktree が、HEADが切り離されているときや別のブランチにいるときに、終了時に確認なしでworktreeとブランチを消し、コミットを失いうる不具合を修正 |
ふつうに使う人(worktreeを使う人) | 安全に関わる(データを失いうる) | 文書に書かれている(changelog) |
| 2.1.304 | 「プラグイン由来のフックだけ許可」という方針のとき、フックが締め出されたスキルが、メイン会話で allowed-tools を持たなくなった |
設定をいじる人 | 権限に関わる | 文書に書かれている(changelog) |
| 2.1.304 | PreToolUseフックの拒否理由が、同じ呼び出しのSDKコールバックフックがタイムアウトしたときに、タイムアウトのエラーに置き換わる不具合を修正 | 設定をいじる人 | 権限に関わる | 文書に書かれている(changelog) |
| 2.1.304 | ProとMaxのプランで、しばらく動かしていない会話を再開すると、5時間の使用上限のかなりの割合を使う場合に、警告を出す | ふつうに使う人 | 使用量に関わる | 文書に書かれている(changelog) |
| 2.1.304 | 1つの出どころ(リポジトリ、自分のフォルダ、プラグイン)のスキルが登録できるフックは、1セッションで最大1,024個、matcherの文字数は合計16,384まで | 設定をいじる人 | 安全に関わりうる | 文書に書かれている(changelog) |
| 2.1.304 | コードレビューに「Quick」「Standard(既定)」「Deep」のレベルを追加。組織の所有者が選び、リポジトリごとに変えられる。GitHub組織の全リポジトリを、あとから足すものも含めて対象にする選択肢も追加 | 設定をいじる人(管理者) | 料金への影響は書かれていない | 文書に書かれている(changelog) |
| 2.1.305 | 新しいworktreeが、bareリポジトリで、既定のブランチではなくローカルのHEADから始まることがあった不具合と、変更のないサブエージェントのworktreeが片付かないことがあった不具合を修正 | ふつうに使う人(worktreeを使う人) | 安全に関わらない | 文書に書かれている(changelog) |
| 2.1.305 | クラウドセッションやSDKの setMcpServers で渡したMCPサーバーが、あとから、自分の設定の同名サーバーに置き換わる不具合を修正 |
設定をいじる人(MCP、クラウド) | 安全に関わりうる(どのサーバーにつながるか) | 文書に書かれている(changelog) |
| 2.1.305 | MCPの同意ダイアログで、プロンプトに向けたEnterが「承認」と取られにくくなった | 全員 | 安全に関わる | 文書に書かれている(changelog) |
| 2.1.305 | /artifacts の削除確認が、1かEnterで残す、2で削除、Escで取り消し、になった。y と n では答えられない(2.1.304は、y・n・Escも使えた) |
ふつうに使う人 | 安全に関わる(誤削除の防止) | 文書に書かれている(changelog) |
| 2.1.305 | 無人のリトライモード(CLAUDE_CODE_RETRY_WATCHDOG)が、リセット前に解除された使用上限に気づくための CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS を追加 |
設定をいじる人(自動実行) | 使用量に関わる | 文書に書かれている(changelog)。公式の環境変数の一覧では、僕らが読めた範囲に項目が見つからなかった |
| 2.1.305 | /usage の警告を、原因を示す1行の対処にして、f で適用できるようにした。同じ対処はVS Codeと /doctor にも出る |
ふつうに使う人 | 使用量に関わる | 文書に書かれている(changelog) |
| 2.1.305 | 起動時の警告をデバッグログへ移し、何も制限しない権限ルールは、バナーの下に警告の行として出す | 設定をいじる人 | 権限に関わる | 文書に書かれている(changelog) |
| 2.1.305 | コードレビューの再レビューが、前のブロック指摘が未解決のうちは「LGTM」で始まらない。複数のpushが重なっても最新のコミットを見るように修正 | ふつうに使う人(コードレビューを使う人) | 安全に関わらない | 文書に書かれている(changelog) |
| 2.1.306 | クラウドセッション内の claude -p が「Not logged in」と出る不具合と、MCPツールが多いセッションで、APIのエラーが「prompt is too long」に置き換わり、不要な圧縮が走る不具合を修正 |
ふつうに使う人(クラウド、MCPが多い人) | 安全に関わらない | 文書に書かれている(changelog) |
| 2.1.303 | 「バグ修正と信頼性の改善」の1行だけ | — | 中身が書かれていないので、判断できない | 文書に書かれている(1行のみ)。具体的な内容は書かれていない |
表に入れなかったもの:VS Code拡張、Claude Tag(Slack)、セルフホストランナー、Windows、mod(Claude Codeの拡張の仕組み)に関する多数の修正と追加です。この週の2.1.304は「12の改善」と「43のバグ修正」、2.1.302は「7つの改善」と「43のバグ修正」、2.1.305は「6つの改善」と「22のバグ修正」と見出しにあります。僕らが数え直したのは、2.1.305の22件だけです。
更新前に確かめること
- [ ] いま使っている版が、2.1.301以前か、2.1.302以降か。
- [ ]
claude -pやAgent SDKで、権限モードを指定していない実行がないか。ある場合、--permission-modeか--allowedToolsなどの許可ルールを、先に決めておく。 - [ ] 組織で
managed-mcp.jsonとallowedMcpServersを併用していないか。している場合、envにだけ${VAR}を使うstdioサーバーの一覧を作り、読み込まれてよいかを確かめる。困るものは、更新の前にdeniedMcpServersに入れておく(公式の管理ページは、以前の同種の変更(v2.1.259)のときにも、更新前に拒否リストへ入れるよう案内している)。 - [ ] Linuxで
sandbox.allowNestedUserNamespacesを使う理由が、あるか。ChromiumやrootlessのpodmanをClaudeに動かさせたい、というような具体的な用途があるときだけ検討する。使うと、サンドボックスのファイル保護を避けられる、とchangelogにある。 - [ ] ゲートウェイ(
ANTHROPIC_BASE_URL)越しの利用で、使っている版が2.1.304ではないか。 - [ ]
allowManagedPermissionRulesOnlyを使う組織で、Claude Desktopが配るプラグインのallowed-toolsを前提にしていないか。 - [ ] ProやMaxで、古い会話を再開する習慣があるか。再開前の警告が出るようになる。
- [ ] 「プラグイン由来のフックだけ許可」の方針や、フックの数が多い設定がないか(2.1.302のフック同時12、2.1.304のスキルのフック上限)。
- [ ]
/artifactsの削除確認を、キー操作で自動化していないか(y・nが使えなくなった)。 - [ ] アイドル圧縮を止めたいか。止めるなら
idleCompactionをfalseにする(公式のプロンプトキャッシュのページに、v2.1.290以降とある)。
気をつけること
- 日付は、changelogのページに書かれていません。GitHub Releasesのページの「released this」の表示を使いました(2.1.302は16 Oct 20:53、2.1.305は20 Oct 20:46、2.1.306は21 Oct 03:16など)。年とタイムゾーンは表示されていません。週の境目に近い版(2.1.302は10月16日)は、タイムゾーンで日付が変わりうるので、版番号を基準に読んでください。
- 読めていない範囲があります。changelogのページは約127,000文字で、読めたのは先頭の約100,000文字です。2.1.302から2.1.306は、その範囲に入っていました。残りの約27,000文字(古い版)は読んでいません。内容は、要約を返す仕組みを通して取っているので、一語一句の写しとは限りません。
- 2.1.307以降は読んでいません。この記事を書いた時点で、GitHub Releasesの最新は2.1.306でした。
- 公式ドキュメントで裏づけられたのは、一部だけです。
claude -pの既定(権限モードのページ)、MCPの許可リストの扱い(管理ページ)、アイドル圧縮(プロンプトキャッシュのページ)は、ドキュメントにも書かれています。sandbox.allowNestedUserNamespacesと、再試行の新しい環境変数は、僕らが読めた範囲のドキュメントに項目が見つからず、changelogだけが根拠です。 ${VAR}の扱いは、changelogとドキュメントで食い違って見えます。changelogは「envにだけ使うstdioサーバーは対象外」と書き、公式の管理ページはenvも対象の例に挙げています。ドキュメントが追随していない可能性がありますが、そうとは書かれていないので、組織の管理者は、自分の環境で確かめてください。- mod(Claude Codeの拡張の仕組み)に関する多数の項目は、表に入れませんでした。mod自体を説明した公式ドキュメントを、僕らは読めていません。
- ネットの解説記事は、使っていません。WebSearchで公式のchangelogの場所を探しましたが、出てきたのは第三者のサイトでした。公式の場所は、依頼にあったURLと、GitHubの公式リポジトリで確かめました。
- この記事は、安全や法律の助言ではありません。組織の設定を変えるときは、管理者やセキュリティ担当と確かめてください。
- この記事は、実際に使って確かめた記録ではありません。
出典
- Changelog(Claude Code Docs、日付の記載なし、確認日2026-10-22)
- Releases · anthropics/claude-code(GitHub、確認日2026-10-22)
- Release v2.1.305(GitHub、20 Oct、確認日2026-10-22)
- Release v2.1.306(GitHub、21 Oct、確認日2026-10-22)
- Release v2.1.302(GitHub、16 Oct、確認日2026-10-22)
- Configure the sandboxed Bash tool(Claude Code Docs、確認日2026-10-22)
- Control MCP server access for your organization(Claude Code Docs、確認日2026-10-22)
- Choose a permission mode(Claude Code Docs、確認日2026-10-22)
- Configure permissions(Claude Code Docs、確認日2026-10-22)
- Settings files and precedence(Claude Code Docs、確認日2026-10-22)
- How Claude Code uses prompt caching(Claude Code Docs、確認日2026-10-22)
- Connect Claude Code to tools via MCP(Claude Code Docs、確認日2026-10-22)
更新履歴
- 2026年10月25日 書き方を直しました。
- 前:運営者が使っていないと読める書き方 → いま:「この記事は、実際に使って確かめた記録ではありません」。公式の資料を読んでまとめた記事で、使い心地は書いていない、という意味に直した
