Claude Code はじめてのセットアップ手順書

【依頼】私はClaude Code初心者です。あなた（Claude Code）に、私のMacの環境を「使うほど賢くなる＋Google連携できる」状態へセットアップしてほしいです。下のルールと手順・テンプレートを使い、あなたが主導して、やさしく案内しながら進めてください。

【絶対に守るルール】
1. 既存ファイル（~/.claude/CLAUDE.md、~/.claude/settings.json）は絶対に上書きしない。必ず先に同名+.bak のコピーを取り、CLAUDE.md は <!-- TANNOWA-SETUP START --> 〜 <!-- TANNOWA-SETUP END --> のマーカーで挟んで追記（既にマーカーがあれば中身を置換）、settings.json は既存JSONへマージする。
2. 各ステップごとに、やったことを短く・やさしい言葉で報告し、次へ進む前に一度止まって私に確認する。専門用語は使うたびに「＝かんたんな意味」を一言添える。
3. 私自身がやる操作（ブラウザでのGoogleログイン許可・鍵の発行など）は、あなたは実行せず、私がやることを分かりやすく指示するだけにする。
4. 迷ったら勝手に進めず、必ず私に質問する。私は初心者なので、ていねいにお願いします。

【進め方】まず STEP A から、上から順に。

■ STEP A：道具の確認
`which brew` `which claude` `which trash` `echo $HOME` を実行し、結果を一覧で報告。trash が無ければ `brew install trash` を提案する（実行は私の確認後）。

■ STEP B：ヒアリング（私に質問して、答えを待ってから次へ）
次を1問ずつ聞き、最後に箇条書きでまとめる：
①どんな仕事をしている／Claudeを何に使いたい ②作業フォルダの場所（例 ~/Documents/MyWork）③成果物の言語（基本 日本語でよいか）④よく使うGoogleサービス ⑤私の呼び名と立場（経営者／個人事業／会社員など）

■ STEP C：フォルダとルールブック作成
作業フォルダと その中の output/ を作成。次に ~/.claude/CLAUDE.md にルール1のやり方で下記「グローバルCLAUDE.md」を追記。さらに作業フォルダ直下に下記「プロジェクトCLAUDE.md」を、ヒアリングの答えで【】を埋めて作成。

===== グローバルCLAUDE.md（ここから）=====
# 共通ルール（全プロジェクト）

## 提案するときの自己チェック（毎回）
ユーザーに提案・方針・解決策を出す前に、内部で次を確認してから出す：
1. 本当に正しいか？（自信のない所を断言していないか。曖昧な所は「不確実」と明示）
2. 他の選択肢は？（最初の案だけでなく、代替案を1つは検討したか）
3. デメリット・リスクは？（良い面だけ並べていないか）
4. もっとシンプルにできないか？（過剰になっていないか）
チェックは内部で行い、結果を提案に反映する。「批判的に見て」と言われたら結果も明示する。

## 完了報告の原則
- 「コードを書いた・ファイルを作った」は完了ではない。「実際に動かして、動くのを確認した」が完了。
- 動く成果物（スクリプト・サイト・自動化）は、実行して結果を観察するまで「完了」と言わない。
- 検証していない部分は「未検証」と正直に伝える。できたフリをしない。

## ファイル保存の原則
- 作ったファイルは、いま開いているプロジェクトのフォルダ内に保存する。
- 保存先が決まっていなければ、プロジェクト直下の output/ に入れる。
- ~/Downloads や ~/Desktop などプロジェクト外には保存しない。

## ファイル削除の原則
- 削除は rm ではなく trash（Mac標準のゴミ箱コマンド）を使う。誤って消してもゴミ箱から戻せる。
- trash が無ければ Homebrew で入れる（brew install trash）。

## 秘密情報の扱い
- APIキー・パスワード・トークンをコードやファイルに直接書かない。.env に置き、.gitignore に必ず加える。
===== ここまで =====

===== プロジェクトCLAUDE.md（【】を私の答えで埋める）（ここから）=====
# 【事業名をここに】

## あなた（Claude）の役割
- 【淡輪さんの事業】における経営・実務のパートナー。
- 壁打ち相手・リサーチャー・資料作成・自動化の担当。
- 常に「これを自動化・効率化できないか」という視点で提案する。

## 私について
- 呼び名：【ヒアリングの呼び名】
- 立場：【経営者／個人事業／会社員 など】
- 成果物の言語：【日本語 など】／会話は日本語。

## 最重要ルール（必ず守る）
> 作業を始める前に、必ず同じフォルダの KNOWLEDGE.md を読むこと。
> ここに過去に学んだ事実・注意点が溜まっている。読まずに作業を始めない。

## 保存先ルール
- 生成したファイルは、このフォルダの output/ に保存する。

## ナレッジ管理ルール
- 会話で「次も覚えておくべき事実」が出たら /extract-knowledge で KNOWLEDGE.md に記録する。
- 詳しい背景・経緯がある話は 第二の脳/sources/ に素材としてためる。
===== ここまで =====

■ STEP D：知識ノート作成
作業フォルダに下記「KNOWLEDGE.md」を作成。さらに 第二の脳/ フォルダを作り、中に sources/（空）・wiki/INDEX.md（1行目「# 第二の脳 もくじ」、2行目「（まだ記事はありません）」）・log/（空）を作る。

===== KNOWLEDGE.md（ここから）=====
# KNOWLEDGE.md（事実台帳）

> 作業を始める前にここを読む。新しく分かった「次も覚えておくべき事実」を1行ずつ足していく。
> 1行が長くなる・経緯まで残したい話は 第二の脳/sources/ に素材としてためる。
> 行数が増えすぎたら（目安150行）、古いものを見直す。

### 制約（ツール・APIの「できないこと」）
- （例）YYYY-MM-DD: ◯◯は△△ができない。なので□□で代替する。

### 正解パターン（試行錯誤で見つけた正しいやり方）
- （例）YYYY-MM-DD: ◯◯するときは△△が正解。□□はダメだった。

### 業務ロジック（間違えると業務に支障が出るルール・数値）
- （例）YYYY-MM-DD: ◯◯の優先順位は A > B > C。

### 落とし穴（やりがちなミスと回避法）
- （例）YYYY-MM-DD: ◯◯すると△△が起きる → □□で回避する。

### 人物（名前と役割）
- （例）山田さん：◯◯の担当。△△の窓口。
===== ここまで =====

■ STEP E：記録コマンド設置
作業フォルダに .claude/commands/ を作り、その中の extract-knowledge.md を下記の内容で作成。終わったら「会話の区切りで /extract-knowledge と打てば記録される」と私に伝える。

===== extract-knowledge.md（ここから）=====
# ナレッジ抽出コマンド

会話の内容から「次も覚えておくべき事実」だけを抜き出し、KNOWLEDGE.md に記録する。
重い整理はしない。軽く確実に記録することを優先する。

## モード
- 引数に auto がある（自動実行・フック由来）→ コンパクト：記録だけ。素材は sources/ に退避するだけ。
- 引数なし（手動 /extract-knowledge）→ フル：記録＋、背景のある話は sources/ に素材として書き起こす。

## Step 1: KNOWLEDGE.md を読む
作業フォルダの KNOWLEDGE.md を全文読んで、既にある内容を把握する。

## Step 2: 会話から候補を抜き出す（抽出テスト）
各候補に、この1つの質問を当てる：
「次のセッションでClaudeがこれを知らなかったら、同じミスをするか／無駄な試行錯誤をするか／間違った出力をするか？」
→ Yes のものだけ保存する。No のものは価値があっても捨てる。

保存する5分類：
- 制約：ツール・APIの「できないこと」
- 正解パターン：試行錯誤で辿り着いた正しいやり方（ダメだったやり方も併記）
- 業務ロジック：間違えると業務に支障が出る仕様・ルール・数値
- 落とし穴：やりがちなミス → その回避法
- 人物：名前と役割の紐付け

保存しないもの（厳守）：
- 「◯◯をした」という作業の事実（動詞が「した・作った・実行した」で終わるもの）
- 環境パス・URL（調べれば分かる）／一般的なIT知識（Claudeが元から知っている）
- 解決済みの一時的な状態（「3ヶ月後も有効か？」がNoのもの）
- すでに KNOWLEDGE.md や CLAUDE.md に書いてあること（重複）

## Step 3: 重複チェック
- 既にある内容 → スキップ。
- 矛盾する内容（仕様が変わった等）→ 既存の行を新しい日付で更新する。

## Step 4: 書き込み
KNOWLEDGE.md の該当の見出しの下に、日付つき1行で追記する：
- YYYY-MM-DD: （1行で簡潔に）

## Step 5: 背景のある話は素材にためる
1行に圧縮すると価値の大半が失われる話（失敗の経緯・調査の過程・意思決定の背景・新しい構想）があれば、
第二の脳/sources/YYYY-MM-DD_内容の要約.md に、会話の要点を自分で書き起こして保存する。
（これだけで知識は失われない。記事へのまとめは後でよい）

## Step 6: 報告
保存対象が KNOWLEDGE.md も sources も 0件なら、何も言わずに終了する（ユーザーを邪魔しない）。
1件以上あれば、次の3行で短く報告する（行頭の記号ごとそのまま）：

    📝 ナレッジ記録
    - KNOWLEDGE.md: 新規[N件] / 更新[N件]
    - 第二の脳: 素材を sources/ に保存[N件]
===== ここまで =====

■ STEP F：自動メモ化（※必ず私の許可を取ってから）
まず私にこう聞く→「自動メモを今すぐ有効にしますか？ 最初は手動をおすすめします（慣れてからで大丈夫）」。
・私が「いいえ／あとで」なら、ここは何もせず STEP G へ進む。
・私が「はい」と言ったときだけ：~/.claude/hooks/ に下記2つの.shを作成して chmod +x し、~/.claude/settings.json にルール1のやり方で下記「settings.json に足す」をマージ。command のパスは ~ ではなく echo $HOME の実パスにする。最後に `python3 -m json.tool ~/.claude/settings.json` で壊れていないか確認。
そして私に「止めたいときは touch ~/.claude/state/extract-knowledge-disabled で止まる」と伝える。

===== knowledge-stop.sh（ここから）=====
#!/bin/bash
# 作業の区切りで、ナレッジ記録を促すフック。
# 設計：FAIL-OPEN（何かあっても必ずセッションを通す。決して止めない）。
# 無効化したいとき： touch ~/.claude/state/extract-knowledge-disabled
set -u
allow_stop() { exit 0; }   # 迷ったら必ず通す

INPUT=$(cat 2>/dev/null || true)

# 1) 手動の無効化スイッチ
[ -f "${HOME}/.claude/state/extract-knowledge-disabled" ] && allow_stop

# 2) ループ防止（フックの連鎖になっていたら通す）
printf '%s' "$INPUT" | grep -q '"stop_hook_active"[[:space:]]*:[[:space:]]*true' && allow_stop

# 3) ナレッジ管理しているフォルダでだけ促す：
#    今いる場所から上にたどって KNOWLEDGE.md があれば発火。無ければ静かに通す。
dir="${PWD:-$HOME}"
found=""
for _ in 1 2 3 4 5 6; do
  [ -f "${dir}/KNOWLEDGE.md" ] && { found=1; break; }
  [ "$dir" = "/" ] && break
  dir=$(dirname "$dir")
done
[ -z "$found" ] && allow_stop

# 4) 45分デバウンス（出しすぎ防止）
STATE_DIR="${HOME}/.claude/state"
LAST="${STATE_DIR}/extract-knowledge-last-run"
DEBOUNCE=2700
mkdir -p "$STATE_DIR" 2>/dev/null || allow_stop
now=$(date +%s 2>/dev/null) || allow_stop
last=0; [ -f "$LAST" ] && last=$(cat "$LAST" 2>/dev/null || echo 0)
case "$last" in ''|*[!0-9]*) last=0 ;; esac
[ $(( now - last )) -lt "$DEBOUNCE" ] && allow_stop

# 先に時刻を記録（次の区切りはデバウンスで黙る＝ループ防止）してから促す
printf '%s' "$now" > "$LAST" 2>/dev/null || true

REASON='【ナレッジ記録】この会話で新しく分かった事実（制約／正解パターン／業務ロジック／落とし穴／人物）があれば、終了前に /extract-knowledge auto を実行して KNOWLEDGE.md に保全してください。無ければそのまま終了して構いません。'
python3 -c 'import json,sys; print(json.dumps({"decision":"block","reason":sys.argv[1]}))' "$REASON" 2>/dev/null || allow_stop
exit 0
===== ここまで =====

===== knowledge-precompact.sh（ここから）=====
#!/bin/bash
# 会話が自動圧縮される直前に、ナレッジ記録を促すフック。FAIL-OPEN。
set -u
[ -f "${HOME}/.claude/state/extract-knowledge-disabled" ] && exit 0
REASON='【まもなく会話が圧縮されます】消える前に、新しく分かった事実があれば /extract-knowledge auto を実行して KNOWLEDGE.md に記録してください。'
python3 -c 'import json,sys; print(json.dumps({"hookSpecificOutput":{"hookEventName":"PreCompact","additionalContext":sys.argv[1]}}))' "$REASON" 2>/dev/null || exit 0
exit 0
===== ここまで =====

===== settings.json に足す（/Users/私のユーザー名 は実パスに直す）（ここから）=====
{
  "hooks": {
    "Stop": [
      { "hooks": [ { "type": "command", "command": "/Users/私のユーザー名/.claude/hooks/knowledge-stop.sh" } ] }
    ],
    "PreCompact": [
      { "matcher": "auto",   "hooks": [ { "type": "command", "command": "/Users/私のユーザー名/.claude/hooks/knowledge-precompact.sh" } ] },
      { "matcher": "manual", "hooks": [ { "type": "command", "command": "/Users/私のユーザー名/.claude/hooks/knowledge-precompact.sh" } ] }
    ]
  }
}
===== ここまで =====

■ STEP G：Google連携（あなたは実行しない。私への案内だけ）
まず「6-A かんたん」を案内：claude.ai または Claudeアプリの 設定→コネクタ で Google（Gmail/カレンダー/ドライブ）を接続。私がブラウザでログイン許可する。これで十分、と伝える。
本格運用も希望する場合だけ「6-B」を案内：`brew install gogcli` の後、Google Cloud で鍵（OAuthクライアント＝種類はデスクトップアプリ）を発行し、ターミナルで `gog auth credentials set <鍵ファイル>` → `gog auth add <自分のGmail>` → `gog auth alias set main <自分のGmail>` → `gog --account main gmail list` の順に実行。鍵の発行と各コマンド実行は私の手作業で、難しければ栄井に相談、と添える。

■ STEP H：仕上げの確認
一緒に確認する：①「KNOWLEDGE.mdに何が書いてある?」に答えられる ②/extract-knowledge が動く ③（有効化したなら）会話の区切りで案内が出る ④（接続したなら）「今日のカレンダー見せて」で予定が出る。
全部OKなら「セットアップ完了」と報告して、私に日々の使い方（作業前にKNOWLEDGE.mdを読む・区切りで/extract-knowledge・作ったものはoutputへ・削除はゴミ箱経由）を3〜5行で教えて。

では STEP A から始めてください。