Skip to main content
1

Install cac

npm install -g claude-cac
No setup command needed — cac auto-initializes on first use.
2

Install a Claude Code version

cac claude install latest
Downloads the latest Claude Code binary with SHA256 verification. You can also install a specific version:
cac claude install 2.1.81
3

Create an environment

Every environment gets an isolated identity (UUID, hostname, MAC) and its own .claude config directory.
# Minimal — just identity isolation
cac env create personal

# With proxy
cac env create work -p 1.2.3.4:1080:user:pass

# With proxy + pinned version
cac env create work -p 1.2.3.4:1080:user:pass -c 2.1.81
Proxy is optional. If you use an API key with a base URL, you don’t need -p at all. See API key users.
4

Activate and run

cac work
claude
The first time, type /login in Claude Code to complete OAuth. After that, just claude.

What just happened?

When you activated work and ran claude, cac’s wrapper:
  1. Set CLAUDE_CONFIG_DIR to ~/.cac/envs/work/.claude/ (isolated config)
  2. Resolved the pinned Claude Code binary from ~/.cac/versions/2.1.81/claude
  3. Injected device fingerprint shims (hostname, UUID, MAC)
  4. Blocked telemetry endpoints via DNS guard + environment variables
  5. Routed traffic through your proxy (if configured)
  6. Launched the real Claude Code binary
All of this is invisible to Claude Code — it sees a normal environment.

Next steps

Proxy setup

Protocol auto-detection, SOCKS5, share links.

Docker mode

Fully isolated container with TUN networking.