# Справочник команд

> Все команды и параметры ccam, от ccam add и ccam <name> до ccam usage, ccam next и ccam doctor.

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

Поставьте `--dry-run` перед командой, чтобы увидеть, что она сделает, ничего не выполняя, например `ccam --dry-run work`. Это работает при запуске Claude Code (`ccam <name>`, `ccam run`, `ccam next`) и с `share`, `migrate`, `shortcut`, `update` и `doctor --fix`. Другие команды, которые что-то меняют, отклоняют этот флаг и не выполняются.

| Команда | Что делает |
| --- | --- |
| `ccam` | Открыть выбор аккаунта |
| `ccam <name|number> [claude arguments]` | Запустить Claude Code от имени этого аккаунта; аргументы передаются без изменений |
| `ccam add [name]` | Добавить аккаунт: папка конфигурации, вход и необязательная короткая команда |
| `ccam completion bash|zsh` | Вывести автодополнение для bash или zsh |
| `ccam doctor` | Проверить ссылки, права доступа, входы и версии и исправить |
| `ccam import [folder]` | Зарегистрировать существующую папку ~/.claude на её месте |
| `ccam list` | Показать список аккаунтов |
| `ccam login <name|number>` | Снова войти в аккаунт |
| `ccam logout <name|number>` | Удалить данные входа аккаунта |
| `ccam mcp [command]` | Управлять общими MCP-серверами |
| `ccam migrate [folder]` | Скопировать существующую настройку Claude Code (~/.claude) в общую группу |
| `ccam next [--auto] [--continue] [-- claude args]` | Открыть следующий аккаунт; --continue сохраняет разговор, --auto выбирает аккаунт с наибольшим запасом |
| `ccam remove <name|number>` | Удалить аккаунт; его папка перемещается в папку корзины |
| `ccam rename <name> <new-name>` | Переименовать аккаунт; его короткая команда сохраняет своё имя |
| `ccam share <name|number> [--mcp on|off|<group>] [--history …]` | Изменить, что делит аккаунт, предварительно показав план |
| `ccam shims [command]` | Пересоздать ссылки коротких команд всех аккаунтов |
| `ccam shortcut <name|number> [command]` | Показать, создать, переименовать или удалить короткую команду аккаунта, например ccwork |
| `ccam statusline` | Показывать аккаунт и использование в строке состояния Claude Code |
| `ccam update` | Обновить ccam до последнего выпуска, проверив контрольную сумму |
| `ccam usage` | Показать использование за 5 часов и за неделю для всех аккаунтов |
| `ccam use <name|number>` | Задать аккаунт по умолчанию |

## Запуск Claude Code

`ccam <name|number> [arguments]` запускает Claude Code от имени этого аккаунта. ccam не читает аргументы после имени; он передаёт их в `claude` в том же порядке, а стандартный ввод, код возврата и сигналы работают точно так же, как с самим `claude`. Указывать `--` после имени необязательно.

`ccam` с аргументами, но без имени аккаунта, например `ccam -p "summarise"`, использует аккаунт по умолчанию. Задать его можно командой `ccam use <name>`.

Короткая команда, например `ccwork`, запускает свой аккаунт так же: `ccwork --resume` делает то же, что и `ccam work --resume`. См. раздел [короткие команды](https://ccam.dev/ru/docs/commands.md#shortcuts).

## Добавление и удаление аккаунтов

```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` без указания папки ищет `~/.claude` и `~/.claude-*` и спрашивает про каждую найденную. Импортированные папки регистрируются там, где они находятся; ccam никогда не перемещает и не копирует данные входа.

`ccam rename`, `ccam remove` и `ccam share` не изменяют аккаунт, пока Claude Code работает от его имени. Сначала завершите сессию.

`ccam list --json` выводит все аккаунты с номером (слотом), короткой командой, email и папкой каждого. Объект `share` в выводе сопоставляет каждому элементу (`mcp`, `settings`, `memory`, `extensions`, `history`) имя группы или `local`.

## Короткие команды

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

Короткая команда представляет собой команду с выбранным вами именем, которая запускает Claude Code от имени одного аккаунта. Как и `ccam work`, она передаёт все аргументы в Claude Code без изменений, поэтому `ccwork --resume` и `ccwork -p "hi"` работают так, как вы ожидаете. Это ссылка на ccam в `~/.local/bin`.

Короткие команды необязательны. Мастер `ccam add` спрашивает, создать ли её, `ccam add <name> --shortcut <command>` создаёт её без вопросов, а `ccam list` показывает короткую команду каждого аккаунта или `-`, если её нет.

В именах допустимы символы a-z, 0-9, `.`, `-` и `_`. Имя не может совпадать с командой ccam, с короткой командой другого аккаунта или с именем другой программы в вашем `PATH`.

`ccam rename` сохраняет имя короткой команды, а `ccam remove` удаляет её вместе с аккаунтом. `ccam shims install` заново создаёт ссылки всех аккаунтов, например после того как вы переместили ccam.

## Общий доступ

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

Каждый элемент принимает `on` (группа `default`), `off` или имя группы. Подробнее в разделе [общий доступ](https://ccam.dev/ru/docs/sharing.md).

## Копирование существующей настройки

```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` копирует `settings.json`, `CLAUDE.md`, расширения и пользовательские MCP-серверы из папки Claude Code в группу, чтобы их получил каждый аккаунт, который делит эти элементы. Папка только читается. Параметры `--settings`, `--memory`, `--extensions`, `--mcp` и `--history` копируют только указанные элементы. Без них в терминале появляется список с флажками, где отмечено всё, кроме истории разговоров; в остальных случаях копируется всё, кроме истории разговоров. `-g` или `--group` выбирает группу, а `-y` или `--yes` копирует без вопросов и оставляет копию группы, если файл отличается. Кроме того, он копирует сохранённые данные входа серверов в собственный файл входа каждого аккаунта. См. раздел [копирование существующей настройки](https://ccam.dev/ru/docs/sharing.md#copy-an-existing-setup).

## 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>` переносит в группу аккаунта серверы, которые есть только у этого аккаунта. Сервер, чьё имя в группе уже занято другим определением, пропускается; добавьте `--force`, чтобы заменить копию в группе, — ccam сначала сохранит её резервную копию.

## Использование и переключение

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

## Обслуживание

```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` проверяет контрольную сумму SHA-256 выпуска, прежде чем заменить ccam, а `--version v0.2.0` устанавливает определённый выпуск. ccam, установленный из пакета `.deb`, обновляется через apt. Подробности в разделе [обновление](https://ccam.dev/ru/docs/install.md#update).

## Файлы

| Путь | Содержимое |
| --- | --- |
| `~/.config/ccam/config.toml` | Аккаунты и то, что они делят |
| `~/.local/share/ccam/profiles/<name>/` | `CLAUDE_CONFIG_DIR` каждого аккаунта |
| `~/.local/share/ccam/groups/<group>/` | Общие настройки, MCP-серверы, расширения и история |
| `~/.local/state/ccam/` | Кэш использования и время последнего использования |
| `~/.local/bin/<shortcut>` | Короткие команды, например `ccwork`; ссылки на ccam |

Переменные `XDG_CONFIG_HOME`, `XDG_DATA_HOME` и `XDG_STATE_HOME` позволяют перенести эти папки.
