跳转到主要内容
你花了不少时间定制 Claude Code —— CLAUDE.md、自定义 skills、hooks、plugins、MCP 服务器。创建新的 cac 环境时,不想从头再来一遍。 --clone 让你把现有配置继承到新的隔离环境中,同时设备身份和遥测保护完全独立。

快速开始

# 从宿主 ~/.claude/ 克隆配置
cac env create work --clone

# 开始使用
cac work
claude
就这么简单。新的 work 环境拥有你所有的自定义配置,同时有自己独立的身份。

继承了什么

资源默认(符号链接)使用 --no-link(复制)
commands/符号链接 — 修改会同步到所有环境复制 — 独立
hooks/符号链接复制
skills/符号链接复制
plugins/符号链接复制
CLAUDE.md符号链接复制 + 自动追加 cac 指令
settings.json通过 settings.override.json 分层合并通过 settings.override.json 分层合并
以下内容不会被继承(每个环境独立生成):
  • 设备身份(UUID、hostname、MAC 地址、machine ID)
  • 登录凭据和会话
  • 遥测保护设置
  • mTLS 证书

符号链接 vs 复制

符号链接(默认)

cac env create work --clone
共享资源通过符号链接指向源目录。在 ~/.claude/ 中修改 skill 或 hook 后,所有克隆环境立即看到变化。 适合:让所有环境保持同步,共用一套自定义配置。

复制(--no-link

cac env create work --clone --no-link
资源被复制到新环境。修改源不影响它,反之亦然。 适合:创建一个需要独立定制的环境。
使用 --no-link 时,cac 会自动在复制的 CLAUDE.md 末尾追加 cac 专属指令(“CAC Meta Prompt”)。符号链接模式下会跳过这步,因为修改符号链接的文件会影响源文件。

从其他环境克隆

可以从任意现有 cac 环境克隆,而不只是 ~/.claude/
# 从 "work" 环境克隆
cac env create work2 --clone work
适合在已有定制的环境基础上分支出新环境。

Settings 合并机制

无论符号链接还是复制模式,settings 都使用分层合并:
  1. 基础层:来自源的 settings.json(宿主 ~/.claude/ 或其他环境)
  2. 覆盖层:环境中的 settings.override.json(cac 特有覆盖项)
  3. 结果:合并后的 settings.json 写入环境的 .claude/ 目录
合并在每次 claude 启动时自动执行,所以更新基础 settings 后,所有克隆环境会自动同步。
~/.claude/settings.json             (共享基础配置)
    +
env/.claude/settings.override.json  (cac 覆盖:权限、statusline 等)
    =
env/.claude/settings.json           (合并结果,自动生成)

典型工作流

# 1. 按喜好配置宿主 ~/.claude/
#    (skills、hooks、plugins、CLAUDE.md、settings)

# 2. 创建继承所有配置的隔离环境
cac env create client-a --clone -p proxy-a:1080:user:pass
cac env create client-b --clone -p proxy-b:1080:user:pass

# 3. 每个环境拥有:
#    - 你的完整配置(skills、hooks 等)
#    - 独立身份(不同指纹)
#    - 独立代理(不同出口 IP)
#    - 独立遥测保护

# 4. 自由切换
cac client-a
claude    # 用你的配置 + client-a 的身份和代理

cac client-b
claude    # 同样的配置,不同的身份和代理

与其他参数组合

所有 create 参数可以自由组合:
# 克隆 + 代理 + 指定版本 + aggressive 遥测
cac env create secure --clone -p socks5://proxy:1080 -c 2.1.85 --telemetry aggressive

# 从其他环境克隆 + 独立复制
cac env create fork --clone work --no-link