Instalar ccam

Ejecuta esto en una terminal de Linux o macOS:

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

El script descarga la versión para tu sistema, comprueba su suma de verificación SHA-256 y coloca ccam en ~/.local/bin, donde ccam también crea los atajos que elijas más adelante, como ccwork. Si esa carpeta no está en tu PATH, el script imprime la línea que debes agregar a ~/.bashrc o ~/.zshrc.

ccam inicia Claude Code por ti, así que instala primero Claude Code y asegúrate de que claude --version funcione.

Sistemas compatibles

• Linux en x86-64 y ARM64: Ubuntu, Debian, Fedora, Arch, Alpine y otras distribuciones. El binario es estático y no tiene dependencias.
• macOS en Apple silicon e Intel.
• Windows no es compatible directamente. Dentro de WSL, ccam funciona como en cualquier sistema Linux.

Otras formas de instalar

Paquete para Debian y Ubuntu. Descarga ccam_<version>_linux_amd64.deb desde la página de versiones e instálalo:

sudo apt install ./ccam_*_linux_amd64.deb

El paquete instala /usr/bin/ccam.

Desde el código fuente. Con Go 1.26 o posterior:

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

Una versión específica. Define CCAM_VERSION:

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

Autocompletado del shell

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

El autocompletado cubre todos los comandos y opciones de ccam, incluidos los nombres de las cuentas.

Comprobar la instalación

ccam version
ccam doctor

ccam doctor comprueba que se encuentre Claude Code y que cada carpeta de cuenta, enlace e inicio de sesión esté en orden. Continúa con el inicio rápido.

Actualizar

ccam update --check
ccam update

ccam update --check solo te indica si hay una versión más reciente. ccam update descarga la versión para tu sistema, comprueba su suma de verificación SHA-256 con el archivo checksums.txt de la versión y luego reemplaza el archivo ccam en un solo paso. Si la suma de verificación no coincide, no se cambia nada. Los atajos como ccwork son enlaces a ccam, así que ejecutan la nueva versión de inmediato.

$ 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 nunca busca actualizaciones por su cuenta; solo busca una versión nueva cuando ejecutas este comando. Para instalar una versión concreta, incluso una anterior, usa --version. ccam --dry-run update muestra qué se descargaría y qué se reemplazaría, sin cambiar nada.

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

Volver a ejecutar el script de instalación también actualiza la copia de ~/.local/bin. Si compilaste ccam con go install, vuelve a ejecutar el mismo comando.

Paquete para Debian y Ubuntu. ccam update no reemplaza un /usr/bin/ccam instalado con apt; en su lugar, muestra estos pasos. Descarga el nuevo ccam_<version>_linux_amd64.deb desde la página de versiones e instálalo sobre el anterior:

sudo apt install ./ccam_*_linux_amd64.deb

Desinstalar

Primero quita los atajos de las cuentas, mientras ccam sigue instalado. ccam list los muestra en la columna Shortcut; quita cada uno con ccam shortcut <account> --remove, o elimina tú mismo esos enlaces de ~/.local/bin. Luego elimina el comando y, si ya no necesitas las cuentas, las carpetas de datos:

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

Al eliminar ~/.local/share/ccam también se eliminan los inicios de sesión y el historial de conversaciones guardados allí. Una carpeta ~/.claude que hayas importado se queda donde está.