Claude Code
ハンズオン講義

Phase 0 — オープニング

今日の講義の目的と、持ち帰ってほしいマインドセット。

このフェーズでやること

• 自己紹介（講師 → 受講者）
• 今日 4 時間の流れのおさらい
• 事前準備の最終チェック
• 近くの人とペア設定

事前準備の最終チェック

以下がすべて通れば当日準備 OK：

node --version

v22.x 以降。

git --version

claude --version

Obsidian を起動して、スタート画面（新規 Vault が作れる画面）が出る状態。

ペア設定

近くの席の人と 2 人 1 組のペア を作ります。ハンズオン中に詰まったら、まずペアに相談してみましょう。同じ場所で詰まっている人がいれば、講師が全員に向けて解決方法をアナウンスします。

今日の流れ

• Phase 1（40 分）：Claude Code とは何か、何ができるか、基本操作
• Phase 2（70 分）：秘書（cc-secretary）を作る
• Phase 3（70 分）：第2の脳（arscontexta + Obsidian）を作る
• Phase 4（20 分）：振り返りと「種」を家で育てる話
• 休憩：Phase 1/2 の間と Phase 2/3 の間に 10 分ずつ

Phase 1 — Claude Code 入門

Claude Code とは何か、何ができるか、基本操作、自分仕様の入口までを一気通貫で体験。

1. Claude Code とは何か Mindset

普段使う Claude（チャット）や ChatGPT と近い技術ですが、できることが大きく違います。

ポイントは「育てる」こと。 最初は素の Claude Code ですが、使い続けるほど「あなた仕様の相棒」にしていけます。今日触るのはその入口です。

2. 何ができるか — 3 系統に整理 Mindset

Claude Code の用途は大まかに 3 系統に分けられます。今日の講義もこの 3 系統を順に体験します。

整理する

• 散らかったファイルをカテゴリ分け
• ダウンロードフォルダのリネーム・統合
• ログや議事録から必要情報だけ抜き出す

作る

• Web ページ・学習教材・スクリプトなど成果物を 1 から生成
• 既存コードの修正・機能追加
• アイデアを形にする

考える

• 壁打ち相手（企画、設計、文書レビュー）
• 秘書として日々のタスク・メモを整理（Phase 2 で体験）
• 第二の脳として知識を蓄積（Phase 3 で体験）

3. Claude Code を起動する

「ターミナル」を開きます — Windows なら PowerShell、macOS なら ターミナル。事前準備で開き方は確認済みのはずです。

ターミナルで以下を実行：

claude

初回はブラウザが立ち上がり、Anthropic アカウントのサインイン画面が出ます。 サインイン後、ターミナルに戻ると Claude Code のプロンプト欄（> で始まる入力欄）が起動しています。これ以降の指示は このプロンプト欄に日本語で入力 していきます。

4. 最初のプロンプト — 対話で決める

まずは チャット AI との違い を感じるプロンプトから。いきなりファイルを作らせるのではなく、何を作るかを対話で決める ところから始めます。

このフォルダで自己紹介ファイル about-me.md を作りたい。
どんな項目を書くとよさそうか、構成案を提案して。

Claude が「名前 / 役割 / 興味のあること / 使っているツール …」のような 構成案（骨組み） を返してくれます。この時点ではまだファイルは作られていません。

5. ファイル操作：作る・読む・書き換える Hands-on

ここからが ハンズオンの本番。Claude Code に実ファイルを触ってもらいます。

5-1. 作る

Claude Code は 起動した作業フォルダ を見ているので、ファイル名だけで指示すればそこに作ってくれます（フルパスは不要）。

hello.txt を作って、中身に "hello from Claude Code" と書いて

5-2. 読む

hello.txt の中身を読んで

5-3. 書き換える

hello.txt の末尾に "こんにちは" を追記して

6. 許可ダイアログの使い分け

初めてのコマンドは Allow once、頻出になってきたら Always allow が無難です。

7. 覚えておきたいコマンド

--dangerously-skip-permissions は強力すぎるので 今日は使いません（存在だけ覚えておけば OK）。

8. Claude Code 理解の基礎：ディレクトリ構造と .claude/

ここは 今日の残りの学びに直結する基礎 です。初学者の方も一緒にやりましょう。Claude Code を「自分仕様」にしていく仕組みは、ほぼ全てが 特定の場所に置かれたファイル を Claude Code が読んで振る舞いを変える、という形で動いています。どこに何を置くと何が変わるのか、この章で掴みます。

8-1. どのフォルダで Claude Code を起動するか

Claude Code は 起動したフォルダ を「作業範囲」として見ます。たとえば C:/Users/<あなた>/project-a/ で起動すると、そのフォルダ配下のファイルを読んだり書いたりします（<あなた> の部分は自分のユーザー名に読み替えてください、以降の例も同様）。

8-2. CLAUDE.md はプロジェクトへの「お願い」

プロジェクトのルートに CLAUDE.md という Markdown ファイルを置くと、そのフォルダで claude を起動した時に 自動で読まれます。あなた専用の「お願い」をここに書いておけます。

例（先ほど §5 で作業した作業フォルダの直下に CLAUDE.md を作る）：

このプロジェクトでは常に日本語で応答してください。
コードを書くときは TypeScript を優先してください。

CLAUDE.md は起動時に読まれます。今いるセッションを 再起動（/exit → claude、§3 で定義済み）してから何か質問してみてください。日本語で応答が返るはずです。

8-3. .claude/ の中身と適用範囲

Claude Code の「自分仕様」は 2 つの層で同じ構造が並びます。プロジェクト層（今いるフォルダ専用）と グローバル層（あなたの全プロジェクト共通）です。

プロジェクト層 — 今いるフォルダ直下に置くファイル／フォルダ：

my-project/
├── CLAUDE.md                   ← このプロジェクト用の「お願い」
└── .claude/
    ├── settings.json           ← 許可・環境変数・フック登録
    ├── settings.local.json     ← ローカル専用の上書き（git 管理外）
    ├── commands/               ← スラッシュコマンド（/daily など）
    ├── skills/                 ← スキル定義
    ├── agents/                 ← サブエージェント定義
    └── hooks/                  ← フックから呼ぶスクリプト置き場

グローバル層 — ホームディレクトリ直下：

~/.claude/        ← Windows: C:\Users\<あなた>\.claude\
├── CLAUDE.md     ← どのプロジェクトでも読まれる個人メモ
├── settings.json ← あなた個人のデフォルト許可・環境変数
├── commands/     ← どこでも呼べるスラッシュコマンド
├── skills/       ← あなた専用のスキル
└── agents/       ← どこでも呼べるサブエージェント

どちらに置くと、どこで効くか:

覚え方:

• グローバル に置くと → あなた個人の Claude Code 全体に効く
• プロジェクト に置くと → そのフォルダで起動したときだけ効く
• 先にグローバルが読まれ、プロジェクトが上書き する（プロジェクトが優先）

図で見る「上書き順序」 — どっちの CLAUDE.md が勝つ？

両方に CLAUDE.md があると、Claude Code は 上から順番に読み込み、あとから来たものが勝つ ように扱います。さらに、その上にあなたが書く プロンプト指示 が乗ります。

矛盾したら下が勝ち。たとえば、

• グローバル: 「常に英語で応答してください」
• プロジェクト: 「このプロジェクトでは日本語で応答してください」

→ そのプロジェクトでは 日本語 が勝ちます。さらに会話中に「今だけ英語で答えて」と言えば、その 1 ターンだけ英語になります（プロンプトが最強）。

「お願い」と「ガード」と「自動実行」 — 強制力の違い

CLAUDE.md は強い装置に見えますが、本質は 「お願い」 です。Claude Code が読んで従う努力をしますが、長い会話で忘れたり、巧妙な指示で上書きされたりすることがあります。「絶対に毎回 X してほしい」 というルールは、書く場所で強制力が変わります。

Phase 2 でプラグインをインストールすると、この .claude/ の中身が自動で増えていきます。今日は「どこに置くとどこで効くか」のイメージを持っておけば十分です。

8-4. .claude/ の中身は何をする？ — 4 つの「自分仕様パーツ」

.claude/ の中の commands/ skills/ agents/ hooks/ は、それぞれ役割と発動タイミングが違います。何を入れると、いつ動くか を一枚の図でつかんでください。

{
  "permissions": {
    "allow": ["Bash(ls:*)", "Bash(cat:*)"]
  }
}

Phase 2 — 秘書を作る

前半で「まず動く秘書」を立ち上げ、後半で自分仕様に育てる第一歩まで。

前半：まず動く秘書を立ち上げる Hands-on

今日の目標は「完璧な秘書」ではなく、明日から毎朝触れる秘書の原型 を立ち上げることです。

1. cc-secretary をインストール

Claude Code には プラグイン という仕組みがあり、外部の機能（スラッシュコマンド・スキル・サブエージェントなど）を後付けで追加できます。今回は「秘書」プラグイン cc-secretary を入れます。

導入は 2 ステップ です。1 行ずつコピーして Enter で実行 してください（2 行を一度にコピペすると 1 つのコマンドとして扱われ失敗します）。

ステップ 1: マーケットプレイスを登録

Claude Code のプロンプト欄で:

/plugin marketplace add Shin-sibainu/cc-secretary

→ cc-secretary が配布されている GitHub リポジトリを Claude Code に「お店」として登録します。この段階ではまだ何もインストールされません。

ステップ 2: プラグイン本体をインストール

/plugin install secretary@cc-secretary

→ 先ほど登録した「お店」から secretary プラグインを実際にインストールします。@ の後ろは「どのお店から取るか」を指定するマーケットプレイス名です。

2. オンボーディング

/secretary

秘書からヒアリングが始まります（役割／1 日の流れ／管理したい領域）。OK で .secretary/ が自動生成されます。

3. 基本操作：タスク・今日・メモ

/secretary

→ 「何をしますか？」

タスク追加 明日の MTG 資料を作る

今日のタスク

メモ 気になった記事：xxx.com/article

後半：自分仕様に育てる Mindset

ここから先は「完成」ではなく「種を持ち帰る」章です。完走できなくても OK、家で続ける前提 で取り組んでください。

4. カテゴリを 1 つ追加

自分の仕事・生活に合うカテゴリを 1 つ足してみましょう。読書が趣味なら reading-list、家事管理なら chores など。

/secretary

カテゴリ追加 reading-list

.secretary/reading-list/ が追加されるはず。

5. 生成物を覗く

ファイラーや Cursor で .secretary/ フォルダを開いてみましょう。

• カテゴリごとのフォルダとテンプレート
• inbox/（メモのキャプチャ先）
• reviews/（週次・月次レビュー）

Claude Code が何を管理しているかが見えます。このフォルダを覗く習慣 をつけると、秘書との距離が縮まります。

---
description: 朝のルーチン
---

今日のタスクを秘書に表示させ、inbox の整理提案もしてください。

Phase 3 — 第二の脳を作る

Obsidian をまずはメモアプリとして触り、arscontexta で第二の脳へ拡張する。

1. Obsidian は「ただのメモアプリ」 Mindset

Obsidian は難しそうなイメージがありますが、最初は「メモアプリ」として触るだけで十分 です。

• Markdown でメモを書ける
• フォルダ分けできる
• ファイルなのでバックアップもコピーも簡単
• クラウド不要、ローカルで動く

「日記」「気になった記事のメモ」「思いついたアイデア」 を入れていく場所、くらいの気持ちで使い始めましょう。

1-1. 新規 Vault を作ってみる

Obsidian を起動 → 「新規 Vault を作成」→ 適当な場所（例：C:/Users/<あなた>/obsidian-test/、<あなた> は自分のユーザー名）。

空の Vault が開くはず。右クリック → 新規ノート → 適当に何か書いてみる。

2. Obsidian の画面ツアーとデモ

Vault が開いたら、まず Obsidian で何ができるかを触って感じてみましょう。ここで押さえるのは 基本画面 + 6 つの操作 だけです。

2-1. 基本画面の見方

• 左サイドバー: ファイル一覧・検索・タグ・ブックマーク（表示切替はリボンで）
• 中央エディタ: Markdown でノートを書く本体。Ctrl/⌘ + E で編集⇄プレビュー切替
• 右サイドバー: アウトライン・バックリンク・タグ一覧（初期状態では隠れていることあり。右端の『>』で展開）
• 左端のリボン: コマンドパレット・グラフビュー・設定アイコンが並ぶ縦バー
• 下部のステータスバー: 単語数・同期状態・カーソル位置など

2-2. ノート作成・リンク・タグ・検索を触ってみる

1. ノートを新規作成

Ctrl + N（Mac: ⌘ + N）か、左サイドバー上部の「新規ノート」アイコン。ファイル名は例として「Claude Code 学習メモ」など自由に。

2. Markdown の基本書式

# 見出し

**太字** と _斜体_ と `インラインコード`

- 箇条書き
- もう 1 つ

3. Wiki リンク [[...]] — Obsidian のキモ

今日は [[Claude Code 入門]] を受講した。

[[ と打つと既存ノートが候補で出ます。まだ存在しないノート名 を書いてリンクをクリックすると、そのノートが新規作成されます。ノート同士を網のように繋いでいけるのが Obsidian の真骨頂。

4. タグ #

#todo #読書 #ideas

本文中に # で始まる単語を書くだけでタグ扱いになり、左サイドバーの「タグ」ペインで一覧・絞り込みができます。

5. 全文検索

Ctrl + Shift + F（Mac: ⌘ + Shift + F）で Vault 全体から検索。単語・タグ・正規表現まで対応。

6. グラフビュー

左リボンの「グラフビュー」アイコンを押すと、ノート同士の繋がりが可視化 されます。最初は点がばらけているだけですが、リンクを貼るほど網が広がり、知識の地図になっていきます。

3. Obsidian × Claude Code の連携（紹介のみ・家で育てる用）

Obsidian 単体でも便利ですが、Claude Code と組み合わせると「メモを溜める」から「メモを対話で育てる」に変わります。繋ぎ方は 2 方向あります:

• Obsidian 側から Claude Code を呼ぶ — Claudian プラグイン：Obsidian のウィンドウ内に Claude Code のチャット欄が現れ、別ウィンドウに切り替えずに Markdown 編集と AI 指示を行き来できる。Claude Pro 以上のサブスク前提。
• Claude Code 側で Obsidian を賢く扱う — Obsidian Skills：Obsidian の作者 kepano が公開している Claude Code 向けスキルセット。Wiki リンクやコールアウトなど Obsidian 記法で出力させたり、.canvas / .base を扱わせたりできる。必要なときだけ読み込まれるのでトークン消費を抑えられる。

どちらも便利ですが 対面では触らず、家で時間をかけて育ててください。詳細な導入手順は下の折りたたみに残しています。

# defuddle スキル用（Web ページのクリーン変換）
npm install -g defuddle-cli

4. arscontexta で「第二の脳」へ拡張

ここから Claude Code と合流します。単なるメモ置き場 を、Claude Code から質問・参照できる知識システム に育てます。

4-0. arscontexta は何をしている？（30 秒で読む）

arscontexta は 「知識システム導出エンジン」 です。テンプレートを配るのではなく、あなたの仕事や思考の性質を 2〜4 ターンの対話で聞き、内蔵された 249 件の研究知見 に基づいて「あなた専用の Vault 構造・処理パイプライン・MOC・テンプレート」を 導き出して 書き出します。

ポイント:

• テンプレ配布ではなく、対話で導出 — 同じ生成は二度と起きない
• 出力は プレーンな Markdown のみ — クラウドや DB に縛られない、git で履歴管理可能
• 生成物に Claude Code 用のスキル / hook / サブエージェント が含まれていて、そのまま 実行基盤 として動く

つまり、「知識を貯める場所」と「それを処理する仕組み」がワンセットで生成されるのが arscontexta の特徴です。

4-1. プラグインをインストール

Claude Code のプロンプト欄で：

/plugin marketplace add agenticnotetaking/arscontexta

/plugin install arscontexta@agenticnotetaking

4-2. /arscontexta:setup を起動

再起動後：

/arscontexta:setup

2〜4 ターンの対話が始まります。あなたの仕事や思考の性質を自然文で説明してください。

4-3. 再起動 2 回目

5. 生成物を Obsidian で開く

Claude Code が教えてくれた Vault の場所を覚えておきます。Obsidian → 「Open folder as vault」でそのフォルダを選択。

見どころ：

• ルートの Maps of Content（MOC） ファイル
• カテゴリ別フォルダとテンプレート
• .claude/ 配下のフック／スキル
• 自動生成された user manual（7 ページ）
• 三空間構造：self/（エージェントの「心」 — identity / methodology / goals）、notes/（知識グラフ本体 — atomic notes が wiki link で繋がる）、ops/（運用状態 — queue / sessions / health / config）

6. inbox にメモを書き溜める Hands-on

Obsidian で inbox/ フォルダ を開いて、ラフなメモを 2〜3 件 書きます。整形は不要、思いついたことを箇条書きでOK。

おすすめのお題（自由に変えてください）:

1. ファイル名「Claude Code ハンズオン初日.md」 — 今日学んだコマンドや感想を 5〜10 行
2. ファイル名「普段の作業メモ.md」 — 自分の仕事で困っている／繰り返している作業を 3〜5 行
3. ファイル名「気になっている本や記事.md」 — 今気になっている話題を 2〜3 行

7. /pipeline で整理してもらう Hands-on

ここがハンズオンのクライマックスです。さっき書き殴ったメモを、Claude Code が 整理して atomic note に分解 → 既存ノートと双方向リンクを貼る → MOC を更新する までを自動でやってくれます。

7-1. パイプラインを実行

Vault フォルダで起動した Claude Code のプロンプト欄で：

/pipeline

7-2. 結果を Obsidian で確認

完了後、Obsidian に戻って 以下が変わっている ことを確認します:

• notes/：inbox の素材から atomic note（小さな主張ごとに分かれたノート）が生成されている
• MOC（Maps of Content）：新しいノートが 文脈句付き でリストに追加されている
• 既存ノート：双方向リンクが貼られ、グラフビューで点同士が線で繋がる
• inbox/：処理済みになったメモが移動 or マークされる
• ops/queue/queue.json：処理状況の記録（中身は気にしなくて OK、確認だけ）

7-3. /arscontexta:ask で引き出す（仕上げ）

整理が終わった Vault に向けて、自然文で問い合わせてみます。

/arscontexta:help

でコマンド一覧を確認したら：

/arscontexta:ask Claude Code について今日学んだことを教えて

整理された atomic note を 出典（ノートへのリンク）付きで 引いてきて答えてくれます。pipeline で整理した直後だと、結果がぐっと豊かになります。

8. 裏側で何が起きているか（家で読む用）

ここから先は 対面では飛ばします。家で「なぜこれが動くのか」を追いたい人向けの解説です。

/arscontexta:health

/arscontexta:add-domain

inbox/ の新規ファイルを処理して、適切なカテゴリに振り分けて

Phase 4 — クロージング

今日の 4 つのメッセージを回収し、家で育てるための導線を確認する。

1. 今日持ち帰れた 4 つを確認

2. 何を作れたか、自分の言葉で

ペアと 2 分ずつ、今日何を作ったか／何が意外だったか を話してみてください。言葉にすると定着します。

3. チートシート

4. 家でやってほしい宿題（1 週間）

秘書

• 毎朝 /secretary で 今日のタスク登録 を 1 つする
• 金曜に 週次レビュー を走らせてみる

第二の脳

• Vault に 3 つのノート を追加（日記・学習メモ・記事要約、何でも）
• 1 週間後に /arscontexta:ask で、自分が書いたノートに関する質問を投げてみる

繋ぐ（余裕があれば）

• .secretary/inbox/ のメモを、第二の脳 Vault に流してみる

5. Q&A

• 詰まった箇所
• 「これ可能ですか？」の相談
• 次に学びたいこと

この場で解決できないものは、後日 Issue / DM で受け付けます。