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

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

Запуск Claude Code

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

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

Короткая команда, например ccwork, запускает свой аккаунт так же: ccwork --resume делает то же, что и ccam work --resume. См. раздел короткие команды.

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

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.

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

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.

Общий доступ

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

Каждый элемент принимает on (группа default), off или имя группы. Подробнее в разделе общий доступ.

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

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 копирует без вопросов и оставляет копию группы, если файл отличается. Кроме того, он копирует сохранённые данные входа серверов в собственный файл входа каждого аккаунта. См. раздел копирование существующей настройки.

MCP-серверы

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 сначала сохранит её резервную копию.

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

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

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

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. Подробности в разделе обновление.

Файлы

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