Claude Code Starter (Free)

動く設定ファイル一式 で、Claude Code を「安全に・無人でも」回すための最小スターター。 解説記事ではなく、そのままコピーして使える .claude/ の実物を配布します。

このスターターは飾りではありません。このリポジトリ自身が、ここで配っている guard-dangerous-bash.sh フックを噛ませた無人スケジュールタスクによって整備・公開されています。「読む内容」と「その内容が実際に動いている実物」が同じ — それがこのプロジェクトの立ち位置です。

何が入っているか

ファイル	役割
presets/settings.dev.json	日常開発向け permissions プリセット。編集・テスト・コミットは無確認、push / rm / ネットは確認を挟む
hooks/guard-dangerous-bash.sh	危険な Bash コマンド（rm -rf /・sudo・force push 等）を環境の強制力でブロックする PreToolUse フック
hooks/README.md	フックの配線ガイド（settings.json への組み込み方・デバッグ手順）
CLAUDE.md.template	毎セッション読まれる CLAUDE.md の雛形。埋めるだけで「指示が一行で済む」状態になる

なぜ permissions と hooks を分けるのか

• permissions は「何を許可/確認/拒否するか」の宣言。速いが、宣言の穴はすり抜けられる。
• hooks は「毎回必ず実行される環境の強制力」。プロンプトで「危険なことはしないで」と頼むのは守られたり守られなかったりするが、exit 2 を返すフックは毎回必ず止める。

無人運転では、この2つを二重の壁にしておくのが前提です。deny は保険ではなく前提。

クイックスタート

# 1. あなたのリポジトリのルートで
mkdir -p .claude/hooks

# 2. プリセットを settings.json として配置
cp path/to/presets/settings.dev.json .claude/settings.json

# 3. ガードフックを配置して実行権限を付与
cp path/to/hooks/guard-dangerous-bash.sh .claude/hooks/
chmod +x .claude/hooks/guard-dangerous-bash.sh

# 4. CLAUDE.md を用意（雛形の <...> を自分のプロジェクトに合わせて埋める）
cp path/to/CLAUDE.md.template CLAUDE.md

そして .claude/settings.json にフックを配線します（詳細は hooks/README.md）:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command", "command": "$CLAUDE_PROJECT_DIR/.claude/hooks/guard-dangerous-bash.sh" }
        ]
      }
    ]
  }
}

動作確認（30秒）

echo '{"tool_input":{"command":"sudo rm -rf /"}}' | .claude/hooks/guard-dangerous-bash.sh; echo "exit: $?"
# → BLOCKED ... と表示され exit: 2 が返れば正常

exit 2 のとき stderr の内容が Claude にフィードバックされ、Claude は理由を読んで別の手を考えます。ただ止めるだけでなく「なぜ止めたか」を伝えるのがコツです。

実戦運用ガイド（有料版）

このスターターは、実際に無人運転で使っている資産パックの一部です。フルセットには以下が含まれます:

• permissions プリセット 3段階（safe 調査専用 / dev 日常開発 / auto 無人運転）
• フック 3本（危険コマンドのブロック + 編集時オートフォーマット + セッションログの自動追記）
• 無人スケジュールタスクの組み方・事故らないための設計と、--target 一発で導入する install.sh
• サブエージェント / スキル / MCP テンプレート

👉 実戦運用ガイド（有料本）は公開中です。

📖 『Claude Code 実戦運用ガイド ― 動く設定・Hooks・無人運転』（全9章 / Zenn） 　→ https://zenn.dev/keithval/books/claude-code-ops-guide

いまは 先行価格 で公開しています（章の追記に合わせて値上げ予定）。掲載コードはすべて実際に動かして検証したもので、この本自体が本書で解説する無人スケジュールタスクによって整備・改訂されています。

更新の告知は本リポジトリの Releases と、著者ページ（note / GitHub）でも行います。⭐ Star しておくと更新に気づけます。

ライセンス

MIT License（LICENSE 参照）。あなたのプロジェクトに自由に組み込んで構いません。