启动参数看官方文档为 Claude 添加额外的工作目录以读写文件Syntax--add-dir <directories>示例claude --add-dir ../apps ../lib全网调研整理典型场景跨仓库开发时同时访问多个 repo(如前端 + 后端 API),让 Claude 读写两侧文件大型 monorepo 中从某个子包启动,按需 --add-dir 其他子包,避免加载整个根目录需要参考开源或第三方项目的实现模式,将其作为只读参考目录添加进来service repo + infra repo 联动时,让 Claude 同时理解业务代码与基础设施配置跨仓库维护共享 configs、设计规范或 API 文档,保持多项目一致性实用技巧会话中可随时用 /add-dir <path> 动态追加目录,无需重启(每次一个,支持相对路径)在 .claude/settings.json 里设置 additionalDirectories 数组,让常用目录每次自动加载,免去重复输入 flag设置环境变量 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1,使额外目录的 CLAUDE.md / CLAUDE.local.md 也被读取生效(v2.1.20+)v2.1.32+ 额外目录中的 .claude/skills/ 会自动发现并加载 skills,无需手动声明将常用多目录组合写成 shell alias(如 alias claude-work='claude --add-dir ../api --add-dir ../shared'),一键启动常见坑默认不读取额外目录的 CLAUDE.md,不设 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 则该目录的项目规则不会生效添加目录越多,Claude 的搜索范围越大,响应质量和速度会随无关上下文的增加而下降/add-dir 运行时命令每次只能添加一个目录,且路径相对于当前工作目录解析,与 --add-dir 的多参数语法不同来源CLI reference - Claude Code DocsClaude Code /add-dir: The Monorepo Command You Miss — Vincent's Blog[DOCS] --add-dir can load CLAUDE.md from additional directories (v2.1.20) · Issue #21138[DOCS] --add-dir docs missing automatic .claude/skills/ loading behavior (v2.1.32) · Issue #23404Feature Request: Configure Additional Directories via Settings Files · Issue #3146创建于v1.0.18最近更新v2.1.45变化次数4新增 2改进 2变化时间线(按版本倒序)改进v2.1.45· 2026/02/18 · 2026/02/18修改 `--add-dir` flag 以支持从添加的目录中读取 `enabledPlugins` 和 `extraKnownMarketplaces` 配置改进v2.1.32· 2026/02/06 · 2026/02/06改进参数自动加载额外目录中定义的 skills新增v2.1.20· 2026/01/27 · 2026/01/27支持通过 --add-dir 标志从指定目录加载 CLAUDE.md 文件新增v1.0.18· 2025/06/10 · 2025/06/10新增 CLI 参数用于指定额外的工作目录回到命令字典下一个--agent
改进v2.1.45· 2026/02/18 · 2026/02/18修改 `--add-dir` flag 以支持从添加的目录中读取 `enabledPlugins` 和 `extraKnownMarketplaces` 配置