2026/11/22

第3回 VS Code + Claude Code — 机に秘書を足す

この記事は「第2回 Cursor 入門 — 常駐する秘書と安全な頼み方 (Part 2)」の続きですが、この記事だけでも単独で読めるように書いてあります。この記事は、CursorよりもClaude CodeをVS Codeで使いたい学生さんのために書きました。

第3回 VS Code + Claude Code — 机に秘書を足す

今日たどる一本の道(通奏シナリオ)

ドキュメント\ClaudeWorkspace\2026-session03\practice-session03.md

教室では、上と同じ場所に練習用の .md を1つ用意します(名前は講師の指示に合わせてよい)。既に別講座で practice-session01.md がある人は、それを ClaudeWorkspace 配下に置いて通奏にしても構いません。

この文書の読み方(単独でも読めます)

これは系列の 第3回 ですが、このファイルだけ読んでも進められるように書いてあります。VS Code・マークダウン・命名・秘書(エージェント)の要点は、必要な箇所で短く説明します。

  • 初めての人: 上から順に。わからない操作はスクショを付けて AI か講師に聞く。
  • 第1回・第2回を受けた人: 既知の節は流し読みでよい。差分は「Claude Code 拡張」「グローバル指示」「CLAUDE.md の階層」「フォルダ名 ClaudeWorkspace」です。第1回で CursorWorkspace を作った人は、中身の考え方はそのまま、本配布では作業フォルダ名を ClaudeWorkspace に揃える/読み替えると考えてください。

先に伝えておく大きなメッセージ(3つ)

  1. わからない操作は、AI に聞く。 設定の場所やボタンの名前は人の画面ごとに異なる場合があります。文章だけでは伝わらなければ、画面のスクリーンショット(画像)を積極的に添付して、「この画面で〇〇したい。どこを押せばよいか、今の表示に合わせて順に教えて」と AI に聞くことを原則にしてください。
  2. AI の操作は変化が速い。 このファイルに書いた Settings の名前・ボタン位置・手順は、あなたが読んでいるときにはすでに古い可能性があります。 狭く開く、確認を読む、消す判断は渡さない、などの約束は長く効く一方、クリック手順の正本はこの文書ではなく、その時点の画面と、公式情報や AI への確認だと考えてください。
  3. 変化を、新しい学びとして楽しむ。 AI の機能はこれからも速く変わります。同時に、あなた自身の AI の使い方も、使うほどに深まります。今日覚えた画面や手順がすべて「完成形」ではありません。狭く開く・確認を読む・消さない・自分の頭で決めるといった長く効く約束を土台に、新しい機能や頼み方を試して、自分の研究や文書仕事に合う学び方を更新していく——その過程自体を楽しんでください。そうすれば年月が経つにつれあなたの AI 活用能力はどんどん高まります。逆に言うなら、今、AI を利用し始めないと、AI を使いこなしている人との差はどんどん大きくなるばかりです。

キーボードまわりの細かい助言(Ctrl+Enter など)は 付録C。Whiteboard/Sheets などのβ機能は 付録E(巻末)。


なぜ、この先を読む価値があるか

すでに Claude の有料プランがあり、文書仕事の土台に VS Code を使う人は、いつものエディタに Claude Code という秘書キットを後付けする道が自然なことがあります。課金を二重にしにくく、フォルダを開いて .md を書く流れもそのままです。

チャット型だけだと、聞く → コピー → Word やメモに貼る、の往復が増えます。VS Code + Claude Code では、いま見ている .md をその場で直してもらえます。 見出しの揃え、メモの新規作成、フォルダの模様替え、提出用 Word への変換まで、同じ部屋の秘書に頼む感覚で進められます。

便利さの裏に、危険もあります(勝手に消す、広すぎるフォルダを開く、確認を読まずに許可する、など)。だからこの文書は、便利さだけを煽らず、安全な頼み方まで一続きで書きます。

構想用のホワイトボードや表(Artifacts)については、本線のあと 付録E にまとめています。正本の原稿はローカルの .md に置く、という分担だけ先に覚えてください。


この文書の対象読者

文書の完成形は Word が中心、プログラミングはしない、チャット型 AI は使ったことがある(またはこれから使う)、という想定の大学院生・研究者・教材や事務文書を書く人向けです。

加えて、次のどちらか(または両方)に当てはまる人向けです。

  • VS Code + Claude Code 拡張を本線にする
  • すでに Claude の有料プランがあり、別製品用の契約を増やしたくない

エンジニア向けの開発手順書ではありません。Git は扱いません。


0. 最小の道具箱 — VS Code・マークダウン・命名

単独で読む人のための最短説明です。既に知っている項目は飛ばして構いません。

0-1. VS Code とは何か

VS Code(Visual Studio Code) は、Microsoft が提供する高機能なテキストエディタです。メモ帳と違い、次がしやすいです。

  • フォルダごと開いて、左側にファイル一覧を出す
  • マークダウン(.md)を色付きで編集し、プレビューで見た目を確認する
  • 拡張機能で能力を足す(今日足すのが Claude Code)

表示言語は 英語のままを強くおすすめします。分からない言葉は日本語で講師や AI に聞いて構いません。

0-2. Open Folder(フォルダを開く)

File → Open Folder…(名称は版による)で、これから触るフォルダを1つ選びます。これが「いまの作業部屋」です。デスクトップ全体や、Dropbox/OneDrive の論文ルート丸ごとではなく、ローカルの狭い AI作業フォルダだけを開きます(本配布の例:ドキュメント\ClaudeWorkspace)。

0-3. マークダウン(.md)

マークダウンは、見出しや箇条書きを簡単な記号で書く、文字中心の原稿形式です。下書きは .md、提出や配布の体裁は Word/PowerPoint、という分担がこの講義の型です。記号の詳細は教室の別紙や、必要なら AI に「いまのファイル用の最小チートシート」を頼んでください。

0-4. 命名 — ケバブ・キャメル・日付・一意性

短い英語の名前を基本にします(共有や文字化けのリスクが小さいことが多いです)。

呼び方 例 特徴
ケバブ research-notes.md、meeting-agenda.md 単語をハイフン - でつなぐ
キャメル ResearchNotes.md、MeetingAgenda.md 単語の先頭を大文字にする

この講義での推奨: ケバブ(またはキャメル)に、必要なら日付を付ける。

型 例
YYYY-MM-DD(日まで) 2026-11-12-meeting-notes.md
YYYY-MMDD-HHMM(分まで) 2026-1112-1536-meeting-notes.md

名前の一意性: ふだん自分で作るファイルやフォルダには、ほかとぶつからない固有の名前を付けます。検索や AI への依頼で「どれか」が名前だけで分かり、コピーしても取り違えにくいです。

例外: README.md、CLAUDE.md、AGENTS.md、_WorkLog.md のように、決まった名前で置く約束のファイルは、フォルダごとに同じ名前であって構いません。

0-5. フォルダ構造を揃える重要性

AI も人も、「いつもの場所・いつもの名前の付け方」を前提に動きます。領域名や命名が案件ごとにバラバラだと、毎回説明し直し、似た名前で取り違え、指示書と実置き場がずれます。

一例(名前は自分の生活に合わせて少数に固定してよい):

ClaudeWorkspace/                 ← ルート。全体の安全策を書いた CLAUDE.md
  Research/                      ← 研究
  Edu/                           ← 教育・教材
  Admin/                         ← 事務・運営
  2026-session03/                ← 今日の講義用練習(仮置き可)

プロジェクトを増やすときは、例えば Research の下に 2026-11-12-literature-notes のように 日付+内容が分かる短い英語名(ケバブ可)で新設し、親の地図(CLAUDE.md)を更新する、が基本です。新しい命名体系を発明しないでください。

0-6. 「常駐する秘書」(エージェント)とは

チャット型 AI が「たまに来る相談役」だとすると、Claude Code は 部屋に常駐し、机の書類(ファイル)に手を出す秘書に近いです。答えを返すだけでなく、読む・書く・作る・(できてしまうが)消す、があります。だから「開く範囲」「確認」「消さない」「指示書」が必要です。

0-7. ペア確認(最初に)

  • ☐ VS Code を起動できる
  • ☐ ローカルに ClaudeWorkspace(または講師が示した AI作業フォルダ)を用意した/用意するつもりがある(論文クラウドではない)
  • ☐ 通奏用の .md が1つある(なければ講師の指示で作る)
  • ☐ (任意)アカウント全体の「Instructions for Claude」を後で書く場所を知っている(§G)

0-8. 今日の1本線

  1. 論文用のクラウド ≠ AI の作業場(ローカルの狭いフォルダだけ開く)
  2. 下書きは .md(提出形は別にあってよい)
  3. フォルダとファイルの名前の型を統一する(ケバブ等・日付・一意性)
  4. 常駐する秘書は書類に手を出せる → 許可を読む・消す判断は渡さない・指示書で縛る
  5. 先にグローバル指示、次に階層のある CLAUDE.md(§G・§7)
  6. 本線は VS Code + Claude Code。 Web/Desktop/Artifacts と役割を分け、同じ場所を二つの書き手で同時に触らない(約束7:別道具どうし/AI 作業中の手編集)

0-9. before / after

Before(チャット型だけ) After(VS Code + Claude Code)
流れ 答えをコピーして Word 等へ貼る往復が多い いま開いている .md がその場で変わる
注意の焦点 秘密を貼らない 開くフォルダ・書いてよい場所・確認・頼まないこと

だから今日は: 通奏の .md で、小さな安全な依頼を1回成功させましょう。


G. 層0 — グローバル指示を先に書く(CLAUDE.md より前)

フォルダの CLAUDE.md に入る前に、アカウント全体向けの指示を短く書いておくことを推奨します。公式ヘルプでは、Settings から Your Claude(または Account)の Instructions(「Instructions for Claude」等。名称は版で変化)に書いた内容が、会話全般の前提になりやすい、と説明されています。画面が違えばスクショ付きで AI に場所を聞いてください。

G-1. グローバルとフォルダ指示の役割分担

層 どこに書くか 向きやすい内容
グローバル claude.ai/Desktop の Settings → Instructions 自分は誰か、文体、言語、批判的に使う約束、機密を不用意に貼らない、など「どの話でも」
フォルダ(階層) ClaudeWorkspace 各層の CLAUDE.md このフォルダでファイルを触るときの安全・命名・書いてよい範囲(§7)

案件専用の事情(特定の論文タイトルだけ、など)をグローバルに書くと、関係ない会話にも漏れます。案件のことは CLAUDE.md 側へ。

G-2. 文系・研究/事務向けの典型例(短く・自分用に直す)

次はたたき台です。全部を無理に入れず、自分に合う行だけ残してください。AI に「文系の研究者が使うグローバル指示の草案を、もっと短くして」と頼んで一緒に直すのもよいです。

# 役割
- 私は人文学/社会科学系の研究者・教員志望で、主なAI利用は論文・教材・事務文書作成です(コードは主目的ではない)。
- 既定の返答言語は日本語(です・ます)。英語原稿の作業中だけ英語で返す。

# 書き方
- 無駄な挨拶・お世辞・前置きは省き、結論から書く。
- 箇条書きは必要なときだけ。曖昧な「〜かもしれません」の連発は避ける。

# 批判的に使う(重要)
- ユーザーの意見に迎合しない。誤っている・危険・曖昧なときは、最初のほうでそう指摘する。
- 異論・反論・代替案は積極的に提示する。同意だけで終わらない。
- 出典や数値を捏造しない。不明なら「要確認」と書く。

# 安全・データの扱い(アカウント全体)
- パスワード、名簿、未公開の個人情報、他人の機微情報を、不用意に貼ったり要約の材料にしたりしないよう注意する。
- 長い原稿の「丸投げ執筆」より、見出し案・推敲・表への整理・論点の洗い出しを優先する提案をする。

批判的に使う指示は、便利さに流されて考えなくなることへの歯止めです(§10 と同趣旨)。グローバルに書いておくと、チャットでもエージェントでも同じ姿勢を頼みやすくなります。

G-3. 実習チェック(§G)

  • ☐ Instructions の入力場所を開けた(または画像つきで聞けた)
  • ☐ 上の例を参考に、自分用を数行保存した(批判的利用の行を最低1つ含むとよい)
  • ☐ 案件専用の長い事情はグローバルに書いていない

1. インストールと最初の設定 — 安全の層1

層1: 文書が外部の AI サービスへ送られうることを理解し、操作が確認なしで進みすぎない設定を先に固める。

1-1. Claude Code 拡張を VS Code に入れる

  1. VS Code を起動する
  2. 拡張機能ビューを開く(Windows では多くの場合 Ctrl+Shift+X)
  3. 「Claude Code」を検索し、発行元が Anthropic のものを入れる(講師が示す)
  4. 必要なら再読み込み/再起動する
  5. Claude のアカウントでサインインする(有料プラン等が必要な場合がある)

公式の目安(変化しうる):比較的新しい VS Code が必要、など。詰まったら画像つきで AI か講師へ。

1-2. プライバシーと「外に送られうる」こと

AI に文章を見せることは、内容が外部サービス側に送られる可能性がある、ということです。名簿・パスワード・未公開の個人情報・論文クラウド丸ごとは、AI作業フォルダに置かない・開かない(§3・§4)。

1-3. 許可モード(Permission)

編集やコマンドの前にどの程度聞くかを切り替えます。表示名は版で変わります。

公式(Claude Code の Permission modes、2026年時点)では、比較的新しい版の対話セッション(ターミナル/VS Code 拡張)の起動時の既定は Auto です(条件やプラン・組織設定で Manual になることもあります)。Auto は、毎回あなたに聞かない代わりに、別の分類器が危険そうな操作を止める向きです。Anthropic も、本番インフラなど高リスクな変更では、自分で確認する運用を勧めています。

画面の呼び方(例) ざっくりした意味 この講義での目安
Auto 製品側のよくある既定。普段の確認は減らし、分類器が危険な操作を止めようとする 既定のまま使ってよい。ただし確認ダイアログが出たら読む。不安なら Manual/Plan へ
Manual 編集や多くの操作の前に、あなたが確認する 最初に動作を掴みたいとき、大事な原稿のときにおすすめ
Plan 先に方針・手順を出し、承認してから本作業 触るファイルが増えそうなとき・大きな依頼の前
Edit automatically など 編集を自動で進めやすい 慣れてから
Bypass permissions など 確認を大きく飛ばす(設定の Allow dangerously skip permissions 等が絡む) 今日は使わない

大きな依頼では 先に Plan。おかしい計画なら始めさせず、直すか拒否する。教室では講師が「今日は Manual にして」などと指定したら、それに従ってください。

1-4. AIモデルとエフォート(Effort)

AIモデルは、向こう側の「頭脳」の種類です(例:Fable/Opus/Sonnet/Haiku 系。名称は版で増減します)。速さ・得意分野・慎重さ・コスト感が変わります。入力欄付近のモデル名や /model で切り替えられることが多いです。

エフォート(Effort)は、選んだ AIモデルに対して「この依頼にどれだけ手間をかけるか」の目安です。公式の説明では、考える深さだけでなく、ファイルをどれだけ読むか、どれだけ検証してから返すか、といった作業量全体に関わります。水準の例は low/medium/high/xhigh/max など(使える段階は AIモデルごとに違うことがあります)。低いほど早く・軽く、高いほど時間と利用枠を使いやすい、と覚えてください。対応している AIモデルでは、モデル選択の画面に Effort の行が出たり、/effort で変えたりできます(版による)。

今日の教室では、AIモデルもエフォートも講師の指定に従い、自分で次々変えなくて構いません。見当たらなければ「AIモデルとエフォートの変え方を、今の画面に合わせて教えて」と画像つきで聞いてください。

1-5. 文章の自動補完はオフを推奨(推敲のとき)

自分の言葉で考えるときは邪魔になりやすいです。オフの仕方は付録C。

1-6. チャット送信は Ctrl+Enter(詳細は付録C)

日本語 IME の誤送信対策です。

1-7. ClaudeWorkspace を開く

File → Open Folder… で、例:ドキュメント\ClaudeWorkspace だけを開きます。通奏の .md はその中に置きます。

1-8. 画面の見方

領域 役割
左 フォルダとファイルの一覧
中央 いま編集している .md
Claude Code のパネル 依頼・確認・計画

左で位置を確認してから、パネルで頼む。

1-9. 自動保存(Auto Save)を勧める — VS Code/Cursor

中央のエディタで人間が文章を直しても、まだディスクに保存されていないと、画面上は新しい文でも、ファイルとしては古いことがあります(タブに白い点などが付く未保存状態)。Claude Code などのエージェントは、多くの場合 保存済みのファイルを読みます。そのため、人間は「いま直した」つもりでも、AI は保存前の内容を見て返事や編集をすることがあり、理解がずれることがあります。

これを減らすため、本講義では VS Code(および Cursor)で自動保存(Auto Save)をオンにすることを勧めます。Cursor は VS Code 系なので、設定の考えは同じです。

設定の形(名称は版で変わります。詰まったら付録C):

  • 手軽:メニュー File → Auto Save にチェックを入れる(多くの場合、遅延つき保存になる)
  • 詳細:Settings で Files: Auto Save を探す
値(例) 意味
off 自動では保存しない(デスクトップ版 VS Code のよくある既定)
afterDelay 一定時間後に自動保存(遅延は Files: Auto Save Delay)
onFocusChange エディタからフォーカスが外れたとき(チャットパネルへ移るときなど)
onWindowChange ウィンドウを離れたとき

遅延(タイムラグ)の目安: 公式の既定は多くの場合 1000 ms(1秒) です。文書作業では 1〜2秒(1000–2000 ms) 程度が扱いやすいことが多いです。100 ms 前後など極端に短い遅延は避けてください(打鍵のたびにディスクへ書きやすく、Undo や「保存時に動く整形」とぶつかりやすいことがあります)。チャットに移る直前に確実に載せたい人は、onFocusChange も選択肢です(afterDelay かこちらか、一つでよい)。

リスク・注意:

  • 書きかけ・試し打ちもディスクに残りやすく、「保存しないで閉じる」で捨てにくい
  • 保存のたびに動く拡張(整形・末尾改行など)があると、Undo が煩雑になることがある
  • 同期フォルダでは書き込みが増えやすい → AI作業フォルダはローカルで狭く、という方針とセットで考える
  • 自動保存は 約束7の代わりではない(AI 作業中に同じ箇所を手で打たない、は別問題)

AI に頼む前に、直した内容が保存されているか(または自動保存がオンか)を見てください。

1-10. プレビュー

マークダウンは右上のアイコン1クリックで横に出せることが多いです(付録C)。

実習チェック(§1)

  • ☐ Claude Code を入れ、サインインできた
  • ☐ 許可モードの場所を見つけた(または AI に聞けた)
  • ☐ ClaudeWorkspace(狭いフォルダ)だけを Open Folder した
  • ☐ 自動保存をオンにした(または講師の指定どおりにした)

2. Claude の入口の使い分け — Web・Desktop・VS Code

同じ「Claude」でも、入口が違うと向きやすい仕事が違います。今日の本線は太字です。

入口 向きやすいこと この講義での扱い
claude.ai や Desktop の普通のチャット 相談、短文の推敲、ファイルを触らない対話 併用してよい(グローバル指示が効きやすい)
Desktop/Web の Artifacts(Whiteboards、Sheets、Docs、Slides など) 構想の板、軽い表、スライド下書き 詳細は巻末・付録E。正本の .md の代わりにしない
VS Code + Claude Code 拡張 開いたフォルダの .md をその場で直す・変換を頼む 今日の本線
Desktop の Code タブ エディタ外のエージェント、並列など 余力。同じフォルダを VS Code と同時に触らせない(約束7)
claude.ai/code(クラウド) 長時間クラウド・GitHub 寄りの作業など 今日はやらない
CLI 全機能・スクリプト 今日はやらない

一文の原則: 話す・描く・表にするのはチャット/Artifacts。手元の原稿ファイルを動かすのは VS Code + Claude Code。同じ場所を二つの書き手で同時に触らない(約束7)。

2-1. VS Code + Claude Code が本線である理由(文書仕事)

  • Open Folder・プレビュー・.md の延長で秘書が使える
  • 変更が見えやすく、確認してから進めやすい
  • @ でファイルを渡し、Plan で大きな作業の前に方針を見られる

2-2. Cursor との関係(深入りしない)

どちらも「フォルダを開き、.md を見ながらエージェントに頼む」仲間です。違いは主に、最初から AI 付きか/VS Code に後付けか、どの会社の契約を中心に使うか、です。約束(狭く開く・消さない・指示書・確認・同時に触らない=約束7)は同じです。比較は 付録B。


3. 読みと書きの範囲 — 安全の層2

3-1. 第1防衛線 — 開くフォルダは狭く

開いてよい例 開いてはいけない例
ドキュメント\ClaudeWorkspace デスクトップ全体
その下の今日の練習フォルダ Dropbox/OneDrive の論文ルート丸ごと

3-2. 実能力 — ディスクの外にも届きうる

「開いたフォルダの中だけ」は目安であって能力の上限ではありません。指示書と確認が要ります。

3-3. 第2防衛線 — 書き込める場所を指示書で縛る

本線は階層のある CLAUDE.md(§7)。AGENTS.md を既に使っている人は二重の長文管理を避け、正本を1つにします。

3-4. 読むだけなら便利

practice-session03.md のフルパスだけ教えてください。書き換えないでください。

(ファイル名は自分の通奏に合わせて変える。)

3-5. 置かないもの(例)

パスワード、名簿、未公開の個人情報、論文クラウドの同期フォルダそのもの、など。


4. 安全に使う約束 — 安全の層3

約束1 開くフォルダは、作業用の1つだけ(狭く)

約束2 「実行しますか」は読んでから押す

分からなければ拒否して言い直すか講師に聞く。

約束3 「いらないものを消して」とは頼まない

消す判断は渡さない。移す提案だけさせて yes を待つ。

約束4 フォルダの作り変え・改名・移動は AI に頼んでよい(範囲を書く)

約束5 控え(コピー)を取る

約束6 AI が書いたものは自分で確認する

主張・事実・出典は自分の責任です。グローバル指示で「迎合しない/異論を出す」と書いてあっても、最終判断はあなたです。

約束7 同じ場所を、二つの書き手で同時に触らない

次のどちらも守ってください。競合・上書き・「どちらが正本か分からない」状態を防ぐための約束です。

  1. 道具をまたがない。 同じ ClaudeWorkspace(やその下の案件フォルダ)を、VS Code の Claude Code と Desktop の Code、あるいは Cursor など別の AI 付き道具で、同時に開いて編集させない。片方で作業しているあいだは、もう片方ではそのフォルダを触らない。
  2. 同じ VS Code の中でも、AI と同時に打たない。 Claude Code が中央のエディタでファイルを直しているあいだは、あなたはそのファイル(や同じ箇所)を手で編集しない。 確認ダイアログや差分の読み取り、依頼の言い直しはしてよいが、AI の書き込みと自分のキー入力を重ねない。AI の一連の作業が止まったら、約束6どおり自分の目で読んでから手を入れる。

あわせて、人間が直した内容がディスクに保存されていないと、AI は保存前の内容を読むことがあります。自動保存の推奨は §1-9。


5. 最初の本番 — 小さな安全な依頼

5-1. 頼み方の基本

対象を @ で明示する。短く具体的に。「外は触らない」「削除しない」を添える。

5-2. 曖昧なときは AskUserQuestion 形式で聞いてもらう

依頼が曖昧なときや、自分が「分かっているつもり」で頼むときほど、AskUserQuestion(選択肢つきの確認質問)の形式で、先に clarifying questions を出してもらう習慣をつけてください。画面上の名前は版で違うことがありますが、「選んで答えられる確認質問」を頼む、という意味です。

作業に入る前に、AskUserQuestion の形式で確認したい点を聞いてください。

この習慣には、次の2つの効き方があります。

  1. 答えやすい。 自由記述より、選択肢つきの方が速く・正確に返せる。
  2. 自分の指示の自己中心さに気づける。 AI にそう質問してもらうと、「相手に伝わっていない前提」が浮かび上がる。自分の指示がいかに自分都合だったかが分かり、自己の客観視が少しずつ高まる。

大きな依頼や Plan の前ほど、この一手が効きます(§1-3・§10 とも同趣旨)。

5-3. @ でファイルを渡す

@practice-session03.md について、次だけ行ってください。
見出し「覚えたこと」の下に、箇条書きを1行だけ追加してください。内容は「Claude Code を VS Code で開いた」でよいです。
このフォルダの外は触らないでください。削除しないでください。
終わったら、変更した箇所だけ報告してください。

@ や /(トークン節約の /clear・/compact 等を含む)は 付録D。送信は 付録C。

5-4. 講師の合図で実践

  1. @ で対象を指定
  2. 短文を送る
  3. 確認を読む(AI が中央のエディタを直しているあいだは、自分では打たない=約束7)
  4. 作業が止まったら、中央の .md を自分の目で読む

実習チェック(§5)

  • ☐ @ で渡せた
  • ☐ (任意)AskUserQuestion 形式で確認を出してもらった
  • ☐ 確認を読んでから押した(または拒否して言い直した)
  • ☐ 変更後を自分の目で読んだ

6. 地図と名前を統一する — 再掲

  1. 領域(Research/Edu など)の名前と役割は長く変えない
  2. プロジェクトは日付+短い英語名(例:2026-11-12-chapter-outline)
  3. ファイルもケバブ/キャメル+必要なら日付。一意性を守る
  4. 固定名例外(CLAUDE.md 等)だけ同名を許す
  5. 道具が変わっても 型は共有する

7. 指示書と記録 — CLAUDE.md の階層と、AI との共同作成

§G のグローバル指示のあとで、フォルダ側の指示書に入ります。

7-1. 階層が重要

CLAUDE.md は、置いたフォルダの「その範囲のルール」です。長く使うほど、ルート → 領域 → プロジェクトの入れ子が効きます。

ClaudeWorkspace/
  CLAUDE.md                 ← 全体の安全・領域一覧・共通の禁止
  Research/
    CLAUDE.md               ← 研究領域の地図・命名
    2026-11-12-topic/
      CLAUDE.md             ← この案件だけの注意
  Edu/
    CLAUDE.md
  2026-session03/
    CLAUDE.md               ← 今日の練習用(短くてよい)
置く場所 向いている内容 効きやすい開き方
ルート ClaudeWorkspace/CLAUDE.md 全体の安全、領域一覧 ClaudeWorkspace/ を Open Folder したとき
領域 例:Research/CLAUDE.md その領域の地図・命名 領域フォルダ(またはそれを含む開き方)
プロジェクト 案件だけの注意 そのプロジェクトを開いたとき

注意: Open Folder したフォルダが作業の「根」になりやすいです。その一つ上の CLAUDE.md は自動では届かないことがあります。よく開く階層には、守ってほしい安全策(外に書かない・消さない)を必ず短く入れる。親だけに書いて安心しない。

狭く開く日の応用:子の CLAUDE.md 先頭に「先に ../CLAUDE.md を読め」と具体的に書く(パスは実物に合わせる)。いちばん重要な禁止は、子にも残す。

7-2. 原則:AI と相談しながら作る(人間がゼロから長文を書かない)

指示書の主な読者は AI です。たたき台は AI に作らせ、人間は読んで直すのが原則です。

  1. 守りたいことを日本語で短く口頭/チャットで伝える
  2. AI に CLAUDE.md を書かせる(/init や Customize → Instructions が使える版もある。付録D)
  3. 自分の目で読む(約束6)
  4. おかしい行だけ直すか、直しを頼む
  5. 長くなりすぎたら、「安全だけ残して、手順は別ファイルへ指せ」と頼む

7-3. 長くしすぎない

指示書は文脈に入りやすいので、短い方が守られやすい経験則があります。まず安全の十数行。好みは見出し+1〜2行。長い変換手順などは別 .md へ「必要なとき読め」。

7-4. 階層ごとの依頼例

ルート用(Open Folder が ClaudeWorkspace のとき):

この ClaudeWorkspace のルートに CLAUDE.md を新規作成(または Safety を先頭に整えて)ください。
読者は AI です。階層の説明を短く入れ、Research / Edu / Admin の領域がある前提の地図を書いてください。
必ず入れること:
- ClaudeWorkspace の外には書かない
- 削除しない。移す提案だけして yes を待つ
- Dropbox / OneDrive の論文置き場を作業ルートにしない
- 新規は日付+短い英語名。下書きは .md 優先
ほかのファイルは触らないでください。要約だけ報告してください。

今日の練習フォルダ用(短い):

いま開いているフォルダに CLAUDE.md を短く作ってください。
Safety だけ:このフォルダの外は書かない/削除しない/移す提案は yes 待ち。
親の ../CLAUDE.md があれば、作業前に読むよう1行入れてください。

7-5. 見本(プロジェクト用・短さ優先)

# CLAUDE.md — this project folder

## Before any other work
1. If readable, read ../CLAUDE.md (and ../../CLAUDE.md if present) first.
2. Follow their Safety rules unless this file explicitly overrides them.

## Safety
- Edit only inside this folder unless I name another path.
- Do not delete files or folders. Propose a move and wait for my yes.
- Do not treat Dropbox / OneDrive thesis areas as the working root.
- New files/folders follow existing naming (date + short English name, kebab-case OK). Prefer .md for drafts.

## Preferences(必要な見出しだけ)
### チャットの言語
既定は日本語。

AGENTS.md が既にある場合は、正本を1つに統合するか、短い方から長い方へ「先に読め」と1行でつなぐ。

7-6. _WorkLog.md と README.md

  • _WorkLog.md … 経緯の申し送り。追記は頼んでよいが、既存行は消させない。
  • README.md … 読者は人間。このフォルダは何か、を短く。

実習チェック(§7)

  • ☐ グローバル指示(§G)を先に済ませた
  • ☐ ルートまたは今日のフォルダに、短い CLAUDE.md を AI と相談して置いた
  • ☐ 階層(ルート/領域/案件)の違いを説明できる
  • ☐ できた指示書を自分の目で読んだ

8. 2回目の練習と、変換

8-1. @ ともう少し/ウェブ調査

関連は @ で渡す。ネットが必要なら「ウェブで調べて」と明示する。

8-2. 2回目の実践

A. 模様替え

2026-session03 の中に notes フォルダを1つ作り、指定する .md を1つそこへ移してください。
このフォルダの外は触らないでください。削除しないでください。

B. 申し送り

_WorkLog.md に、今日やったことを3行以内で追記してください。
既存の行は消さないでください。

8-3. Markdown → Word/PowerPoint

原則:

  1. 同期中の ClaudeWorkspace 内で、変換用の環境構築や大量の中間ファイル書き込みをしない
  2. 変換はクラウド同期していない サンドボックス(例:C:\Users\あなたの名前\AISandbox\)で行う
  3. 完成した提出用だけを AI作業フォルダへ戻す
  4. 手修正した提出ファイルを、同じ名前で安易に再変換して上書きしない

フォントの一例:本文は游明朝+ Times New Roman、10.5 pt。見出しは游ゴシック(1=14 pt、2=12 pt、3=10.5 pt)。教室指定があればそちら優先。

@practice-session03.md を Word(.docx)に変換してください。
本文の日本語フォントは游明朝、英数字は Times New Roman、本文は 10.5 pt にしてください。
見出しは游ゴシックで、見出し1は 14 pt、見出し2は 12 pt、見出し3は 10.5 pt にしてください。
変換用の作業は講師が示したサンドボックスで行い、完成した .docx だけこのフォルダに置いてください。
元の .md は残し、削除しないでください。

一度決めたルールは、該当階層の CLAUDE.md に短く移すと依頼が短くなります。


9. 本日のまとめと宿題

まとめ

  • この配布だけでも、VS Code・命名・秘書・安全の最小は足りる
  • グローバル指示(批判的利用を含む)→ CLAUDE.md の階層の順
  • 本線は VS Code + Claude Code。作業フォルダ名の例は ClaudeWorkspace
  • 約束7: 同じ場所を二つの書き手で同時に触らない(別道具どうし/VS Code 内で AI 作業中に手編集しない)
  • 自動保存をオンにし、人間と AI が見る原稿のずれを減らす(§1-9)
  • 曖昧な依頼では AskUserQuestion 形式で先に聞いてもらう(§5-2)
  • トークン節約の /clear・/compact・/rewind・/context は 付録D
  • Artifacts(Whiteboard/Sheets 等)のβ詳細は 付録E
  • 細かいキー操作は 付録C

宿題

  1. グローバル指示を自分用に保存する(迎合しない/異論を出す、を含む)
  2. ClaudeWorkspace に、短い CLAUDE.md を AI と相談して置く(できればルート+よく開く下層)
  3. .md を1つ、小さな依頼で安全に直す(控えを取ってから)
  4. (任意)付録E を読み、Artifacts とローカル .md の分担を3行で書く

10. 便利さの先にある危険 — 自分の頭を使わなくなること

提出は速くなっても、問いを立て、文献を読み、筋の通らない箇所に自分で気づき、言葉を選び直す力は、丸投げでは育ちません。グローバル指示で異論を出させても、採用するかどうかはあなたです。「何を主張するか」「なぜそう言えるか」まで委ねないでください。

AskUserQuestion 形式で確認を出してもらう習慣(§5-2)も、同じ方向の歯止めです。答えやすいだけでなく、自分の指示の抜けに気づく練習になります。


付録A. よくあるつまずき

症状 まず疑うこと
拡張が見つからない 発行元 Anthropic か、VS Code の版
サインインできない プラン・アカウント・ネットワーク
別ファイルを触る 開く範囲/@/CLAUDE.md
確認なしで進みすぎる/不安 Auto のままだと確認が減る。Manual/Plan に切り替える(§1-3)
同じファイルが二重に変わる/競合する 約束7。①Desktop・Cursor などと VS Code で同じフォルダを同時に触っていないか ②AI が中央エディタを直している最中に、自分も打っていないか
AI がさっきの修正を知らない/話がずれる 未保存のまま頼んでいないか。自動保存はオンか・遅延中でないか(§1-9)
会話が長くて遅い・枠を食いすぎる 付録D の /compact//clear//context。新指示のたびにそれまでのやり取りも送り直されやすい
作業がおかしい方向に進んだ 付録D の /rewind(必要ならその後に言い直す)
親の指示が効かない Open Folder の位置。下層にも安全策
日本語の誤送信 付録C の Ctrl+Enter
Whiteboard/Sheets が出ない 付録E(プラン・β・組織設定)

付録B. Cursor との違い(短く)

Cursor VS Code + Claude Code
たとえ AI 付きの机が最初からセット いつもの机に秘書キットを後付け
向きやすい人 一本の製品で覚えたい VS Code と Claude 契約を主なツールにしたい
変わらない約束 狭く開く・消さない・指示書・確認・同時に触らない(約束7:道具どうし/AI作業中の手編集) 同じ

付録C. 困ったときの入力・キーボード・小技

C-1. 送信を Ctrl+Enter に

チャットの送信を Ctrl+Enter だけにする方法を、今の VS Code と Claude Code の画面に合わせて順に教えてください。

C-2. 半角/全角(Windows)

キー よくある割り付け
左の 無変換 半角英数へ
右の 変換 全角ひらがなへ

割り付けの方法はAIに尋ねてください。

# や .md の前は半角英数か確認する。

C-3. わからない操作は画像つきで聞く

C-4. プレビューは右上アイコンを先に試す

C-5. パネル・許可モード

Claude Code のパネルを開く方法と、いまの許可モード(Auto/Manual/Plan など)の見方・切り替え方を、今の画面に合わせて教えてください。

C-6. 自動保存のオン/遅延の変え方

本線の意味は §1-9。手順が分からなければ、次を画像つきで頼む。

VS Code(または Cursor)で Auto Save をオンにし、afterDelay の遅延を 1000〜2000 ms にする方法を、今の画面に合わせて順に教えてください。

C-7. 英語 UI のまま進める


付録D. Claude Code — @ とスラッシュ

入力 意味
@ ファイル/フォルダを渡す
/(先頭) コマンド一覧
/plan 計画モード
/init CLAUDE.md 等のたたき台
/model AIモデルの選択(対応機種ではエフォートも同じ画面で触れることがある)
/effort エフォート(作業の丁寧さ・手間の目安)
/help ヘルプ

確認を全部飛ばす系は今日は使いません。重要な対象は @ で明示する。コマンドの出揃いはプラン・版で違います。見当たらなければ / で一覧を見てください。

D-1. トークン消費を抑えるための4コマンド

なぜ短くした方がよいか: 同じセッションでは、あなたが新しい指示を送るたびに、それまでのやり取りもまとめてAI側へ送り直される(文脈として再提示される)ことが多いです。会話が長くなるほど、1回の送信で使う量(トークン)が増えやすくなります。別作業に移る・長くなった・おかしくなった、のタイミングで次を使うと節約しやすいです。

コマンド いつ使うか 何が起きるか
/clear 別の作業に移るとき 会話を完全リセットする
/compact 同じ作業を続けたいが、会話が長くなってきたとき これまでのやり取りを要約して圧縮する
/rewind おかしくなったとき 前の地点(うまくいっていた付近)に戻る
/context いまどれくらい使っているか見たいとき 文脈の使用状況を確認する

目安:作業の区切りでは /clear、同じ案件の続きなら /compact、道を外れたら /rewind、不安なら先に /context。


付録E. 巻末 — Whiteboards・Sheets など Artifacts(β・変化しやすい)

本文本線ではありません。必要になったときだけ読んでください。手順の正本は画面と Anthropic 公式です。

E-1. 何か

Claude の Web/Desktop/Mobile では、チャットの横に Artifacts(成果物キャンバス)を開けることがあります。2026年時点の公式案内の例:

名前(例) 向きやすいこと 注意
Whiteboards(ベータ) 構想・章立て・議論の地図。話す/書く/ラフに描くと整理される 有料プラン向け。組織設定でオフのことも
Sheets(ベータ) 軽い表・進捗・予算のたたき台。共同編集、.xlsx/CSV 書き出し 本格 Excel が必要なら書き出しや Excel 連携へ。論文データの唯一の保管庫にしない
Docs/Slides/Design/Data 等 文書・スライド・ダッシュボードなど 機能ごとに差・βあり

E-2. 本線との分担

  1. Whiteboard 等で構想する(任意)
  2. 決まった主張・見出しだけを ClaudeWorkspace の .md へ移す
  3. 提出は .md → Word/PPT(§8)

Artifacts 上の板や表を、修士論文や教材の正本にしないでください。

E-3. プラン・組織・β

Team/Enterprise では Artifacts のオンオフが管理者設定のことがあります。画面に出なければ教室で無理に掘らず、講師か公式を確認してください。ベータは仕様が特に変わりやすいです。

E-4. 機密

未公開データや個人情報を板・表に載せる前に、プランと組織のルールを確認してください。


付録F. 大きくなってからの地図(今日は深入りしない)

複数の AI 道具を使い始めたら、道具ごとの部屋分けや共通ルール置き場が欲しくなることがあります。今日は次だけで十分です。

  1. クラウドの論文置き場と ClaudeWorkspace を分ける
  2. 領域を少数に固定し、プロジェクトは日付付きで増やす
  3. 命名の型を統一する
  4. 同じ場所を二つの書き手で同時に触らない(約束7)
  5. グローバル指示 → 階層のある CLAUDE.md の順を守る
Paste this at the end of each Blogger post (HTML view): ```html

このシリーズの記事

```

第3回 VS Code + Claude Code — 机に秘書を足す

この記事は「 第2回 Cursor 入門 — 常駐する秘書と安全な頼み方 (Part 2) 」の続きですが、この記事だけでも単独で読めるように書いてあります。この記事は、CursorよりもClaude CodeをVS Codeで使いたい学生さんのために書きました。 第3回 VS...