Claude Code /add-dir：被低估的 Monorepo 神器

2026年3月23日

Claude

什么是 /add-dir

用 Claude Code 的时候，你可能遇到过这样的情况：

你在项目 A 里工作，但需要参考项目 B 的代码
你在一个 monorepo 的子包里启动了 Claude Code，但需要看另一个子包的实现
你想让 Claude Code 同时了解前端和后端两个仓库，帮你做联调

默认情况下，Claude Code 只能看到当前工作目录下的文件。你启动时在哪个目录，它就只认识那个目录。

这就是 /add-dir 命令的用武之地。

/add-dir 是 Claude Code 的一个斜杠命令，让你在对话过程中把额外的目录添加到 Claude Code 的工作范围中，让它能够读取和操作这些目录下的文件。

简单来说：打破目录的围墙，让 Claude Code 看到更多代码。

两种用法

/add-dir 有两种使用方式：一种是在对话中随时添加，另一种是启动时就指定好。

方式一：交互模式下添加（/add-dir）

在 Claude Code 交互模式下输入：

/add-dir /path/to/another/project

执行后，Claude Code 就能访问这个目录下的所有文件了。你可以让它读取、搜索、甚至编辑这个目录中的代码。

每次 /add-dir 添加一个目录。如果需要添加多个，多次执行即可：

/add-dir /path/to/frontend
/add-dir /path/to/backend
/add-dir /path/to/shared-libs

方式二：启动时指定（—add-dir）

如果你在启动 Claude Code 之前就知道需要哪些额外目录，可以用 --add-dir 参数一次性指定：

claude --add-dir ../apps ../lib

注意和交互模式的区别——--add-dir 可以一次性指定多个目录，用空格分隔。路径会被验证是否存在且是一个目录。

这种方式适合你有固定的多项目组合，每次都需要加载同样的目录集。

使用相对路径

两种方式都支持相对路径：

# 交互模式
/add-dir ../another-project

# 启动时
claude --add-dir ../apps ../../shared/components

路径是相对于当前工作目录来解析的。

什么时候需要它

场景一：Monorepo 跨包协作

这是最常见的场景。假设你有一个 monorepo，结构如下：

my-monorepo/
├── packages/
│   ├── frontend/
│   ├── backend/
│   └── shared/

你在 packages/frontend/ 下启动了 Claude Code。现在你想让它看看 shared 包里某个工具函数的实现，然后在前端项目里调用它。

/add-dir ../shared

这样 Claude Code 就能同时看到前端和共享包的代码，帮你写出正确的导入路径和调用方式。

场景二：前后端联调

你在前端项目里工作，但需要知道后端 API 的请求和响应格式：

/add-dir /Users/me/projects/my-backend

现在你可以直接问 Claude Code：“后端的 /api/users 接口返回什么格式？帮我写一个对应的 TypeScript 类型定义。”

它会去后端目录找到对应的接口定义，然后在前端项目里帮你生成类型文件。

场景三：参考开源项目

想参考某个开源项目的实现方式？把它也加进来：

/add-dir ~/projects/reference-project

然后你可以说：“看看这个项目的路由怎么实现的，我们的项目也参考这个方式来做。“

场景四：共享配置和文档

很多团队会把公共配置、设计规范、API 文档放在单独的仓库里：

/add-dir ~/team/design-system
/add-dir ~/team/api-docs

加进来之后，Claude Code 就能基于这些规范帮你写代码，保证风格一致。

实际使用技巧

技巧一：只加需要的目录

不要一口气把整个磁盘都加进去。添加的目录越多，Claude Code 搜索文件时的范围就越大，可能会影响效率。建议只添加当前任务确实需要的目录。

技巧二：配合提问明确来源

添加多个目录后，提问时最好指明你说的是哪个项目：

看看 shared 包里的 formatDate 函数是怎么实现的，然后在 frontend 项目里调用它

而不是含糊地说”帮我看看 formatDate”——多个目录中可能有同名文件或函数，明确来源能避免歧义。

技巧三：Monorepo 的最佳实践

如果你经常在 monorepo 里工作，最好的做法是在 monorepo 根目录启动 Claude Code，而不是在子包里启动。这样 Claude Code 天然就能看到所有子包的代码，不需要额外 /add-dir。

但如果你的 monorepo 特别大，几十上百个包，从根目录启动可能信息太多。这时候在子包里启动，按需 /add-dir 其他包反而更高效。

技巧四：用 —add-dir 写 alias

如果你每天都在同一组项目间切换，可以在 shell 配置里写一个 alias：

alias claude-fullstack="claude --add-dir ../backend ../shared"

以后在前端目录里直接敲 claude-fullstack，就会自动带上后端和共享库。比每次手动 /add-dir 省事多了。

技巧五：配合 CLAUDE.md 使用

如果你经常需要添加某个外部目录，可以在 CLAUDE.md 里提一下这个目录的作用和路径，方便 Claude Code 理解上下文。虽然 CLAUDE.md 不能自动添加目录，但它能帮 Claude Code 更好地理解你添加的目录是用来干什么的。

/add-dir vs —add-dir vs 在根目录启动

	/add-dir（交互模式）	—add-dir（启动参数）	在根目录启动
时机	对话过程中随时添加	启动时一次性指定	不需要额外操作
多目录	每次一个，多次执行	一次性指定多个	天然包含所有子目录
灵活性	最高，按需添加	中等，需要提前规划	固定的工作范围
适合场景	临时需要看其他项目	固定的多项目组合	中小型 monorepo

我的经验是：

中小型 monorepo → 直接在根目录启动，省事
大型 monorepo → 在子包启动，claude --add-dir 指定需要的其他包
跨仓库协作 → 在主仓库启动，按需 /add-dir 其他仓库
固定工作组合 → 用 --add-dir 写成 alias，一个命令搞定

写在最后

/add-dir 是一个看起来不起眼但关键时刻能救命的命令。它解决的问题很朴素：让 Claude Code 的视野不再局限于一个目录。

现实中的开发工作很少只涉及一个目录。前后端分离、monorepo 多包、共享库依赖——这些场景下，Claude Code 只看一个目录是远远不够的。

下次遇到”要是 Claude Code 能看到另一个项目就好了”的时候，试试 /add-dir，给它多开一扇窗。

相关推荐

AI-first 创业公司，为什么只需要一种编程语言？

技术架构越简单 = AI Coding 效率越高。从 Java 的"防人"设计到 TypeScript 全栈通吃，聊聊 AI 时代创业公司的编程语言选择。

cc-ping：一行命令 Ping 所有 Claude Code 配置

用多个 Claude Code API Key 或中继？cc-ping 帮你管理配置、一键切换，还能并行 Ping 所有节点比速度。

震惊！程序员用这个工具，4分钟干完95分钟的活！效率暴涨24倍

躺床上发3条消息，4分钟搞定3个项目。传统方式需要95分钟，这就是冷兵器和热兵器的差距。

CCBot - 研发提效 24 倍

通过 IM 机器人控制 Claude Code，3 个项目 4 分钟全部搞定。传统编程需要 95 分钟，效率提升 24 倍。

Claude Code 省 Token 小技巧：感叹号的妙用

一个简单却容易被忽略的技巧——用感叹号直接执行命令，省 token、提速度、更可控。

我做了个机器人，让团队在飞书里用 Claude Code

CCBot 让你的团队在飞书群聊里直接用 Claude Code——不需要终端、不需要 SSH。开源、自部署、五分钟搞定。

Claude Code /btw 命令详解：不打扰主线的快问快答

详细介绍 Claude Code 的 /btw 命令——它是什么、怎么用、什么时候该用，以及它和子代理、/compact 的区别。

Claude Code /compact：释放上下文，不丢进度

任务做到一半上下文满了？/compact 帮你压缩对话继续干活——和 /clear、/rewind 的区别一次讲清。

Claude Code /config：一文搞懂所有可调设置

用 Claude Code 却从没打开过 /config？这篇带你逐项拆解——从权限模式到自动压缩，从主题切换到通知配置，帮你打造最顺手的 AI 编程环境。

Claude Code /context：你的上下文都被什么吃了？

对话到一半 Claude Code 说上下文不够了？/context 用一张可视化网格告诉你：上下文被什么占了、占了多少、怎么优化。

Claude Code /diff：这次对话改了什么，一目了然

Claude Code 帮你改了一堆文件，但你不确定到底改了什么？/diff 用交互式界面展示所有改动——既有 git 视角的全量 diff，也有按对话轮次拆分的逐步 diff。

Claude Code /fast：同样的 Opus，两倍速——值不值？

/fast 不会降级模型，还是 Opus，只是更快。什么时候该开、什么时候该关，以及实际体验差异。

Claude Code 引用外部知识的最佳实践：GitHub MCP + Context7

用 GitHub MCP 和 Context7 MCP 两个工具组合，解决 Claude Code 知识过时导致的代码错误问题。

Claude Code /hooks：让 AI 按你的规矩办事

想在 Claude Code 执行命令前自动检查？想在任务完成后自动通知？/hooks 让你用脚本、AI 甚至 HTTP 请求，在关键节点插入自定义逻辑。

Claude Code /init：10 秒自动生成 CLAUDE.md

别再手写 CLAUDE.md 了。看看 /init 自动生成的效果、怎么自定义输出，以及一个让 Claude Code 效率翻倍的小技巧。

Claude Code MCP：让 AI 连接 GitHub、数据库等一切工具

MCP 把 Claude Code 从代码阅读器升级为全栈 Agent。哪些 MCP 服务器值得装、配置怎么写，实测分享。

Claude Code /memory 详解：让 AI 真正记住你的项目

详细介绍 Claude Code 的 /memory 命令和记忆系统——CLAUDE.md 手动指令、Auto Memory 自动记忆、模块化规则，让 Claude 跨会话记住项目规范和个人偏好。

Claude Code /model：Opus、Sonnet、Haiku 怎么选？

不是每个任务都需要 Opus。怎么切换模型、哪个场景用哪个、怎么省 token 又不掉质量。

Claude Code /permissions：谁能干什么，你说了算

每次 Claude Code 要跑命令都弹窗问你？嫌烦又不敢全放开？/permissions 帮你精细控制每个工具的权限——该放的放，该拦的拦。

Claude Code /plan 详解：先想清楚再动手

详细介绍 Claude Code 的 /plan 命令和 Plan Mode——只读规划模式，让 Claude 先分析代码、制定方案，确认后再动手，避免复杂任务翻车。

Claude Code + Playwright MCP：AI 终于能"看见"页面了

一个 Modal 溢出的 bug，Claude Code 反复修了 5 次都没搞定。直到接入 Playwright MCP 让它真正看到页面，一次定位，一次修复。

Claude Code /resume 命令详解：别让对话白聊

详细介绍 Claude Code 的 /resume 命令——恢复历史对话、管理会话、实用技巧，让你的每一轮对话都不浪费。

Claude Code /review：让 AI 帮你做 Code Review

提了 PR 没人看？想在合并前多一道把关？/review 让 Claude Code 像一个资深开发者一样审查你的代码——还有 /ultrareview 和 /security-review 两个进阶选择。

Claude Code Skills 详解：打造你的专属命令库

详细介绍 Claude Code 的 Skills 功能——创建自定义斜杠命令、复用提示词模板、共享团队最佳实践，让 AI 编程更高效更一致。

Claude Code /stats：看看 AI 到底帮你写了多少代码

好奇 Claude Code 到底写了多少行代码？/stats 给你完整数据——token、编辑次数、工具调用，教你怎么看。

Claude Code /status 命令详解：一眼看清会话全貌

详细介绍 Claude Code 的 /status 命令——它是什么、怎么用、能看到哪些信息，以及它在日常工作流中的实际价值。

Claude Code /tasks 命令详解：后台任务尽在掌控

详细介绍 Claude Code 的 /tasks 命令——查看后台任务、管理并行 Agent、掌控长时间运行的进程，让多任务开发井井有条。

Claude Code /usage 命令详解：你的额度还剩多少

详细介绍 Claude Code 的 /usage 命令——查看用量、了解限额、避免突然被限速，让你对自己的额度心中有数。

Claude Code /vim：在 AI 编程助手里用 Vim 键位

习惯了 Vim 的操作方式？/vim 让你在 Claude Code 的输入框里用 hjkl 移动、dd 删行、ciw 替换单词——不用改变肌肉记忆。

Claude Code 使用指南：从安装到实战，一篇就够（2026）

用了半年 Claude Code 的经验总结——5 分钟安装配置、最常用的命令、CLAUDE.md 编写技巧，以及没人告诉你的实战心得。

Claude 全家桶：从聊天到写代码到自动办公，一文讲清楚

一篇文章带你了解 Anthropic 的 Claude 全家桶——Claude.ai、Claude Code、Claude Cowork，以及 Opus、Sonnet、Haiku 三大模型家族。

Claude Code /agents 详解：自定义 AI 子代理，各司其职

详细介绍 Claude Code 的 /agents 命令——查看、管理和创建自定义 Agent，让不同任务由专门的 AI 角色来执行，从代码探索到架构规划各司其职。

Claude Code /doctor 详解：一键诊断你的开发环境

详细介绍 Claude Code 的 /doctor 命令——自动检测安装状态、API 连接、MCP 配置、上下文用量等问题，帮你快速定位和修复环境故障。

Claude Code /effort 详解：控制 AI 思考的深度

详细介绍 Claude Code 的 /effort 命令——调节 Claude 的推理努力程度，在速度和质量之间找到最佳平衡点，让每一次对话都恰到好处。

Claude Code /cost 详解：你的 AI 编程到底花了多少钱

详细介绍 Claude Code 的 /cost 命令——实时查看会话 API 成本，了解各模型定价和 Token 消耗明细，让每一分钱都花得明明白白。

Claude Code /export 详解：把 AI 对话带走

详细介绍 Claude Code 的 /export 命令——将对话导出为文件或复制到剪贴板，方便分享、存档和复盘，让每一次有价值的对话都不浪费。

Claude Code /rewind 详解：AI 改错了？一键回退

详细介绍 Claude Code 的 /rewind 命令——将代码和对话回退到任意历史节点，支持只回退代码、只回退对话、或两者同时回退，是你和 AI 协作时的后悔药。

Claude Code /plugin 详解：给你的 AI 编程助手装插件

详细介绍 Claude Code 的 /plugin 命令——管理插件的安装、启用、禁用和更新，通过插件扩展 Claude Code 的命令、技能、Agent 和 Hook，打造你专属的 AI 编程工具链。

Claude Code /theme 详解：给你的终端换个好看的皮肤

详细介绍 Claude Code 的 /theme 命令——6 种预设主题 + 自动模式，支持深色/浅色、色盲友好、ANSI 兼容，60+ 色值覆盖终端全部 UI 元素。

Claude Code /insights 详解：用 AI 分析你自己用 AI 的方式

详细介绍 Claude Code 的 /insights 命令——五阶段数据分析流水线、七大洞察章节、多维度会话统计，用 Claude Opus 生成专属 HTML 使用报告。

Claude Code /rename 详解：给你的会话取个有意义的名字

详细介绍 Claude Code 的 /rename 命令——手动命名、AI 自动生成（Haiku 模型）、启动参数命名、Plan 模式自动命名，以及双标题系统与 Bridge 同步机制。

Claude Code settings.json 详解（一）：配置文件在哪里、谁说了算

全面介绍 Claude Code 的配置文件体系——五个配置来源的路径、优先级规则、数组合并与单值覆盖的区别、企业管理设置的多种下发方式。

Claude Code settings.json 详解（二）：permissions 权限系统全解析

深入解析 Claude Code 的 permissions 配置——allow/deny/ask 三类规则、通配符语法、MCP 工具权限、defaultMode 各模式含义，以及 additionalDirectories 的作用。

Claude Code settings.json 详解（三）：hooks 钩子全解析

深入解析 Claude Code 的 hooks 配置——四种钩子类型、核心事件（PreToolUse/PostToolUse/Stop/Notification）、stdin/stdout 协议、exit code 语义，以及实用配置示例。

Claude Code settings.json 详解（四）：env、模型、认证与其他实用字段

全面介绍 Claude Code settings.json 中的 env 环境变量注入、模型配置、身份认证辅助、Git 提交署名、会话清理、语言与界面、思考深度、自动更新、记忆系统等实用字段。

Claude Code Agent Loop：拆解 AI 编程助手的心脏

Claude Code 是怎么一步步理解你的需求、调用工具、自我修复的？从源码角度拆解 Agent Loop 的核心架构——流式响应、并行工具执行、自动压缩、错误恢复，一次讲透。