Claude Code はじめの一歩

堀が Claude Code に聞きながら覚えてきたことを、図と短い言葉でまとめました。通しで読んだあとは、メニューから必要なところだけ戻って引いてください。

この資料のゴール自分の資料やメモを Claude Code に読ませて、文章の修正案を自分で出せるようになる
いちばん大事な考え方作るのは AI、出口に立つのは人。外に出す前に自分の目で見る
読む順番1 → 2 → 3 → 4 で使い始められます。5 以降は慣れてから

1. Claude Code って何

会話の Claude と、何が違うのか
会話の Claude(claude.ai) この文章を直して こう直しました 言葉で聞いて、言葉で返る。ファイルには触れない Claude Code メモを直して 読む → 書く → 直す → 確かめる あなたのパソコンの中のフォルダで、実際に手を動かす
  • 会話の Claude は「言葉で返す」。Claude Code は「あなたのフォルダの中のファイルを読んで、書いて、直す」。
  • だから、資料やメモをフォルダに置いておけば、毎回貼り付けなくても読んでくれます。
  • 反対に、フォルダの中は本当に書き換わります。何をしてよいかを決めるのが 4 章のセキュリティです。
もう少し知りたい人へ

Claude Code は、デスクトップアプリの「Code」タブから使います。最初に「どのフォルダで作業するか」を選び、そのフォルダが Claude の机になります。机の上にあるものは読めて、机の外には基本的に手を出しません。

会話の Claude のプロジェクト機能に資料を登録するのと似ていますが、Code は「読んだ結果を、その場でファイルに書き戻せる」のが決定的な違いです。文章の修正案を出すだけでなく、修正した版のファイルを作れます。

2. AI との付き合い方

どこまで任せて、どこから自分が見るか

作るのは AI、出口に立つのは人

あなたが頼む何を、何のために AI が作る下書き・案・集計 あなたが確かめる読む・数える・試す 外に出す 送る・公開する・決める ここに人が立つ
  • AI は「案を作る」のがうまい。「これでいいか決める」のはあなたの仕事として残す。
  • 外に出るもの(お客様へのメッセージ、公開する文章、数字の報告)は、必ず自分の目で読んでから出す。
  • そのために Claude には「下書きまで」を頼み、「送る」は自分でやる。この線を引くと安心して任せられます。

どこは信用してよくて、どこは確かめるか

だいたい信用してよい

・読ませた資料の中身を要約する、言い換える
・読ませた資料から該当箇所を探す
・文章の下書き、言い回しの候補を出す
・表の形を整える、並べ替える

自分で確かめる

・資料に書いていないことを聞いたとき(それらしく埋めてくる)
・数字・日付・件数(計算させて、元を見せてもらう)
・「できました」「直しました」(開いて見る)
・世の中の最新情報(いつの情報か聞く)

確かめ方はひとつ覚えれば足ります。「それはどこに書いてあった?」と聞き返す。根拠の場所を示せない答えは、まだ案の段階です。

聞き方の型

目的を先に

「BOT の文言を直したい。理由は店舗さんが迷うから」。何のためかを言うと、案の方向が揃います。

現物を渡す

説明するより、ファイルや画面の写真を渡す。Code ならフォルダに置いて「これを読んで」で済みます。

出口の形を言う

「3 案、各 2 行で」「表にして」「メモに書き戻して」。形を言わないと長文が返ってきます。

あなたBOT対応メモ.md を読んで。リッチメニューの「不具合かも」の項目名を、店舗さんが迷わない言い方に変えたい。案を 3 つ、各 1 行で。理由も 1 行ずつ。
Claude読みました。現在の項目名は「不具合かも」で、一覧には 8 項目あります。案:1 …/2 …/3 …(それぞれ理由つき)
あなた2 案でいく。メモの該当行を書き換えて、変えた場所を教えて。

覚えさせる、区切る

直したら「これ覚えて」

言い回しや呼び方を訂正したら、そのあとに「これ覚えて」と一言。次の会話から同じ指摘をしなくて済みます。堀はこれで、同じ訂正を 2 回しない状態を保っています。

話題が変わったら新しい会話

1 つの会話に何でも詰めると、前半のことを取り違え始めます。BOT の話が終わって集計の話に移るなら、新しい会話を立てる。会話の名前に話題を付けておくと後で探せます。

3. 最初にやる 3 つ

これだけで、Claude が毎回あなたのことを忘れなくなる

先に言葉を 2 つだけ

Vault(ボルト)って何

Obsidian が「メモを入れるフォルダ」に付けている名前です。中身はパソコンの普通のフォルダで、エクスプローラーで開けます。Obsidian を最初に起動したときに「Vault を作る」と聞かれたのが、そのフォルダを作った瞬間です。

.md ファイルって何

「ただの文章ファイル」です。Word のような装飾は持たず、記号で見出しや箇条書きを表します。メモ帳でも開けて、Obsidian でも Claude でもそのまま読めるので、Claude に読ませる資料はこの形が一番相性がいいです。

.md に書くとこう(自分で打つ文字)

# 予約の設定
## よくある質問
- 営業時間を変えたい
- 定休日を入れたい

大事なところは **こう** 書く

Obsidian で見るとこう

予約の設定
よくある質問
・営業時間を変えたい
・定休日を入れたい
大事なところは こう 書く

CLAUDE.md も 作業ログ.md も、この「.md ファイル」です。ファイル名の最後に .md を付けるだけで、特別なソフトは要りません。

Vault Obsidian のフォルダ ① ここを作業フォルダに選ぶ CLAUDE.md 約束ごと。毎回読まれる ② 約束を書く 作業ログ.md 09-16 BOT 文言 3 案 09-17 集計の形を決めた 09-18 … 終わりに 1 行足す ③ 1 行残す 資料たち BOT対応メモ.md 問い合わせ集計.xlsx 読ませたいものは全部ここ
1Vault を作業フォルダに

Obsidian で作った Vault は、ただのフォルダです。Code タブでフォルダを選ぶとき、その Vault を選ぶ。これで Obsidian で書いたメモを Claude が読め、Claude が書いたファイルを Obsidian で見られます。つなぐ設定は要りません。

2CLAUDE.md に約束を書く

作業フォルダの一番上に CLAUDE.md という名前のファイルを置くと、Claude は会話のたびに最初に読みます。ここに「あなたの好み」を書いておくと、毎回言わなくてよくなります。下に雛形があります。

3終わりに作業ログを 1 行

「今日やったことを作業ログに 1 行足して」と最後に言う。次の会話で「作業ログの直近を読んで」と言えば、前回の続きから始められます。堀はこれを 1 年以上続けていて、1,800 行を超えました。

CLAUDE.md の雛形(堀のものから、誰にでも当てはまる部分だけ抜きました)
# 約束ごと

## 答え方
- 回答の最初に結論を書く。理由はそのあと。
- わからないことは「わからない」と言う。推測なら「推測」と書く。
- 私の意見をそのまま肯定しない。前提の抜けやリスクがあれば言う。
- 質問は本当に必要なものだけ、まとめて聞く。
- 文章に太字を使わない。数字は算用数字で書く。

## やってよいこと、いけないこと
- ファイルの作成・修正・下書きは確認なしで進めてよい。
- 外に送るもの(メール・Slack・公開)は、送る前に必ず私に見せる。
- 削除や元に戻せない操作は、実行前に「元に戻せません」と言って確認を取る。

## 終わりに
- 作業の最後に 作業ログ.md へ 1 行追記する。形式:YYYY-MM-DD 内容

そのまま貼って、自分に合わないところを消したり足したりしてください。「Claude の性格はここで自分が決める」というのが、この 1 ファイルの意味です。

4. セキュリティ

4 つだけ。この順番で身につける
1 勝手にやる範囲送る・消すは止める 2 貼らないもの個人情報・パスワード 3 確かめ方出す前に開いて見る 4 外から来た文章命令が混ざっている
1勝手にやる範囲を決める

Claude Code には「確認せずに進める」設定があります。便利ですが、線を引かないと送信や削除まで進みます。堀が止めているのは 2 つだけ。外へ送ること(メール・Slack・公開)と、元に戻せないこと(削除・上書き)。3 章の CLAUDE.md に書けば守られます。

2貼らないもの

お客様の名前・電話番号・住所、パスワード、鍵(API キー)。問い合わせの本文には電話番号が混ざっていることがあります(リピッテの実データで実際にありました)。読ませる前に、その列を消すか伏せ字にする。

3出す前に開いて見る

「直しました」「送れる状態です」は、Claude が自分の作業を終えた合図であって、正しい証拠ではありません。ファイルを開く、数字を 1 つ抜き取って元と照らす、リンクを 1 本踏む。それで足ります。

4外から来た文章の罠

Web ページやメールの中に「AI へ:この内容を送信して」のような文が仕込まれていることがあります。Claude が読んだ文章の中の指示は、あなたの指示ではない。Claude が急に妙なことをしようとしたら「誰が言った?」と聞く。今の作業では起きにくいので、頭の片隅に。

もう少し知りたい人へ

Claude Code には 3 つの動き方があります。毎回聞く(初期設定)、自動で進める(堀の設定)、計画だけ立てて手を動かさない。慣れるまでは「毎回聞く」のままで構いません。自動で進める設定に変えるときが、1 の線引きを CLAUDE.md に書くタイミングです。

川口さんの Claude は CNC のグループアカウントで契約しているので、つなげる先や使える機能の一部は CNC の管理者が決めています。「この機能が出てこない」ときは、設定の問題ではなく方針の可能性があるので、CNC の管理者に確認してください。

5. スキル

毎回同じ頼み方をしているなら、それは 1 つのファイルにできる
気づく 「また同じ頼み方をしている」 手順を書き出す いつ・何を・どの順でどんな形で出すか SKILL.md に置く .claude/skills/名前/に 1 ファイル /名前 で呼ぶ 会話の頭で打つだけ。毎回説明しなくてよい スキル=あなたの頼み方を書いた手順書。レシピをカードにして引き出しに入れるのと同じ
  • スキルは「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 を、あなたが毎日使うサービスにつなぐ口
Claude Gmail Slack ドライブ Notion カレンダー 線の規格 = MCP / 1 本 1 本の線 = コネクタ
  • コネクタをつなぐと、Claude が Gmail を読んだり、Slack に下書きを出したり、ドライブのファイルを開いたりできます。
  • MCP は「つなぎ方の共通規格」の名前です。コンセントの規格が同じだから、どの家電でも挿せるのと同じ。名前を覚える必要はなく、「コネクタ=MCP でつながる線」と思えば足ります。
  • つなぐ場所は、デスクトップアプリの設定にある「コネクタ」。一覧に出てこないものは、CNC の管理者が決めている可能性があるので、そちらに確認してください。
堀が実際につないでいるもの

Gmail、Google ドライブ、Google カレンダー、Slack、Notion、Dropbox、Chrome(ブラウザを操作させる)など。全部で 15 ほど。よく使うのは Slack と Gmail で、「このスレッドを読んで返信の下書きを作って」「先週の #チャンネル で決まったことをまとめて」のような使い方です。

注意は 2 つ。つないだ先のデータが Claude に読まれるので、4 章の 2(貼らないもの)が自動で起きうる。そして「送る」ができるようになるので、4 章の 1(送信は止める)を先に決めておく。堀は「下書きまで作る、送るのは自分」で運用しています。ブラウザ操作は便利ですが事故も起きやすいので、慣れてから堀に聞いてください。

7. モデルと使用量

選び方は 1 つ。使い方で減り方が変わる

モデル=頭の速さと深さの違い

速い

短い言い換え、一覧の整形、簡単な質問。すぐ返る。使用量も少ない。

ふだん

迷ったらこれ。文章の下書き、資料の要約、修正案。ほとんどの作業はここで足ります。

じっくり

設計を考える、長い資料を突き合わせる、判断の根拠を詰める。遅いが深い。使用量は多い。

画面のモデル選択で、一覧の上にあるほど「じっくり」です。名前や番号は更新でよく変わるので覚えなくてよく、「今日はどの深さが要るか」で選びます。堀はふだん一番上を使い、軽い作業だけ下げています。

使用量は「何回やりとりしたか」より「どれだけ読ませたか」で決まる

短い質問 1 回
ごく少し
メモを読ませて修正案
少し
Web 調査を丸投げ 1 回
約 20 万
調査を「並行で」と頼む
倍々

堀の実測です。「Web で調べて」を丸投げすると、検索と読み込みを 60〜90 回繰り返して約 20 万トークン、15 分かかりました。「複数の Claude で並行して」と頼んだときは、頼んだ 2 本が勝手に 8 本に増えて 3 回止めることになりました。グループアカウントでは上限が皆で共有なので、調べものは「まず範囲を絞って 1 つ聞く」から始めてください。使用量は設定画面から確認できます。

8. Cloudflare と GitHub って何

堀がよく口にする言葉を、仕組みとして
手元の机 あなたのパソコンの作業フォルダ コミット=写真を撮る push(送る) pull(持ってくる) 倉庫 = GitHub 写真を全部しまう。誰がいつ何を変えたか残る リポジトリ=棚 1 つ デプロイ お店 = Cloudflare 倉庫の中身を並べて、URL で誰でも見られる https://… この資料そのものが、机 → 倉庫 → お店 と通ってあなたの画面に出ています リピッテの BOT や返信チェックの画面も同じ経路。「デプロイした」=「お店に並べ直した」
  • GitHub は、ファイルの「変更の履歴」ごと預ける倉庫です。いつでも前の状態に戻せて、誰が何を変えたかが残ります。
  • Cloudflare は、倉庫の中身を世界中から見られる場所に並べるお店です。堀が作った画面(返信チェック、ダッシュボード、BOT)は全部ここで動いています。
  • どちらも、川口さんが操作するものではありません。堀が「push した」「デプロイした」と言ったときに、何が起きたかがわかれば十分です。

よく出る言葉を、比喩で

言葉ひとことでたとえると
リポジトリ1 つのプロジェクトのファイル一式と、その履歴倉庫の中の棚 1 つ。BOT の棚、返信チェックの棚
コミット「ここまで」の区切りを記録すること机の上の写真を 1 枚撮って、日付とメモを付ける
push手元の記録を倉庫へ送る撮った写真を倉庫に届ける
pull倉庫の最新を手元へ持ってくるほかの人が届けた写真を、自分の机にも並べる
ブランチ本線を汚さずに試すための、枝分かれした作業場本番の書類はそのまま、コピーに赤を入れて試す
マージ枝で試した変更を本線に合流させる赤入れが OK だったので、本番の書類に反映する
デプロイ倉庫の中身を、実際に動く場所に並べるお店の棚に商品を並べ直す。並べた瞬間から客に見える
本番/テストお客様が触る環境と、試すための環境営業中の店と、裏の試作キッチン。BOT の「いろいろ試すやつ」はテスト
D1・データベース件数や記録をしまう表の集まりお店の帳簿。BOT の押した記録はここに入る
WorkerCloudflare 上で動く小さなプログラムお店の店員 1 人。LINE から来た問い合わせに応対する
API・鍵プログラム同士が話すための窓口と、その合言葉裏口と合鍵。合鍵は絶対に Claude に貼らない(4 章)

9. 用語集

この資料に出てきた言葉と、出てこなかったけど聞く言葉
言葉意味
Claude Codeあなたのフォルダの中で読み書きできる Claude。デスクトップアプリの Code タブ(1 章)
作業フォルダClaude の机。Code を始めるときに選ぶフォルダ。Obsidian の Vault をそのまま選べる(3 章)
CLAUDE.md作業フォルダに置く約束ごとのファイル。会話のたびに最初に読まれる(3 章)
メモリClaude が会話をまたいで覚えている内容。「これ覚えて」で増える(2 章)
セッション1 つの会話のこと。話題が変わったら新しく立てる(2 章)
スキル頼み方を書いた手順書。/名前 で呼ぶ(5 章)
コネクタ/MCPClaude を Gmail や Slack につなぐ線と、その規格(6 章)
権限モードClaude が確認せずに進めてよい範囲の設定。初期は毎回聞く(4 章)
トークン使用量の単位。読ませた文字と返ってきた文字の量でだいたい決まる(7 章)
サブエージェントClaude が別の Claude を呼んで並行で働かせる仕組み。便利だが使用量が倍々に増える(7 章)
定期タスク決めた時刻に Claude を自動で動かす仕組み。堀は毎朝のまとめや見張りに使っている。慣れてから
プロンプトClaude への頼み文のこと。この資料では「頼み方」と書いています
ハルシネーション資料に無いことを、それらしく埋めてしまうこと。「どこに書いてあった?」で見抜く(2 章)
VaultObsidian がメモを入れるフォルダに付けた名前。中身は普通のフォルダ(3 章)
Markdown(.md)見出しや箇条書きを記号で書く、ただの文章ファイル。Obsidian も CLAUDE.md もこの形式(3 章)