Skip to main content

版本

版本是由 cac 管理的 Claude Code 二进制文件。二进制文件从 Anthropic 官方分发渠道下载,并通过 SHA256 校验验证。
你可以同时安装多个版本。每个环境可以锁定不同的版本。

环境

环境是运行 Claude Code 的完整隔离上下文。它包括:

激活

激活环境是全局的——它影响所有终端和所有项目目录。这是设计使然:你的身份和代理路由是用户级别的关注点,而非项目级别的。
激活后,cac 包装器会拦截每次 claude 调用并应用该环境的设置。 创建环境时会自动激活,无需手动运行 cac env activate

修改环境

使用 cac env set 可以在创建后修改环境配置:

代理是可选的

两种用户类型: 未配置代理时,cac 会保留你的 ANTHROPIC_API_KEYANTHROPIC_BASE_URLANTHROPIC_AUTH_TOKEN 环境变量。配置代理后,这些变量会被清除以强制通过代理进行 OAuth 认证。

自动安装

当你引用尚未安装的版本时,cac 会自动下载——就像 uv 自动安装 Python 版本一样:
-c latest 会自动解析为当前最新版本,无需手动查找版本号。

自动中继

如果 cac 检测到系统中运行了 TUN 模式的代理软件(Clash、Surge、sing-box),它会自动启动本地 TCP 中继。这可以防止 TUN 包裹 cac 代理流量导致的双重代理问题。
无需用户操作——中继会自动激活和停止。