ccam installieren

Führe dies in einem Terminal unter Linux oder macOS aus:

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

Das Skript lädt das Release für dein System herunter, prüft seine SHA-256-Prüfsumme und legt ccam in ~/.local/bin ab, wo ccam später auch die Kurzbefehle anlegt, die du wählst, etwa ccwork. Wenn dieser Ordner nicht in deinem PATH liegt, gibt das Skript die Zeile aus, die du zu ~/.bashrc oder ~/.zshrc hinzufügen musst.

ccam startet Claude Code für dich, also installiere zuerst Claude Code und stelle sicher, dass claude --version funktioniert.

Unterstützte Systeme

• Linux auf x86-64 und ARM64: Ubuntu, Debian, Fedora, Arch, Alpine und andere Distributionen. Die Binärdatei ist statisch und hat keine Abhängigkeiten.
• macOS auf Apple Silicon und Intel.
• Windows wird nicht direkt unterstützt. Innerhalb von WSL funktioniert ccam wie auf jedem Linux-System.

Andere Installationswege

Paket für Debian und Ubuntu. Lade ccam_<version>_linux_amd64.deb von der Release-Seite herunter und installiere es:

sudo apt install ./ccam_*_linux_amd64.deb

Das Paket installiert /usr/bin/ccam.

Aus dem Quellcode. Mit Go 1.26 oder neuer:

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

Eine bestimmte Version. Setze CCAM_VERSION:

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

Shell-Vervollständigung

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

Die Vervollständigung deckt alle Befehle und Optionen von ccam ab, einschließlich der Kontonamen.

Installation prüfen

ccam version
ccam doctor

ccam doctor prüft, ob Claude Code gefunden wird und ob jeder Kontoordner, jeder Link und jede Anmeldung in Ordnung ist. Weiter geht es mit dem Schnellstart.

Aktualisieren

ccam update --check
ccam update

ccam update --check zeigt nur an, ob es ein neueres Release gibt. ccam update lädt das Release für dein System herunter, prüft seine SHA-256-Prüfsumme anhand der checksums.txt des Releases und ersetzt dann die Datei ccam in einem Schritt. Stimmt die Prüfsumme nicht, wird nichts verändert. Kurzbefehle wie ccwork sind Links auf ccam und starten deshalb sofort die neue Version.

$ 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 sucht nie von selbst nach Updates, sondern erst, wenn du diesen Befehl ausführst. Um ein bestimmtes Release zu installieren, auch ein älteres, gib --version an. ccam --dry-run update zeigt, was heruntergeladen und ersetzt würde, ohne etwas zu verändern.

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

Wenn du das Installationsskript erneut ausführst, wird die Kopie in ~/.local/bin ebenfalls aktualisiert. Hast du ccam mit go install gebaut, führe denselben Befehl noch einmal aus.

Paket für Debian und Ubuntu. ccam update ersetzt kein /usr/bin/ccam, das über apt installiert wurde, und gibt stattdessen diese Schritte aus. Lade das neue ccam_<version>_linux_amd64.deb von der Release-Seite herunter und installiere es über das alte:

sudo apt install ./ccam_*_linux_amd64.deb

Deinstallieren

Entferne zuerst die Kurzbefehle der Konten, solange ccam noch installiert ist. ccam list zeigt sie in der Spalte Shortcut; entferne jeden mit ccam shortcut <account> --remove oder lösche diese Links selbst aus ~/.local/bin. Entferne dann den Befehl und die Datenordner, wenn du die Konten nicht mehr brauchst:

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

Wenn du ~/.local/share/ccam löschst, werden auch die dort gespeicherten Anmeldungen und Gesprächsverläufe gelöscht. Ein ~/.claude-Ordner, den du importiert hast, bleibt, wo er ist.