它到底是什么

/cd 是 Claude Code CLI 中的会话内 slash 命令,作用是把当前会话整体搬到一个新的工作目录,而不是新开会话、也不是临时多挂一个目录。

它和 /add-dir 是两个不同的命令、各管各的事:

• /add-dir <path> —— 在不改变主工作目录的前提下,额外授予对另一个目录的文件访问权(当前目录仍是原来那个)。
• /cd <path> —— 把会话的主工作目录换成新目录:新目录的 CLAUDE.md 被加载、会话被重新落到新目录的 project storage(于是 --resume / --continue 之后从那里能找到它)。

关键设计是保留 prompt cache:换目录时,新目录的 CLAUDE.md 是作为一条追加消息塞进对话,而不是重建整个 system prompt —— 所以不会因为换目录而把已经命中的缓存全部作废。

版本门槛:需要 Claude Code v2.1.169 或更高。早于该版本输入 /cd 会报 Unknown command: /cd。/cd 在 v2.1.169 引入,v2.1.176 有一次 fixed。

怎么触发 / 怎么使用

在会话内,消息开头直接输入:

/cd path/to/new/dir

• 支持相对路径(相对当前工作目录)与绝对路径。
• 如果你之前没在该目录工作过,/cd 会提示你是否信任该目录,确认后才迁入。
• 迁入后,该目录的 CLAUDE.md 生效,会话归属也随之转移到新目录的项目存储。

想"只加目录、不搬家"

那不该用 /cd,而用 /add-dir:它只扩展可访问范围,主工作目录不变。

用 Cd 权限规则限制 / 关闭 /cd

/cd 的目标目录可以用 Cd 权限规则约束。注意一个重要事实:Cd 不是模型可调用的工具 —— Claude 自己调不动它,规则只在你本人手动运行 /cd 时才生效。

路径 pattern 复用 Read/Edit 规则的 //(绝对)、~/(home)、/(项目根)三种锚:

deny 规则会检查目标的每一种拼法(包括它解析穿过的每一跳 symlink),所以为某条路径写的 deny 也会挡住"解析后等于它"的别名路径。

配置写在 settings.json 的 permissions 里,例如禁用一切 /cd:

{
  "permissions": {
    "deny": ["Cd"]
  }
}

或只允许搬到某个工作区根下:

{
  "permissions": {
    "allow": ["Cd(~/work/**)"]
  }
}

运行约束 / 限制

跟 /add-dir 对比

经典使用场景

• 在 monorepo 里换主战场:从仓库根启动后,决定专注某个子包,/cd packages/api 把会话搬过去,让该子包的 CLAUDE.md 与项目存储生效,而不必丢掉当前上下文重开。
• 接力到另一个项目:同一对话里完成 A 项目的调研后,/cd ../project-b 直接迁到 B 项目继续,prompt cache 不被整体作废。
• 企业侧收紧 /cd:管理员在 managed settings 写 Cd(~/work/**) 白名单,防止会话被搬到工作区之外的目录。

常见坑

1. 把 /cd 当成 /add-dir 的别名:它不是。/cd 会真的搬家(改主目录、转移会话存储),只想多挂一个目录读文件请用 /add-dir。
2. 以为 Claude 能自己 /cd:Cd 不是模型可调用工具,只有你本人手输 /cd 才触发,所以也别指望在 prompt 里让模型"切目录"。
3. 早于 v2.1.169 报 Unknown command:不是命令拼错,是版本太旧,升级到 2.1.169+。
4. 配了 allow 规则后被意外拒绝:只要存在任意一条 Cd allow 规则,/cd 就进入白名单模式,目标不在白名单内一律拒绝——别只加一条窄 allow 就忘了它会关掉其余所有目标。
5. 搬家后找不到会话:迁入后会话归属转移到新目录,--resume 要从新目录而非原目录恢复。

关闭 / 退出方式

• 在 settings.json 的 permissions.deny 加裸 Cd 即彻底禁用 /cd。
• 想限定可搬范围:用 Cd(<path-pattern>) deny 黑名单,或加 Cd(...) allow 进入白名单模式。
• 不想换目录就别运行它;/cd 是一次性操作,运行后无需"退出",再 /cd 别处即可。

来源

• Commands · Claude Code 官方文档
• Configure permissions(Cd 规则)· Claude Code 官方文档