SessionStart（セッションスタート）

Claude Codeを少し触ってみて、毎回手で同じ準備コマンドを叩くのに飽きてきた人向け

Claude Codeを使い始めて毎日同じプロジェクトを触っていると、起動するたびに同じ準備動作を手で繰り返しているはず。「cd ~/projects/cooking-blog で移動して、git pull で最新に揃えて、ls drafts/ で書きかけのレシピを見て…」と、私も最初の3週間は毎朝これをやっていた。SessionStart はその「毎朝の儀式」を Claude Code が起動した瞬間に自動で流して、結果を AI が読める形で置いておくための仕組みです。

面白いのは、画面に出した文字列がそのまま AI のコンテキストに混ざる点。echo で「下書き中のレシピは bibimbap.md と ramen.md の2件」と出しておけば、最初のユーザープロンプトを送る前に Claude が既にその情報を知っている状態で会話が始まります。

噛み砕くと「キッチン開店前の仕込み係」

料理屋に例えると、SessionStart は「店を開ける前に冷蔵庫を確認して、今日の仕込みメモをカウンターに置いておく担当者」です。シェフ（Claude）が出社してきたとき、メモを読めば「今日は鶏肉が在庫薄、刺身は午前中の予約3件あり」みたいな状況がすぐ分かる。

逆に SessionStart を仕込んでいないと、シェフは出社するたびに毎回冷蔵庫を見て、予約表をめくって、と毎回同じ確認動作をする。それが「毎回 git pull を手で叩いている状態」と同じです。

画面に何が出るのか（実際の挙動）

言葉だけだと分かりづらいので、実際に SessionStart を仕込んだ Claude Code を起動したときの流れを見ます。フックとして「git pull して、下書き一覧を画面に出す」だけのシェルスクリプトを登録した想定です。

$ claude

[SessionStart hook running...]
draft一覧:
bibimbap.md
ramen.md
napolitan.md

> こんにちは。今日の作業を始めましょう。

「draft一覧:」以下の3行は、フックが画面に出した文字列。これがそのまま AI に渡されている。だから次に私が「下書きで止まってるビビンバを仕上げよう」と打つと、Claude は既に bibimbap.md の存在を知っていて、いきなり中身を読み始めます。

これがミソ。draft一覧 を伝える会話のラリーが消える。

「料理ブログ cooking-blog」を例に、4ステップで仕込む

Hugo（静的サイト生成ツール）で作っている料理ブログを題材に、SessionStart を実際に動かしてみます。やりたいのは3つ。「作業フォルダに移動」「最新の変更を取り込む」「下書き一覧を画面に出す」。

ステップ1: フック本体のシェルスクリプトを書く

プロジェクトの直下に .claude/hooks/ フォルダを作って、session-start.sh という名前で次の内容を保存します。

#!/bin/bash
cd ~/projects/cooking-blog
git pull --quiet
echo "===== cooking-blog セッション準備 ====="
echo "現在ブランチ: $(git branch --show-current)"
echo ""
echo "下書き中のレシピ:"
ls drafts/ 2>/dev/null || echo "（drafts フォルダが空）"

保存したら忘れずに実行できる状態にします。

$ chmod +x .claude/hooks/session-start.sh

ステップ2: settings.json にフックを登録する

同じプロジェクトの .claude/settings.json を開いて、hooks.SessionStart の項目を足します。matcher を書かなければ、起動・再開・/clear 後・会話圧縮後の全パターンで走ります。

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/session-start.sh"
          }
        ]
      }
    ]
  }
}

ステップ3: Claude Code を起動して動作を見る

cooking-blog フォルダ直下で claude を叩くと、最初のプロンプトを打つ前にフックが走って、画面に下書き一覧が表示されます。

$ cd ~/projects/cooking-blog
$ claude
===== cooking-blog セッション準備 =====
現在ブランチ: main

下書き中のレシピ:
bibimbap.md
napolitan.md
ramen.md

>

ステップ4: AI が情報を覚えているか確認する

そのまま「いま下書きで止まっているレシピを1つ仕上げたい。どれが良さそう？」と打つと、Claude は3つのファイル名を既に知っている前提で答えてきます。ls drafts/ を AI 側に打たせる必要がない。

ここで初心者がやりがちな勘違いがあります。「画面に出てる文字は AI に渡らないんじゃないの？」と思いがちですが、SessionStart については逆。**標準出力に出した文字がそのまま AI のコンテキストに追加される**のがこのフックの一番の特徴です。

仕組みをもう少し正確に

SessionStart は4種類のきっかけで発火します。matcher でどのきっかけだけに絞るかを選べる。公式が定義している値は以下の通り。

フックに渡される入力データ（JSON形式）には次のフィールドが入っています。

{
  "session_id": "abc123",
  "transcript_path": "/Users/.../00893aaf-19fa-41d2-8238-13269b9b3ca0.jsonl",
  "cwd": "/Users/me/projects/cooking-blog",
  "hook_event_name": "SessionStart",
  "source": "startup",
  "model": "claude-sonnet-4-6"
}

source の値が「今回はどのきっかけで起動したか」を教えてくれる。matcher なしで全パターンで走らせつつ、スクリプト側で source を見て分岐する書き方もあります。

もう1つ覚えておきたい挙動。フック側で echo で画面に出すだけでも AI に渡せますが、もっと構造的に渡したい場合は次の形のJSONを画面に出します。

{
  "hookSpecificOutput": {
    "hookEventName": "SessionStart",
    "additionalContext": "現在ブランチ: main\n下書き: bibimbap.md, ramen.md"
  }
}

この additionalContext に書いた文字列が、最初のプロンプトの直前に「システムリマインダー」として AI に挿入されます。チャット欄には表示されないけど、AI の判断には影響する。

つまり SessionStart は何をしてくれるのか

• やってくれる: セッション開始時に毎回同じ準備コマンドを自動実行し、結果を AI に渡す（git pull、ファイル一覧、ブランチ確認など）
• やってくれる: 起動・再開・/clear後・会話圧縮後の4タイミングそれぞれを区別して処理を変える
• やってくれない: セッション終了時の片付け（それは別の SessionEnd フックの仕事）
• やってくれない: ツール実行の前後に走らせる処理（PreToolUse / PostToolUse の担当）
• 意味が薄い場面: 1人で1つのプロジェクトしか触らず、毎回同じ準備が要らない使い方

使いどころ3シナリオ

シナリオ1: 料理ブログで「下書き棚卸し」を毎朝自動化

Hugo製の料理ブログを毎日少しずつ書いていると、「今どのレシピが下書きで止まっているか」を毎回 ls drafts/ で確認するのが地味にめんどくさい。SessionStart に ls drafts/ && cat drafts/*.md | head -20 みたいに仕込んでおけば、起動と同時に「下書き一覧 + 各下書きの先頭20行」が画面と AI コンテキストに出ます。「napolitan の続きを書こう」と言うだけで、Claude が冒頭を覚えた状態で続きを書き始める。

シナリオ2: 複数人プロジェクトで「最新の同期」を強制

料理ブログをパートナーと2人で書いている場合、作業を始める前に相手の変更を取り込んでいないと、コミット時に衝突する。SessionStart に git pull --rebase を仕込んでおけば、「git pull 忘れて作業始めた問題」を構造的に潰せる。私がレシピを書き始める前に Claude も「最新のブランチ状態」を把握できる状態になる。

シナリオ3: 起動時の設定値（環境変数）を毎回読み直す

Hugo は HUGO_BASEURL という設定値で「公開時のURL」を切り替える。本番用と下書きプレビュー用で値が違う。SessionStart で echo "export HUGO_BASEURL=https://cooking-blog.local" >> "$CLAUDE_ENV_FILE" と書いておくと、そのセッション中に Claude が hugo server を叩いたときに正しい設定値が効いた状態で起動する。設定値を毎回手で読み込ませる手間が消えます。

初心者が踏みやすい落とし穴

• 画面に大量出力するとコンテキストを汚す。git pull のログを --quiet なしで流したり、ls -la でファイルを200個出したりすると、その全部が AI に渡って、肝心の本題を考える余地が削られる。出すのは「AI に知っておいてほしい要点」だけに絞る。
• /clear でも発火するのを忘れる。会話の途中で /clear を叩くと、SessionStart がもう一度走る。「起動時に1回だけやればいい処理」を書くと、/clear のたびに走って二重実行になる。matcher: "startup" で絞るか、スクリプト側で source を見て判断する。
• SessionEnd と対になっていない。SessionStart で npm run dev のような長時間プロセスを起動しても、終了時に止める仕組みは別途 SessionEnd フックを書かないといけない。バックグラウンドで走らせっぱなしにしない。
• cwd はセッション開始時の場所で固定。起動した瞬間のフォルダ位置が cwd として渡される。会話中に Claude が cd で別フォルダに移動しても、cwd の値は更新されない。スクリプト側で「今いるフォルダ」を知りたいときは pwd を都度叩き直す。
• 10分以上かかる処理は止められる。command 型のフックには10分のタイムアウトがある。重い git clone や npm install を SessionStart に置くと、終わる前に切られる。重い処理は別の手動コマンドに逃がす。
• --bare 起動ではフックがスキップされる。テスト用に claude --bare で起動するとフックは動かない。「あれ、フックが走らない」と慌てる前に、起動コマンドの後ろに何を書き足したかを確認する。
• ツール実行の判定ロジックを使い回せない。SessionStart には PreToolUse のような tool_name や tool_input が渡されない。「Bash ツールが叩かれたら〜」みたいな判定は SessionStart では成立しない。きっかけが違うフックだと割り切る。

書き方

.claude/settings.json の hooks.SessionStart に登録する。matcher を書かなければ全きっかけ（起動・再開・/clear後・compact後）で走る。matcher に startup / resume / clear / compact のどれかを書けば、そのきっかけだけに絞れる

やってみるとこうなる

入力

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/session-start.sh"
          }
        ]
      }
    ]
  }
}

出力例

$ claude
===== cooking-blog セッション準備 =====
現在ブランチ: main

下書き中のレシピ:
bibimbap.md
napolitan.md
ramen.md

>
（この『下書き中のレシピ』3行がそのままAIのコンテキストに追加されるので、次のプロンプトで『下書きを仕上げよう』と言えばClaudeが3つのファイル名を既に把握した状態で答えてくる）

関連項目

• PreToolUse（プリツールユース）
• PostToolUse（ポストツールユース）
• Hooks（フックス）
• settings.json（セッティングス・ジェイソン）
• CLAUDE.md

公式ドキュメント

https://code.claude.com/docs/en/hooks