Claude Code v2.1.69：100以上の変更を含む過去最大のリリース

Claude Code v2.1.69は2.1.xシリーズ最大のアップデートです。新しい/claude-apiスキル、InstructionsLoadedフック、${CLAUDE_SKILL_DIR}変数、10の新しい音声言語、エージェントのworktree分離、大幅なメモリ/パフォーマンス改善を含みます。

2026年3月4日 • 10 min read • 著者：ClaudeWorld

Claude Code v2.1.69は、2.1.xシリーズ全体で最大の単一リリースであり、新機能、セキュリティ強化、バグ修正、パフォーマンス最適化にわたる100以上の個別変更を含んでいます。これは増分的なパッチではなく、フックシステムとスキルアーキテクチャからメモリ管理、MCP認証、VS Code拡張機能に至るまで、製品のほぼすべてのレイヤーに手を入れた画期的なアップデートです。スキルを構築する開発者、エンタープライズデプロイメントを管理する管理者、あるいは単に日常的にターミナルでClaude Codeを使用するユーザーのいずれであっても、このリリースには重要な変更が含まれています。

新しい開発者向け機能

/claude-api スキル

今回の目玉機能は、/claude-apiで呼び出せる新しいビルトインスキルです。Claude APIとAnthropic SDK上にアプリケーションを構築する開発者向けに設計されています。ドキュメントのタブとエディタを切り替える代わりに、APIコールのスキャフォールディング、ストリーミングレスポンスの処理、ツール使用ペイロードの管理、SDK統合の問題デバッグを、アプリケーションコードを書いているのと同じセッション内で行えるようになりました。

InstructionsLoaded フックイベント

InstructionsLoadedという新しいライフサイクルフックが追加されました。Claude CodeがCLAUDE.mdファイルまたは.claude/rules/*.md配下のルールファイルを読み込むたびに発火します。これにより高度な自動化が可能になります。命令ファイルが解析された瞬間に、プログラムで検証、変換、またはログ記録を行えます。後述するHTTPフックの新しいサポートと組み合わせることで、監査や分析のために命令メタデータを外部サービスに送信することが容易になります。

${CLAUDE_SKILL_DIR} 変数

スキルが実行時に${CLAUDE_SKILL_DIR}変数を使用して自身のディレクトリを参照できるようになりました。以前は、関連ファイルやテンプレートを読み込む必要があるスキルは、パスをハードコードするか脆弱な相対パスに依存する必要がありました。この変数により、スキルのSKILL.mdからコンパニオンスクリプト、データファイル、テンプレートをポータブルに参照できます。スキルがどこにインストールされていても問題ありません。

エージェントとフックのID

フックイベントにagent_idとagent_typeフィールドが含まれるようになり、フックハンドラがどのエージェントがイベントをトリガーしたかを識別できるようになりました。これは、同じフックインフラストラクチャを共有しながら異なる処理ロジックを必要とする複数の専門エージェント（例：コードレビューエージェントとテスト生成エージェント）を実行するチームにとって不可欠です。

HTTP フック

シェルコマンドフックに加えて、URLにJSONペイロードをPOSTするフックを定義できるようになりました。フックロジックが既にWebサービス、サーバーレス関数、または内部Webhookレシーバーに存在する場合、ローカルラッパースクリプトが不要になります。

エージェントの宣言的Worktree分離

エージェント定義でisolation: worktreeがサポートされ、エージェントが独自のGit worktree内で実行されるようになりました。メインのチェックアウトに影響を与えることなくクリーンな作業ディレクトリが提供されます。探索的なリファクタリング、破壊的なテストスイートの実行、またはプライマリブランチに触れるべきでない一時的なコード生成を行うエージェントに最適です。

音声とアクセシビリティ

音声の音声認識サポートが、このリリースで10言語から20言語に倍増しました。新たに追加された10言語は以下の通りです：

言語言語
ロシア語ギリシャ語
ポーランド語チェコ語
トルコ語デンマーク語
オランダ語スウェーデン語
ウクライナ語ノルウェー語

この拡張により、母国語でプロンプトを口述することを好む開発者にとってClaude Codeの利便性が大幅に向上し、音声駆動ワークフローを採用する国際チームの障壁が低くなります。

設定とプラグイン管理

管理者やパワーユーザーがClaude Codeの動作をより細かく制御できる新しい設定が追加されました：

設定用途
sandbox.enableWeakerNetworkIsolationカスタムプロキシメカニズムを使用するGoベースのCLIツール（gh、gcloud、terraform）がmacOSサンドボックス内で機能できるようにする
includeGitInstructionsビルトインのコミットおよびPRワークフロー指示のオン/オフを切り替え。チームがCLAUDE.md経由で独自のGit規約を提供している場合に有用
pluginTrustMessageマネージド環境でプラグインが信頼承認を要求する際に表示されるカスタムメッセージ
oauth.authServerMetadataUrlMCPサーバー用のOpenID Connect / OAuth検出URLを指定し、フェデレーション認証セットアップを簡素化
strictKnownMarketplaces内のpathPatternプラグインマーケットプレイスの信頼境界に対するきめ細かいパスマッチング

その他のQOL改善：

  • /reload-pluginsコマンド — セッションを再起動せずにプラグイン設定の変更を適用できます。
  • プラグインソースタイプgit-subdir — リポジトリのルートだけでなく、Gitリポジトリ内のサブディレクトリからプラグインをインストールできます。
  • MCP OAuthの手動URLペーストフォールバック — 自動ブラウザフローが失敗した場合、コールバックURLを手動で貼り付けて認証を完了できるようになりました。
  • UI上のエフォートレベル表示 — ロゴとスピナーに現在のエフォート設定（例：「低いエフォートで」）が表示されるようになり、Claudeがどの程度思考しているかを常に把握できます。

セキュリティ修正

このリリースでは、詳細を理解する価値のある4つのセキュリティ問題を修正しています：

gitignoreされたディレクトリ内のネストされたスキル検出。 以前は、Claude Codeの再帰的スキルスキャナーが.gitignoreにリストされているディレクトリ（node_modulesなど）にも降下する可能性がありました。悪意のあるまたは設定ミスのパッケージが、サイレントに読み込まれるSKILL.mdを注入できる状態でした。スキル検出時にスキャナーが.gitignoreルールを尊重するようになりました。

信頼ダイアログによる全MCPサーバーの有効化。 初回実行時の信頼ダイアログが、サーバーごとの明示的な同意なしに.mcp.jsonで定義されたすべてのサーバーをサイレントに有効化する可能性がありました。各サーバーが個別の承認を必要とするように修正されました。

親ディレクトリ書き込みのシンボリックリンクバイパス。 巧妙に構築されたシンボリックリンクの親ディレクトリにより、サンドボックス化された書き込み操作がワーキングディレクトリの境界を超えて脱出できる可能性がありました。サンドボックスはパス権限を評価する前にシンボリックリンクを解決するようになりました。

ワークスペースの信頼なしでのフックコマンド実行。 statusLineとfileSuggestionのフックコマンドは、ワークスペースに信頼が付与されていなくても実行可能でした。これらのコマンドは、他のすべてのフックタイプと同じ信頼チェックの背後に配置されました。

主要なバグ修正

このリリースには50以上の個別のバグ修正が含まれていますが、以下は最も影響の大きい修正です：

メモリと安定性

  • Agent Teamsのメモリリーク。 完了したチームメイトがガベージコレクションされず、多くのエージェントを生成する長時間実行セッションで無制限のメモリ増加を引き起こしていました。完了したエージェントは速やかにクリーンアップされるようになりました。
  • コミット時の数GBのメモリスパイク。 大きな未追跡バイナリファイルを含むリポジトリでコミットをステージングする際、Claude Codeがそれらのファイルをdiffバッファに読み込んで数GBのメモリを消費する可能性がありました。diffロジックが未追跡バイナリをスキップするようになりました。
  • React CompilerのmemoCacheリーク。 React Compilerの統合で使用されるメモ化キャッシュがエントリを解放せず、長時間のセッション中に徐々にメモリが膨張していました。
  • REPLのレンダースコープリーク。 REPL評価中に作成されたレンダースコープが破棄されず、時間の経過とともに蓄積されていました。
  • フックイベントの蓄積。 発行されたフックイベントが内部リストに無期限に保持されていました。配信後に解放されるようになりました。

プラットフォーム固有

  • macOSキーチェーンの破損。 複数のOAuth認証済みMCPサーバーを実行するとmacOSキーチェーンのエントリが破損し、手動クリーンアップが必要になる可能性がありました。トークンストレージがサーバーごとに分離されたキーチェーンアイテムを使用するようになりました。
  • Linuxでのゴーストdotファイル。 Linuxでサンドボックス化されたBashコマンドが完了した後、ファントムdotファイル（例：.bash_history）がワーキングディレクトリに出現する可能性がありました。サンドボックスのクリーンアップルーチンがこれらのアーティファクトを削除するようになりました。
  • Windowsでのリテラルnulファイル。 特定の操作がWindows NULデバイスへの書き込みの代わりに、文字通りnulという名前のファイルを作成していました。パス処理がWindowsのnullデバイスを正しく識別するようになりました。
  • Windowsでの並行設定書き込み。 設定ファイルへの同時書き込みが破損したJSONを生成する可能性がありました。ファイル書き込みがアトミックなリネーム・オン・クローズを使用するようになりました。

MCPと認証

  • OAuthトークンリフレッシュの競合状態。 複数のMCPリクエストが同時にトークンリフレッシュをトリガーした場合、競合するリフレッシュの試みが互いのトークンを無効化する可能性がありました。リフレッシュ操作がサーバーごとにシリアライズされるようになりました。

エージェントとスキル

  • チームメイトがネストされたチームメイトを生成。 特定の条件下で、エージェントチームメイトが独自のネストされたチームメイトを誤って生成し、エージェントの暴走的な増殖を引き起こす可能性がありました。チームメイトエージェントがさらなるチームメイトを生成することが防止されました。
  • コロンを含むスキルの説明。 descriptionフィールドにコロン文字を含むSKILL.mdファイルが解析に失敗していました。YAMLパーサーがdescription値のコロンを正しく処理するようになりました。

パフォーマンス改善

v2.1.69のパフォーマンス作業は異例の広範囲にわたり、メモリフットプリント、レンダリング速度、ネットワーク効率を対象としています。

改善内容影響
Yoga WASMの遅延読み込みベースラインメモリを約16MB削減
スピナーアニメーションループの分離スピナーがUI全体を再レンダリングする代わりに専用の50msタイマーで動作
React Compilerの統合自動メモ化によりUI全体の不要な再レンダリングを削減
コンパクション時の画像保持によるプロンプトキャッシュコンパクションされた会話に画像コンテンツが含まれる場合のキャッシュミスを削減
MCPバイナリコンテンツのディスク保存デコードされたバイナリペイロードがメモリに保持される代わりに一時ファイルに書き込み
プロンプト入力の再レンダリング削減プロンプト入力コンポーネントの再レンダリングサイクルを約74%削減
起動時のメモリ削減初期化時に約426KBを節約
Remote Controlのポーリングレート削減ポーリング頻度を約300分の1に削減し、アイドル状態のリモートセッションのCPUおよびネットワークオーバーヘッドを大幅に低減

これらの変更を合わせると、長時間実行されるClaude Codeセッションが顕著にレスポンシブかつ軽量になります。特に複数のエージェントやチームメイトがアクティブなマシンで効果的です。

VS Code拡張機能

VS Code統合がこのリリースでいくつかの注目度の高い改善を受けています：

  • Sparkアイコンのセッションリスト。 アクティビティバーの新しいSparkアイコンにより、セッション履歴に素早くアクセスでき、フルパネルを開かずに会話を切り替えることが容易になりました。
  • コメント付きフルMarkdownプランビュー。 Claudeが生成したプランがインラインコメントサポート付きのフルMarkdownとしてレンダリングされ、エディタ内で直接より豊かなレビュー体験を提供します。
  • ネイティブMCPサーバー管理（/mcp）。 MCP サーバー接続を管理する専用ダイアログが、以前の手動設定ワークフローに代わります。JSONファイルを編集せずにサーバーの追加、削除、認証が可能です。
  • コンパクション表示を折りたたみ可能なカードに。 会話がコンパクションされた際、コンパクションサマリーがテキストの壁ではなく折りたたみ可能なカードとして表示され、チャットビューをクリーンに保ちます。
  • RTLテキストレンダリングの修正。 右から左に書く言語（アラビア語、ヘブライ語など）がチャットパネルで正しくレンダリングされるようになり、これらの言語で作業する開発者にとって長年の表示問題が修正されました。

アップデート方法

Claude Code v2.1.69にアップデートするには：

  1. claude --versionで現在のバージョンを確認
  2. npm install -g @anthropic-ai/claude-code@latestまたはお好みのパッケージマネージャーでアップデート
  3. アクティブなClaude Codeセッションを再起動してすべての変更を適用
  4. MCP OAuthを使用している場合、キーチェーンとトークンリフレッシュの修正を適用するためにサーバーを再認証
  5. .claude/ディレクトリを確認し、gitignoreされたパスから読み込まれたスキルがないか確認 — セキュリティ修正により検出されるスキルが変わる可能性があります

このリリースの規模を考えると、新しい/claude-apiスキルの探索、カスタムスキルでの${CLAUDE_SKILL_DIR}変数のテスト、新しいInstructionsLoadedイベントでフック設定が期待通りに動作するかの確認に数分を費やす価値があります。

リンク