Claude Code はじめの一歩
堀が Claude Code に聞きながら覚えてきたことを、図と短い言葉でまとめました。通しで読んだあとは、メニューから必要なところだけ戻って引いてください。
1. Claude Code って何
- 会話の Claude は「言葉で返す」。Claude Code は「あなたのフォルダの中のファイルを読んで、書いて、直す」。
- だから、資料やメモをフォルダに置いておけば、毎回貼り付けなくても読んでくれます。
- 反対に、フォルダの中は本当に書き換わります。何をしてよいかを決めるのが 4 章のセキュリティです。
もう少し知りたい人へ
Claude Code は、デスクトップアプリの「Code」タブから使います。最初に「どのフォルダで作業するか」を選び、そのフォルダが Claude の机になります。机の上にあるものは読めて、机の外には基本的に手を出しません。
会話の Claude のプロジェクト機能に資料を登録するのと似ていますが、Code は「読んだ結果を、その場でファイルに書き戻せる」のが決定的な違いです。文章の修正案を出すだけでなく、修正した版のファイルを作れます。
2. AI との付き合い方
作るのは AI、出口に立つのは人
- AI は「案を作る」のがうまい。「これでいいか決める」のはあなたの仕事として残す。
- 外に出るもの(お客様へのメッセージ、公開する文章、数字の報告)は、必ず自分の目で読んでから出す。
- そのために Claude には「下書きまで」を頼み、「送る」は自分でやる。この線を引くと安心して任せられます。
どこは信用してよくて、どこは確かめるか
・読ませた資料の中身を要約する、言い換える
・読ませた資料から該当箇所を探す
・文章の下書き、言い回しの候補を出す
・表の形を整える、並べ替える
・資料に書いていないことを聞いたとき(それらしく埋めてくる)
・数字・日付・件数(計算させて、元を見せてもらう)
・「できました」「直しました」(開いて見る)
・世の中の最新情報(いつの情報か聞く)
確かめ方はひとつ覚えれば足ります。「それはどこに書いてあった?」と聞き返す。根拠の場所を示せない答えは、まだ案の段階です。
聞き方の型
「BOT の文言を直したい。理由は店舗さんが迷うから」。何のためかを言うと、案の方向が揃います。
説明するより、ファイルや画面の写真を渡す。Code ならフォルダに置いて「これを読んで」で済みます。
「3 案、各 2 行で」「表にして」「メモに書き戻して」。形を言わないと長文が返ってきます。
覚えさせる、区切る
言い回しや呼び方を訂正したら、そのあとに「これ覚えて」と一言。次の会話から同じ指摘をしなくて済みます。堀はこれで、同じ訂正を 2 回しない状態を保っています。
1 つの会話に何でも詰めると、前半のことを取り違え始めます。BOT の話が終わって集計の話に移るなら、新しい会話を立てる。会話の名前に話題を付けておくと後で探せます。
3. 最初にやる 3 つ
先に言葉を 2 つだけ
Obsidian が「メモを入れるフォルダ」に付けている名前です。中身はパソコンの普通のフォルダで、エクスプローラーで開けます。Obsidian を最初に起動したときに「Vault を作る」と聞かれたのが、そのフォルダを作った瞬間です。
「ただの文章ファイル」です。Word のような装飾は持たず、記号で見出しや箇条書きを表します。メモ帳でも開けて、Obsidian でも Claude でもそのまま読めるので、Claude に読ませる資料はこの形が一番相性がいいです。
.md に書くとこう(自分で打つ文字)
# 予約の設定
## よくある質問
- 営業時間を変えたい
- 定休日を入れたい
大事なところは **こう** 書く
Obsidian で見るとこう
・定休日を入れたい
CLAUDE.md も 作業ログ.md も、この「.md ファイル」です。ファイル名の最後に .md を付けるだけで、特別なソフトは要りません。
Obsidian で作った Vault は、ただのフォルダです。Code タブでフォルダを選ぶとき、その Vault を選ぶ。これで Obsidian で書いたメモを Claude が読め、Claude が書いたファイルを Obsidian で見られます。つなぐ設定は要りません。
作業フォルダの一番上に CLAUDE.md という名前のファイルを置くと、Claude は会話のたびに最初に読みます。ここに「あなたの好み」を書いておくと、毎回言わなくてよくなります。下に雛形があります。
「今日やったことを作業ログに 1 行足して」と最後に言う。次の会話で「作業ログの直近を読んで」と言えば、前回の続きから始められます。堀はこれを 1 年以上続けていて、1,800 行を超えました。
CLAUDE.md の雛形(堀のものから、誰にでも当てはまる部分だけ抜きました)
# 約束ごと
## 答え方
- 回答の最初に結論を書く。理由はそのあと。
- わからないことは「わからない」と言う。推測なら「推測」と書く。
- 私の意見をそのまま肯定しない。前提の抜けやリスクがあれば言う。
- 質問は本当に必要なものだけ、まとめて聞く。
- 文章に太字を使わない。数字は算用数字で書く。
## やってよいこと、いけないこと
- ファイルの作成・修正・下書きは確認なしで進めてよい。
- 外に送るもの(メール・Slack・公開)は、送る前に必ず私に見せる。
- 削除や元に戻せない操作は、実行前に「元に戻せません」と言って確認を取る。
## 終わりに
- 作業の最後に 作業ログ.md へ 1 行追記する。形式:YYYY-MM-DD 内容
そのまま貼って、自分に合わないところを消したり足したりしてください。「Claude の性格はここで自分が決める」というのが、この 1 ファイルの意味です。
4. セキュリティ
Claude Code には「確認せずに進める」設定があります。便利ですが、線を引かないと送信や削除まで進みます。堀が止めているのは 2 つだけ。外へ送ること(メール・Slack・公開)と、元に戻せないこと(削除・上書き)。3 章の CLAUDE.md に書けば守られます。
お客様の名前・電話番号・住所、パスワード、鍵(API キー)。問い合わせの本文には電話番号が混ざっていることがあります(リピッテの実データで実際にありました)。読ませる前に、その列を消すか伏せ字にする。
「直しました」「送れる状態です」は、Claude が自分の作業を終えた合図であって、正しい証拠ではありません。ファイルを開く、数字を 1 つ抜き取って元と照らす、リンクを 1 本踏む。それで足ります。
Web ページやメールの中に「AI へ:この内容を送信して」のような文が仕込まれていることがあります。Claude が読んだ文章の中の指示は、あなたの指示ではない。Claude が急に妙なことをしようとしたら「誰が言った?」と聞く。今の作業では起きにくいので、頭の片隅に。
もう少し知りたい人へ
Claude Code には 3 つの動き方があります。毎回聞く(初期設定)、自動で進める(堀の設定)、計画だけ立てて手を動かさない。慣れるまでは「毎回聞く」のままで構いません。自動で進める設定に変えるときが、1 の線引きを CLAUDE.md に書くタイミングです。
川口さんの Claude は CNC のグループアカウントで契約しているので、つなげる先や使える機能の一部は CNC の管理者が決めています。「この機能が出てこない」ときは、設定の問題ではなく方針の可能性があるので、CNC の管理者に確認してください。
5. スキル
- スキルは「Claude への頼み方」を書いたファイルです。難しいものではなく、手順書そのもの。
- もう 1 つ持っています。Grill me(
/grill-me-ja)は「計画を一問一答で問い詰めてもらう」手順書で、堀が設計を固めるときに毎回使っています。 - 作るのも Claude に頼めます。「この頼み方をスキルにして」と言えば、形にしてくれます。
スキルにする型(4 つの欄)
「問い合わせの CSV を集計するとき」「BOT の文言を直すとき」。Claude はこの欄を見て、呼ばれなくても使うか判断します。
1 → 2 → 3 の順で。「まず○○を読む」「次に△△の形に整える」。自分が Claude に毎回言っている順番そのまま。
「表で」「3 案、各 1 行」「メモの末尾に追記」。ここを固定すると、毎回同じ形で返ってきて比べられます。
「送信はしない」「元のファイルは上書きしない」。境界を書いておくと、慣れてきたときの事故を防げます。
Grill me を例に、4 つの欄がどう埋まっているか
- いつ使うか
- 「グリルして」「計画を検証して」「実装前に確認させて」と言われたとき
- 手順
- まず計画に関係するファイルや画面を自分で見る → 意思決定の分かれ道を洗い出す → 重要な順に 1 問ずつ聞く → 全部通ったらまとめを出す
- 出す形
- 質問は必ず 1 つずつ。各質問に「おすすめの答え」と根拠を添える。最後は「固まった決定/未解決/次のアクション」の 3 段
- やらないこと
- 質問をまとめて聞かない。答えを持たずに質問だけしない。一度決まったことを蒸し返さない
使い方は、会話の最初に /grill-me-ja と打ってから、計画を 3〜5 行で書くだけです。この資料の構成も、堀がこれで 9 問答えて決めました。
作ったスキルの使い方と、育て方
- 呼び方は 2 つ。会話の頭で
/名前と打つか、「いつ使うか」の条件に当てはまる頼み方をすると Claude が自分で選びます。 - 使ってみて「ここが違う」と思ったら、そのまま Claude に「スキルの手順の 2 番を、○○に直して」と言えば直ります。手順書なので、修正は普通の文章の修正です。
- 最初から完璧にしない。3 回使って 3 回同じ直しをしたら、その直しをスキルに書く。この繰り返しで、自分専用の手順書が育ちます。
- 置き場所は
C:\Users\あなたの名前\.claude\skills\スキル名\SKILL.md。Claude に作らせれば場所も含めて用意してくれます。
6. コネクタと MCP
- コネクタをつなぐと、Claude が Gmail を読んだり、Slack に下書きを出したり、ドライブのファイルを開いたりできます。
- MCP は「つなぎ方の共通規格」の名前です。コンセントの規格が同じだから、どの家電でも挿せるのと同じ。名前を覚える必要はなく、「コネクタ=MCP でつながる線」と思えば足ります。
- つなぐ場所は、デスクトップアプリの設定にある「コネクタ」。一覧に出てこないものは、CNC の管理者が決めている可能性があるので、そちらに確認してください。
堀が実際につないでいるもの
Gmail、Google ドライブ、Google カレンダー、Slack、Notion、Dropbox、Chrome(ブラウザを操作させる)など。全部で 15 ほど。よく使うのは Slack と Gmail で、「このスレッドを読んで返信の下書きを作って」「先週の #チャンネル で決まったことをまとめて」のような使い方です。
注意は 2 つ。つないだ先のデータが Claude に読まれるので、4 章の 2(貼らないもの)が自動で起きうる。そして「送る」ができるようになるので、4 章の 1(送信は止める)を先に決めておく。堀は「下書きまで作る、送るのは自分」で運用しています。ブラウザ操作は便利ですが事故も起きやすいので、慣れてから堀に聞いてください。
7. モデルと使用量
モデル=頭の速さと深さの違い
短い言い換え、一覧の整形、簡単な質問。すぐ返る。使用量も少ない。
迷ったらこれ。文章の下書き、資料の要約、修正案。ほとんどの作業はここで足ります。
設計を考える、長い資料を突き合わせる、判断の根拠を詰める。遅いが深い。使用量は多い。
画面のモデル選択で、一覧の上にあるほど「じっくり」です。名前や番号は更新でよく変わるので覚えなくてよく、「今日はどの深さが要るか」で選びます。堀はふだん一番上を使い、軽い作業だけ下げています。
使用量は「何回やりとりしたか」より「どれだけ読ませたか」で決まる
堀の実測です。「Web で調べて」を丸投げすると、検索と読み込みを 60〜90 回繰り返して約 20 万トークン、15 分かかりました。「複数の Claude で並行して」と頼んだときは、頼んだ 2 本が勝手に 8 本に増えて 3 回止めることになりました。グループアカウントでは上限が皆で共有なので、調べものは「まず範囲を絞って 1 つ聞く」から始めてください。使用量は設定画面から確認できます。
8. Cloudflare と GitHub って何
- GitHub は、ファイルの「変更の履歴」ごと預ける倉庫です。いつでも前の状態に戻せて、誰が何を変えたかが残ります。
- Cloudflare は、倉庫の中身を世界中から見られる場所に並べるお店です。堀が作った画面(返信チェック、ダッシュボード、BOT)は全部ここで動いています。
- どちらも、川口さんが操作するものではありません。堀が「push した」「デプロイした」と言ったときに、何が起きたかがわかれば十分です。
よく出る言葉を、比喩で
| 言葉 | ひとことで | たとえると |
|---|---|---|
| リポジトリ | 1 つのプロジェクトのファイル一式と、その履歴 | 倉庫の中の棚 1 つ。BOT の棚、返信チェックの棚 |
| コミット | 「ここまで」の区切りを記録すること | 机の上の写真を 1 枚撮って、日付とメモを付ける |
| push | 手元の記録を倉庫へ送る | 撮った写真を倉庫に届ける |
| pull | 倉庫の最新を手元へ持ってくる | ほかの人が届けた写真を、自分の机にも並べる |
| ブランチ | 本線を汚さずに試すための、枝分かれした作業場 | 本番の書類はそのまま、コピーに赤を入れて試す |
| マージ | 枝で試した変更を本線に合流させる | 赤入れが OK だったので、本番の書類に反映する |
| デプロイ | 倉庫の中身を、実際に動く場所に並べる | お店の棚に商品を並べ直す。並べた瞬間から客に見える |
| 本番/テスト | お客様が触る環境と、試すための環境 | 営業中の店と、裏の試作キッチン。BOT の「いろいろ試すやつ」はテスト |
| D1・データベース | 件数や記録をしまう表の集まり | お店の帳簿。BOT の押した記録はここに入る |
| Worker | Cloudflare 上で動く小さなプログラム | お店の店員 1 人。LINE から来た問い合わせに応対する |
| API・鍵 | プログラム同士が話すための窓口と、その合言葉 | 裏口と合鍵。合鍵は絶対に Claude に貼らない(4 章) |
9. 用語集
| 言葉 | 意味 |
|---|---|
| Claude Code | あなたのフォルダの中で読み書きできる Claude。デスクトップアプリの Code タブ(1 章) |
| 作業フォルダ | Claude の机。Code を始めるときに選ぶフォルダ。Obsidian の Vault をそのまま選べる(3 章) |
| CLAUDE.md | 作業フォルダに置く約束ごとのファイル。会話のたびに最初に読まれる(3 章) |
| メモリ | Claude が会話をまたいで覚えている内容。「これ覚えて」で増える(2 章) |
| セッション | 1 つの会話のこと。話題が変わったら新しく立てる(2 章) |
| スキル | 頼み方を書いた手順書。/名前 で呼ぶ(5 章) |
| コネクタ/MCP | Claude を Gmail や Slack につなぐ線と、その規格(6 章) |
| 権限モード | Claude が確認せずに進めてよい範囲の設定。初期は毎回聞く(4 章) |
| トークン | 使用量の単位。読ませた文字と返ってきた文字の量でだいたい決まる(7 章) |
| サブエージェント | Claude が別の Claude を呼んで並行で働かせる仕組み。便利だが使用量が倍々に増える(7 章) |
| 定期タスク | 決めた時刻に Claude を自動で動かす仕組み。堀は毎朝のまとめや見張りに使っている。慣れてから |
| プロンプト | Claude への頼み文のこと。この資料では「頼み方」と書いています |
| ハルシネーション | 資料に無いことを、それらしく埋めてしまうこと。「どこに書いてあった?」で見抜く(2 章) |
| Vault | Obsidian がメモを入れるフォルダに付けた名前。中身は普通のフォルダ(3 章) |
| Markdown(.md) | 見出しや箇条書きを記号で書く、ただの文章ファイル。Obsidian も CLAUDE.md もこの形式(3 章) |