セットアップフックで初期化・メンテナンス処理を行いたい

コマンド / 機能

Setup（matcher: init / maintenance）

claude -p --init / --maintenance で起動

概要

Setup フックは claude -p --init または claude -p --maintenance で起動された時に発火するフックです。matcher に init を指定すると初回セットアップ時、maintenance を指定すると定期メンテナンス実行時にだけフックを絞り込めます。CI や自動化環境で環境構築・依存関係の更新などを標準化するのに使います。

設定例

// .claude/settings.json
{
  "hooks": {
    "Setup": [
      {
        "matcher": "init",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/setup-init.sh"
          }
        ]
      },
      {
        "matcher": "maintenance",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/setup-maintenance.sh"
          }
        ]
      }
    ]
  }
}

// 起動コマンド例
claude -p --init "初回セットアップを実行して"
claude -p --maintenance "依存関係を最新化して"

// setup-init.sh の例
#!/bin/bash
npm install
cp .env.example .env

公式ドキュメントを見る