你在前端目录里启动了会话，让智能体修改一个 API 调用。问题是接口代码在另一个仓库里，在上一级目录，智能体够不着。Verboo Code 的 /add-dir 就是为此准备的：它给当前会话授权一个额外的文件夹，不需要关掉一切再从父目录重新打开。
Verboo Code 的 /add-dir 是做什么的？
它把一个文件夹加入会话的工作目录列表。从这一刻起，读取和编辑文件的工具也能作用于它，同时沙箱配置会立即刷新，让终端命令也能访问新文件夹。
默认情况下，Verboo Code 只操作你启动会话的那个目录。这是有意为之：限制智能体的影响范围。/add-dir 是显式扩大这个边界的方式，一次一个文件夹。
如何一步步授权另一个文件夹？
在会话中传入文件夹路径。相对路径、绝对路径和 ~ 开头的路径都可以：
/add-dir ../apiCLI 会检查路径是否存在、是否是目录。通过后，会打开 Add directory to workspace 对话框，有三个选项：
| 选项 | 效果 | 适用场景 |
|---|---|---|
Yes, for this session | 授权到你退出会话为止 | 在另一个仓库做一次性修改 |
Yes, and remember this directory | 立即授权，并写入当前项目的 .verboo/settings.local.json | 总是一起用的文件夹，比如共享包 |
No | 不授权 | 路径输错了 |
确认后会返回 Added /home/you/projects/api as a working directory for this session · /permissions to manage。不带参数时，/add-dir 会打开一个输入框让你填写路径，按 Tab 可以补全。
如何在启动时就授权这些文件夹？
启动时使用 --add-dir 参数，它可以接收多个文件夹：
verboo --add-dir ../api ../shared如果不想每次都输入，Yes, and remember this directory 选项会把文件夹写入项目的本地配置文件。你也可以手动写：
// .verboo/settings.local.json
{
"permissions": {
"additionalDirectories": ["/home/you/projects/api"]
}
}当 CLI 自己写入这个文件时，会把 .verboo/settings.local.json 加进 .gitignore，所以你本机的路径不会进入仓库。如果整个团队都需要同一个相邻文件夹，同样的键也可以写在共享配置文件 .verboo/settings.json 里。
为什么 /add-dir 拒绝了这个文件夹？
几乎都是下面四条消息之一，原文来自 CLI 源码：
| 消息 | 原因 | 怎么办 |
|---|---|---|
Path ... was not found. | 路径不存在，或当前用户没有读取权限 | 用 ls -ld ../api 检查 |
... is not a directory. Did you mean to add the parent directory ...? | 传入的是文件 | 改传包含该文件的文件夹 |
... is already accessible within the existing working directory ... | 该文件夹已经在某个已授权目录之内 | 无需操作：智能体已经能访问 |
Please provide a directory path. | 输入为空 | 填写路径 |
第三条最容易让人困惑：当前项目的子文件夹永远不需要 /add-dir。这个命令是给会话启动目录之外的文件夹用的。
注意：授权文件夹并不会让智能体读取它的规则。相邻仓库的 AGENTS.md 默认不会加载。智能体可能在不了解你为那个项目写的约定的情况下修改那里的文件。要加载额外文件夹的指令，启动时设置环境变量：
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 verboo --add-dir ../api设置后，CLI 会读取额外文件夹的 AGENTS.md（没有 AGENTS.md 时读 CLAUDE.md）、.claude/CLAUDE.md 以及 .claude/rules/ 下的文件。可接受的值为 1、true、yes 或 on。关于这些文件，见 /memory 与 AGENTS.md 教程。
如何查看和移除已授权的文件夹？
打开 /permissions，进入 Workspace 标签页。这里会列出原始目录（标记为 (Original working directory)）以及每个额外文件夹。你可以在这里移除文件夹，或通过 Add directory… 再添加一个。
/permissions同一个界面还控制智能体可以不经确认就执行哪些命令。如果你还没配置，/permissions 教程介绍了允许和禁止规则。
授权两三个文件夹后，智能体每次请求会读更多文件，因为它要先理解两边，才能修改两者之间的接口。在 Verboo Code 上，各套餐都是无限 token，所以把后端和前端一起打开不会增加费用。
