Claude Codeを始める前に、最初の1日にやっておきたい3つの仕掛け

Last updated at 2026-09-02Posted at 2026-05-13

Claude Codeを始める前に、最初の1日にやっておきたい3つの仕掛け

ターミナルで動くAIアシスタント「Claude Code」を初めて使い始める人――情報系の大学に入った1年生、これからプログラミングを学ぼうとしている高校生、いま家のパソコンに入れてみたばかりの社会人――そういう人に役に立つ話を書きます。

AIに作業を任せると、自分は別のことができます。コードを書き換えたり、ファイルを整理したり、テストを走らせたり。便利ですが、AIは「お願いされた作業」をやろうとするので、たまに、人間が見ていれば止めたであろう命令を、そのまま実行してしまうことがあります。

これを防ぐ仕掛けが、Claude Codeには標準で用意されています。「hook」というしくみです。最初の1日にこれを入れておくと、安心して作業を任せられる範囲が広がります。

この記事では、その中で「最初の1日に入れておくと良い」3つの仕掛けを、コードと一緒に紹介します。

💡 6月15日に予定された課金分離(施行当日に一時停止・再実施に備える)。自動の使用 (claude -p、 GitHub Actions、 SDK) は別の月次の枠に分離される予定だった(現在は一時停止)、公式の値段で消費。 Migration Playbook Edition 2 ($19) で、 Path A / B' / D の判定の手引きと cache の費用の計算の経路を articulate。

hookってなに?

📕 5月22日発売の Claim-Verify Handbook。完了の主張が届くが実態の道具の呼び出しが0件の事例を130件の corpus で整理。 Claim-Verify Handbook (Gumroad、 $19) で章の構造と15件の本文の事例の articulate を扱う。

Claude Codeが何かのツール(ファイルの読み書き、シェルの実行など)を使う直前に、自分が書いた小さなスクリプトを挟み込めるしくみです。

イメージはこんな感じ。

AI「ファイルを書き換えたい」
   ↓
hook(自分が書いたスクリプト)が間に入る
   ↓
スクリプトが内容を見て判断する
   ↓
OKなら通す、危なそうなら止める

挟み込む場所は2つあります。「PreToolUse」はツール実行の前、「PostToolUse」は実行の後。今回紹介する3つは、すべて「PreToolUse」で、実行の前に止める形のものです。

設定の場所は、ホームの中の ~/.claude/settings.json というファイル。スクリプトは、たとえば ~/.claude/hooks/ の下に置きます。これだけ覚えれば、3つとも動きます。

仕掛け1: 認証の鍵のファイルを読み込ませない

ターミナルで開発をしていると、.env という名前のファイルに、APIの鍵やパスワードを書くことがあります。たとえばGitHubの鍵、AnthropicのAPIキー、データベースの接続情報。これらは「家の鍵」みたいなものなので、第三者に渡したくない情報です。

AIに「このプロジェクトのバグを直して」とお願いすると、AIはコードを読み込みます。普通のコードを読む流れで、.env のファイルもうっかり読み込んでしまうことがあります。そうなると、認証の鍵が会話の記録に残ってしまい、その記録を誰かに渡したり、あるいは万一漏れたりしたときに、鍵が一緒に流出する可能性があります。

これを防ぐスクリプトは、こんな感じです。

#!/bin/bash
# 認証関連のファイルへの読み込みを止める
INPUT=$(cat)
TARGET=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
if echo "$TARGET" | grep -qE '\.env($|\.)|credentials|secret'; then
    echo "認証関連のファイルへのアクセスは止めました: $TARGET" >&2
    exit 2
fi
exit 0

これを ~/.claude/hooks/credential-guard.sh という名前で保存し、実行の権限をつけます。

chmod +x ~/.claude/hooks/credential-guard.sh

そして ~/.claude/settings.json に、こんなふうに登録します。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Read|Edit|Write",
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/credential-guard.sh" }
        ]
      }
    ]
  }
}

これで、AIがファイルを読み書きする前に、必ずスクリプトが間に入ります。ファイルの名前に .env や credentials や secret が入っていたら、その読み書きは止まります。

スクリプトの中身は短いので、自分なりに条件を足したり減らしたりできます。「.git/ の中身は読ませない」「ホームの下の .ssh/ は止める」など、自分の環境に合わせて拡張するのも楽しいです。

仕掛け2: 破壊的なシェルコマンドを実行の前に立ち止まらせる

Linuxやmacのターミナルには、「ファイルやフォルダをまとめて消す」コマンドがあります。代表的なのが rm -rf です。これを実行すると、ゴミ箱には入らず、復元もほぼ不可能。

AIが「古い仮の置き場を片付けたい」と思って rm -rf ~/tmp のような命令を出すことがあります。だいたいは問題ないのですが、たまに、人間ならわかる「これは消してはいけないフォルダ」を、AIが判断できずに対象に入れてしまうことがあります。

これを実行の前に止めるスクリプト。

#!/bin/bash
INPUT=$(cat)
CMD=$(echo "$INPUT" | jq -r '.tool_input.command // empty')
if echo "$CMD" | grep -qE 'rm[[:space:]]+-rf|rm[[:space:]]+-fr|rm[[:space:]]+-r[[:space:]]+-f'; then
    echo "破壊的な削除のコマンドを検出しました。" >&2
    echo "対象: $CMD" >&2
    echo "本当に実行してよいなら、自分の手で承認してください。" >&2
    exit 2
fi
exit 0

これを ~/.claude/hooks/destructive-command-guard.sh という名前で保存して、設定に登録。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "~/.claude/hooks/destructive-command-guard.sh" }
        ]
      }
    ]
  }
}

AIが rm -rf の命令を出した瞬間、必ず一度立ち止まります。中身を見て、自分の判断で「進めていい」と思ったら、その場で承認すれば実行されます。「これは止めて」と思ったら、AIに別の方法を指示すれば良いです。

承認の手順を1段挟むだけですが、これがあるとないとで、まあまあ気持ちの落ち着きが違います。

仕掛け3: ファイルを大量に書き換える前に、git の状態を確認する

これは少し違うタイプの仕掛けです。「コマンドを止める」のではなく、「実行する前に、自分の作業の状態を一度立ち止まって確認する」というものです。

AIに「このプロジェクトの全部のファイルでこのライブラリを新しい版にアップデートして」と頼むと、AIは何十個ものファイルを一気に書き換えます。それ自体は便利なのですが、もしその直前に自分が手で書いていた変更があって、まだ git commit していなかったら、AIの書き換えと混ざってしまい、後で「自分のどの変更がどこに行ったか」がわからなくなります。

これを防ぐスクリプトは、Bashコマンドが「複数のファイルへの書き換え」を含むときに、git status の結果を確認させて、未コミットの変更がたくさんあるなら立ち止まる、という形です。

#!/bin/bash
INPUT=$(cat)
CMD=$(echo "$INPUT" | jq -r '.tool_input.command // empty')

# sed や find -exec で複数のファイルを書き換える命令を検出
if echo "$CMD" | grep -qE 'find.*-exec|sed[[:space:]]+-i|xargs.*(sed|rm|mv)'; then
    # 未コミットの変更の数を確認
    if [ -d .git ]; then
        UNCOMMITTED=$(git status --porcelain 2>/dev/null | wc -l)
        if (( UNCOMMITTED > 5 )); then
            echo "未コミットの変更が ${UNCOMMITTED} 件あります。" >&2
            echo "先に git add と git commit をしてからの方が安全です。" >&2
            exit 2
        fi
    fi
fi
exit 0

これを ~/.claude/hooks/git-state-check.sh という名前で保存して、設定に登録(2件目の仕掛けと同じ場所に並べる形)。

AIに大規模な書き換えを頼む直前に、もし自分の手の変更が溜まっていたら、「先にコミットしましょう」というメッセージが出ます。これだけで、「あれ、自分が書いたあの修正はどこに行った?」という事故がぐっと減ります。

自分の環境に合わせて育てていく楽しさ

3つの仕掛けは、それぞれ20行くらいの短いシェルスクリプトです。今のうちに入れておくと、後で「これがあって助かった」と思う場面が来ます。

慣れてくると、自分なりに条件を足したくなります。「特定のフォルダに書き込む時は、特別なメッセージを出す」「シェルコマンドの中に curl が含まれていたら、URLを確認する」「一定の時間の中の使用が多すぎたら警告する」。仕掛けの形は同じで、中身は自分の作業の様子に合わせて少しずつ変えていけます。

このタイプの仕掛けの集まりは、公開の場所でも共有されています。たとえば https://www.npmjs.com/package/cc-safe-setup には、似たような仕掛けが集まっています(MITの公開の権利)。自分で全部書く前に、既にある形を参考にするのも良いと思います。

3つ全部入れるのに、 10分もかかりません。最初の1日に組み込んでおくと、その後の作業の安心感が確実に変わります。

Claude Codeを始める時の最初の数日が、楽しい時間になりますように。

📕 主張と実態の乖離の事例集 (5/22 発売): 道具や作業者が「成功した」と主張するが実態は失敗している事例 130 件 (本文 15 件 + 付録 D 115 件) を整理した事例集を 2026 年 5 月 22 日に発売 (Claim-Verify Handbook、 Gumroad、約 89 頁、英語 19 米ドル)。本記事の最初の 1 日の 3 つの仕掛けは「事故が起きてから直す」ではなく「最初から仕掛けで守る」の体系の入り口で、事例集の 130 件は仕掛けが何を防ぐかの具体の事例集として読める。
📚 月次の事故事例の継続の点検 (Claude Code 安全運用便): Claude Code の事故事例（主張と実態の乖離、子の作業者の境界の不在、課金の枠の引き上げの失敗）を毎月まとめて届ける会員制「Claude Code 安全運用便」(月500円)。仕掛けの集まりを継続して育てるための場。
📖 過去の事故の総括 (Postmortems): 4 月から 5 月の運用の事故の総括は Postmortems、 Gumroad、 4,350 円に納めています。

📅 Claim-Verify Handbook（Gumroad、19米ドル）は、道具が「成功した」「設定した」と報告する裏で実態がずれていた100件以上の失敗を、操作する側の意図・システムの主張・実際の動作の三層で整理した本です。詳しくは Claim-Verify Handbook (Gumroad、$19) を参照してください。
📘 本記事の延長の Zenn の本: 「最初の1日の3つの仕掛け」を整備した次の段で、 800時間の運用で19→85点の整備の全記録を整理した Anthropic公式ガイドにない事故防止が役に立つ場合があります。第3章まで無料で読めます。 2026年5月27日に Chapter 16 (5月の3つの集積) を追加。
📗 まだ Claude Code に慣れていない・自分でコードは書かない方へ: how-to の寄せ集めより、実際に800時間任せて踏んだ失敗を赤字込みで正直に記録した一次体験のほうが回り道を減らせます。非エンジニアがClaude Codeを800時間走らせた——失敗と学びの全記録 (¥800)(はじめにと第2章まで無料)。スキルの設計や使い分けでつまずいたら Claude Code Skills 実践レシピ集 (¥500)(第1章まで無料)も入口に向いています。
本記事の主題の延長で、直接の運用の道具と継続の整理の経路:

毎月の予防の素材: まず無料で試すなら事故防止チェックリストを配っている（報告された事故から作った点検リスト・登録すると破壊的な変更や新しい事故が出た時だけ設定のパッチ付きで知らせる・月に数通・いつでも解除）。もっと踏み込んで最新の事故を毎月追うなら会員制「Claude Code 安全運用便」(月500円)。
過去の事故の corpus (¥4,350): Postmortems の集まり。 130件以上の Claude Code の事故の forensic の記録。
6月15日に予定された課金分離(当日に一時停止・再実施に備える)への備え ($19): Migration Playbook。 47頁の判定の枠組み、留まる・切り替える・混合の経路の articulate。

Claude Code の運用・安全・費用の検証記事は、これからも続けて公開します。note のゆるくさをフォローしておくと、新しい記事を公開したときに通知が届きます(無料)。

ほかにも、800時間の運用データから、トークン消費の削減・複数ベンダー(Claude / Codex / Gemini / Copilot)の並行運用・サブエージェントの沈黙の失敗対策など、テーマ別の手引きを公開しています。気になる人は著者の本の一覧から、価格と評価を見て選べます。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up