代码库导航

面对陌生的代码库,Claude Code 可以帮你快速建立全局理解。

理解项目结构

> 帮我梳理一下这个项目的目录结构,每个主要目录的作用是什么?

Claude Code 会扫描目录树,读取关键文件(package.jsontsconfig.json 等),给出结构化的总结。

搜索代码

按文件名搜索

> 找到所有和用户认证相关的文件

Claude Code 使用 Glob 工具按模式匹配文件。

按内容搜索

> 搜索项目中所有使用了 `useEffect` 的地方

Claude Code 使用 Grep 工具进行内容搜索,支持正则表达式。

组合搜索

> 在 src/ 目录下找到所有导入了 lodash 但只用了一两个方法的文件,考虑换成原生实现

追踪代码流

理解调用链

> 用户点击登录按钮后,代码的执行流程是怎样的?从前端组件到后端 API 完整追踪一下

查找定义和引用

> `UserService.createUser` 这个方法在哪里定义的?哪些地方调用了它?

分析代码质量

> 检查 src/api/ 目录下的错误处理,看看有没有遗漏的 try-catch 或未处理的 Promise rejection
> 这个项目有哪些 TODO 和 FIXME 注释?帮我整理一下

实用技巧

用 LSP 增强理解

Claude Code 内置 LSP 支持,可以:

  • 跳转到定义(goToDefinition)
  • 查找所有引用(findReferences)
  • 查看类型信息(hover)
  • 查看调用层级(prepareCallHierarchy)
> 用 LSP 查一下 `handleLogin` 函数的所有调用者

渐进式探索

面对大型代码库,建议从宏观到微观:

  1. 先看结构 — 项目有哪些模块?
  2. 再看入口 — 程序从哪里开始执行?
  3. 后看核心 — 关键业务逻辑在哪里?
  4. 最后看细节 — 具体实现是怎样的?
> 先帮我看看这个项目的整体架构,然后重点分析一下核心的业务逻辑模块

下一步