一、文件搜索是什么
文件搜索是在项目中按名称模式或内容关键词定位文件和代码片段的过程。Claude Code 内置三种搜索工具，分别解决两个问题："文件叫什么"和"文件里写了什么"。
文件搜索不是文件读取。搜索返回匹配的文件路径和位置信息，不会将完整文件内容加载到对话上下文中。需要查看具体内容时，搜索之后再用 Read 工具读取目标文件。
二、三种搜索工具
Claude Code 提供三种搜索方式，对应不同的搜索维度：
Glob——按名称模式匹配文件
Glob 根据文件名模式在项目目录中查找匹配的文件路径。名称源自 "global pattern matching"，使用通配符描述文件名规则。
Glob 只关心文件名和路径，不读取文件内容。适合回答"项目里有哪些 X 类型的文件"或"某个文件在哪个目录下"。
Grep——按内容搜索文件
Grep 扫描文件内容，找到包含指定关键词或正则模式的所有位置。底层基于 ripgrep，搜索速度极快。
Grep 返回三项信息：文件路径、行号、匹配行的内容。适合回答"哪些文件里用到了这个函数"或"这个错误信息是从哪里抛出的"。
自然语言搜索
直接用自然语言描述搜索目标，Claude 会自动判断使用 Glob、Grep 或两者组合。多数场景下无需手动指定工具或语法。
Claude 会先用 Glob 定位测试文件（**/test_*.py 或 **/*.test.ts），再用 Grep 在这些文件中搜索 skip 关键词。