環境設計
── ClaudeCodeを"社内標準"にする土台作り

「ChatGPTは入れた」「Cursorも試した」。でもClaudeCodeだけはハードルが高く感じる──この正体はターミナル（黒い画面）への苦手意識です。でも安心してください。このノックは"ターミナルを初めて開く経営者"でも3分で終わる粒度で書きます。

ここで躓くと、このあとの99ノック全部が始まりません。最初の1ミリを越えさせるのが目的です。

• macOS / Windows / Linux どれでも動きます（本ノックはMac想定、Windowsの人も同じコマンド）
• 必要なのはターミナル（MacならLaunchpadから「ターミナル.app」）とnpmというパッケージ管理ツール
• Claude の有料プラン（Pro or Max）があるとフル機能。無料でも起動できます

Step 1 — Node.js (npm) を入れる

ターミナルを開いて、以下を打ちます。すでに入ってれば v20.x.x みたいに出ます。

# バージョン確認
node -v
npm -v

入ってない場合は nodejs.org から LTS版をインストール。Macユーザーなら brew install node でもOK。

Step 2 — Claude Code CLI をインストール

npm install -g @anthropic-ai/claude-code

これだけ。所要30秒。グローバルインストール（-g）なので、どのフォルダからでも claude と打てば起動します。

Step 3 — 任意のフォルダで起動

# 適当な作業フォルダに移動
cd ~/Desktop
mkdir ai-experiment && cd ai-experiment

# 起動
claude

初回は Anthropic アカウントのログインを求められます。ブラウザが自動で開くのでログインして戻ってくるだけ。これでClaudeCodeが起動します。おめでとうございます。

.claude/ の中身を知らないまま使ってる経営者は「Claude頭いいなぁ」で終わります。でも、このフォルダを意図的に設計すれば、自社専用のClaudeが作れます。つまりチームの誰が起動しても「自社のやり方」で動く状態。これが実装できて初めて"社内標準ツール"になります。

your-project/
├── .claude/
│   ├── skills/          # 仕事のやり方を覚えさせる（社内ノウハウ）
│   │   └── my-skill/
│   │       └── SKILL.md
│   ├── agents/          # 長時間タスク専用のサブエージェント
│   │   └── code-reviewer.md
│   ├── commands/        # /自社コマンド で一発実行
│   │   └── deploy.md
│   ├── hooks/           # 起動時・停止時の自動処理
│   │   └── on-session-start.sh
│   └── settings.json    # 権限・環境変数
└── CLAUDE.md              # プロジェクトの前提共有（最重要）

skills/ ─ 社内ノウハウの格納庫

繰り返す仕事を1回SKILL.mdに書くと、2回目以降Claudeが勝手に判断して呼び出します。僕の会社には現在50本以上の自作スキルがあります。例：「X投稿作成」「UTAGEシナリオ作成」「議事録→タスク化」「経費CSV生成」等、全てここに入ってます。

agents/ ─ 長時間タスクのサブエージェント

「コード全体をレビューする」「セキュリティスキャンする」みたいな重い単発タスク専用。メインセッションとは別プロセスで走るため、待ち時間中もメインでは別作業できます。

commands/ ─ 社内標準の一発実行コマンド

/deploy /estimate /review みたいに、社内固有の業務をスラッシュコマンドとして登録する場所。これをチーム全員で共有すれば、誰がClaudeを起動しても同じ手順が使えます。

hooks/ ─ 起動時・停止時の自動処理

「セッション開始時に最新のナレッジDBをPull」「終了時にログを社内Slackに通知」など、人が忘れがちな処理を強制自動化できる場所。

settings.json ─ 権限・環境変数

「このプロジェクトでは bash の rm -rf を禁止」「Python実行は事前許可制」のようなガードレール設定を置くファイル。社内ルールをコードで強制できる。

「毎回同じ前提を説明するのが疲れる」が止まります。自社の業界専門用語、独自ルール、禁止事項、過去の失敗例、全部1回書けば次から勝手に踏襲してくれる。これがClaudeCodeが他のAIツールと決定的に違うポイントです。

1. プロジェクト概要 ─ 何の事業／プロダクトか（3行）
2. ユーザー像 ─ このプロジェクトで"誰に向けて"作るのか
3. 技術スタック ─ 使ってる言語・フレームワーク・外部サービス
4. ディレクトリ構成 ─ プロジェクト直下に何があるか（ツリー）
5. コーディング規約 ─ インデント・命名・禁止事項
6. ドメイン用語 ─ 業界・自社特有の言葉（例：「顧問先」「本契約」の意味）
7. 運用ルール ─ Git運用、コミットメッセージ形式、デプロイ手順

# CLAUDE.md - CC講座プロジェクト

## Git運用ルール（必須）
- ファイルの作成・編集・削除が発生したら**毎回必ずGitHubにプッシュ**する
- リモート: `origin` → https://github.com/RenTonoduka/03-ALA.git

## プロジェクト構成

```
03_ALA/
├── .claude/            # 自作スキル・コマンド
├── AIWSプロジェクト/    # 関連プロジェクト群
└── _触らないでください/ # MCP・スクリプト（変更禁止）
```

## 企画作成ルール
"新しい企画を作成したい" と言われたら：
1. 企画名確認
2. 連番自動判定
3. セミナー型テンプレ8ステップで一括作成
...

これが起動時に自動で読まれるので、「新しい企画作りたい」と言うだけで、Claudeが勝手に 03_企画シーケンス/XX_企画名/ を作って、8ステップのフォルダまで整えます。

MCP公式ドキュメントの例を真似して claude mcp add … と打つと、謎の構文エラーや「already exist」の罠にハマります。CC講座第2回でも全員ここで止まりました。原因は1つ：HTTPSから末尾までをダブルクォートで囲む必要があるという暗黙ルール。

• MCP は "Claude が外部ツールを呼び出すための共通規格"
• 追加する場所はプロジェクトローカル（.mcp.json）かユーザーグローバル（~/.claude/mcp.json）
• 追加コマンドは claude mcp add。手動で mcp.json を編集してもOK

Step 1 — まず接続可能なMCPサーバー一覧を知る

公式リストは modelcontextprotocol/servers。経営者が最初に入れるべきは：

• filesystem ─ ローカルフォルダ読み書き
• github ─ リポジトリ操作
• slack / notion ─ 社内コミュニケーションツール
• google-drive ─ ファイル・スプレッドシート操作

Step 2 — Slack MCPを追加する（実例）

# NG: クォートなしだとエラー
claude mcp add slack --url https://example.com/mcp

# OK: URLとトークンをダブルクォートで囲む
claude mcp add slack --url "https://example.com/mcp?token=xoxb-xxx"

URL中に? や &が入ってる場合、シェルが誤解釈するためクォート必須。これに気づかず1時間溶かすのが定番パターンです。

Step 3 — 接続確認

claude mcp list

slack ✓ connected のように出れば成功。"already exist" は実は成功のサインなので慌てない。

技術選択を間違うと「スキル作り直し」「MCP入れ直し」の二度手間。判断基準さえ持てば、要件を聞いた瞬間に5秒で選択肢が1つに絞れます。

• CLI：ターミナルからclaudeで対話する窓口。人間とClaudeの会話
• MCP：Claudeが外部ツールを呼ぶ規格。Slack・Notion・Google Drive等を"Claudeの手足"にする
• API：Claudeを自社プロダクト内に組み込む時に使うプログラム接続口。顧客にClaude機能を提供したい時

Q: Claudeで何をしたい？

├── 自分が社内業務で使う
│   → CLI（claude コマンド）
│   → 必要に応じてMCPで外部ツール追加
│
├── 社内の他の人にも使わせる（ダッシュボード等）
│   → MCP + 社内ツール連携
│   → CLAUDE.md + スキル共有で横展開
│
└── 自社プロダクトの機能として顧客に提供
    → Anthropic API（課金は自社負担）
    → Claude SDKを使ってアプリ組込

• 「毎朝の売上レポートを作らせたい」 → CLI + Google Sheets MCP
• 「全社員がClaudeで議事録化できる仕組みを」 → CLI + 共通CLAUDE.md + Slack MCP
• 「自社SaaSにAI要約機能を追加」 → Anthropic API（Claude APIを組み込む）
• 「社内Notionの情報をClaudeから引く」 → Notion MCP

公開リポジトリに流出したAPIキーは、botが秒単位でスキャンしています。流出発覚から数分で不正利用・課金事故・本番DB改変まで起きます。"暗号化すればcommit可能"というライブラリ宣伝を鵜呑みにしないのが経営者の鉄則。本ノックは「.env は commit しない」を前提にした安全運用を徹底解説します。

1. .env は必ず .gitignore に入れる。暗号化済みでも commit 禁止。
2. APIキーはパスワードマネージャー（1Password / Bitwarden）で共有する。Slack平文は絶対NG。
3. 万が一commitしてしまったら即キー無効化＆再発行。履歴削除は"漏れた前提"で対応。

Step 1 — .gitignore を最初に書く

# .gitignore（プロジェクト直下）
.env
.env.*
*.pem
*.key

# サンプル用テンプレは commit OK
!.env.example

プロジェクト作成の初日に必ず書く。後回しにするとほぼ事故る。

Step 2 — .env.example を置いてチームに共有

# .env.example（commit OK。実キーは書かない）
OPENAI_API_KEY=your_key_here
ANTHROPIC_API_KEY=your_key_here
SLACK_TOKEN=your_token_here

これで「どのキーが必要か」だけチームに伝わる。実キーは各自が1Password経由で取得して .env を作る。

Step 3 — 実キーの共有ルートを確立

• 1Password / Bitwarden の共有ボールトで管理（監査ログ・アクセス権制御が効く）
• 退職・異動時は即キー無効化＆再発行（ボールトから外すだけでは不十分）
• 本番用と開発用を必ず別キーにする。事故時の被害局所化

Step 4 — git-secrets で事故防止

# Mac（brew）の場合
brew install git-secrets
git secrets --install
git secrets --register-aws

# commit時に sk-xxx / cmk_xxx 等を自動検出してブロック

これがあれば sk-xxx や cmk_xxx のようなキー形式を含む commit をgit側で強制的に拒否できる。

経営者には「毎回自分で指示しないとClaudeが間違える」という時間泥棒があります。例えば議事録の要約形式、コミットメッセージのフォーマット、採用メールの書き方、全部毎回説明してる。これをSKILL.md に1回書くだけで、Claudeがそれ以降記憶して勝手に使います。

.claude/skills/my-first-skill/
└── SKILL.md           # Claudeへの指示書（必須）

これだけ。Pythonコードもシェルスクリプトも不要。Markdownファイル1個でスキル完成です。

1. YAMLフロントマター：name（スキル名）+ description（いつ発動するか）
2. Role：Claudeは何者として振る舞うか
3. Task：何をするか
4. Process：具体的な手順
5. Output：出力フォーマット

---
name: meeting-to-tasks
description: Zoom議事録をActionable Task Listに変換する。「議事録をタスクに」
allowed-tools: Read, Write, Edit
---

# 議事録 → タスク化スキル

## トリガー
「議事録をタスクに」「ミーティングログをタスクリストに」「会議メモを整理」

## 実行フロー

Step 1: 議事録ファイルを読む（Read）

Step 2: 以下の形式でタスクを抽出：
- [ ] {タスク名} | 担当: {名前} | 期限: {YYYY-MM-DD}

Step 3: 元議事録の末尾に"## アクションアイテム"として追記（Edit）

## 注意
- "やる"と明示された発言のみ抽出（雑談や可能性は除外）
- 担当が曖昧なものは"@未割当"で出力

「コード全体レビュー」「セキュリティスキャン」「大量ファイル整理」など重いタスクを走らせると、メインセッションが数分〜数十分止まります。サブエージェントは別プロセスで実行するので、待ち時間に別作業できる。経営者の1時間を2時間に変える武器です。

• スキル：仕事のやり方を"覚えさせる"。Claudeが呼び出すか判断。短時間実行。
• サブエージェント：独立した"もう1人のClaude"。明示的に起動。長時間実行OK。別の権限も持てる。

Step 1 — agents/ フォルダに定義を置く

.claude/agents/code-reviewer.md

---
name: code-reviewer
description: Performs thorough code review. Use when user says "コードレビューして"
tools: Read, Grep, Glob
model: sonnet
---

あなたは厳格なシニアエンジニアです。
コード全体を読んで、以下の観点で100点満点評価してください：

- 正確性 (40%)
- セキュリティ (30%)
- パフォーマンス (20%)
- 保守性 (10%)

出力フォーマット：
- 総合スコア: XX/100
- 各観点の詳細
- 改善提案（Priority順 / 最大5件）

Step 2 — メインセッションから呼び出す

# メインセッションで
"code-reviewerで、src/ 配下を全部レビューして"

するとメインは即座に空く。サブエージェントが別プロセスで走り、完了時に結果が返ってくる。

社内業務は"個々人の頭の中"に依存しがち。ベテランが辞めた瞬間に誰もできなくなる。スラッシュコマンドは業務手順そのものをコード化して、新人でも"/estimate"と打つだけで100%再現できる状態を作ります。

• スキル：Claudeが発動判定する。トリガー曖昧でもOK
• スラッシュコマンド：人間が明示的に /xxx で起動。判定の揺れゼロ

つまり"絶対に同じ手順で動かしたい業務"はスラッシュコマンド。流れで判断してほしいものはスキル。

Step 1 — commands/ に定義を置く

.claude/commands/deploy.md

---
description: Build and deploy to staging environment
---

# /deploy コマンド

手順：
1. テスト実行（npm test）
2. ビルド（npm run build）
3. dist/ をステージングサーバーにrsync
4. ヘルスチェック（curl /health）
5. Slack #deploy チャンネルに完了通知

失敗時：
- テスト失敗 → 即中断、エラー内容を表示
- デプロイ失敗 → ロールバック実行

Step 2 — 使う

# Claudeのセッション内で
/deploy

これだけ。Claudeが上記手順を順番に実行してくれる。失敗時の振る舞いもコマンド定義に書いてあるから事故らない。

「毎朝Gitをpullする」「コミット前にlintを走らせる」「終了時にログを送る」──これら全部、人に任せると必ず誰かが忘れる。フックは強制実行レイヤー。チーム全員にミスなく運用を徹底させたい経営者の必須機能です。

• UserPromptSubmit：ユーザーが送信する直前（入力の検証・追加指示）
• SessionStart：Claudeセッション開始時（環境変数ロード、最新Pull等）
• Stop：セッション終了時（ログ保存、通知等）
• PreToolUse / PostToolUse：ツール実行前後（権限チェック、監査ログ）

Step 1 — settings.json にフック定義

.claude/settings.json

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          { "type": "command", "command": "git pull --rebase" },
          { "type": "command", "command": "./scripts/load-env.sh" }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          { "type": "command", "command": "./scripts/post-session-log.sh" }
        ]
      }
    ]
  }
}

Step 2 — スクリプト本体を作る

scripts/load-env.sh

#!/bin/bash
# セッション開始時に必ず走る
dotenvx decrypt  # 暗号化された .env を使える状態に
echo "✓ 環境変数ロード完了"