Claude CodeのGrep・Glob・Readの違い｜必要なファイルだけ探して読む

Globは、ファイルパスのパターンに合う候補を探します。例えば、docs/**/*.mdなら、docs配下にあるMarkdownファイルを探す指定です。

Grepは、ファイルの中にある文字列を検索します。「解約」という語が書かれた資料を探したいなら、ファイル名より本文の検索が向いています。Readは、見つかったファイルの内容を読むために使います。

このサイトの制作でも、先に対象プロジェクトのファイルを絞ってから実装を確認しています。複製された作業フォルダまで一度に探すと、同じ内容が大量に出て、どれが今回の対象か追いにくくなるためです。

次のコマンドはmacOSなどのシェルで、練習用の小さなフォルダを新規作成します。同じ名前のフォルダがない場所で実行してください。作成するファイルは2つで、どちらも架空のメモです。

この例では、ファイル名にplanがあるのはplan.md、本文に「承認」があるのはmemo.mdです。どちらを探しているかで、使う道具が変わることを確認できます。

この練習用ファイルは、2026年9月11日に実際に作成して確認しました。Markdownファイルは2件、名前にplanを含むのはplan.md、本文に「承認」を含むのはmemo.mdです。

memo.mdというファイル名には「承認」が含まれていません。したがって、ファイル名のパターンで承認を探すだけでは、この文書を拾えません。「たしか承認について書いた資料があった」という探し方なら、本文検索が必要です。

Grepで一致したら、Readでそのファイルを読みます。一致した語の前後に「今回は不要」「前回から変更」と書かれていないかまで確かめると、検索結果の断片だけで意味を決めずに済みます。

Claude Codeのチャットで、次のように依頼します。最初に範囲をsearch-practiceだけへ絞り、ファイル一覧と本文検索を分けています。

検索結果は、ファイル名だけでなく、該当する行と前後の文まで見ます。「承認不要」のような否定や条件が付いている場合、単語が見つかっただけでは意味を判断できないためです。

検索に使った語が出てこなくても、資料自体がないとは限りません。「確認」「レビュー」など別の言葉で書かれている場合があります。検索0件なら、対象範囲と表記を確認してから条件を変えます。

対象を広く取りすぎると、依存ライブラリ、古いバックアップ、別の作業コピーまで検索結果に混ざります。最初からプロジェクト名やフォルダ名を指定して、必要な範囲へ絞ります。

大きなファイルは、必要な行の前後から読みます。ただし、その範囲だけを見て「全体を確認した」とは扱いません。章の前提や別の定義が必要なら、その範囲も追加で確認します。

画像やPDFは、文字列検索だけで内容を把握できるとは限りません。ファイル一覧で存在を確認し、形式に合う読み方へ切り替えます。PDFの図表を読むときは、ページ指定と原本の照合も使います。

資料を確認してほしい段階なら、変更は不要と伝えます。確認した結果を保存してほしい場合は、新しい保存先と、含める内容を指定してください。既存ファイルを直す場合は、どの箇所をどう直すかを明示します。

AIがファイルを変えられると、原稿の修正も分析メモの作成も、そのまま進められます。だからこそ、対象と保存先を具体的に渡すと、後から何が変わったか確認しやすくなります。

練習では、2つのファイルの内容を比べた確認メモを、新しいMarkdownに保存してみてください。元のファイルが変わっていないことも確かめます。

検索0件は、情報が存在しないことの証明にはなりません。対象フォルダが違う、拡張子で除外した、ファイル名だけを探した、表記が違う、といった可能性があります。

例えば議事録本文の「承認済み」を探すなら、フォルダを決め、Markdownを対象に本文検索をします。結果が多ければ期間や案件のフォルダを絞り、0件なら検索範囲や表記を確認する。検索語を長くし続けるより、どの対象を調べたかを残す方がやり直しやすくなります。

練習用ZIPにはmemo.mdとplan.mdだけを入れています。既存の仕事フォルダへ同名ファイルを上書きせず、新しい練習用フォルダへ展開して試してください。