Claude Codeワークブック

0-1. Web版・Slack版との違い

具体例で比較:

• Web版・Slack版: 質問して答えをもらう。実行するのは自分
• Claude Code: 手順を渡せば、ファイル作成・外部SaaS操作・定期実行まで実際にやってくれる

0-2. 今日のゴール（持ち帰るもの）

研修が終わったときに、以下があなたの環境にある状態を目指します。

1-1. Claude Codeのインストール

# ターミナルで実行
$ npm install -g @anthropic-ai/claude-code
...インストールが進む...
$ claude --version
1.x.x   ← バージョンが表示されればOK

1-2. 起動してみる（実際のやり取り例）

$ claude

> こんにちは、自己紹介してください

Claude: こんにちは！私はClaudeです。文章作成、調査、データ分析、
ファイル操作などをお手伝いできます。何かお手伝いできることはありますか？

claude と打つと、対話画面（TUI）が開く。ここから先のやり取りは基本的にこのTUI上で行う。

1-3. アカウントとプライバシー設定（最重要）

1-4. 機密情報の扱い方（絶対に守ること）— 具体例で確認

Before / After の実例

1-5. Claude Code開発ガバナンス5原則（松田さんルール）

CTO松田さんが2026年6月、社内研修で発表した全社ルール（#9999_claude_相談窓口）。

Claude Codeを活用した開発は非常に便利な一方、気づかないうちにコストが積み上がったり、セキュリティやデータの取り扱いにおいて出口が見えにくくなったりするなど、"見えないリスク"も増えている。だからこそ、以下の5つを「安心して開発を進めるためのガードレール」として共有する。

判断の起点: ローカル完結・無料なら自由。外につながる時・お金が動く時だけ管理する。

実務での適用（早見）:

• ローカル完結・無料・自分だけ → 自由に作ってOK（GitHubに上げるなら原則②も）
• ローカルでもグループ共有 or 会社データ利用 → 原則①②③④
• クラウドにホスト → 原則①②③④に加え⑤（エンジニアレビュー）必須

迷ったら #9999_claude_相談窓口 へ。台帳・課金の複合ケースは松田さんに確認。

2-1. TUI / GUI / Editor / Channels の使い分け

2-2. .claude/フォルダの全体像

Claude Codeを本気で使うなら、まず整えるべきなのが .claude/ フォルダ。ここが「Claudeにどう動くかを教える司令塔」になる。

2種類の.claude/がある:

2-3. CLAUDE.md（プロジェクト共有ルール）— 具体例

プロジェクトのルール・注意事項を書いておくファイル。GitHubで管理すればチーム全員に共有される。

実際の例（TikTok Shop運用プロジェクト用）

# CLAUDE.md

## このプロジェクトについて
担当ブランドのTikTok Shop運用を効率化するプロジェクト

## ルール
- 競合の投稿をチェックする際は、必ず公開情報のみを参照する
- 売上データを集計する前に、必ず「対象期間」を確認してから進める
- クライアント名は社内共有のため実名でよいが、社外に出す資料では匿名化する
- 集計結果は必ず担当チャンネルに要約して報告する

2-4. MEMORY（個人の好み・役割を継承させる）— Before/Afterで比較

MEMORYは、実は2-2で紹介した ~/.claude/（グローバル）に保存される自動メモリの仕組みそのもの。

Claude Codeが「あなたがA社・B社のアカウントを担当している」ことを覚えている前提で、説明なしに動いてくれる。

覚えさせる時の言い方の例

> 私はTikTok Shop運用担当で、A社・B社のアカウントを管理しています。これを覚えておいてください

2-5. Obsidianを「第二の脳」にする（応用）

CLAUDE.md/MEMORYと同じ考え方（自己紹介・ルールを書いて覚えさせる）は、自分の知識管理にも応用できる。TORIHADAでも日報・ナレッジ管理にObsidian（無料のメモアプリ）を使っている人が多い。

なぜObsidianなのか: ただのテキストファイルの集まりなので、AIが「このフォルダのこのファイルを読む」と探しやすい。Claude Codeならファイルを直接読めるので、貼り付けなくても自動で読み込まれる。スマホの標準メモやチャットのメモだと増えるほど散らかるが、Obsidianなら専用の引き出しを1個作れるので増えても崩れない。

最小構成（5つだけ）:

vault用CLAUDE.mdのテンプレート

# 自己紹介
名前: / 仕事: / 今フォーカスしていること: / 今年の目標:

# 今のプロジェクト
進行中: / 詰まっているところ: / 次のマイルストーン:

# このvaultの使い方
- inbox: 未処理の置き場所
- notes: 整理済みの記事・メモ
- ideas: 自分の考え
- projects: 進行中の仕事

# AIにしてほしいこと
- 気づいていないつながりを教えて
- すぐ同意せず、前提を疑ってから答えて
- 「何にフォーカスすべき？」と聞かれたら、vaultの中身を踏まえて答えて。一般論で返さない
- 前に書いたことと矛盾していたら教えて

# 今読んだり考えたりしていること（毎週更新）

毎朝「話しかけてくる」仕組み（手動でOK）

> Obsidianのvaultを見て。/inboxの直近24時間分と、/notesの直近7日分を読んで、次の3つをやって：
  ① CONNECTIONS: 最近のメモと過去のメモの間で、まだ気づいてなさそうなつながりを3つ、具体的に
  ② PATTERN: 今週読んでる/考えてる内容に共通するパターンを1つ
  ③ QUESTION: そのパターンを踏まえて、今日考える価値のある問いを1つ
  /inbox/brief-{{日付}}.md に保存して

週1回、腰を据えて話す仕組み（15分）

> Obsidianのvault全体を読んで、直近7日間に追加したものを中心に、次の4つを教えて：
  ① まだ言葉にしていない、育ちつつある考え
  ② 前に書いたことと矛盾していること
  ③ 読めていない視点・知識のギャップ
  ④ 今週一番てこの効く一手
  遠慮せず、知ってることの要約はしないで

実例: 失敗から学ぶ「第二の脳」

仕事でミスやヒヤリハットがあったら、「①何が起きたか ②真因 ③再発防止ルール」の3点セットでvaultに1本追記する運用も効果的。次に似た作業をする前に「関連する過去の失敗ある？」とAIに聞けば、忘れていた注意点を思い出させてくれる。

実際に効いている学びの例（一般化したもの）:

• 「エラーなく完了しました」は「正しい」ではない — 成果物は最終形式まで必ず開いて目で見る
• 「該当なし」「0件でした」を一度疑う — 本当にゼロなのか、検索条件や取得件数の上限に引っかかっているだけなのかは別
• 同じやり方で2回失敗したら、3回目は手段を変える — 別の聞き方・別の切り口を試す
• 「これで何件変わるか」を数えられない一括作業はまだ実行しない

2-6. フォルダ整理・GitHub命名ルール — 具体例

• 作業ファイルは ~/Projects/ 配下に、プロジェクトごとにサブフォルダを作って保存する
• 直下に置かず、必ずフォルダ分けする

3-1. なぜ「マインドセット」を先にやるのか

Claude Codeの操作は1日で覚えられる。でも、Claude Codeを業務に組み込むには、「AIに何を任せ、何を任せないか」「失敗したときどう振る舞うか」の判断軸=マインドセットが必要。

3-2. AIと働く6つの原則

原則① — AIは「部下」ではなく「同僚」として扱う

理由: AIは"従順だが文脈を持たない新人"です。指示書を渡すマネージャーの感覚で接する。

実践: 目的（Why）を必ず最初に伝える／制約（締切・予算・対象者）を明記する／「途中で迷ったら確認して」と一言添える

原則② — 業務を「構造化」する癖をつける（=スキル化の素地）

理由: 「自分の業務を手順で書ける」=「スキル化できる」状態。構造化できない業務はAIに任せにくく、構造化できた瞬間にスキル化→量産化が見える。同じ手順が2回出てきたらPart 6のスキル化対象にメモする。

原則③ — 「やらせる」と「自分でやる」の線引きを持つ

覚え方: AIは"下書きと素材集めと分析"は最強、"判断と関係性"は人間がやる。この原則は、Part 5で扱う「Slack送信・メール送信は必ず人が確認してから」というルールの根っこにもなっている。

原則④ — AIに「自分の文脈」を継承させる（CLAUDE.md / MEMORY / feedback）

Part 2で実際にやった通り。一度伝えた前提はCLAUDE.mdかMEMORYに残し、次回からAIが覚えている状態を作る。修正指示が同じパターンで2回出たら → feedback_*.md に蓄積する。

具体例: 「日付の書き方がいつも西暦と和暦で揺れる」と2回指摘したら、「日付は必ず西暦で書くこと」とMEMORYに保存させる。次回から指摘不要になる。

原則⑤ — AIを「個人ツール」ではなく「チームの常駐戦力」として抱える

理由: AIを個人ツールに留めると「あの人しかAIを使いこなせない」属人化が起きる。チーム共有のチャネルに常駐させると、メンバー全員が同じAIを使え、AIが"1人のアシスタント"から"チームの戦力"に進化する。1人で今すぐ使いたいだけなら、Remote Control（Part 4）でスマホから続きを操作する方法もある。

原則⑥ — 「失敗ログ」を残して、同じミスを繰り返さない

①Claude Codeから怒られた・間違えられたら、メモする ②同じことが2回起きたら、ルール化する ③ルールをClaude Codeに食わせる（CLAUDE.md or MEMORY経由）

例え: 新人教育と同じ。「前に教えたよね？」が増えるなら、マニュアル化する。Part 2で紹介したObsidianの「失敗アーカイブ」運用は、まさにこの原則の実践形。

3-3. マインドセット6原則 まとめカード

→ このカードをスクショして、Obsidianの 30_Knowledge/ 相当のフォルダに保存することを推奨。

4-1. Remote Controlとは

「今動いているセッションを、別デバイスから覗く・操作する」機能。Discordのようにボットを作る手間なく、その場で今動いているセッションに接続できる。

claude --remote-control

起動すると、通常どおりターミナルで対話セッションが始まると同時に、ブラウザ接続用のセッションURLとモバイルアプリ用のQRコードが表示される。

接続方法（いずれか）:

• 表示されたURLをブラウザで開く
• Claude iOS/Androidアプリでモバイル画面からQRコードをスキャンする
• claude.ai/code のセッション一覧から探す（PCのアイコンで見分けられる）

接続後にできること:

• 別デバイスからメッセージ送信・ファイル添付・操作がすべて可能
• 複数デバイスから同時に接続でき、ローカルターミナル・スマホ・ブラウザを行き来しながら作業できる
• サブエージェントやワークフローの進捗もリアルタイムで同期表示される

5-1. コネクタとは

claude.aiの個人アカウントで、SlackワークスペースやGoogleアカウントをあらかじめ接続しておくと、Claude Codeからも直接それらのデータを読み書きできるようになる仕組み。

5-2. 接続のやり方

claude.ai → 画面左下のツールボックス → Customize → Connectors → 「＋」から接続したいサービスを選び、OAuth認証で接続する。

5-3. 接続すると何ができるか（具体例）

[Slack]
> #general チャンネルの直近の議論を要約して
> 自分宛のメンションで未読のものを教えて

[Google Drive]
> 共有ドライブから「〇〇規程」というファイルを探して
> このスプレッドシートを読み込んで部署別に集計して

[Gmail]
> 「見積書」という件名のメールを検索して
> この内容で返信の下書きを作って

[Google Calendar]
> 来週の自分の予定を確認して
> 火曜の14時に「面談」の予定を入れて

5-4. 注意点

• 専用アカウントで接続する方が安全（プライベート個人アカウントは避ける）
• 最初は読み取り専用の範囲から始め、必要になったら書き込み権限を追加する
• メッセージ送信・投稿・メール送信は自動化せず、必ず人が最終確認してから実行する（原則③のとおり、下書きまでがAI、送信は人）

6-1. スキルとは何か

スキル = "プロンプトの型紙"。毎回同じ依頼をするなら、その依頼をファイルに保存して /コマンド で呼べる形にする。これだけ。難しい技術は不要。

6-2. 具体例で見るスキルの中身

実際の例（競合の新着投稿チェック）

---
description: 競合アカウントの新着投稿を自動チェック。エンゲージメント率が高い投稿を抽出し、自社アカウントへの応用ポイントをまとめる
argument-hint: "<競合アカウント名（任意）>"
---

# /competitor-check - 競合の新着投稿チェック

## 実行ステップ
### Step 1: 対象アカウント確認
チェック対象の競合アカウントを確認する

### Step 2: 新着投稿の確認
過去1週間の新着投稿を確認し、エンゲージメント率を確認する

### Step 3: 出力フォーマット

## 競合チェック YYYY-MM-DD
- [ ] 対象アカウント: ○○
- [ ] 注目投稿: ○○（エンゲージメント率◯%）
- [ ] 自社への応用ポイント: ○○

これを ~/.claude/commands/competitor-check.md に保存するだけで /competitor-check が使えるようになる。

6-3. スキル作成の鉄則

① 「Skill作って」とClaude Codeに頼む（自分で書かない）

> 私の業務で毎週繰り返してる「競合の新着投稿チェック」をスキルにしたい。
  毎回やる手順は次のとおり：
  1. 競合アカウントの新着投稿を確認する
  2. エンゲージメント率が高い投稿を抽出する
  3. 自社アカウントへの応用ポイントをまとめて出力する

  これを /competitor-check というコマンドで呼べるスキルにしてください。

→ Claude Codeが ~/.claude/commands/competitor-check.md を自動生成。自分でMarkdownを書く必要なし。

6-4. スキル管理のコツ

7-1. MCPとCLI — AIが外部ツールを使う2つの手段

具体例: マネフォ勤怠にはMCPがまだないので、手順書＋CLIでログイン操作を自動化。Slack・カレンダーはMCPがあるので、Part 5で接続した状態で直接呼び出せる。

使い分け原則: 既にCLIがある→AIに使わせる。ツールを増やす→MCPで追加。

7-2. エージェントとは何か（スキルとの違い）

ポイント: スキル = "何をするか" の手順書。エージェント = "誰がやるか" の人格・専門性。

7-3. 具体例で見るエージェントの中身（TikTok Shop運用エージェント）

---
name: tiktokshop-assistant
model: sonnet
description: TikTok Shop運用関連の業務を担当。競合チェック、売上集計、インフルエンサー選定など。
---
あなたはTORIHADAのTikTok Shop運用を支援する専門エージェントです。
担当ブランドの売上最大化に向けて、競合分析とデータ集計を正確に行うことが役割です。

## 担当業務
- 競合アカウントの新着投稿チェック・分析
- 週次売上データの集計・可視化
- インフルエンサー候補のパフォーマンス分析

## 専門外
- クライアントとの契約交渉そのもの → 営業担当が行う
- 炎上対応の判断 → 人間が行う

## 判断基準
- データの正確性を最優先（曖昧な場合は必ず確認を求める）
- クライアントへの提案資料は下書きまで、最終判断は人が行う

## よく使うスキル
- /competitor-check
- /creator-analytics

7-4. エージェント定義のテンプレート（最小構成）

---
name: [エージェント名]  # 小文字ケバブケース
model: sonnet           # 軽い業務はsonnet、深い判断が必要ならopus
description: [どんな業務を担当するか。1〜2文。トリガーワードを含める]
---

あなたは [所属組織] の [専門領域名] エージェントです。
[業務の目的を1文で]。

## 担当業務（このエージェントに任せる仕事）
- [業務1]
- [業務2]
- [業務3]

## 専門外（このエージェントが断る仕事）
- [専門外1] → [推奨エージェント]

## 判断基準
- [優先順位1]: [理由]

## よく使うスキル
- /[スキル1]

7-5. エージェントを作る5ステップ

事前準備：テーマ持参

以下から1つ選んで研修に来てください: 自分のチームの週次レポート作成／自分の担当業務の定型集計／業界ニュースのダイジェスト作成

Step 1: スキル化

> 私の [テーマ] をスキルにしたい。
  毎回やる手順は:
  1. [...]
  2. [...]
  3. [...]

  コマンド名は /[your-name]-[task] で、~/.claude/commands/ に保存して。

→ ファイルが生成されたら ls ~/.claude/commands/[your-name]-*.md で実在確認。

Step 2: エージェント化

Part 7のワークで書いた「担当業務」「専門外」をそのまま使う。

> いま作った /[skill-name] を中心に、私の [専門領域] 全般を任せられる
  エージェントを作ってください。
  - name: [your-name]-assistant
  - model: sonnet
  - 担当業務: [Part 7で書いた3つ]
  - 専門外: [Part 7で書いた2つ]
  ~/.claude/agents/[your-name]-assistant.md に保存して。

→ ファイルが生成されたら ls ~/.claude/agents/[your-name]-*.md で実在確認。

Step 3: テスト実行

> [your-name]-assistant エージェントを使って、[テスト用タスク] をやってみてください。

期待した動きをするか確認。OKなら持ち帰り完了。微妙なら「もう少し◯◯にして」と日本語で追加指示し、修正させる。

成功の判定基準

未達成なら、研修後に Claude Codeに「修正して」と頼めばOK。

9-1. ハルシネーション（もっともらしい間違い）に注意

数字・日付・固有名詞・URLは必ず自分で1次情報を確認する。

具体例: 「先月のTikTok Shop流通額は◯万円でした」と即答されても、実際の管理画面の数字を必ず確認してから使う。

9-2. 生成物をそのまま提出しない

下書き・集計結果は必ず人間が中身を確認してから使う。

9-3. 機密情報・送信操作の扱いを継続する

• 機密情報はPart1のルールを継続（Claude Codeはファイルアクセス範囲が広いため特に注意）
• Slack送信・メール送信などの外部発信操作は、Part5のとおり必ず人が最終確認してから実行する
• 開発ガバナンス5原則（Part1）は、ツールを作り始めたら継続的に意識する

9-4. 今日持ち帰ったもの

9-5. 困ったときは

操作で詰まったら → スクリーンショットを撮ってClaude.aiに質問。同じミスを繰り返しそうなら → feedback_*.mdやObsidianにルール化して蓄積。

付録A: マインドセット6原則

付録B: 開発ガバナンス5原則

付録C: .claude/フォルダ構成

プロジェクト内の.claude/ → チーム共有・Gitで管理　／　~/.claude/（グローバル）→ 個人専用・自動メモリを保存

付録D: 用語集

CLI（Command Line Interface）

ターミナルからコマンド・引数で操作する方式全般。claude --remote-controlのようにコマンド一発で実行する使い方。Claude Codeは「CLIツール」としてインストール・起動する

TUI（Text/Terminal User Interface）

ターミナル上で動く対話型の画面。claudeと打って起動する、チャットのやり取りができる画面そのもの。この資料で教える内容の大半は、実際にはこのTUIの使い方

GUI（Graphical User Interface）

マウスで操作するデスクトップアプリ画面

Editor拡張

VSCode等のエディタの中からClaude Codeを呼び出す方式

Channels

Discord/SlackなどにBotとして常駐させ、チャットから呼び出す方式（今回は割愛）

MCP（Model Context Protocol）

AIがSlack/Google等の外部サービスに接続するための標準プロトコル（2024年11月公開）

CLAUDE.md

プロジェクトのルールや指示を書いておくマニュアルファイル

MEMORY

個人の好み・役割をAIに継続的に覚えさせる仕組み。~/.claude/に保存される

Skill（スキル）

繰り返す業務を/コマンドで呼び出せる形にした「プロンプトの型紙」

Agent（エージェント）

役割・判断基準・使えるスキル群をまとめた「人格を持ったAI」

Remote Control

今動いているセッションを別デバイス（スマホ等）から操作する機能

Connector（コネクタ）

claude.aiでSlack/Googleアカウント等を接続する仕組み

GitHub

ソースコードやプロジェクトファイルをオンラインで保存・共有するサービス。チームでの共同開発や、Cloudflare等へのデプロイ元としてもよく使われる

デプロイ（Deploy）

作ったツール・サイトを、実際にインターネット上で使える状態に公開すること。「GitHubに上げてCloudflareにデプロイする」のように使う

ハーネス（Harness）

AIモデル（Claude本体）に、ファイル操作やコマンド実行などの「手足」を与えて実際に作業させる仕組み・器のこと。Claude Code自体が、Claudeというモデルのための「ハーネス」にあたる

付録E: 自分専用エージェント テンプレート

---
name: my-assistant
model: sonnet
description: 私の[専門領域]を担当。[主要業務1]、[主要業務2]、[主要業務3]に関するタスクで使用。
---

あなたは [所属組織・チーム名] の [役職名] を支援する専門エージェントです。
[業務目的の1文]

## 判断基準（いつこのエージェントを使うか）
- トリガー: [トリガーワード1]・[トリガーワード2]
- 不向き: [専門外領域1] → [推奨エージェント]

## 担当業務
- [業務1]
- [業務2]
- [業務3]

## アウトプット基準
- [品質基準1]
- [品質基準2]

## よく使うスキル
- /[skill1]
- /[skill2]

付録F: 次のステップ

今日扱わなかった内容（LP作成→GitHub→Cloudflareデプロイ、Discord連携など）に興味があれば、GM研修シリーズで個別に案内します。