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

Короткая команда представляет собой команду с выбранным вами именем, которая запускает Claude Code от имени одного аккаунта: ccwork --resume делает то же, что и ccam work --resume. Это ссылка на ccam в ~/.local/bin, поэтому она работает в bash, zsh, скриптах и везде, где программы запускаются из PATH. Короткие команды необязательны; создайте их для аккаунтов, которые вы запускаете часто.

Использование

ccam shortcut work ccwork     # create the shortcut ccwork for work
ccam shortcut 2 ccside        # the account with number 2
ccam shortcut work            # show it
ccam shortcut work ccw        # rename it; the old link is removed
ccam shortcut work --remove   # delete it
ccam add side --shortcut ccside
ccam shims install            # recreate missing links of all accounts
ccwork -p "summarise" --output-format json

ccam подтверждает каждое изменение:

$ ccam shortcut work ccwork
✓ shortcut for work: ccwork
$ ccam shortcut work ccw
✓ shortcut for work: ccw (was ccwork)
$ ccam shortcut work --remove
✓ ccw removed; work has no shortcut now
$ ccam shortcut work
work: none (add one with `ccam shortcut work ccwork`)

У аккаунта может быть не больше одной короткой команды, она хранится как shortcut в ~/.config/ccam/config.toml. Мастер ccam add спрашивает Create a shortcut command for <name>? [y/N], а затем Shortcut name [cc<name>]:. Вне мастера ccam add создаёт её только с --shortcut. ccam list показывает короткую команду каждого аккаунта или -.

Короткая команда передаёт в Claude Code каждый аргумент так же, как ccam <name> после имени. Это относится и к --dry-run и --help: чтобы заранее посмотреть запуск, используйте ccam --dry-run work.

Параметры

ccam shims install не принимает аргументов и отклоняет --dry-run с сообщением ccam: --dry-run is not supported by `ccam shims install`; nothing was changed.

Правила для имени, проверяемые в таком порядке:

• от 1 до 64 символов из a-z, 0-9, ., - и _, начинается с буквы или цифры;
• не ccam, не claude и не команда ccam, например run или usage;
• не короткая команда другого аккаунта;
• не файл в ~/.local/bin, который ещё не является ссылкой на ccam;
• не имя другой исполняемой программы в вашем PATH.

Если указать и команду, и --remove, выполнение останавливается с сообщением give a command or --remove, not both. Если задать имя, которое у аккаунта уже есть, выводится work: ccwork (unchanged), а отсутствующая ссылка создаётся заново.

Как это работает

Задание имени запускает checkShortcut, который вызывает shim.Check с папкой bin и реальным путём к исполняемому файлу ccam:

Имя проходит проверки по порядку. Рядом с каждой проверкой показано имя, которое она отклоняет: Work не соответствует шаблону, run является командой ccam, ccside принадлежит другому аккаунту, ccfile уже существует как файл в ~/.local/bin, а git скрыл бы /usr/bin/git. Сохраняется и связывается только имя, прошедшее все проверки.

1. shim.Check сопоставляет имя с ^[a-z0-9][a-z0-9._-]{0,63}$, затем с config.Reserved, затем с cfg.FindShortcut. Он вызывает os.Lstat для ~/.local/bin/<name>, а для каждой другой папки в PATH вызывает os.Stat и отклоняет исполняемый файл, который не является ссылкой на ccam.
2. ccam сохраняет config.toml через fsutil.AtomicWrite (временный файл, fsync, переименование).
3. shim.Remove удаляет ссылку старой короткой команды, но только если это ссылка на ccam.
4. shim.Install создаёт ссылку для каждой настроенной короткой команды, у которой её нет, через os.Symlink на исполняемый файл ccam, путь к которому определяется через os.Executable и filepath.EvalSymlinks. Он никогда ничего не удаляет.

Ссылка считается собственной ссылкой ccam, если os.Readlink возвращает путь к ccam или если ссылка и путь к ccam указывают на один и тот же файл. Каждое удаление и каждая проверка перед перезаписью проходят через эту проверку, поэтому ccam не трогает файлы, которые создал не он.

Когда вы запускаете короткую команду, ccam нужно только набранное вами имя:

Оболочка находит ccwork в PATH, ядро следует по ссылке и запускает исполняемый файл ccam, а argv[0] по-прежнему равен ccwork. В app.Main любое имя, кроме ccam, один раз загружает config.toml и вызывает shim.Lookup, который находит аккаунт, у которого shortcut равен filepath.Base(argv[0]). Затем launcher.LaunchWith выполняет те же шаги, что и ccam <name>, с уже загруженной конфигурацией и передаёт argv[1:] в claude без изменений.

Почему символическая ссылка, а не псевдоним оболочки или скрипт-обёртка: символическая ссылка работает в любой оболочке и в скриптах, не добавляет лишнего запуска оболочки (около 1–2 мс), а запуск по-прежнему читает один файл. scripts/perf-check.sh измеряет короткую команду с помощью hyperfine с тем же пределом 10 мс (p95), что и для ccam <name>.

Безопасность и особые случаи

• Ссылка, которая не принадлежит ни одному аккаунту. Если у ссылки на ccam в ~/.local/bin имя, которое не использует ни один аккаунт, например после ручного изменения shortcut в config.toml, ccam не переходит на аккаунт по умолчанию. Он останавливается с сообщением ccam: ccold is not the shortcut of any account (see `ccam list`, `ccam shortcut`). Задайте имя заново через ccam shortcut или удалите ссылку.
• Существующие файлы. ccam никогда не заменяет файл, который создал не он. ccam shims install останавливается с сообщением <path> already exists and is not a ccam link, so it was left alone.
• Перемещённый исполняемый файл ccam. Старые ссылки тогда указывают на путь, которого больше нет, и ccam не считает их своими. Удалите их, затем выполните ccam shims install.
• Переименование и удаление. ccam rename сохраняет имя короткой команды, и ссылка продолжает работать, потому что она указывает на ccam, а ccam ищет имя в config.toml. ccam remove удаляет ссылку аккаунта. ccam shortcut <account> <new> удаляет старую ссылку, прежде чем создать новую.
• PATH. Если ccam создаёт ссылку, а ~/.local/bin нет в вашем PATH, он выводит Note: /home/me/.local/bin is not in PATH. Add it to ~/.bashrc or ~/.zshrc: и следом строку export PATH=..., которую нужно добавить.
• Последующая проверка. ccam doctor сообщает missing shortcuts in /home/me/.local/bin: ccwork и предупреждает, если папки нет в PATH. ccam doctor --fix создаёт отсутствующие ссылки.

См. также

• Запуск Claude Code
• Управление аккаунтами
• Справочник команд
• Установка ccam