--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 | Включить 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 | Переместить контекст для каждого пользователя, такой как местоположение автоматической памяти, из системного приглашения в первое пользовательское сообщение. Улучшает повторное использование 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 или Skill, который порождает каждый; это требует Claude Code v2.1.219 или позже, и сообщения subagents, которые forked skill порождает, и вложенных forked skills, требуют v2.1.275 или позже. Переменная окружения 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 считаются в сторону лимита. Когда вы возвращаетесь к беседе с --continue или --resume, итоги восстановленные из более ранних запусков не считаются в сторону него. Как только расходы достигают лимита, порождение другого 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). См. 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 |