7.2 /add-dir - 添加额外工作目录
概述
/add-dir 命令用于向 Claude Code 添加额外的工作目录,使 AI 能够访问和操作多个目录中的文件。这对于多模块项目或需要同时处理多个代码库的场景非常有用。
基本语法
bash
/add-dir <directory-path>
参数说明
| 参数 | 描述 |
|---|
<directory-path>| 要添加的目录路径,可以是相对路径或绝对路径
功能说明
执行 /add-dir 命令后,Claude Code 会:
- 将指定目录添加到工作目录列表
- Claude 可以访问该目录下的所有文件
- 文件操作(读取、编辑、创建)可以在多个目录中进行
## 使用场景
### 1\. 多模块项目
bash
# 在主项目中添加子模块目录
/add-dir ./modules/auth
/add-dir ./modules/payment
# 现在 Claude 可以同时访问主项目和子模块的代码
### 2\. 共享代码库
bash
# 添加共享代码库
/add-dir ../shared-lib
# Claude 可以引用共享库中的代码
### 3\. 测试目录
bash
# 添加测试目录
/add-dir ./tests
# Claude 可以查看和修改测试文件
## 注意事项- 添加的目录路径必须存在且可访问
- 可以多次执行
/add-dir添加多个目录 - 添加的目录会在当前会话中保持有效
- 建议使用相对路径,便于项目迁移
- 敏感目录(如包含密钥的目录)应谨慎添加
与其他命令的配合使用
bash
# 初始化主项目,添加额外目录,然后开始工作
/init
/add-dir ./shared
/add-dir ./tests
# 执行流程:
# 1. 初始化主项目知识图谱
# 2. 添加共享代码目录
# 3. 添加测试目录
# 4. Claude 现在可以访问所有这些目录
最佳实践
- 项目结构清晰 :在多模块项目中,使用
/add-dir让 Claude 了解完整的项目结构 - 按需添加 :只添加当前任务需要的目录,避免不必要的目录访问
- 相对路径优先 :使用相对路径而不是绝对路径,便于团队协作
- 注意安全 :避免添加包含敏感信息的目录
总结
/add-dir 命令是 Claude Code 中用于扩展工作范围的重要命令。通过使用此命令,你可以:
- 让 Claude 访问多个目录中的文件
- 处理多模块项目或多个代码库
- 提高跨目录操作的效率
合理使用 /add-dir 命令可以帮助你在复杂项目结构中更高效地使用 Claude Code。