/add-dir - 添加额外

概述

/add-dir 命令用于向 Claude Code 添加额外的工作目录，让 AI 可以访问和操作多个目录中的文件。适合多模块项目或需要同时处理多个代码库的场景。

基本语法

/add-dir <directory-path>

参数说明

功能说明

执行 /add-dir 后，Claude Code 会：

• 将指定目录添加到工作目录列表。
• 允许 Claude 访问该目录下的所有文件。
• 支持在多个目录中进行读取、编辑与创建操作。

使用场景

1. 多模块项目

# 在主项目中添加子模块目录
/add-dir ./modules/auth
/add-dir ./modules/payment

# 现在 Claude 可以同时访问主项目和子模块的代码

2. 共享代码库

# 添加共享代码库
/add-dir ../shared-lib

# Claude 可以引用共享库中的代码

3. 测试目录

# 添加测试目录
/add-dir ./tests

# Claude 可以查看和修改测试文件

注意事项

• 添加的目录路径必须存在且可访问。
• 可多次执行 /add-dir 添加多个目录。
• 添加的目录仅在当前会话中有效。
• 建议使用相对路径，便于项目迁移与团队协作。
• 敏感目录（如包含密钥的目录）应谨慎添加。

与其他命令的配合使用

# 初始化主项目，添加额外目录，然后开始工作
/init
/add-dir ./shared
/add-dir ./tests

# 执行流程：
# 1. 初始化主项目知识图谱
# 2. 添加共享代码目录
# 3. 添加测试目录
# 4. Claude 现在可以访问所有这些目录

最佳实践

• 项目结构清晰：在多模块项目中，用 /add-dir 让 Claude 了解完整的项目结构。
• 按需添加：只添加当前任务需要的目录，避免不必要的目录访问。
• 相对路径优先：更利于迁移与协作。
• 注意安全：避免添加包含敏感信息的目录。

总结

/add-dir 命令是 Claude Code 中用于扩展工作范围的重要能力。通过该命令，你可以：

• 让 Claude 访问多个目录中的文件。
• 处理多模块项目或多个代码库。
• 提高跨目录操作的效率。

合理使用 /add-dir 能帮助你在复杂项目结构中更高效地使用 Claude Code。