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

Команды 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 auth loginВойти в свою учетную запись Anthropic. Используйте --email для предварительного заполнения адреса электронной почты и --sso для принудительной аутентификации SSOclaude auth login --email [email protected] --sso
claude auth logoutВыйти из своей учетной записи Anthropicclaude auth logout
claude auth statusПоказать статус аутентификации в формате JSON. Используйте --text для удобочитаемого вывода. Выходит с кодом 0, если вы вошли, 1, если нетclaude auth status
claude agentsСписок всех настроенных subagents, сгруппированных по источникуclaude agents
claude mcpНастроить серверы Model Context Protocol (MCP)См. документацию Claude Code MCP.
claude remote-controlЗапустить сеанс Remote Control для управления Claude Code из Claude.ai или приложения Claude во время локального запуска. См. Remote Control для флаговclaude remote-control

Флаги CLI

Настройте поведение Claude Code с помощью этих флагов командной строки:
ФлагОписаниеПример
--add-dirДобавить дополнительные рабочие каталоги для доступа Claude (проверяет, что каждый путь существует как каталог)claude --add-dir ../apps ../lib
--agentУказать агента для текущего сеанса (переопределяет параметр agent)claude --agent my-custom-agent
--agentsОпределить пользовательские subagents динамически через JSON (см. ниже формат)claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissionsВключить обход разрешений как опцию без немедленной активации. Позволяет компоновать с --permission-mode (используйте с осторожностью)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
--betasЗаголовки бета-версии для включения в запросы API (только пользователи API ключей)claude --betas interleaved-thinking
--chromeВключить интеграцию браузера Chrome для веб-автоматизации и тестированияclaude --chrome
--continue, -cЗагрузить последнюю беседу в текущем каталогеclaude --continue
--dangerously-skip-permissionsПропустить все запросы разрешения (используйте с осторожностью)claude --dangerously-skip-permissions
--debugВключить режим отладки с дополнительной фильтрацией категорий (например, "api,hooks" или "!statsig,!file")claude --debug "api,mcp"
--disable-slash-commandsОтключить все skills и команды для этого сеансаclaude --disable-slash-commands
--disallowedToolsИнструменты, которые удаляются из контекста модели и не могут быть использованы"Bash(git log *)" "Bash(git diff *)" "Edit"
--fallback-modelВключить автоматический переход на указанную модель, когда модель по умолчанию перегружена (только режим печати)claude -p --fallback-model sonnet "query"
--fork-sessionПри возобновлении создать новый ID сеанса вместо повторного использования исходного (используйте с --resume или --continue)claude --resume abc123 --fork-session
--from-prВозобновить сеансы, связанные с конкретным PR GitHub. Принимает номер PR или URL. Сеансы автоматически связываются при создании через gh pr createclaude --from-pr 123
--ideАвтоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDEclaude --ide
--initЗапустить hooks инициализации и запустить интерактивный режимclaude --init
--init-onlyЗапустить hooks инициализации и выход (без интерактивного сеанса)claude --init-only
--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Запустить hooks обслуживания и выходclaude --maintenance
--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
--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Начать в указанном режиме разрешенияclaude --permission-mode plan
--permission-prompt-toolУказать инструмент MCP для обработки запросов разрешения в неинтерактивном режимеclaude -p --permission-prompt-tool mcp_auth_tool "query"
--plugin-dirЗагрузить plugins из каталогов только для этого сеанса (повторяемо)claude --plugin-dir ./my-plugins
--print, -pВывести ответ без интерактивного режима (см. документацию Agent SDK для деталей программного использования)claude -p "query"
--remoteСоздать новый веб-сеанс на claude.ai с описанием предоставленной задачиclaude --remote "Fix the login bug"
--resume, -rВозобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса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, игнорируя все остальные конфигурации 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Установить способ отображения товарищей по команде agent team: auto (по умолчанию), in-process или tmux. См. настройка agent teamsclaude --teammate-mode in-process
--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
Флаг --output-format json особенно полезен для написания скриптов и автоматизации, позволяя вам программно анализировать ответы Claude.

Формат флага agents

Флаг --agents принимает объект JSON, который определяет один или несколько пользовательских subagents. Каждый subagent требует уникального имени (в качестве ключа) и объекта определения со следующими полями:
ПолеОбязательноОписание
descriptionДаОписание на естественном языке того, когда должен быть вызван subagent
promptДаСистемный запрос, который направляет поведение subagent
toolsНетМассив конкретных инструментов, которые может использовать subagent, например ["Read", "Edit", "Bash"]. Если опущено, наследует все инструменты. Поддерживает синтаксис Agent(agent_type)
disallowedToolsНетМассив имен инструментов для явного отрицания для этого subagent
modelНетПсевдоним модели для использования: sonnet, opus, haiku или inherit. Если опущено, по умолчанию inherit
skillsНетМассив имен skill для предварительной загрузки в контекст subagent
mcpServersНетМассив MCP servers для этого subagent. Каждая запись — это строка имени сервера или объект {name: config}
maxTurnsНетМаксимальное количество агентских ходов перед остановкой subagent
Пример:
claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
  }
}'
Для получения дополнительной информации о создании и использовании subagents см. документацию subagents.

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

Claude Code предоставляет четыре флага для настройки системного запроса. Все четыре работают как в интерактивном, так и в неинтерактивном режимах.
ФлагПоведениеВариант использования
--system-promptЗаменяет весь запрос по умолчаниюПолный контроль над поведением и инструкциями Claude
--system-prompt-fileЗаменяет содержимым файлаЗагрузить запросы из файлов для воспроизводимости и контроля версий
--append-system-promptДобавляет к запросу по умолчаниюДобавить конкретные инструкции, сохраняя поведение Claude Code по умолчанию
--append-system-prompt-fileДобавляет содержимое файла к запросу по умолчаниюЗагрузить дополнительные инструкции из файлов, сохраняя значения по умолчанию
Когда использовать каждый:
  • --system-prompt: используйте, когда вам нужен полный контроль над системным запросом Claude. Это удаляет все инструкции Claude Code по умолчанию, давая вам чистый лист.
    claude --system-prompt "You are a Python expert who only writes type-annotated code"
    
  • --system-prompt-file: используйте, когда вы хотите загрузить пользовательский запрос из файла, полезно для согласованности команды или контролируемых версией шаблонов запросов.
    claude --system-prompt-file ./prompts/code-review.txt
    
  • --append-system-prompt: используйте, когда вы хотите добавить конкретные инструкции, сохраняя возможности Claude Code по умолчанию. Это самый безопасный вариант для большинства случаев использования.
    claude --append-system-prompt "Always use TypeScript and include JSDoc comments"
    
  • --append-system-prompt-file: используйте, когда вы хотите добавить инструкции из файла, сохраняя значения Claude Code по умолчанию. Полезно для контролируемых версией дополнений.
    claude --append-system-prompt-file ./prompts/style-rules.txt
    
--system-prompt и --system-prompt-file являются взаимоисключающими. Флаги добавления можно использовать вместе с любым флагом замены. Для большинства случаев использования рекомендуется --append-system-prompt или --append-system-prompt-file, так как они сохраняют встроенные возможности Claude Code, добавляя ваши пользовательские требования. Используйте --system-prompt или --system-prompt-file только когда вам нужен полный контроль над системным запросом.

См. также