Справочник 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 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> для отображения только сеансов, запущенных в этом каталоге |
claude agents |
claude attach <id> |
Подключиться к фоновому сеансу в этом терминале | claude attach 7c5dcf5d |
claude auto-mode defaults |
Вывести встроенные правила классификатора auto mode в формате JSON. Используйте claude auto-mode config для просмотра вашей эффективной конфигурации с применяемыми параметрами |
claude auto-mode defaults > rules.json |
claude logs <id> |
Вывести недавний вывод из фонового сеанса | claude logs 7c5dcf5d |
claude mcp |
Настроить серверы Model Context Protocol (MCP) | См. документацию Claude Code MCP. |
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 respawn 7c5dcf5d |
claude rm <id> |
Удалить фоновый сеанс из списка | claude rm 7c5dcf5d |
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> для переопределения 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 |
--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 |
Инструменты, которые выполняются без запроса разрешения. См. синтаксис правила разрешения для сопоставления шаблонов. Чтобы ограничить доступные инструменты, используйте --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 |
--bare |
Минимальный режим: пропустить автоматическое обнаружение hooks, skills, plugins, MCP серверов, автоматической памяти и CLAUDE.md, чтобы скриптовые вызовы начинались быстрее. Claude имеет доступ к инструментам Bash, чтения файлов и редактирования файлов. Устанавливает CLAUDE_CODE_SIMPLE. См. bare mode |
claude --bare -p "query" |
--betas |
Заголовки бета-версии для включения в запросы API (только для пользователей API-ключей) | claude --betas interleaved-thinking |
--bg |
Запустить сеанс как фоновый агент и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с --agent для запуска конкретного subagent |
claude --bg "investigate the flaky test" |
--channels |
(Исследовательский предпросмотр) MCP серверы, чьи уведомления channel Claude должен слушать в этом сеансе. Разделенный пробелом список записей plugin:<name>@<marketplace>. Требует аутентификацию Claude.ai |
claude --channels plugin:my-notifier@my-marketplace |
--chrome |
Включить интеграцию браузера Chrome для веб-автоматизации и тестирования | claude --chrome |
--continue, -c |
Загрузить самую последнюю беседу в текущем каталоге. Включает сеансы, которые добавили этот каталог с помощью /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. См. режимы разрешения для информации о том, что это пропускает и что не пропускает |
claude --dangerously-skip-permissions |
--debug |
Включить режим отладки с дополнительной фильтрацией категорий (например, "api,hooks" или "!statsig,!file") |
claude --debug "api,mcp" |
--debug-file <path> |
Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над CLAUDE_CODE_DEBUG_LOGS_DIR |
claude --debug-file /tmp/claude-debug.log |
--disable-slash-commands |
Отключить все skills и команды для этого сеанса | claude --disable-slash-commands |
--disallowedTools |
Инструменты, которые удаляются из контекста модели и не могут быть использованы | "Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort |
Установить уровень усилий для текущего сеанса. Опции: low, medium, high, xhigh, max; доступные уровни зависят от модели. Переопределяет параметр effortLevel для этого сеанса и не сохраняется |
claude --effort high |
--enable-auto-mode |
{/* max-version: 2.1.110 */}Удалено в v2.1.111. Auto mode теперь находится в цикле Shift+Tab по умолчанию; используйте --permission-mode auto для запуска в нем |
claude --permission-mode auto |
--exclude-dynamic-system-prompt-sections |
Переместить разделы для каждой машины из системного приглашения (рабочий каталог, информация об окружении, пути памяти, статус git) в первое пользовательское сообщение. Улучшает повторное использование prompt-cache на разных пользователях и машинах, запускающих одну и ту же задачу. Применяется только с системным приглашением по умолчанию; игнорируется, когда установлены --system-prompt или --system-prompt-file. Используйте с -p для скриптовых многопользовательских рабочих нагрузок |
claude -p --exclude-dynamic-system-prompt-sections "query" |
--fallback-model |
Включить автоматический переход на указанную модель, когда модель по умолчанию перегружена (только режим печати) | claude -p --fallback-model sonnet "query" |
--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 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 в выходной поток. Требует --output-format stream-json |
claude -p --output-format stream-json --include-hook-events "query" |
--include-partial-messages |
Включить частичные события потоковой передачи в вывод. Требует --print и --output-format stream-json |
claude -p --output-format stream-json --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) или полным именем модели. Переопределяет параметр model и ANTHROPIC_MODEL |
claude --model claude-sonnet-4-6 |
--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.zip |
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" |
--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-json |
claude -p --input-format stream-json --output-format stream-json --replay-user-messages |
--resume, -r |
Возобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Включает сеансы, которые добавили этот каталог с помощью /add-dir |
claude --resume auth-refactor |
--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, игнорируя все остальные конфигурации 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 |
--teleport |
Возобновить веб-сеанс в вашем локальном терминале | claude --teleport |
--teammate-mode |
Установить способ отображения товарищей по команде агентов: auto (по умолчанию), in-process или tmux. Переопределяет параметр teammateMode для этого сеанса. См. выбор режима отображения |
claude --teammate-mode in-process |
--tmux |
Создать сеанс tmux для worktree. Требует --worktree. Использует встроенные панели iTerm2, если доступны; передайте --tmux=classic для традиционного tmux |
claude -w feature-auth --tmux |
--tools |
Ограничить, какие встроенные инструменты может использовать Claude. Используйте "" для отключения всех, "default" для всех или имена инструментов, такие как "Bash,Edit,Read" |
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 по системным приглашениям охватывает то же решение более подробно.
См. также
- Расширение Chrome - Веб-автоматизация и веб-тестирование
- Интерактивный режим - Сочетания клавиш, режимы ввода и интерактивные функции
- Руководство быстрого старта - Начало работы с Claude Code
- Общие рабочие процессы - Продвинутые рабочие процессы и шаблоны
- Параметры - Опции конфигурации
- Документация Agent SDK - Программное использование и интеграции