Перейти к основному содержанию

Команды 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"Продолжить через SDKclaude -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 на Bedrock, Vertex AI или 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 вместо подписки Claudeclaude auth login --console
claude auth logoutВыйти из своей учетной записи Anthropicclaude 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 для просмотра вашей эффективной конфигурации с применяемыми параметрамиclaude auto-mode defaults > rules.json
claude daemon statusВывести состояние супервизора фонового сеанса, версию, каталог сокета и количество рабочих процессов для диагностики. Выходит с кодом 1, если супервизор не запущенclaude daemon status
claude daemon stop --anyОстановить супервизора фонового сеанса и размещаемые им сеансы. Передайте --keep-workers для сохранения работающих фоновых сеансов, чтобы следующий супервизор переподключился к ним. --any подтверждает остановку супервизора по требованию, который используется по умолчанию. Используйте это для восстановления после неответчивого супервизораclaude daemon stop --any --keep-workers
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 Codeclaude respawn 7c5dcf5d
claude rm <id>Удалить фоновый сеанс из списка. Стенограмма беседы остается на вашем локальном компьютере, доступная через claude --resumeclaude rm 7c5dcf5d
claude setup-tokenСоздать долгоживущий OAuth токен для CI и скриптов. Выводит токен в терминал без сохранения. Требует подписку Claude. См. Создать долгоживущий токенclaude setup-token
claude stop <id>Остановить фоновый сеанс. Также принимает claude killclaude stop 7c5dcf5d
claude ultrareview [target]Запустить ultrareview неинтерактивно. Выводит результаты в stdout и выходит с кодом 0 при успехе или 1 при ошибке. Используйте --json для необработанного полезного груза и --timeout <minutes> для переопределения 30-минутного значения по умолчаниюclaude ultrareview 1234 --json
Если вы неправильно введете подкоманду, Claude Code предложит ближайшее совпадение и выйдет без запуска сеанса. Например, claude udpate выводит Did you mean claude update?.

Флаги CLI

Настройте поведение Claude Code с помощью этих флагов командной строки. claude --help не выводит каждый флаг, поэтому отсутствие флага в --help не означает, что он недоступен.
ФлагОписаниеПример
--add-dirДобавить дополнительные рабочие каталоги для Claude для чтения и редактирования файлов. Предоставляет доступ к файлам; большинство конфигурации .claude/ не обнаруживается из этих каталогов. Проверяет, что каждый путь существует как каталог. Чтобы сохранить эти каталоги между сеансами, установите permissions.additionalDirectories в параметрахclaude --add-dir ../apps ../lib
--advisor <model>Включить инструмент advisor на стороне сервера для этого сеанса с псевдонимом модели: opus, sonnet или fable (v2.1.170+), или полный ID модели. Имеет приоритет над параметром advisorModel для сеанса. Требует Claude Code v2.1.98 или позжеclaude --advisor opus
--agentУказать агента для текущего сеанса (переопределяет параметр agent)claude --agent my-custom-agent
--agentsОпределить пользовательские subagents динамически через JSON. Использует те же имена полей, что и subagent frontmatter, плюс поле prompt для инструкций агента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 вместо этого"Bash(git log *)" "Bash(git diff *)" "Read"
--append-system-promptДобавить пользовательский текст в конец системного приглашения по умолчаниюclaude --append-system-prompt "Always use TypeScript"
--append-system-prompt-fileЗагрузить дополнительный текст системного приглашения из файла и добавить к приглашению по умолчаниюclaude --append-system-prompt-file ./extra-rules.txt
--ax-screen-readerОтрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Принудительно использует классический рендерер, поэтому параметр tui не имеет эффекта для сеанса. Имеет приоритет над CLAUDE_AX_SCREEN_READER и параметром axScreenReader. Требует Claude Code v2.1.181 или позжеclaude --ax-screen-reader
--bareМинимальный режим: пропустить автоматическое обнаружение hooks, skills, plugins, MCP серверов, автоматической памяти и CLAUDE.md, чтобы скриптовые вызовы начинались быстрее. Claude имеет доступ к инструментам Bash, чтения файлов и редактирования файлов. Устанавливает CLAUDE_CODE_SIMPLE. См. bare modeclaude --bare -p "query"
--betasЗаголовки бета-версии для включения в запросы API (только для пользователей API-ключей)claude --betas interleaved-thinking
--bg, --backgroundЗапустить сеанс как фоновый агент и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с --exec для запуска команды shell как фонового задания вместо сеанса Claude, или с --agent для запуска конкретного subagentclaude --bg "investigate the flaky test"
--channels(Исследовательский предпросмотр) MCP серверы, чьи уведомления channel Claude должен слушать в этом сеансе. Разделенный пробелом список записей plugin:<name>@<marketplace>. Требует аутентификацию Claude.aiclaude --channels plugin:my-notifier@my-marketplace
--chromeВключить интеграцию браузера Chrome для веб-автоматизации и тестированияclaude --chrome
--continue, -cЗагрузить самую последнюю беседу в текущем каталоге. Включает сеансы, которые добавили этот каталог с помощью /add-dirclaude --continue
--dangerously-load-development-channelsВключить channels, которые не находятся в утвержденном списке разрешений, для локальной разработки. Принимает записи plugin:<name>@<marketplace> и server:<name>. Запрашивает подтверждениеclaude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissionsПропустить запросы разрешения. Эквивалентно --permission-mode bypassPermissions. См. режимы разрешения для информации о том, что это пропускает и что не пропускаетclaude --dangerously-skip-permissions
--debugВключить режим отладки с дополнительной фильтрацией категорий (например, "api,hooks" или "!statsig,!file")claude --debug "api,mcp"
--debug-file <path>Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над CLAUDE_CODE_DEBUG_LOGS_DIRclaude --debug-file /tmp/claude-debug.log
--disable-slash-commandsОтключить все skills и команды для этого сеансаclaude --disable-slash-commands
--disallowedTools, --disallowed-toolsПравила отрицания. Простое имя инструмента удаляет соответствующие инструменты из контекста модели: "Edit" удаляет Edit, "*" удаляет каждый инструмент, и "mcp__*" удаляет каждый MCP инструмент. Правило с областью действия, такое как Bash(rm *), оставляет инструмент доступным и отрицает только совпадающие вызовы"Bash(git log *)" "Bash(git diff *)" "Edit"
--effortУстановить уровень усилий для текущего сеанса. Опции: low, medium, high, xhigh, max; доступные уровни зависят от модели. Переопределяет параметр effortLevel для этого сеанса и не сохраняетсяclaude --effort high
--enable-auto-modeУдалено в v2.1.111. Auto mode теперь находится в цикле Shift+Tab по умолчанию; используйте --permission-mode auto для запуска в немclaude --permission-mode auto
--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 для запуска из shellclaude --bg --exec 'pytest -x'
--fallback-modelВключить автоматический переход на указанную модель (модели) при перегрузке или недоступности основной модели, например снятая с производства модель. Принимает разделенный запятыми список, пробуемый по порядку. См. Цепочки резервных моделей. Чтобы сохранить цепочку между сеансами, используйте параметр fallbackModel, который этот флаг переопределяетclaude --fallback-model sonnet,haiku
--fork-sessionПри возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с --resume или --continue)claude --resume abc123 --fork-session
--from-prВозобновить сеансы, связанные с конкретным pull request. Принимает номер PR, URL GitHub или GitHub Enterprise PR, URL GitLab merge request или URL Bitbucket pull request. Сеансы автоматически связываются при создании Claude pull requestclaude --from-pr 123
--ideАвтоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDEclaude --ide
--initЗапустить Setup hooks с помощью matcher init перед сеансом (только режим печати)claude -p --init "query"
--init-onlyЗапустить Setup и SessionStart hooks, затем выйти без запуска беседыclaude --init-only
--include-hook-eventsВключить все события жизненного цикла hook в выходной поток. Требует --output-format stream-jsonclaude -p --output-format stream-json --verbose --include-hook-events "query"
--include-partial-messagesВключить частичные события потоковой передачи в вывод. Требует --print и --output-format stream-jsonclaude -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 -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenanceЗапустить Setup hooks с помощью matcher maintenance перед сеансом (только режим печати)claude -p --maintenance "query"
--max-budget-usdМаксимальная сумма в долларах для расходования на вызовы API перед остановкой (только режим печати)claude -p --max-budget-usd 5.00 "query"
--max-turnsОграничить количество агентских ходов (только режим печати). Выходит с ошибкой при достижении лимита. По умолчанию нет лимитаclaude -p --max-turns 3 "query"
--mcp-configЗагрузить MCP серверы из JSON файлов или строк (разделенные пробелом)claude --mcp-config ./mcp.json
--modelУстанавливает модель для текущего сеанса с псевдонимом для последней модели (sonnet, opus, haiku или fable) или полным именем модели. Переопределяет параметр model и ANTHROPIC_MODELclaude --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. Переопределяет defaultMode из файлов параметровclaude --permission-mode plan
--permission-prompt-toolУказать инструмент MCP для обработки запросов разрешения в неинтерактивном режимеclaude -p --permission-prompt-tool mcp_auth_tool "query"
--plugin-dirЗагрузить plugin из каталога или архива .zip только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких plugins: --plugin-dir A --plugin-dir B.zipclaude --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"
--remoteСоздать новый веб-сеанс на claude.ai с предоставленным описанием задачи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-jsonclaude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages
--resume, -rВозобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Выбор и поиск по имени включают сеансы, которые добавили этот каталог с помощью /add-dir; передача ID сеанса ищет только текущий каталог проекта и его git worktrees. Начиная с v2.1.144, фоновые сеансы появляются в выборе, отмеченные как bgclaude --resume auth-refactor
--safe-modeЗапустить со всеми отключенными настройками для устранения неполадок в нарушенной конфигурации: CLAUDE.md, skills, plugins, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, рабочие процессы, пользовательские темы, пользовательские сочетания клавиш, строка состояния и команды предложения файлов, LSP серверы и автоматическая память не загружаются. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально, что отличается от --bare. Политика управляемых параметров все еще применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемый CLAUDE.md и настроенные политикой MCP серверы не загружаются. Полезно для проверки того, является ли настройка причиной автоматического переключения с Fable 5. Устанавливает CLAUDE_CODE_SAFE_MODEclaude --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 для этого сеанса. Ключи, которые вы опускаете, сохраняют свои значения на основе файла. См. приоритет параметровclaude --settings ./settings.json
--strict-mcp-configИспользовать только MCP серверы из --mcp-config, игнорируя все остальные конфигурации MCPclaude --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
--teleportВозобновить веб-сеанс в вашем локальном терминалеclaude --teleport
--teammate-modeУстановить способ отображения товарищей по команде агентов: in-process (по умолчанию), auto, tmux или iterm2 (добавлено в v2.1.186). Значение по умолчанию изменилось с auto в v2.1.179. Переопределяет параметр teammateMode для этого сеанса. См. выбор режима отображенияclaude --teammate-mode auto
--tmuxСоздать сеанс tmux для worktree. Требует --worktree. Использует встроенные панели iTerm2, если доступны; передайте --tmux=classic для традиционного tmuxclaude -w feature-auth --tmux
--toolsОграничить, какие встроенные инструменты может использовать Claude. Используйте "" для отключения всех, "default" для всех или имена инструментов, такие как "Bash,Edit,Read". MCP инструменты не затронуты; чтобы отрицать и их, используйте --disallowedTools "mcp__*" или передайте --strict-mcp-config без --mcp-config, чтобы не загружались MCP серверыclaude --tools "Bash,Edit,Read"
--verboseВключить подробное логирование, показывает полный вывод по ходам. Переопределяет параметр viewMode для этого сеансаclaude --verbose
--version, -vВывести номер версииclaude -v
--worktree, -wЗапустить Claude в изолированном git worktree в <repo>/.claude/worktrees/<name>. Если имя не указано, оно генерируется автоматически. Передайте #<number> или URL GitHub pull request для получения этого PR из origin и ветвления worktree из негоclaude -w feature-auth

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

Claude Code предоставляет четыре флага для настройки системного приглашения. Все четыре работают как в интерактивном, так и в неинтерактивном режимах.
ФлагПоведениеПример
--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 и --system-prompt-file являются взаимоисключающими. Флаги добавления можно комбинировать с любым флагом замены. Выбирайте в зависимости от того, подходит ли стандартная идентичность Claude Code для вашей задачи. Используйте флаг добавления, когда Claude должен оставаться помощником по кодированию, который также следует вашим дополнительным правилам: инструкции для каждого вызова, форматирование вывода или контекст домена для скрипта -p. Добавление сохраняет стандартное руководство по инструментам, инструкции безопасности и соглашения кодирования, поэтому вы предоставляете только то, что отличается. Используйте флаг замены, когда поверхность, идентичность или модель разрешения отличаются от Claude Code, например некодирующий агент в конвейере, который не смотрит ни один человек. Замена удаляет весь стандартный запрос, включая руководство по инструментам и инструкции безопасности, поэтому вы берете на себя ответственность за все, что вашей задаче все еще нужно. Эти флаги применяются только к текущему вызову. Для постоянных персон, которые вы можете переключать и делиться между проектом, используйте стили вывода. Для соглашений проекта, которые Claude должен всегда соблюдать, используйте CLAUDE.md. Руководство Agent SDK по системным приглашениям охватывает то же решение более подробно.

См. также