它到底是什么

--add-dir 是 Claude Code CLI 的启动 flag，作用是让 Claude 除了当前工作目录之外，还能读写额外指定的目录。官方文档原文：

Add additional working directories for Claude to read and edit files. Grants file access; Claude Code doesn't discover most .claude/ configuration from these directories. Validates that each path exists as a directory. You can't add most network paths, such as \\server\share.

接受值：一个或多个目录路径（可以是相对路径或绝对路径），支持一次传入多个。

用法

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

官方示例即为上例：一次性添加 ../apps 和 ../lib 两个目录。

会话中途也可以用等价的斜杠命令动态添加目录（无需重启会话）：

/add-dir ../other-project

官方 slash-commands 文档提到：

When you add a directory with --add-dir or /add-dir, Claude Code loads the skills in that directory's .claude/skills/, along with its .claude/commands/ and .claude/agents/.

并补充"要更早加载它们，对子目录路径运行 /add-dir，需要 Claude Code v2.1.257 或更高版本"——这个版本号来自该官方文档页面。

要跨会话持久生效，对应的 settings.json 字段是 permissions.additionalDirectories:

{
  "permissions": {
    "additionalDirectories": ["../apps", "../lib"]
  }
}

官方 settings-reference 对该字段的描述是："Give Claude file access to directories outside the current one"。目前没有找到对应的独立环境变量。

在 settings.json 的等价配置

运行约束 / 限制

常见坑

• 只用 --add-dir 只对当次会话生效，重启会话后需要重新指定；如果想要每次启动都自动生效，需要写进 settings.json 的 permissions.additionalDirectories，而不是依赖 flag。
• 被添加的目录不会自动带上它自己的 CLAUDE.md 或权限规则——这点和"添加一个新的工作区"直觉不同，容易误以为该目录的项目级配置也会一并生效。

来源

• CLI reference
• Settings reference
• Slash commands
• Claude Code --add-dir: Additional Working Directories Guide | ClaudeLog