MENU

Claude Codeのコンテキストとは?フォルダとの違いを個別支援計画で解説

「コンテキストって何?」

Claude Codeを使い始めた人が最初に戸惑う言葉のひとつです。

コンテキストとは、「Claudeが今この瞬間に見ながら考えられる情報の範囲」のことです。

フォルダにファイルを入れるだけでは、Claudeはその内容を読んでいません。この誤解が精度のブレを生んでいます。

この記事を読めば、Claude Codeがどうコンテキストを作るかの仕組みがわかり、指示の出し方を少し変えるだけで精度がグッと上がるようになります。

教員×AI講師の私が、実際の教育現場での使い方をもとに解説します。

CLAUDE.mdに何を書けば精度が上がるか、現場で使えるサンプル文も紹介します。

この記事では、次の流れで解説します。

この記事を読んでわかること
  • Claude Codeのコンテキストはフォルダ構造の確認から始まる
  • Claude Codeのコンテキストの動きを個別の支援計画で理解する
  • Claude Codeのコンテキスト精度は「何を読むか」の指定で変わる
  • Claude CodeのCLAUDE.mdはコンテキストとして扱われる

それでは、順番に説明していきましょう。


目次

Claude Codeのコンテキストはフォルダ構造の確認から始まる

Claude Codeはフォルダの中を「最初から全部読む」のではありません。

まず開いているフォルダの構造を確認し、何があるかを把握することから始まります。その上で、ユーザーの指示に応じて必要なファイルを探し、コンテキストに読み込んでいくのです。

この節では次の2点を説明します。

  • フォルダ構造とファイルの中身をざっと確認してから動く
  • ユーザーの指示に応じて、コンテキストに必要なファイルを探しに行く

一つずつ確認していきましょう。

フォルダ構造とファイルの中身をざっと確認してから動く

Claude Codeは最初に、フォルダの構造とファイルの存在を確認します。

どんなファイルがあるかを把握することで、次のステップで「何を読むか」を判断できるからです。

たとえば「学校タスク」というフォルダを開いていれば、その中に何のファイルがあるかをまず確認します。ここで全体像をつかんでから、次の動きに進むのです。

この「全体把握」のステップがあるからこそ、次の指示に応じた正確な動きができます。

ユーザーの指示に応じて、コンテキストに必要なファイルを探しに行く

フォルダ構造を把握した後、指示の内容に合ったファイルを探してコンテキストに読み込みます。

Claude Codeはエージェント型ツールのため、タスクに必要な情報を自律的に判断して取得します。Anthropic公式もコードやファイルを読み・編集・コマンド実行するエージェントと説明しています。

たとえば「Aさんの支援計画を作って」と指示すると、Claude Codeは支援計画・学習記録・通知表などのファイルを探して読み始めます。この「探して読む」動きで積み上がった情報が、コンテキストのかたちになります。

弟子

フォルダに入れておけば、Claudeが全部読んでくれると思ってました。

いち関係者の私

それはよくある誤解です。フォルダはあくまで「本棚」。Claudeが実際に作業に使えるのは、本棚から取り出して机の上に広げた資料、つまりコンテキストに読み込まれた情報だけなんです。


Claude Codeのコンテキストの動きを個別の支援計画で理解する

コンテキストの仕組みは、個別の支援計画の作成場面で考えると一気に腑に落ちます。

実際のフォルダ構成を見ながら、Claude Codeがどう動くかを確認してみましょう。

  • フォルダに8種類の資料があるとする
  • AIが「読みに行く」資料と「読まない」資料の違い
  • 読まれなかったファイルに大事な記録があったら?

この3点を順番に見ていきましょう。

フォルダに8種類の資料があるとする

支援計画・学習記録・通知表など、8種類の資料が1つのフォルダにあるとします。

実際の現場では、1人の児童のフォルダにさまざまな資料が混在しています。

学校タスク/
├─ 個別の支援計画
├─ 昨年度の支援方針
├─ 学習の記録
├─ 通知表
├─ 保護者面談記録
├─ 音楽の指導案
├─ 数学の単元計画
└─ 行事計画

Claude Codeはこの8つを全部読むわけではありません。ここが重要なポイントです。

AIが「読みに行く」資料と「読まない」資料の違い

「Aさんの支援計画を作って」と指示すると、Claude Codeは関係しそうな資料だけを選んで読みます。

フォルダ構造の把握後、タスクに関連しそうなファイルを推測して読み込むためです。

  • 読みに行く可能性が高い:個別の支援計画・昨年度の支援方針・学習の記録・通知表・保護者面談記録
  • 読まない可能性が高い:音楽の指導案・数学の単元計画・行事計画

ただし、「関係ありそう」という推測で動くため、必ずしも完璧に選び分けられるわけではありません。

読まれなかったファイルに大事な記録があったら?

AIが「読まない」と判断したファイルに、重要な記録が含まれることもあります。

ファイル名や構造から関連度を推測するため、見落としが起きる可能性があるからです。

たとえば「音楽の指導案」の中にAさんへの重要な配慮事項が書かれていたとします。Claude Codeはそのファイルを読まないかもしれません。

AIの推測は完璧ではありません。だから人間が「見るべき資料」を指定することが、コンテキストの精度を上げるポイントになります。


Claude Codeのコンテキスト精度は「何を読むか」の指定で変わる

Claude Codeのコンテキスト精度は、「どの資料を読み込むか」で決まります。

「これを読んでください」と指定するだけで精度は大きく変わります。具体的な方法を2つ紹介します。

  • 「この資料を必ず見てください」と書くだけで変わる
  • CLAUDE.mdに書いておけば毎回言わなくて済む

順番に説明していきましょう。

「この資料を必ず見てください」と書くだけで変わる

冒頭に「次の資料を必ず参照してください」と書くだけで、読み込む資料を指定できます。

Claude Codeはユーザーの指示をコンテキストとして受け取り、優先して処理するためです。

以下のように書くだけで構いません。

この作業では、次の資料を必ず見てください。
・昨年度の支援方針
・学習の記録
・通知表
・保護者面談記録

音楽の指導案や行事計画は、今回は参照しないでください。

読ませる資料・読まなくていい資料を両方書くと、さらに精度が上がります。

CLAUDE.mdに書いておけば毎回言わなくて済む

毎回この指示を書くのは面倒です。そこで使えるのがCLAUDE.mdです。

弟子

毎回同じ指示を書くのは手間がかかりますね…

いち関係者の私

それを解決するのがCLAUDE.mdです。ここにルールを一度書いておけば、セッションのたびに読み込まれるので、毎回指示する手間がなくなります。

CLAUDE.mdはセッション開始時に読まれるファイルです。ここにルールを書いておくことで、毎回の指示を省略できます。

以下のように書いておくと、次回からClaude Codeがルールを参考に自動的に動いてくれます。

個別の支援計画を作るときは、次の順で資料を確認する。

1. 昨年度の支援方針
2. 学習の記録
3. 通知表
4. 保護者面談記録

文章は保護者に伝わるように、専門用語を使いすぎず、具体的に書く。

一度書いておけばClaude Codeがルールを参考に毎回動いてくれます。


Claude CodeのCLAUDE.mdはコンテキストとして扱われる

CLAUDE.mdは万能ではありません。Anthropic公式も「強制的な設定ではない」と説明しています。

それでも書く価値は十分にあります。正直にお伝えします。

  • Anthropic公式はCLAUDE.mdを「コンテキスト」と説明している
  • それでも書く価値がある3つの理由

順番に見ていきましょう。

Anthropic公式はCLAUDE.mdを「コンテキスト」と説明している

Anthropic公式によれば、CLAUDE.mdはコンテキストとして扱われます。強制的な設定ではありません。

CLAUDE.mdはエージェントに永続的な指示を与えますが、絶対的な制約ではないのです。

たとえば「〇〇しないでください」と書いても、状況によって従わないケースがあります。

「書けば必ず守られる」ではなく、「参考情報として毎回読まれる」が正確な理解です。

それでも書く価値がある3つの理由

CLAUDE.mdを書く3つのメリットがあります。精度向上・毎回指示の省略・ルールの積み上げです。

コンテキストとして毎回読まれるため、書かないよりも確実に精度が安定します。

参照ファイル・文体・作成手順を書いておくと、指示なしでも一定水準の出力が得られます。書き込む内容が増えるほど、現場のノウハウをClaude Codeに蓄積していくことができます。

「絶対命令ではない」と理解した上で使えば、CLAUDE.mdは現場の強力な補助線になります。


よくある質問

コンテキストには容量の上限がありますか?

コンテキストウィンドウには上限があります。大量のファイルを一度に読み込もうとすると上限に達し、後半の内容が処理されなくなることがあります。個別支援計画の作業なら、関係するファイルを5つ以内に絞って指定するのが安定した使い方です。

CLAUDE.mdはどこに保存すればいいですか?

プロジェクトフォルダの直下に置くのが基本です。フォルダを開いたときに自動で読み込まれます。複数のフォルダそれぞれにCLAUDE.mdを置くこともできるため、「支援計画用」「指導案用」のように業務ごとにルールを分けることも可能です。

複数のフォルダをまたいで作業するときはどうすればいいですか?

作業開始時に「〇〇フォルダのAファイルと△△フォルダのBファイルを参照してください」と具体的に指示するのが確実です。Claude Codeは別フォルダのファイルを自動では探せないため、パスを含めて明示的に伝える必要があります。

セッションをまたいでコンテキストの内容は記憶されますか?

記憶されません。Claude Codeのコンテキストはセッションごとにリセットされます。毎回のセッションで必要なファイルを読み込み直す必要があります。CLAUDE.mdに読み込むルールを書いておくと、毎回の手間を大幅に省けます。

ファイルが大きい場合、コンテキストへの読み込みはどうなりますか?

ファイルが大きすぎるとコンテキストの上限に達し、後から読んだ内容が押し出されることがあります。重要な情報は文書の冒頭にまとめておくか、ファイルを分割して必要な部分だけを指定するのが安定した運用方法です。


まとめ|コンテキストを理解したClaude Codeは、現場の強力な相棒になる

Claude Codeを使いこなすうえで、まず押さえておきたいのはコンテキストとは「今Claudeが見ている情報の範囲」だということです。

フォルダにファイルを入れておくだけでは、Claudeはその内容を読んでいません。読み込まれたファイルだけが、Claudeが実際に作業に使える情報です。

もう一つ大切なのは、「何を読むか」を人間が指定することです。

AIは関連するファイルを自律的に探して読みに行きますが、その推測は完璧ではありません。「この資料を必ず参照してください」とひとこと書き添えるだけで、精度は大きく変わります。

毎回指示を出すのが手間なら、CLAUDE.mdにルールを書いておくのが確実です。セッション開始時に読み込まれるため、指示なしでも一定水準の出力が安定して得られます。

この仕組みを理解して使うのと、なんとなく使うのとでは、積み上がる成果がまったく違います。Claude Codeは理解して使うほど、現場の強力な相棒になるツールです。

Claude Code活用の実践記事は、このブログで随時発信しています。気になる記事をぜひ読んでみてください。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次