跳转到主要内容
每个环境是完全隔离的上下文：独立的 .claude 配置、设备身份、Claude Code 版本和可选代理。

​
create

创建新环境。 
cac env create <name> [-p <proxy>] [-c <version>] [--type local|container]
参数说明
-p, --proxy代理地址。可选。
-c, --claude锁定的 Claude Code 版本。未安装时自动下载。
--typelocal（默认）或 container。
示例： 
# 仅身份隔离（无代理，使用系统 Claude）
cac env create personal

# 带代理
cac env create work -p 1.2.3.4:1080:user:pass

# 带代理 + 锁定版本
cac env create work -p socks5://proxy:1080 -c 2.1.81

# 自动安装最新版 Claude Code
cac env create dev -c latest
代理格式： 
host:port:user:pass       # 自动检测协议（依次尝试 http → socks5 → https）
host:port                 # 无认证
socks5://user:pass@host:port
http://host:port
环境名称必须是字母数字、连字符或下划线。如 my-work 和 prod_us1 是有效的；my/work 无效。

​
ls

列出所有环境。 
cac env ls
cac ls        # 快捷方式

  ▶ work
      proxy: socks5://u:p@1.2.3.4:1080  claude: 2.1.81  type: local
    personal
      claude: system  type: local
▶ 标记显示当前活跃环境。

​
activate

激活环境。这是全局的——影响所有终端。 
cac env activate work
cac work              # 快捷方式
激活时：
  1. 将 ~/.cac/current 设置为环境名称
  2. 更新隔离 .claude 配置中的 statsig 和用户 ID 文件
  3. 如果检测到 TUN 且配置了代理，重启中继

​
deactivate

停用当前环境。Claude Code 将在无保护状态下运行。 
cac env deactivate

​
check

对当前活跃环境运行诊断检查。 
cac env check
检查项目：
  • 环境信息（代理、UUID、版本、时区）
  • 代理连通性和出口 IP（如果配置了代理）
  • TUN 冲突检测（如果配置了代理）
  • 安全防护（DNS 守卫、遥测环境变量、mTLS）

​
rm

移除环境。不能移除当前活跃的环境。 
cac env rm staging
此操作会永久删除环境目录，包括其 .claude 配置、身份文件和 mTLS 证书。