# Opis poleceń

> Wszystkie polecenia i opcje ccam, od ccam add i ccam <name> po ccam usage, ccam next i ccam doctor.

Source: https://ccam.dev/pl/docs/commands/ · Updated 2026-10-19

Wpisz `--dry-run` przed poleceniem, żeby zobaczyć, co by zrobiło, bez wykonywania go, na przykład `ccam --dry-run work`. Działa to przy uruchamianiu Claude Code (`ccam <name>`, `ccam run`, `ccam next`) oraz z `share`, `migrate`, `shortcut`, `update` i `doctor --fix`. Inne polecenia, które coś zmieniają, odrzucają tę opcję zamiast się wykonać.

| Polecenie | Co robi |
| --- | --- |
| `ccam` | Otwórz wybór konta |
| `ccam <name|number> [claude arguments]` | Uruchom Claude Code jako to konto; argumenty są przekazywane bez zmian |
| `ccam add [name]` | Dodaj konto: folder konfiguracji, logowanie i opcjonalny skrót |
| `ccam completion bash|zsh` | Wypisz uzupełnianie dla bash lub zsh |
| `ccam doctor` | Sprawdź linki, uprawnienia, loginy i wersje oraz napraw |
| `ccam import [folder]` | Zarejestruj istniejący folder ~/.claude w miejscu, w którym jest |
| `ccam list` | Wyświetl konta |
| `ccam login <name|number>` | Zaloguj konto ponownie |
| `ccam logout <name|number>` | Usuń login konta |
| `ccam mcp [command]` | Zarządzaj współdzielonymi serwerami MCP |
| `ccam migrate [folder]` | Skopiuj istniejącą konfigurację Claude Code (~/.claude) do współdzielonej grupy |
| `ccam next [--auto] [--continue] [-- claude args]` | Otwórz następne konto; --continue zachowuje rozmowę, --auto wybiera konto z największym zapasem |
| `ccam remove <name|number>` | Usuń konto; jego folder trafia do folderu kosza |
| `ccam rename <name> <new-name>` | Zmień nazwę konta; jego skrót zachowuje swoją nazwę |
| `ccam share <name|number> [--mcp on|off|<group>] [--history …]` | Zmień, co konto współdzieli, po pokazaniu planu |
| `ccam shims [command]` | Utwórz ponownie linki skrótów wszystkich kont |
| `ccam shortcut <name|number> [command]` | Pokaż, utwórz, zmień nazwę lub usuń skrót konta, na przykład ccwork |
| `ccam statusline` | Pokaż konto i użycie na pasku stanu Claude Code |
| `ccam update` | Zaktualizuj ccam do najnowszego wydania po sprawdzeniu sumy kontrolnej |
| `ccam usage` | Pokaż 5-godzinne i tygodniowe użycie wszystkich kont |
| `ccam use <name|number>` | Ustaw domyślne konto |

## Uruchamianie Claude Code

`ccam <name|number> [arguments]` uruchamia Claude Code jako to konto. ccam nie odczytuje argumentów po nazwie; przekazuje je do `claude` w tej samej kolejności, a standardowe wejście, kod wyjścia i sygnały działają dokładnie tak jak w samym `claude`. `--` po nazwie jest opcjonalne.

`ccam` z argumentami, ale bez nazwy konta, na przykład `ccam -p "summarise"`, używa domyślnego konta. Ustawisz je poleceniem `ccam use <name>`.

Skrót taki jak `ccwork` uruchamia swoje konto w ten sam sposób: `ccwork --resume` robi to samo co `ccam work --resume`. Zobacz [skróty](https://ccam.dev/pl/docs/commands.md#shortcuts).

## Dodawanie i usuwanie kont

```sh
ccam add                      # wizard
ccam add work --share history=on
ccam add side --shortcut ccside
ccam add ci --no-login        # log in later with: ccam login ci
ccam rename work job
ccam remove side              # folder moves to ~/.local/share/ccam/trash
ccam import ~/.claude-old --name old
```

`ccam import` bez podanego folderu szuka `~/.claude` i `~/.claude-*` i pyta o każdy z nich. Zaimportowane foldery są rejestrowane tam, gdzie są; ccam nigdy nie przenosi ani nie kopiuje loginu.

`ccam rename`, `ccam remove` i `ccam share` odmawiają zmiany konta, gdy Claude Code działa jako to konto. Najpierw zakończ sesję.

`ccam list --json` wypisuje każde konto z jego numerem (slotem), skrótem, adresem e-mail i folderem. Jego obiekt `share` przypisuje każdy element (`mcp`, `settings`, `memory`, `extensions`, `history`) do nazwy grupy albo `local`.

## Skróty

```sh
ccam shortcut work ccwork     # create it, or rename the existing one
ccam shortcut work            # show it
ccam shortcut work --remove
```

Skrót to polecenie o nazwie wybranej przez ciebie, które uruchamia Claude Code jako jedno konto. Podobnie jak `ccam work` przekazuje każdy argument do Claude Code bez zmian, więc `ccwork --resume` i `ccwork -p "hi"` działają tak, jak się spodziewasz. Jest to link do ccam w `~/.local/bin`.

Skróty są opcjonalne. Kreator `ccam add` pyta, czy utworzyć skrót, `ccam add <name> --shortcut <command>` tworzy go bez pytania, a `ccam list` pokazuje skrót każdego konta albo `-`, gdy konto go nie ma.

Nazwy mogą zawierać znaki a-z, 0-9, `.`, `-` i `_`. Nazwa nie może być poleceniem ccam, skrótem innego konta ani nazwą innego programu w twoim `PATH`.

`ccam rename` zachowuje nazwę skrótu, a `ccam remove` usuwa skrót razem z kontem. `ccam shims install` odtwarza linki wszystkich kont, na przykład po przeniesieniu ccam.

## Współdzielenie

```sh
ccam share work                       # show the current state
ccam share work --history on --mcp team
ccam share work --settings off --fresh
```

Każdy element przyjmuje `on` (grupa `default`), `off` lub nazwę grupy. Zobacz [współdzielenie](https://ccam.dev/pl/docs/sharing.md).

## Kopiowanie istniejącej konfiguracji

```sh
ccam migrate                    # ~/.claude into the default group
ccam --dry-run migrate          # show the plan, copy nothing
ccam migrate ~/.claude-work --group work --settings --mcp
ccam migrate --history --yes    # conversation history only
```

`ccam migrate` kopiuje `settings.json`, `CLAUDE.md`, rozszerzenia i serwery MCP użytkownika z folderu Claude Code do grupy, żeby dostało je każde konto współdzielące te elementy. Folder jest tylko odczytywany. Opcje `--settings`, `--memory`, `--extensions`, `--mcp` i `--history` kopiują tylko wskazane elementy. Bez nich w terminalu pojawia się lista wyboru, na której zaznaczone jest wszystko oprócz historii rozmów; poza terminalem kopiowane jest wszystko oprócz historii rozmów. `-g` lub `--group` wybiera grupę, a `-y` lub `--yes` kopiuje bez pytania i zachowuje kopię grupy, gdy plik się różni. Kopiuje też zapisane logowania serwerów do własnego pliku logowania każdego konta. Zobacz [kopiowanie istniejącej konfiguracji](https://ccam.dev/pl/docs/sharing.md#copy-an-existing-setup).

## Serwery MCP

```sh
ccam mcp add fs -- npx -y @modelcontextprotocol/server-filesystem ~/code
ccam mcp add docs --url https://mcp.example.com/mcp --header "Authorization: Bearer $TOKEN"
ccam mcp add-json db '{"type":"stdio","command":"db-mcp"}'
ccam mcp list
ccam mcp import work gh
ccam mcp remove fs
```

`ccam mcp import <account>` przenosi do grupy konta serwery, które ma tylko to konto. Serwer, którego nazwy grupa używa już dla innej definicji, jest pomijany; dodaj `--force`, aby zastąpić kopię w grupie, a ccam najpierw zrobi jej kopię zapasową.

## Użycie i przełączanie

```sh
ccam usage           # also: ccam u
ccam usage --watch   # refresh every 60 seconds
ccam usage --json
ccam next --continue
ccam next --auto
```

## Konserwacja

```sh
ccam doctor          # check
ccam doctor --fix    # repair what is safe to repair, with backups
ccam statusline install
ccam shims install   # recreate the shortcut links
ccam update          # install the latest ccam release
ccam update --check  # only check for a newer release
ccam version         # also: ccam -v, ccam --version
```

`ccam update` sprawdza sumę kontrolną SHA-256 wydania, zanim podmieni ccam, a `--version v0.2.0` instaluje konkretne wydanie. ccam zainstalowany z pakietu `.deb` aktualizujesz przez apt. Szczegóły znajdziesz w części [aktualizacja](https://ccam.dev/pl/docs/install.md#update).

## Pliki

| Ścieżka | Zawartość |
| --- | --- |
| `~/.config/ccam/config.toml` | Konta i to, co współdzielą |
| `~/.local/share/ccam/profiles/<name>/` | `CLAUDE_CONFIG_DIR` każdego konta |
| `~/.local/share/ccam/groups/<group>/` | Współdzielone ustawienia, serwery MCP, rozszerzenia i historia |
| `~/.local/state/ccam/` | Pamięć podręczna użycia i czasy ostatniego użycia |
| `~/.local/bin/<shortcut>` | Skróty takie jak `ccwork`, czyli linki do ccam |

Zmienne `XDG_CONFIG_HOME`, `XDG_DATA_HOME` i `XDG_STATE_HOME` zmieniają położenie tych folderów.
