SpyBara
Go Premium

cli-reference.md 2026-10-22 22:58 UTC to 2026-10-23 22:59 UTC

This page contains 87 additions and 87 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Tue 6 23:59 Wed 7 23:59 Fri 9 23:02 Sat 10 23:01 Sat 17 23:57 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Thu 29 23:57

Справочник CLI

Полный справочник по интерфейсу командной строки Claude Code, включая команды и флаги.

Команды CLI

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

Команда Описание Пример
claude Запустить интерактивную сессию claude
claude "query" Запустить интерактивную сессию с начальным промптом claude "explain this project"
claude -p "query" Запрос через SDK, затем выход claude -p "explain this function"
cat file | claude -p "query" Обработка переданного содержимого cat logs.txt | claude -p "explain"
claude -c Продолжить самый последний диалог в текущем каталоге claude -c
claude -c -p "query" Продолжить через SDK claude -c -p "Check for type errors"
claude -r "<session>" "query" Возобновить сессию по ID или имени claude -r "auth-refactor" "Finish this PR"
claude update Обновить до последней версии claude update
claude gateway Запустить сервер самостоятельно размещаемого Claude apps gateway для администраторов, развёртывающих SSO и политики перед Claude Code на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Требует --config, указывающий на gateway.yaml. claude gateway --config gateway.yaml
claude install [version] Установить или переустановить нативный двоичный файл. Принимает версию, такую как 2.1.118, или stable, или latest. См. Установить конкретную версию claude install stable
claude auth login Войти в свою учётную запись Anthropic. Используйте --email для предварительного заполнения адреса электронной почты, --sso для принудительной аутентификации SSO и --console для входа с помощью Anthropic Console с биллингом за использование API вместо подписки Claude claude auth login --console
claude auth logout Выйти из своей учётной записи Anthropic claude auth logout
claude auth status Показать статус аутентификации в формате JSON. Используйте --text для удобочитаемого вывода. Завершается с кодом 0, если вы вошли, и 1, если нет. JSON включает поле configDirectory с указанием каталога конфигурации, который использует CLI. Это поле требует Claude Code v2.1.268 или новее. Поле authMethod в JSON принимает одно из значений: none, claude.ai, oauth_token, api_key, api_key_helper или third_party claude auth status
claude agents Открыть представление агентов для мониторинга и отправки параллельных фоновых сессий. Используйте --cwd <path> для отображения только сессий, запущенных в этом каталоге, или --json для вывода активных сессий в виде массива JSON для скриптов (--json --all также включает завершённые фоновые сессии). Передайте --permission-mode, --model, --effort или --agent для установки значений по умолчанию для отправленных сессий. Принимает --settings, --add-dir, --plugin-dir и --mcp-config, как и команда верхнего уровня claude. Открытие представления агентов требует интерактивного терминала claude agents --json
claude attach <id|name> Подключиться к фоновой сессии в этом терминале. Передача части имени работающей сессии вместо ID требует Claude Code v2.1.290 или новее claude attach 7c5dcf5d
claude auto-mode defaults Вывести встроенные правила классификатора авторежима в формате JSON. Используйте claude auto-mode config, чтобы увидеть вашу действующую конфигурацию с применёнными настройками. --label <prefix> выводит только правила, метка которых начинается с этого префикса, без учёта регистра. Требует Claude Code v2.1.208 или новее claude auto-mode defaults --label 'Git Destructive'
claude auto-mode reset Восстановить конфигурацию авторежима по умолчанию, удалив раздел autoMode из файла пользовательских настроек. Запрашивает подтверждение перед записью; передайте -y/--yes, чтобы пропустить запрос. Правила из управляемых настроек или флага --settings по-прежнему применяются. Требует Claude Code v2.1.212 или новее. См. Проверить значения по умолчанию и вашу действующую конфигурацию claude auto-mode reset --yes
claude daemon logs Отслеживать файл лога супервизора фоновых сессий, ~/.claude/daemon.log, выводя новые строки по мере их появления, пока вы не нажмёте Ctrl+C claude daemon logs
claude daemon run Запустить супервизор фоновых сессий на переднем плане этого терминала с выводом его лога claude daemon run
claude daemon status Вывести состояние супервизора фоновых сессий, версию, каталог сокетов и количество рабочих процессов для диагностики. Завершается с кодом 1, если супервизор не запущен claude daemon status
claude daemon stop --any Остановить супервизор фоновых сессий и размещённые им сессии. Передайте --keep-workers, чтобы оставить фоновые сессии работающими, и следующий супервизор переподключится к ним. --any подтверждает остановку супервизора по требованию, который используется по умолчанию. Используйте это для восстановления после неотвечающего супервизора claude daemon stop --any --keep-workers
claude doctor Вывести диагностику установки и настроек (только для чтения) из терминала без запуска сессии, включая состояние установки, ошибки валидации файлов настроек и доступность Remote Control. Для проверки настройки внутри сессии, которая также может применять исправления, запустите /doctor claude doctor
claude import [source] Запустить интерактивную сессию, которая выполняет /import для переноса конфигурации из других агентов для программирования в Claude Code. Принимает те же опции --dry-run и --yes, что и команда. Недоступно на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или Claude Platform on AWS. Также недоступно, если вы отключили получение флагов функций. Требует Claude Code v2.1.213 или новее claude import codex --dry-run
claude logs <id|name> Вывести недавний вывод фоновой сессии. Передача части имени сессии вместо ID требует Claude Code v2.1.290 или новее claude logs 7c5dcf5d
claude mcp Настроить серверы Model Context Protocol (MCP) См. документацию Claude Code по MCP.
claude mcp login <name> Запустить процесс OAuth настроенного MCP-сервера без открытия интерактивной панели /mcp. Работает для HTTP, SSE и серверов коннекторов claude.ai. Добавьте --no-browser при работе через SSH, чтобы вывести URL авторизации вместо открытия браузера. Для HTTP- или SSE-сервера вставьте URL перенаправления обратно в поле ввода. Для коннектора claude.ai см. Повторная авторизация коннектора из оболочки. См. Аутентификация из командной строки claude mcp login sentry
claude mcp logout <name> Очистить сохранённые учётные данные OAuth для MCP-сервера claude mcp logout sentry
claude plugin Управлять плагинами Claude Code. Псевдоним: claude plugins. Подкоманды см. в справочнике по плагинам claude plugin install code-review@claude-plugins-official
claude purge [path] Удалить всё локальное состояние Claude Code для проекта: транскрипты, списки задач, логи отладки, историю редактирования файлов, строки истории промптов и запись проекта в ~/.claude.json. Опустите [path], чтобы выбрать из интерактивного списка. Флаги: --dry-run для предпросмотра, -y/--yes для пропуска подтверждения, -i/--interactive для подтверждения каждого элемента, --all для всех проектов. См. Очистить локальные данные claude purge ~/work/repo --dry-run
claude remote-control Запустить сервер Remote Control для управления Claude Code из Claude.ai или приложения Claude. Работает в режиме сервера (без локальной интерактивной сессии). См. флаги режима сервера. После остановки сервера вы можете вернуть сессии, которые он обслуживал. См. Возобновить сессии после остановки сервера claude remote-control --name "My Project"
claude respawn <id> Перезапустить фоновую сессию, работающую или остановленную, с сохранением её диалога. Используйте --all для перезапуска всех работающих сессий, например чтобы применить обновлённый двоичный файл Claude Code claude respawn 7c5dcf5d
claude rm <id> Удалить фоновую сессию из списка. Если в удалении отказано из-за worktree сессии и повторный вызов claude rm может это решить, сообщение об отказе выводит точный флаг и значение для передачи: --discard-unpushed <commit>@<worktree-id> отбрасывает worktree с неотправленными коммитами вместе с этими коммитами, а --force-remove-worktree <worktree-id> удаляет каталог worktree, который git или хук WorktreeRemove не смогли удалить. --discard-unpushed требует Claude Code v2.1.260 или новее, а --force-remove-worktree требует v2.1.268 или новее. Транскрипт диалога остаётся на вашем локальном компьютере и доступен через claude --resume claude rm 7c5dcf5d
claude self-hosted-runner Запустить процесс runner, который регистрирует эту машину или контейнер в самостоятельно размещаемой среде и размещает облачные сессии Claude Code на вашей инфраструктуре. Запустите claude self-hosted-runner setup для пошагового руководства оператора, claude self-hosted-runner doctor для диагностики развёрнутого runner и claude self-hosted-runner orchestrator для создания runner по требованию. Требует Claude Code v2.1.224 или новее claude self-hosted-runner setup
claude setup-token Создать долгоживущий OAuth-токен для CI и скриптов. Выводит токен в терминал без сохранения. Требует подписки Claude. См. Создать долгоживущий токен claude setup-token
claude stop <id> Остановить фоновую сессию. Также принимается claude kill claude stop 7c5dcf5d
claude ultrareview [target] Запустить ultrareview неинтерактивно. Выводит результаты в stdout и завершается с кодом 0 при успехе или 1 при ошибке. Используйте --json для получения необработанных данных и --timeout <minutes>, чтобы переопределить значение по умолчанию в 45 минут. Используйте --post с целевым pull request на github.com, чтобы опубликовать готовые результаты в PR одним простым комментарием от вашей учётной записи GitHub. По умолчанию используется --no-post. --post и --no-post требуют Claude Code v2.1.227 или новее. См. Публикация результатов в pull request claude ultrareview 1234 --json

Если вы опечатаетесь в подкоманде, Claude Code предложит ближайшее совпадение и завершит работу без запуска сессии. Например, claude udpate выводит Did you mean claude update?.

claude --dangerously-skip-permissions daemon <subcommand> запускает подкоманду daemon, поэтому подкоманда работает, когда для claude задан псевдоним, включающий этот флаг. Только стоящий в начале --dangerously-skip-permissions или --allow-dangerously-skip-permissions направляет к daemon таким образом; если перед daemon стоит любой другой флаг, подкоманда не выполняется.

Флаги CLI

Настройте поведение Claude Code с помощью этих флагов командной строки. claude --help не выводит каждый флаг, поэтому отсутствие флага в --help не означает, что он недоступен.

Флаг Описание Пример
--add-dir Добавить дополнительные рабочие каталоги для Claude для чтения и редактирования файлов. Предоставляет доступ к файлам; Claude Code не обнаруживает большинство конфигурации .claude/ из этих каталогов. Проверяет, что каждый путь существует как каталог. Вы не можете добавить большинство сетевых путей, таких как \\server\share. Чтобы сохранить эти каталоги между сеансами, установите permissions.additionalDirectories в параметрах claude --add-dir ../apps ../lib
--advisor <model> Включить инструмент advisor на стороне сервера для этого сеанса с псевдонимом модели fable, opus или sonnet, или полным ID модели. Имеет приоритет над параметром advisorModel для сеанса. fable требует доступ к Fable claude --advisor opus
--agent Указать агента для текущего сеанса (переопределяет параметр agent) claude --agent my-custom-agent
--agents Определить пользовательские subagents динамически через JSON. Принимает поля, указанные для subagents, определённых через CLI. С --print значение может быть вместо этого путём к файлу JSON, содержащему объект; форма файла требует Claude Code v2.1.281 или позже. Claude Code проверяет значение при запуске и выходит при недействительном; см. Invalid --agents configuration для сообщения и для флагов и переменной окружения, которые пропускают проверку. Проверка требует Claude Code v2.1.242 или позже claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissions Добавить bypassPermissions в цикл режима Shift+Tab без немедленной активации. Позволяет начать в другом режиме, таком как plan, и переключиться на bypassPermissions позже. См. режимы разрешения claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedTools, --allowed-tools Инструменты, которые выполняются без запроса разрешения, за исключением чтения из сетевых путей. Сопоставление шаблонов см. в разделе синтаксис правил разрешений. Чтобы ограничить набор доступных инструментов, используйте вместо этого --tools. Если указать здесь один из инструментов отслеживания задач, Claude Code также включает их для сессии "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt Добавить пользовательский текст в конец системного приглашения каждого subagent, включая вложенные subagents, кроме forked subagent, который повторно использует приглашение собственной беседы. Применяется только в неинтерактивном режиме с -p. Требует Claude Code v2.1.205 или позже claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"
--append-subagent-system-prompt-file Загрузить текст из файла и добавить его к системным приглашениям subagent. Альтернатива --append-subagent-system-prompt для текста, слишком длинного для передачи в командной строке. Два флага не могут быть скомбинированы. Применяется только в неинтерактивном режиме с -p. Требует Claude Code v2.1.261 или позже claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"
--append-system-prompt Добавить пользовательский текст в конец системного приглашения по умолчанию claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Загрузить дополнительный текст системного приглашения из файла и добавить к приглашению по умолчанию claude --append-system-prompt-file ./extra-rules.txt
--autocompact <auto|tokens> Установить окно auto-compact для этого сеанса без изменения сохранённых параметров. Принимает те же значения, что и /autocompact; этот раздел охватывает формы значений и то, что переопределяет флаг. Требует Claude Code v2.1.221 или позже claude --autocompact 500k
--ax-screen-reader Отрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Принудительно использует классический рендерер, поэтому параметр tui не имеет эффекта; присоединённые фоновые сеансы по-прежнему отрендериваются в полноэкранном режиме. Имеет приоритет над CLAUDE_AX_SCREEN_READER и параметром axScreenReader. Требует Claude Code v2.1.181 или позже claude --ax-screen-reader
--bare Минимальный режим: пропустить автоматическое обнаружение hooks, skills, пользовательских команд, subagents, plugins, MCP серверов, автоматической памяти и CLAUDE.md, чтобы скриптовые вызовы начинались быстрее. Skills в каталоге, который вы передаёте с --add-dir, всё ещё загружаются. Claude имеет доступ к инструментам Bash, чтения файлов и редактирования файлов. Устанавливает CLAUDE_CODE_SIMPLE. См. bare mode claude --bare -p "query"
--betas Заголовки бета-версии для включения в запросы API (только для пользователей API-ключей) claude --betas interleaved-thinking
--bg, --background Запустить сеанс как фоновый агент и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с --exec для запуска команды shell как фонового задания вместо сеанса Claude, или с --agent для запуска конкретного subagent. Проверяет доверие рабочей области для каталога перед запуском. Не может быть скомбинирован с -p/--print; см. справочник ошибок claude --bg "investigate the flaky test"
--channels (Исследовательский предпросмотр) MCP серверы, чьи уведомления channel Claude должен слушать в этом сеансе. Разделённый пробелом список записей plugin:<name>@<marketplace>. Требует аутентификацию Anthropic через claude.ai или API-ключ Console claude --channels plugin:my-notifier@my-marketplace
--chrome Включить интеграцию браузера Chrome для веб-автоматизации и тестирования claude --chrome
--cloud С описанием задачи создать новую облачную сессию. С ID сессии (session_... или cse_...) или URL claude.ai/code поставить в очередь сообщение в эту существующую сессию вместо этого, с -p. См. отправить последующее сообщение. claude --cloud "Fix the login bug"
--continue, -c Загрузить самый последний диалог в текущем каталоге, включая завершившуюся фоновую сессию; для открытия завершившихся фоновых сессий требуется Claude Code v2.1.257 или новее. Пропускает сессии, созданные с помощью claude -p или Agent SDK, а также сессии, первым промптом которых был /loop. claude -p --continue включает сессии -p, SDK и /loop. Включает сессии, которые добавили этот каталог с помощью /add-dir claude --continue
--dangerously-load-development-channels Включить каналы, которых нет в утверждённом списке разрешённых, для локальной разработки. Принимает записи plugin:<name>@<marketplace> и server:<name>. Запрашивает подтверждение, поэтому действует в интерактивных сессиях. С -p Claude Code игнорирует этот флаг claude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissions Пропустить запросы разрешения. Эквивалентно --permission-mode bypassPermissions. См. режимы разрешения для информации о том, что это пропускает и что не пропускает. Для сеансов, запущенных с --bg, режим сохраняется при перезапуске сеанса супервизором claude --dangerously-skip-permissions
--debug Включить режим отладки с необязательной фильтрацией по категориям, например --debug='mcp,startup' или --debug='!mcp'. Фильтр применяется только в форме с =; фильтр, указанный через пробел, включает режим отладки без фильтрации claude --debug='mcp,startup'
--debug-file <path> Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над CLAUDE_CODE_DEBUG_LOGS_DIR claude --debug-file /tmp/claude-debug.log
--desktop Открыть приложение Claude Desktop в текущем каталоге и выйти без запуска сеанса в терминале. Добавьте --continue или --resume с ID сеанса для открытия этого сеанса в Desktop вместо этого. --resume здесь принимает только ID сеанса, не имя или путь транскрипта. Не принимает приглашение и никакие другие флаги, кроме --verbose и флагов --debug, так как приложение само запускает сеанс. Доступно на macOS и x64 Windows, когда вы вошли с подпиской Claude. Требует Claude Code v2.1.285 или позже claude --desktop
--disable-slash-commands Отключить все skills и команды для этого сеанса claude --disable-slash-commands
--disallowedTools, --disallowed-tools Правила отрицания. Простое имя инструмента удаляет соответствующие инструменты из контекста Claude: "Edit" удаляет Edit, "*" удаляет каждый инструмент, и "mcp__*" удаляет каждый MCP инструмент. Правило с областью действия, такое как Bash(rm *), оставляет инструмент доступным и отрицает только вызовы, которые совпадают как написано. Правило, называющее EndConversation, не может удалить его, пока остаётся любой другой инструмент "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort Установить уровень усилий для текущего сеанса. Опции: low, medium, high, xhigh, max или ultracode. Доступные уровни зависят от модели. ultracode запускает сеанс с усилием xhigh с включённым ultracode и требует Claude Code v2.1.203 или позже. Переопределяет параметры modelSettings и effortLevel для этого сеанса и не сохраняется claude --effort high
--enable-auto-mode Удалено в v2.1.111. Auto mode теперь находится в цикле Shift+Tab по умолчанию; используйте --permission-mode auto для запуска в нем claude --permission-mode auto
--environment <environment-id> Создать новый облачный сеанс, который работает на самостоятельно размещённой среде с заданным ID. ID среды начинаются с ccpool_. См. поведение отправки --environment для поведения отправки и комбинаций флагов, которые она отклоняет. Требует Claude Code v2.1.224 или позже claude -p "Fix the login bug" --environment ccpool_abc123
--exclude-dynamic-system-prompt-sections Переместить контекст для каждого пользователя, такой как местоположение автоматической памяти, из системного приглашения в первое пользовательское сообщение. Улучшает повторное использование prompt-cache на разных пользователях и машинах, запускающих одну и ту же задачу. Применяется только с системным приглашением по умолчанию; игнорируется, когда установлены --system-prompt или --system-prompt-file. Используйте с -p для скриптовых многопользовательских рабочих нагрузок claude -p --exclude-dynamic-system-prompt-sections "query"
--exec Запустить команду shell как фоновое задание с поддержкой PTY вместо запуска сеанса Claude. Используйте с --bg для запуска из shell claude --bg --exec 'pytest -x'
--fallback-model Включить автоматический переход на указанную модель (модели) при перегрузке или недоступности основной модели, например снятая с производства модель. Принимает разделённый запятыми список, пробуемый по порядку. См. Цепочки резервных моделей. Чтобы сохранить цепочку между сеансами, используйте параметр fallbackModel, который этот флаг переопределяет claude --fallback-model sonnet,haiku
--fork-session При возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с --resume или --continue) claude --resume abc123 --fork-session
--forward-subagent-text Выводить текст и блоки размышлений субагентов в выходной поток как сообщения assistant и user с установленным parent_tool_use_id, чтобы можно было восстановить транскрипт каждого субагента. Без этого флага Claude Code опускает текст и блоки размышлений субагента, работающего на переднем плане. Требует --print и --output-format stream-json. О вложенных субагентах, ответвлённых скиллах и версиях, необходимых для каждого из них, см. Отслеживание сообщений субагентов. Переменная окружения CLAUDE_CODE_FORWARD_SUBAGENT_TEXT включает то же поведение. Требует Claude Code v2.1.211 или новее claude -p --output-format stream-json --verbose --forward-subagent-text "query"
--from-pr Открыть выбор сеанса, отфильтрованный по сеансам, связанным с конкретным pull request. Принимает номер PR, URL GitHub или GitHub Enterprise PR, URL GitLab merge request или URL Bitbucket pull request. Сеансы автоматически связываются при создании Claude pull request claude --from-pr 123
--ide Автоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDE claude --ide
--init Запустить Setup hooks с matcher init перед сеансом (только режим печати) claude -p --init "query"
--init-only Запустить Setup и SessionStart hooks, затем выйти без запуска беседы claude --init-only
--include-hook-events Включить события жизненного цикла hook в выходной поток. События SessionStart и Setup hook всегда включены и не требуют этого флага. Некоторые события hook, такие как Notification, SessionEnd, PreCompact и PostCompact, никогда не производят событие hook_started, даже с этим флагом. Для этих событий Claude Code всё ещё выдаёт hook_progress, пока команда hook, которая работает более одной секунды, производит вывод, и выдаёт hook_response только когда hook, который работает в фоне, завершается. Требует --output-format stream-json claude -p --output-format stream-json --verbose --include-hook-events "query"
--include-partial-messages Включить частичные события потоковой передачи в вывод. Требует --print и --output-format stream-json claude -p --output-format stream-json --verbose --include-partial-messages "query"
--input-format Указать формат входных данных для режима печати (опции: text, stream-json) claude -p --output-format json --input-format stream-json
--json-schema Получить проверенный вывод JSON, соответствующий JSON Schema после завершения рабочего процесса агента (только режим печати). См. структурированные выходы. Claude Code выходит с ошибкой при недействительной схеме и принимает ключевое слово format как аннотацию без проверки на стороне клиента claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenance Запустить Setup hooks с matcher maintenance перед сеансом (только режим печати) claude -p --maintenance "query"
--max-budget-usd Остановить запуск, как только оценочные расходы на вызовы API достигнут этой суммы (только режим печати). Claude Code сверяет лимит со своей клиентской оценкой стоимости, которая может отличаться от вашего счёта. Расходы субагентов учитываются в лимите. Расходы могут превысить лимит, поэтому оставляйте запас. Когда вы возвращаетесь к диалогу с --continue или --resume, итоги, восстановленные из предыдущих запусков, в нём не учитываются. Когда расходы достигают лимита, запуск ещё одного субагента завершается ошибкой Budget limit reached, а Claude Code останавливает всё ещё работающих фоновых субагентов; для этого поведения ограничения требуется Claude Code v2.1.217 или новее claude -p --max-budget-usd 5.00 "query"
--max-turns Ограничить количество агентских ходов (только режим печати). Выходит с ошибкой при достижении лимита. По умолчанию нет лимита. С --input-format stream-json сообщение, всё ещё находящееся в очереди, когда лимит заканчивает ход, остаётся в очереди и начинает новый ход с собственным лимитом claude -p --max-turns 3 "query"
--mcp-config Загрузить MCP-серверы из JSON-файлов или строк (через пробел). Когда вы передаёте этот флаг с -p, Claude Code перед первым ходом ждёт подключения ещё не подключившихся серверов — не дольше стартового таймаута MCP_TIMEOUT, по умолчанию 30 секунд; сервер с кэшированным списком инструментов не ожидается и подключается при первом использовании. В самостоятельно размещённом окружении вместо этого действует более короткое ожидание. Для ожидания требуется Claude Code v2.1.221 или новее claude --mcp-config ./mcp.json
--model Устанавливает модель для текущего сеанса с псевдонимом модели, таким как sonnet, opus, haiku или fable, или полным именем модели. Переопределяет параметр model и ANTHROPIC_MODEL claude --model claude-sonnet-5
--name, -n Задать отображаемое имя сессии, которое показывается в /resume и в заголовке терминала. Именованную сессию можно возобновить с помощью claude --resume <name>. /rename изменяет имя во время сессии и также показывает его на панели промпта claude -n "my-feature-work"
--no-chrome Отключить интеграцию браузера Chrome для этого сеанса claude --no-chrome
--no-session-persistence Отключить сохранение сеанса, чтобы сеансы не сохранялись на диск и не могли быть возобновлены. Только режим печати. Переменная окружения CLAUDE_CODE_SKIP_PROMPT_HISTORY делает то же самое в любом режиме claude -p --no-session-persistence "query"
--output-format Указать формат вывода для режима печати (опции: text, json, stream-json) claude -p "query" --output-format json
--permission-mode Начать в указанном режиме разрешения. Принимает default, acceptEdits, plan, auto, dontAsk, bypassPermissions или manual как псевдоним для default. Псевдоним manual выбирает режим разрешения, который UI обозначает как Manual и требует Claude Code v2.1.200 или позже; claude --help выводит его вместо default, и оба значения работают. Переопределяет defaultMode из файлов параметров. Без этого флага или --dangerously-skip-permissions новый сеанс начинается в режиме разрешения, описанном в какой режим разрешения начинает сеанс, который также охватывает то, в каком режиме начинается запуск -p claude --permission-mode plan
--permission-prompt-tool Указать MCP-инструмент для обработки запросов разрешения в неинтерактивном режиме. Передайте полное имя, например mcp__<server>__<tool>, инструмента на MCP-сервере, который загружается при этом запуске. Claude Code перед первым ходом ждёт подключения MCP-сервера этого инструмента — не дольше стартового таймаута MCP_TIMEOUT, по умолчанию 30 секунд. Инструмент обработки запросов не может одобрить MCP-инструмент, помеченный как требующий взаимодействия с пользователем: Claude Code преобразует результат allow для такого инструмента в запрет. Это ограничение требует Claude Code v2.1.199 или новее claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"
--permission-prompts Установить, кто отвечает на запросы разрешения в режиме печати. С по умолчанию host, Claude Code отправляет их хосту Agent SDK или инструменту --permission-prompt-tool. Передайте none, когда никто не может ответить, и Claude Code отклоняет их вместо этого. См. Отключить запросы разрешения в автоматических запусках. Требует Claude Code v2.1.259 или позже claude -p --permission-prompts none "query"
--plugin-dir Загрузить plugin из каталога или архива .zip, или несколько из папки plugins, только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких путей: --plugin-dir A --plugin-dir B.zip. Передача папки plugins требует Claude Code v2.1.265 или позже claude --plugin-dir ./my-plugin
--plugin-url Получить plugin архив .zip из URL только для этого сеанса. Повторите флаг для нескольких plugins, или передайте разделённые пробелом URL в одном значении в кавычках claude --plugin-url https://example.com/plugin.zip
--print, -p Вывести ответ без интерактивного режима (подробности программного использования см. в документации Agent SDK). Об использовании --resume для фоновой сессии, которая всё ещё работает, см. Возобновление работающей фоновой сессии claude -p "query"
--prompt-suggestions Выдать сообщение prompt_suggestion с предсказанным следующим приглашением пользователя после каждого хода, который генерирует один; очень короткие беседы могут не производить ни одного. Требует --print, --output-format stream-json и --verbose. См. Предложения приглашений claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--ref <branch> С --environment, основать новый checkout сеанса на именованном ref вместо локального HEAD claude -p "Run the smoke test" --environment ccpool_abc123 --ref main
--remote Устаревший псевдоним для --cloud, включая форму существующего сеанса claude --remote "Fix the login bug"
--remote-control, --rc Запустить интерактивный сеанс с включённым Remote Control, чтобы вы также могли управлять им из claude.ai или приложения Claude. Опционально передайте имя для сеанса claude --remote-control "My Project"
--remote-control-session-name-prefix <prefix> Префикс для автоматически генерируемых имён сеансов Remote Control при отсутствии явного имени. По умолчанию используется имя хоста вашей машины, создавая имена вроде myhost-graceful-unicorn. Установите CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX для того же эффекта claude remote-control --remote-control-session-name-prefix dev-box
--replay-user-messages Повторно отправить пользовательские сообщения из stdin обратно на stdout для подтверждения. Требует --input-format stream-json и --output-format stream-json claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages
--restricted Запустить в ограниченном режиме. Используйте его, когда оценочный каркас управляет claude на общей машине и Claude Code не должен запускать команды или читать параметры пользователя и проекта этой машины. Claude Code удаляет встроенные инструменты, которые запускают команды или код, и WebFetch, если вы не назовёте их индивидуально в --tools, не через предустановку default. Он также ограничивает встроенные инструменты файлов рабочими каталогами, загружает только управляемые параметры и --settings, отказывает bypassPermissions и отказывает создавать облачные сеансы. Требует Claude Code v2.1.248 или позже claude --restricted -p "query"
--resume, -r Возобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Вместо ID вы можете передать абсолютный путь к файлу транскрипта .jsonl сеанса. Выбор и поиск по имени включают сеансы, которые добавили этот каталог с /add-dir. Когда вы передаёте ID сеанса, Claude Code ищет текущий каталог проекта и его git worktrees, затем каждый другой проект на этой машине. До v2.1.223 поиск ID охватывал только текущий каталог проекта и его git worktrees. Фоновые сеансы появляются в выборе, отмеченные с bg. Возобновление того, который всё ещё работает, открывает этот сеанс в этом терминале через claude attach, и приглашение, которое вы передаёте в командной строке, идёт ему как его следующий ход. До v2.1.285 Claude Code отказывал и выводил команду claude attach для запуска вместо этого claude --resume auth-refactor
--safe-mode Запустить со всеми отключенными настройками для устранения неполадок в нарушенной конфигурации: CLAUDE.md, skills, plugins, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, рабочие процессы, пользовательские темы, пользовательские сочетания клавиш, строка состояния и команды предложения файлов, LSP серверы и автоматическая память не загружаются. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально, что отличается от --bare. Политика управляемых параметров всё ещё применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемый CLAUDE.md и настроенные политикой MCP серверы не загружаются. Полезно для проверки того, является ли настройка причиной автоматического переключения модели. Устанавливает CLAUDE_CODE_SAFE_MODE claude --safe-mode
--session-id Использовать конкретный ID сеанса для беседы (должен быть действительным UUID) claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sources Разделённый запятыми список источников параметров для загрузки (user, project, local). См. agent view и agent teams для сеансов, которые вы запускаете из этого, которые наследуют список claude --setting-sources user,project
--settings Путь к файлу параметров JSON или встроенная строка JSON. Значения, которые вы устанавливаете здесь, переопределяют те же ключи в ваших файлах settings.json для этого сеанса. Ключи, которые вы опускаете, сохраняют свои значения на основе файла. Файл должен быть обычным файлом размером не более 2 МиБ. См. приоритет параметров claude --settings ./settings.json
--strict-mcp-config Использовать только MCP серверы из --mcp-config, игнорируя все остальные конфигурации MCP. См. Исключительный контроль с managed-mcp.json для того, что флаг делает под управляемым файлом MCP claude --strict-mcp-config --mcp-config ./mcp.json
--system-prompt Заменить весь системный запрос пользовательским текстом claude --system-prompt "You are a Python expert"
--system-prompt-file Загрузить системный запрос из файла, заменяя приглашение по умолчанию claude --system-prompt-file ./custom-prompt.txt
--system-prompt-snapshot Передать off для перестройки системного приглашения при каждом запросе вместо повторного использования приглашения записанного при первом запросе беседы, например, пока вы итерируете текст --append-system-prompt через запуски --continue. Требует Claude Code v2.1.257 или позже claude --system-prompt-snapshot off
--teleport Возобновить облачную сессию в вашем локальном терминале claude --teleport
--teammate-mode Установить способ отображения товарищей по команде агентов: in-process (по умолчанию), auto, tmux или iterm2. Переопределяет параметр teammateMode для этого сеанса. См. Выбор режима отображения claude --teammate-mode auto
--tmux Создать сеанс tmux для worktree. Требует --worktree. Использует встроенные панели iTerm2, если доступны; передайте --tmux=classic для традиционного tmux claude -w feature-auth --tmux
--tools Ограничить, какие встроенные инструменты может использовать Claude. Используйте "" для отключения всех, "default" для набора по умолчанию или имена инструментов, такие как "Bash,Edit,Read". На macOS, Linux и WSL набор по умолчанию исключает Glob и Grep, как описано в разделе Поведение инструмента Glob. Если вы назовёте один из инструментов отслеживания задач здесь, Claude Code также включит эти инструменты для сессии. Флаг не влияет на MCP инструменты; чтобы запретить и их, используйте --disallowedTools "mcp__*". Список, который опускает EndConversation, не удаляет его; "" удаляет его только, когда не остаётся MCP инструментов claude --tools "Bash,Edit,Read"
--verbose Включить подробное логирование, показывает полный вывод по ходам. Переопределяет параметр viewMode для этого сеанса claude --verbose
--version, -v Вывести номер версии claude -v
--worktree, -w Запустить Claude в изолированном git worktree в <repo>/.claude/worktrees/<name>. Если имя не указано, Claude Code генерирует одно. Передайте #<number>, URL GitHub pull request или URL GitLab merge request для получения этого PR или MR из origin и ветвления worktree из него. Ветвление из GitLab merge request требует Claude Code v2.1.233 или позже claude -w feature-auth

Флаги системного приглашения

Claude Code предоставляет пять флагов для настройки системного приглашения. Четыре устанавливают его текст, и с --system-prompt-snapshot вы контролируете, сохраняет ли беседа текст, с которым она началась. Все пять работают как в интерактивном, так и в неинтерактивном режимах.

Флаг Поведение Пример
--system-prompt Заменяет весь запрос по умолчанию claude --system-prompt "You are a Python expert"
--system-prompt-file Заменяет содержимым файла claude --system-prompt-file ./prompts/review.txt
--append-system-prompt Добавляет к запросу по умолчанию claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Добавляет содержимое файла к запросу по умолчанию claude --append-system-prompt-file ./style-rules.txt
--system-prompt-snapshot С off, перестраивает запрос при каждом запросе. С on, по умолчанию, повторно использует записанный запрос, где применяется запись claude --append-system-prompt "Draft rules" --system-prompt-snapshot off

Эти флаги можно комбинировать. Чтобы заменить промпт по умолчанию и при этом добавить собственный текст, передайте --append-system-prompt или --append-system-prompt-file вместе с --system-prompt или --system-prompt-file. В Claude Code v2.1.283 или новее можно также передать флаг вместе с его файловой формой, например --append-system-prompt с --append-system-prompt-file, и Claude Code использует оба.

Например, выполните следующую команду в оболочке, чтобы добавить и руководство по стилю из файла, и одну дополнительную инструкцию:

claude -p --append-system-prompt-file ./style.md --append-system-prompt "Always reply in French" "Summarize README.md"

Claude получает системный промпт по умолчанию, за которым следуют содержимое style.md, пустая строка и затем Always reply in French. Содержимое файла идёт первым, даже если вы передаёте --append-system-prompt перед --append-system-prompt-file.

Когда текст замены объединяет инструкции, которые одинаковы при каждом запуске, с контекстом, который изменяется при каждом запуске, добавьте строку, содержащую только __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ между инструкциями и контекстом. Claude Code разделяет приглашение в первой такой строке и удаляет эту строку, поэтому часть выше неё остаётся кэшированной, а часть ниже изменяется. Требует Claude Code v2.1.275 или позже. Кэшировать статическую часть пользовательского приглашения перечисляет конфигурации, где применяется разделение.

Выбирайте в зависимости от того, подходит ли стандартная идентичность Claude Code для вашей задачи. Используйте флаг добавления, когда Claude должен оставаться помощником по кодированию, который также следует вашим дополнительным правилам: инструкции для каждого вызова, форматирование вывода или контекст домена для скрипта -p. Добавление сохраняет стандартное руководство по инструментам, инструкции безопасности и соглашения кодирования, поэтому вы предоставляете только то, что отличается. Используйте флаг замены, когда поверхность, идентичность или модель разрешения отличаются от Claude Code, например некодирующий агент в конвейере, который не смотрит ни один человек. Замена удаляет весь стандартный запрос, включая руководство по инструментам и инструкции безопасности, поэтому вы берёте на себя ответственность за всё, что вашей задаче всё ещё нужно.

Для постоянных персон, которые вы можете переключать и делиться между проектом, используйте стили вывода. Для соглашений проекта, которые Claude должен всегда соблюдать, используйте CLAUDE.md. Руководство Agent SDK по системным приглашениям охватывает то же решение более подробно.

Флаги системного приглашения в возобновлённых беседах

По умолчанию Claude Code строит системное приглашение один раз, при первом запросе беседы, с текстом из любых флагов системного приглашения, применённых, и записывает его в сеанс. До компактирования беседы каждый более поздний запрос использует это записанное приглашение, включая после возврата к беседе с --resume или --continue. Если вы передаёте другой текст флага системного приглашения, или ничего, при этом более позднем запуске, он вступает в силу после компактирования беседы или когда вы начинаете новую беседу.

Вне облачных сеансов, если вы запускаете Claude Code в bare mode, передав --bare или установив CLAUDE_CODE_SIMPLE=1, запись остаётся отключённой, если вы не передаёте --system-prompt-snapshot on. До v2.1.268 сеансы, которые не получают флаги функций, включая сеансы на Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, перестраивали запрос при каждом запросе и --system-prompt-snapshot не имел эффекта.

Чтобы перестроить запрос при каждом запросе вместо этого, например, пока вы итерируете его формулировку через запуски --continue, передайте --system-prompt-snapshot off. До v2.1.265 передача любого из флагов системного приглашения также отключала запись, если вы не передавали --system-prompt-snapshot on.

См. также