はじめに
2026年8月27日、Claude Code v2.1.247 がリリースされました。今回のリリースは新機能追加よりも「実害のあるバグ修正」と「セキュリティ強化・挙動変更」が中心で、特に以下の3点は多くのユーザーに直接影響します。
- Bash サンドボックスが
~/.claude/settings.jsonのシンボリックリンクを削除してしまう critical バグ(dotfile管理ユーザー要注意) - managed settings が読めない場合に組織サインイン強制環境で 起動時に終了する 破壊的変更
- API コストを段階的に最適化できる新コマンド
/claude-api cost-optimizeの追加
CLI・エージェント運用を日常的に行うエンジニアや、Claude Code を組織展開している管理者にとって見逃せない内容なので、ポイントを整理します。
変更の全体像
今回のリリースに含まれる33件の変更を、影響度の高いものを中心に分類すると以下のようになります。
変更内容
重大な不具合修正(severity: critical / high)
| 変更 | 内容 | 影響 |
|---|---|---|
~/.claude/settings.json シンボリックリンク削除 |
Bash サンドボックスのクリーンアップ処理が、サンドボックス外を指すシンボリックリンクを削除していた | nix/home-manager・stow など dotfile 管理ツール利用者の設定が消える可能性 |
| サブエージェントのモデル404停止 | 初回呼び出しでモデル404を受けると即死していた | セッションのフォールバックモデルチェーンで継続、エラーにも詳細情報(タイプ・ステータス・request id・モデル名)が付与 |
| 大量エラー出力でのセッション破綻 | hook やバックグラウンドエージェントが数MBのエラーを出すと Prompt is too long で完全停止 |
長時間運用中のセッションが突然使えなくなる問題が解消 |
/terminal-setup の Zed keymap 全上書き |
Zed の keymap.json を丸ごと上書きしていた |
既存のキーバインド設定が消えていた問題を修正、マージ方式に変更 |
| 出力書き込み失敗時のメモリ無制限増加 | 出力ファイルへの書き込みに失敗するとメモリを消費し続けた | 長時間稼働のバックグラウンドタスクでのメモリリークを防止 |
| クラウドセッションのコンテナ再起動で無反応化 | ターン間でコンテナが再起動すると応答が返らなくなっていた | 再開後に「失われた作業」を報告するように改善 |
新機能・改善
| 変更 | 内容 |
|---|---|
/claude-api cost-optimize |
既存プロジェクトの API コストをプロファイリングし、キャッシュ・トークン整理・Batch API・reasoning effort・モデル選択を1つずつ計測しながら最適化 |
/claude-api の Admin API 対応 |
組織メンバー、招待、ワークスペース、API キー、レート制限レポート、Workload Identity Federation、CMEK を扱えるように |
SendFeedback ツール |
セッション中の問題を Claude が下書きし、/feedback で人間がレビューしてから送信。feedbackDrafts でオフ可能 |
spinnerTipsOverride 拡張 |
{id, text, cooldownSessions, priority} 形式のエントリ、tipsFile、label に対応。組織独自の Tips を組み込みと並行配信可能に |
破壊的変更・セキュリティ強化
⚠️ Breaking Change
組織のサインイン強制(organization sign-in enforcement)環境で、管理者の managed settings が読み取れない場合、host-supplied 設定やユーザーごとの Windows レジストリ設定があっても起動時に終了するように変更されました。従来はこれらのフォールバックで起動できていたため、設定配布が壊れている環境では Claude Code が使えなくなります。
そのほか、プラグインマーケットプレイスで制御文字・不可視文字を含むプラグイン名を拒否し、/plugin 出力のエスケープを安全化。ターミナルハイパーリンクについても、ネットワーク/オートマウンタパスや制御文字・不可視文字を含むものはクリック不可のプレーンテキストとして描画されるようになり、悪意あるリンク経由の意図しないアクセスを防止します。
またモデル関連では、Sonnet 5 の auto-compact 発動点が 1M コンテキスト基準に変更されました。
| 項目 | v2.1.247 以前 | v2.1.247 以降 |
|---|---|---|
| Sonnet 5 (1Mコンテキスト) auto-compact 発動点 | 約 934K トークン | 約 967K トークン |
影響と対応
📌 影響を受ける人
~/.claude/settings.jsonを nix/home-manager や stow などでシンボリックリンク管理している人 → アップデート後は安全ですが、過去に消えたリンクは復元が必要な場合があります- 組織でサインイン強制(managed settings)を運用している管理者 → 設定配布が正しく行われているか、今のうちに確認してください
- Zed エディタ +
/terminal-setupを使っているユーザー → 上書きされた keymap は手動復元が必要な場合があります- Claude API のコストを継続的に見ている人 →
/claude-api cost-optimizeを試す価値あり
💡 Tips
/claude-api cost-optimizeは一度に複数のコストレバーを変えず、1つずつ計測しながら進める設計です。キャッシュ活用 → トークン削減 → Batch API → effort調整 → モデル選択、の順に効果を確認しながら適用すると、想定外のレイテンシ悪化を避けられます。
アップデート後の推奨アクション:
-
claude --versionで2.1.247以降になっていることを確認する - dotfile 管理ツールを使っている場合、
~/.claude/settings.jsonのシンボリックリンクが健全か確認する - 組織管理者は managed settings の配布経路(MDM、GPOなど)を再確認する
-
/claude-api cost-optimizeを一度実行し、無駄なトークン消費がないか棚卸しする
コード例
/claude-api cost-optimize は Claude Code のスラッシュコマンドとして実行します。
# プロジェクトルートで実行
> /claude-api cost-optimize
実行すると、キャッシュ利用率・不要トークン・バッチ化可能なリクエスト・reasoning effort 設定・モデル選択の観点から、1つずつ改善案が提示されるワークフローが始まります。
組織独自の Tips をローテーション配信したい場合、spinnerTipsOverride は以下のような形式で設定します(Before/After)。
// Before: 単純な文字列配列のみ
{
"spinnerTipsOverride": [
"困ったときは /help"
]
}
// After: id・優先度・再表示間隔を制御できる
{
"spinnerTipsOverride": [
{
"id": "org-security-tip-01",
"text": "社内では /claude-api cost-optimize を月次で実行してください",
"cooldownSessions": 10,
"priority": 1
}
],
"tipsFile": "./org-tips.json",
"label": "Acme Corp Tips"
}
まとめ
v2.1.247 は機能追加よりも「事故につながりかねない不具合の是正」に重きが置かれたリリースです。
-
最重要: Bash サンドボックスによる
~/.claude/settings.jsonシンボリックリンク削除バグが修正。dotfile 管理ユーザーは即アップデート推奨 - 要確認: managed settings が読めない場合の起動時終了は破壊的変更。組織管理者は設定配布を事前チェック
-
新機能:
/claude-api cost-optimizeで API コストの段階的最適化、/claude-apiの Admin API 対応で組織管理系操作もカバー - セキュリティ強化: プラグイン名・ターミナルハイパーリンクへのエスケープ/検証強化により、なりすまし・不正リンクのリスクを低減
Claude Code を業務利用している場合は、破壊的変更(change-033)の対象になっていないか、組織のサインイン強制設定を確認したうえでのアップデートをおすすめします。