Claude Code v2.1.10 — リポジトリ初期化・メンテナンスをSetup Hookで扱えるように

このリリースで何ができるようになるか

Claude Code v2.1.10は、Hookが扱えるライフサイクル段階を「セッション中」から「リポジトリ初期化・メンテナンス」へ広げた小粒パッチです。

• 新しい Setup Hookイベントが追加: --init / --init-only / --maintenance CLIフラグでトリガーでき、初期化・メンテナンス処理をClaude Codeの設定群と同じ場所で管理できます
• ログイン時にキー c でOAuth URLをクリップボードにコピー: ブラウザが自動起動しないリモート / コンテナ環境でログイン失敗を回避
• heredoc内JavaScriptテンプレートリテラル(${index + 1})でクラッシュする問題を修正
• REPL起動前のキーストロークが取りこぼされる問題を修正
• ファイル候補が「テキスト挿入」から「削除可能な添付」扱いに変更: プロンプト本文を膨らませずに済みます
• VSCode拡張にプラグインのインストール数表示と信頼警告を追加

あなたの開発フローはどう変わるか

チームで .claude/ テンプレートを配布しているチーム

新しい Setup Hookを --init / --init-only / --maintenance の各フラグに紐付けられるようになりました。

これまでリポジトリ初期化のカスタマイズはシェルスクリプトで外付けすることが多かったところ、Setup HookにまとめればClaude Codeの設定ファイル群と同じ場所で管理できます。--init-only はCIでも走らせやすく、PRで .claude/ 配下の雛形が壊れていないかを初期化の完走可否で判定する簡易チェックに使えます。

リモート / コンテナ / WSL環境でClaude Codeを使う人

ブラウザが自動起動しない環境では、ターミナルに表示されたOAuth URLを手でコピーする必要があり、長いURLの = や & を巻き込みそこねるトラブルが発生していました。本版ではキー c でクリップボードにコピーできます。リモート開発環境でのログイン成功率が体感で上がる種類の改善です。

bashでheredoc + JavaScriptを多用する人

bashのheredoc内にNode.jsコードを書く場面で、${index + 1} のようなJavaScriptテンプレートリテラルが含まれているとClaude Code側のパーサがクラッシュしていた問題が修正されました。「Node.jsスクリプトをheredocで流して実行して」という運用がそのまま通るようになります。

起動直後から打鍵を始める人

Claude Code起動直後、プロンプト表示前に打鍵すると最初の数文字が欠落することがあった問題が解消されました。シェルでは当たり前の「先行入力」がREPL起動時にも効くようになります。

コンテキスト管理を意識する人

ファイル補完で選んだファイルが、これまではテキストとしてプロンプト本文に挿入されていました。本版以降は削除可能な添付として扱われます。

VSCode拡張でプラグインを使う人

プラグイン一覧にインストール数が表示されるようになり、インストール時に信頼警告が出るようになりました。プラグイン選定の判断材料が増え、未知の配布元のコードを取り込む前に一歩立ち止まる導線が入ります。

主な変更点

Hookの拡張

• Setup Hookイベント追加: --init / --init-only / --maintenance CLIフラグでトリガー

ログインUX

• OAuth URLコピーショートカット: キー c でクリップボードにコピー(ブラウザが自動起動しない場合用)

バグ修正

• heredoc + JavaScriptテンプレートリテラルでクラッシュする問題を修正
• REPL起動前のキーストローク取りこぼしを起動処理側でバッファするよう修正

UI / UX

• ファイル候補の扱い: テキスト挿入から削除可能な添付に変更
• VSCode拡張: プラグインリストにインストール数表示
• VSCode拡張: プラグインインストール時の信頼警告を追加

Setup Hookが運用パイプラインに開く3つの接合点

Setup Hookの追加は単独では地味ですが、Claude Codeの実行形態を「セッション起動」以外にも正式に広げる仕掛けです。3つの観点で意味を捉え直します。

1. リポジトリ配布物としての .claude/ の再評価

Skill / エージェント / スラッシュコマンド / settings.json は、リポジトリに同梱される「配布物」の性格を帯びています。Setup Hookを --init に紐付けられることで、配布物が初回インストールされる瞬間の挙動をHook越しに差し込めるようになります。

2. メンテナンス実行を「自動化の対象」として扱える

--maintenance 経由の Setup Hookは、定期的に走らせたいメンテナンスの置き場として有力です。週次でキャッシュをクリーンアップする、月次でallowlistを再検査する、Skillのfrontmatterが古い規格を使っていないか点検する、といった運用負債のたまる処理を仕組みに寄せられます。

3. CI/CDとの接合点が増える

--init-only はCIで走らせやすい形です。PRごとに .claude/ 配下の雛形が壊れていないかを初期化の完走可否で判定できます。Setup Hookをここに噛ませると、CIのログにHook実行結果を残せる副産物も付いてきます。

前後版との位置付け

v2.1.0で「フックを書ける場所」を広げ、本版で「フックで扱える段階」を広げる、という流れになっています。Setup のようなAPI拡張が小粒パッチの中に静かに入ってくるのが、Claude Codeの現在の開発リズムの特徴です。

まとめ

• .claude/ テンプレート配布チーム: Setup Hookで初期化・メンテナンスを標準化する設計を見直す価値があります
• リモート / コンテナ / WSL環境: OAuth URLコピーショートカットでログイン失敗が減ります
• bash heredoc + JavaScript利用: クラッシュ修正でNode.jsワンライナー運用が安定します
• 起動直後から打鍵する人: REPL起動時のキー取りこぼし解消で体感が変わります
• コンテキスト管理を意識する人: ファイル補完が添付扱いになり、プロンプト本文が膨らみません

派手ではないものの、Hookが触れる範囲を広げた節目のリリースです。チーム配布の .claude/ を持っているなら、Setup Hookを起点に運用パイプラインを再設計できる版です。