第5课：多文件操作

为什么需要这个#

实际项目不是一个文件，而是数十甚至数百个相互关联的文件。一个网页可能依赖样式文件、数据库和多个模块。Claude Code 能同时处理整个项目——但它需要知道该看哪里。

在本课中，我们将学习如何引导 Claude 的注意力到需要的文件，以及如何处理大型项目。

项目上下文——Claude 看到了什么#

当您在项目文件夹中启动 Claude Code 时，它不会立即读取所有文件。对于大型项目来说那样太慢了。相反，Claude：

读取 CLAUDE.md 文件（项目规则）
加载自动记忆（关于项目的笔记）
之后按需读取文件——当您提问或任务需要时

💡 可以这样想：Claude 就像新入职的员工。他知道一般规则（CLAUDE.md），但具体文件在需要时才打开。

@-文件提及#

指引 Claude 关注特定文件的最简单方式是在文件名前使用 @ 符号。

如何使用#

您：查看 @src/app.js 并添加错误处理

Claude 会立即打开这个文件并进行操作。

可以提及多个文件#

您：比较 @src/old-utils.js 和 @src/new-utils.js——
    哪些函数被删除了？

可以提及文件夹#

您：分析 @src/components/ 中的所有文件
    找出未使用的组件

@-提及使用示例#

任务	输入内容
修复特定文件	`修复 @src/login.js 中的错误`
比较文件	`@config/dev.json 和 @config/prod.json 有什么不同？`
迁移代码	`将函数从 @src/helpers.js 移到 @src/utils.js`
应用风格	`按照 @src/main-page.js 的风格格式化 @src/new-page.js`

处理大型代码库#

策略1：从概览开始#

如果项目很大且不熟悉，先让 Claude 了解结构：

您：查看项目结构并解释：
    - 主要文件夹有哪些，各负责什么
    - 入口点（主文件）在哪里
    - 使用了哪些技术

策略2：分部分工作#

不要让 Claude “重写整个项目”。将任务分解：

--- 步骤1 ---
您：告诉我项目中的授权是如何实现的。
    涉及哪些文件？

--- 步骤2 ---
您：现在在 @src/auth/login.js 中添加
    Google 登录功能

--- 步骤3 ---
您：更新 @src/auth/config.js 以支持 Google OAuth

策略3：通过 CLAUDE.md 提供上下文#

对于大型项目，在 CLAUDE.md 中描述结构：

# 项目结构

## 主要文件夹
- src/api/ — 服务器端（API 端点）
- src/components/ — React 界面组件
- src/models/ — 数据库模型
- src/utils/ — 辅助函数

## 关键文件
- src/app.js — 入口点
- src/routes.js — 路由
- src/database.js — 数据库连接

## 模块间依赖
- 组件使用 src/api/ 中的 API 函数
- API 使用 src/models/ 中的模型

附加目录#

如果您的项目由多个文件夹组成（例如前端和后端在不同位置），可以连接附加文件夹：

claude --add-dir /path/to/other/folder

现在 Claude 既能看到主项目，也能看到附加文件夹。

实际示例：添加新页面#

假设您有一个网站，需要添加"关于我们"页面。

--- 步骤1：了解其他页面的结构 ---
您：显示首页的文件结构。
    涉及哪些文件？

Claude：首页由以下部分组成：
        - src/pages/Home.js（组件）
        - src/styles/Home.css（样式）
        - src/routes.js（路由）

--- 步骤2：按照相同方式创建 ---
您：参照 @src/pages/Home.js 创建"关于我们"页面。
    内容：公司历史、团队、联系方式。

Claude：[创建 src/pages/About.js 和 src/styles/About.css]

--- 步骤3：连接 ---
您：在 @src/routes.js 中添加"关于我们"页面的路由
    并在 @src/components/Navbar.js 的导航菜单中添加链接。

Claude：[更新两个文件]

建议#

✅ 使用 @ 精确指定文件——比等 Claude 自己找更快
✅ 在 CLAUDE.md 中描述项目结构——特别是大型项目
✅ 分步工作：概览 → 修改特定文件 → 验证
✅ 处理不熟悉的项目时先请求"解释结构"
⚠️ 不要试图在一次请求中修改太多文件——最好分成多个部分

课程总结#

Claude Code 不会一次读取所有文件——它按需打开
@-提及（@src/file.js）是指引 Claude 关注特定文件的最快方式
大型项目请在 CLAUDE.md 中描述结构
分步工作：先概览，再具体修改
可以通过 --add-dir 连接附加文件夹