SpyBara
Go Premium

cli-reference.md 2026-09-12 03:02 UTC to 2026-09-13 21:00 UTC

This page contains 2 additions and 2 deletions.

2026
Thu 10 23:00 Sat 12 03:02 Sun 13 21:00 Fri 18 23:58 Tue 22 23:59 Fri 25 23:58

Справочник 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 Code v2.1.195 и позже. 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, если нет 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> Подключиться к фоновому сеансу в этом терминале claude attach 7c5dcf5d
claude auto-mode defaults Вывести встроенные правила классификатора auto mode в формате JSON. Используйте claude auto-mode config для просмотра вашей эффективной конфигурации с применяемыми параметрами. --label <prefix> выводит только правила, метка которых начинается с этого префикса, сопоставляя без учета регистра. Требует Claude Code v2.1.208 или позже claude auto-mode defaults --label 'Git Destructive'
claude auto-mode reset Восстановить конфигурацию auto mode по умолчанию, удалив раздел autoMode из файла пользовательских параметров. Запрашивает подтверждение перед записью; передайте -y/--yes для пропуска приглашения. Правила из управляемых параметров или флага --settings по-прежнему применяются. Требует Claude Code v2.1.212 или позже. См. Проверить значения по умолчанию и вашу эффективную конфигурацию claude auto-mode reset --yes
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 на AWS. Также недоступно, когда вы отключаете получение флагов функций. Требует Claude Code v2.1.213 или позже claude import codex --dry-run
claude logs <id> Вывести недавний вывод из фонового сеанса 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 авторизации вместо открытия браузера, затем вставьте URL перенаправления обратно в приглашение. Требует Claude Code версии 2.1.186 или позже. См. Аутентификация из командной строки claude mcp login sentry
claude mcp logout <name> Очистить сохраненные учетные данные OAuth для сервера MCP. Требует Claude Code версии 2.1.186 или позже claude mcp logout sentry
claude plugin Управлять Claude Code plugins. Псевдоним: claude plugins. См. справочник plugins для подкоманд claude plugin install code-review@claude-plugins-official
claude project purge [path] Удалить все локальное состояние Claude Code для проекта: стенограммы, списки задач, журналы отладки, историю редактирования файлов, строки истории подсказок и запись проекта в ~/.claude.json. Опустите [path] для выбора из интерактивного списка. Флаги: --dry-run для предпросмотра, -y/--yes для пропуска подтверждения, -i/--interactive для подтверждения каждого элемента, --all для каждого проекта. См. Очистить локальные данные claude project 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?.

Начиная с версии v2.1.199, claude --dangerously-skip-permissions daemon <subcommand> запускает подкоманду daemon. В более ранних версиях daemon <subcommand> рассматривалась как приглашение для нового интерактивного сеанса, поэтому подкоманда никогда не запускалась, когда флаг шел первым, что является распространенной настройкой, когда claude имеет псевдоним, включающий флаг. Только ведущий --dangerously-skip-permissions или --allow-dangerously-skip-permissions маршрутизирует к 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. Claude Code проверяет JSON при запуске и выходит при недействительном значении; см. 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 С описанием задачи создать новый веб-сеанс на claude.ai. С 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 Включить channels, которые не находятся в утвержденном списке разрешений, для локальной разработки. Принимает записи plugin:<name>@<marketplace> и server:<name>. Запрашивает подтверждение claude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissions Пропустить запросы разрешения. Эквивалентно --permission-mode bypassPermissions. См. режимы разрешения для информации о том, что это пропускает и что не пропускает. Для сеансов, запущенных с --bg, режим сохраняется при перезапуске сеанса супервизором claude --dangerously-skip-permissions
--debug Включить режим отладки с дополнительной фильтрацией категорий, такой как --debug='mcp,startup' или --debug='!1p'. Фильтр привязывается только в форме =; разделённый пробелом фильтр включает режим отладки без фильтрации claude --debug='mcp,startup'
--debug-file <path> Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над CLAUDE_CODE_DEBUG_LOGS_DIR claude --debug-file /tmp/claude-debug.log
--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 Переместить разделы для каждой машины из системного приглашения (рабочий каталог, информация об окружении, пути памяти, флаг git-repo) в первое пользовательское сообщение. Улучшает повторное использование 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 Выдать текст subagent и блоки thinking в выходной поток как сообщения assistant и user с установленным parent_tool_use_id, чтобы вы могли восстановить транскрипт каждого subagent. Без этого флага Claude Code опускает текст и блоки thinking subagent, который работает на переднем плане. Требует --print и --output-format stream-json. Claude Code также пересылает сообщения от вложенных subagents, устанавливая parent_tool_use_id на ID вызова инструмента Agent, который порождает каждый; это требует Claude Code v2.1.219 или позже. Переменная окружения 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 перед остановкой (только режим печати). Расходы от subagents считаются в сторону лимита. Как только расходы достигают лимита, порождение другого subagent не удаётся с Budget limit reached, и Claude Code останавливает фоновые subagents, которые всё ещё работают; поведения принудительного применения лимита требуют 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>. В интерактивном сеансе, если другой живой сеанс на этой машине уже использует имя, Claude Code применяет вариант его вместо этого.

/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 это default, когда ничего не настроено claude --permission-mode plan
--permission-prompt-tool Указать инструмент MCP для обработки запросов разрешения в неинтерактивном режиме. Claude Code ждёт подключения MCP сервера этого инструмента перед запуском первого хода, до стартового таймаута MCP_TIMEOUT, 30 секунд по умолчанию.

Инструмент приглашения не может одобрить инструмент MCP, отмеченный как требующий взаимодействия пользователя: Claude Code преобразует результат allow для одного в отрицание. Это ограничение требует Claude Code v2.1.199 или позже		 claude -p --permission-prompt-tool mcp_auth_tool "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 для деталей программного использования) 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 --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) 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 (добавлено в v2.1.186). Переопределяет параметр 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

--system-prompt и --system-prompt-file являются взаимоисключающими. Флаги добавления можно комбинировать с любым флагом замены.

Выбирайте в зависимости от того, подходит ли стандартная идентичность 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.

См. также