Claude Code 搜不到文件,先看它当前能访问哪些工作目录。它不是自动知道你电脑上所有项目;如果文件在当前目录外,要先添加目录,或者从正确项目根目录启动。
先确认当前工作目录
进入项目根目录后再运行 Claude Code。让它先执行或读取当前目录结构,比如列出根目录、查看 package 文件、确认 Git 状态。只要第一步目录就不对,后面问再多也会跑偏。
如果你要跨两个目录处理问题,可以用 /add-dir 添加额外工作目录。比如前端项目和后端项目分开,不要指望它自动越过父目录去找。
CLAUDE.md 不是文件索引
很多人以为写了 CLAUDE.md,Claude Code 就会自动读到所有相关文件。其实 CLAUDE.md 更像项目记忆和工作约定,适合写架构说明、常用命令、代码规范和注意事项。真正要分析文件,还是要让它读取对应路径。
可以在 CLAUDE.md 里写清楚关键目录:后端入口、前端入口、测试命令、生成文件位置。这样它搜索时更不容易绕远。
WSL 和路径问题也常见
如果你在 Windows 上用 WSL,确认 Node、npm 和项目都在 WSL 环境里。Anthropic 文档也提醒过,WSL 里如果误用了 Windows 的 npm 或 node,可能出现各种找不到命令、路径异常的问题。
用 which node、which npm 看路径。如果指到 /mnt/c/ 下,建议修到 Linux 版本。
最好这样提问
“当前项目根目录是这里。请先读取 CLAUDE.md,再搜索 src/routes 和 src/services,不要查看 dist。如果找不到文件,先告诉我你实际能看到哪些目录。”
这能避免 Claude Code 自己猜路径。AI 编程工具找不到文件时,先修可见范围,再谈代码能力。