安装 ccam

在 Linux 或 macOS 的终端中运行：

curl -fsSL https://ccam.dev/install.sh | sh

脚本会下载适用于你系统的版本，校验其 SHA-256 校验和，然后把 ccam 放入 ~/.local/bin；之后你选择的快捷命令（例如 ccwork）也会由 ccam 创建在这个文件夹中。如果该文件夹不在你的 PATH 中，脚本会打印需要添加到 ~/.bashrc 或 ~/.zshrc 的那一行。

ccam 会为你启动 Claude Code，所以请先安装 Claude Code，并确认 claude --version 可以正常运行。

支持的系统

• x86-64 和 ARM64 上的 Linux：Ubuntu、Debian、Fedora、Arch、Alpine 及其他发行版。二进制文件是静态的，没有任何依赖。
• Apple 芯片和 Intel 处理器上的 macOS。
• 不直接支持 Windows。在 WSL 中，ccam 的使用方式与在任何 Linux 系统上相同。

其他安装方式

Debian 和 Ubuntu 软件包。 从发布页面下载 ccam_<version>_linux_amd64.deb 并安装：

sudo apt install ./ccam_*_linux_amd64.deb

该软件包会安装 /usr/bin/ccam。

从源码安装。 需要 Go 1.26 或更高版本：

go install github.com/jhyunwoo/ccam/cmd/ccam@latest

安装特定版本。 设置 CCAM_VERSION：

curl -fsSL https://ccam.dev/install.sh | CCAM_VERSION=v0.1.0 sh

Shell 补全

ccam completion bash > ~/.local/share/bash-completion/completions/ccam
ccam completion zsh > "${fpath[1]}/_ccam"

补全覆盖 ccam 的所有命令和选项，包括账号名。

检查安装

ccam version
ccam doctor

ccam doctor 会检查能否找到 Claude Code，以及每个账号文件夹、链接和登录是否正常。接下来请阅读快速入门。

更新

ccam update --check
ccam update

ccam update --check 只告诉你是否有更新的版本。ccam update 会下载适用于你系统的版本，用该版本的 checksums.txt 校验其 SHA-256 校验和，然后一步替换 ccam 文件。如果校验和不匹配，不会做任何更改。ccwork 这样的快捷命令是指向 ccam 的链接，因此会立即运行新版本。

$ ccam update --check
ccam 0.3.0 is available (you have 0.2.0). Run `ccam update`.
$ ccam update
→ downloading https://github.com/jhyunwoo/ccam/releases/download/v0.3.0/ccam_linux_amd64.tar.gz
✓ Updated ccam 0.2.0 → 0.3.0 (/home/me/.local/bin/ccam)
$ ccam update
ccam 0.3.0 is up to date.

ccam 从不自动检查更新，只有在你运行这个命令时才会查找新版本。要安装特定版本（包括较旧的版本），请传入 --version。ccam --dry-run update 会显示将要下载和替换的内容，但不做任何更改。

ccam update --version v0.2.0
ccam --dry-run update

重新运行安装脚本也会更新 ~/.local/bin 中的 ccam。如果你是用 go install 构建的 ccam，再运行一次同样的命令即可。

Debian 和 Ubuntu 软件包。 ccam update 不会替换由 apt 安装的 /usr/bin/ccam，而是打印以下步骤。从发布页面下载新的 ccam_<version>_linux_amd64.deb，覆盖安装旧版本：

sudo apt install ./ccam_*_linux_amd64.deb

卸载

趁 ccam 还在，先删除账号的快捷命令。ccam list 会在 Shortcut 列中显示它们；用 ccam shortcut <account> --remove 逐个删除，或者自己从 ~/.local/bin 中删除这些链接。然后删除 ccam 命令；如果不再需要这些账号，再删除数据文件夹：

ccam list
ccam shortcut work --remove   # once for each account that has a shortcut
rm ~/.local/bin/ccam
rm -r ~/.config/ccam ~/.local/share/ccam ~/.local/state/ccam

删除 ~/.local/share/ccam 也会删除其中存储的登录信息和对话历史。你导入的 ~/.claude 文件夹会保留在原位置。