Справочник 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 |
Список всех настроенных subagents, сгруппированных по источнику | claude agents |
claude auto-mode defaults |
Вывести встроенные правила классификатора auto mode в формате JSON. Используйте claude auto-mode config для просмотра вашей эффективной конфигурации с применяемыми параметрами |
claude auto-mode defaults > rules.json |
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 setup-token |
Создать долгоживущий OAuth токен для CI и скриптов. Выводит токен в терминал без сохранения. Требует подписку Claude. См. Создать долгоживущий токен | claude setup-token |
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/ не обнаруживается из этих каталогов. Проверяет, что каждый путь существует как каталог |
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 |
--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; доступные уровни зависят от модели. Область действия сеанса и не сохраняется в параметры |
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) или полным именем модели |
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 -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 |
Загрузить plugins из каталога только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких каталогов: --plugin-dir A --plugin-dir B |
claude --plugin-dir ./my-plugins |
--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 для загрузки дополнительных параметров | 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. См. выбор режима отображения |
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 |
Включить подробное логирование, показывает полный вывод по ходам | claude --verbose |
--version, -v |
Вывести номер версии | claude -v |
--worktree, -w |
Запустить Claude в изолированном git worktree в <repo>/.claude/worktrees/<name>. Если имя не указано, оно генерируется автоматически |
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 при добавлении ваших требований. Используйте флаг замены только когда вам нужен полный контроль над системным приглашением.
См. также
- Расширение Chrome - Веб-автоматизация и веб-тестирование
- Интерактивный режим - Сочетания клавиш, режимы ввода и интерактивные функции
- Руководство быстрого старта - Начало работы с Claude Code
- Общие рабочие процессы - Продвинутые рабочие процессы и шаблоны
- Параметры - Опции конфигурации
- Документация Agent SDK - Программное использование и интеграции