# Instalar ccam

> Instala ccam en Linux o macOS con un comando, desde un paquete .deb o desde el código fuente, y mantenlo al día con ccam update. Primero debes instalar Claude Code.

Source: https://ccam.dev/es/docs/install/ · Updated 2026-10-19

Ejecuta esto en una terminal de Linux o macOS:

```sh
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](https://docs.claude.com/en/docs/claude-code/overview) 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](https://github.com/jhyunwoo/ccam/releases) e instálalo:

```sh
sudo apt install ./ccam_*_linux_amd64.deb
```

El paquete instala `/usr/bin/ccam`.

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

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

**Una versión específica.** Define `CCAM_VERSION`:

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

## Autocompletado del shell

```sh
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

```sh
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](https://ccam.dev/es/docs/quick-start.md).

## Actualizar

```sh
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.

```console
$ 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.

```sh
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](https://github.com/jhyunwoo/ccam/releases) e instálalo sobre el anterior:

```sh
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:

```sh
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](https://ccam.dev/es/docs/commands.md) se queda donde está.
