CLI-флаги задают поведение конкретного запуска и делятся по назначению так же, как и всё остальное в Claude Code. Прежде всего различают формы запуска: интерактивная сессия по команде claude, неинтерактивный прогон claude -p и subcommands вроде mcp, doctor, agents, project, auth, plugin и update. Форма определяет, какие флаги вообще имеют смысл. Этот справочник группирует наиболее употребимые флаги; полный и точный список для вашей версии - в официальном CLI reference и по claude --help.
Флаги контекста и разрешений - самые важные для безопасности. --permission-mode задаёт режим на запуск, --allowedTools и --disallowedTools - точечный контроль инструментов синтаксисом permission-правил, --add-dir даёт доступ к дополнительному каталогу, --dangerously-skip-permissions включает bypass (и назван опасным намеренно). --settings, --setting-sources, --mcp-config, --agents, --plugin-dir и --plugin-url управляют тем, какая конфигурация подхватывается, - особенно вместе с --bare, который отключает автоподхват, и --safe-mode для диагностики.
Флаги автоматизации определяют детерминированность. --output-format выбирает text, json или stream-json; --json-schema ограничивает структурированный вывод; --max-turns и --max-budget-usd ставят потолок на ходы и стоимость; --continue и --resume управляют непрерывностью сессии; --verbose и --debug раскрывают диагностику. Отдельно стоят --worktree для изолированного дерева, --background для фоновой сессии и --remote-control для удалённого управления локальной работой. Ниже - карта ключевых флагов и subcommands по группам.
Как и с командами, наличие флага в справочнике не заменяет проверку. Флаги, модели и их поведение меняются между версиями, поэтому перед тем как зашить флаг в скрипт или CI, сверяются с claude --help и официальным reference - особенно с теми, где есть слова dangerously, skip или bypass. Точный синтаксис --allowedTools совпадает с permission-правилами из соответствующей главы; при сомнении лучше один раз проверить фактическое поведение узким прогоном, чем построить автоматизацию на предположении.
| Группа | Флаг / форма | Назначение |
|---|---|---|
| Формы запуска | claude / claude -p | Интерактивная сессия / неинтерактивный прогон |
| subcommands |
| mcp, doctor, agents, project, auth, plugin, update, remote-control |
| Разрешения/контекст | --permission-mode | Режим на запуск (plan, acceptEdits, dontAsk, ...) |
|---|
| --allowedTools / --disallowedTools | Точечный контроль (синтаксис permission-правил) |
| --add-dir | Доступ к дополнительному каталогу |
| --dangerously-skip-permissions | Bypass permissions (опасно, только в изоляции) |
| Конфигурация | --bare / --safe-mode | Без автоподхвата / диагностический режим |
|---|
| --settings / --setting-sources | Явные настройки / ограничение источников |
| --mcp-config / --agents / --plugin-dir | Явные MCP, агенты, плагин |
| Автоматизация | --output-format / --json-schema | text|json|stream-json; структурированный вывод |
|---|
| --max-turns / --max-budget-usd | Потолок ходов и стоимости |
| --continue / --resume | Непрерывность сессии |
| --verbose / --debug | Диагностика прогона |
| Параллельность | --worktree / --background | Изолированное дерево / фоновая сессия |
|---|