Команды CLI
| Команда | Описание | Пример |
|---|
claude | Запустить интерактивный REPL | claude |
claude "query" | Запустить REPL с начальным запросом | 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-id>" "query" | Возобновить сеанс по ID | claude -r "abc123" "Finish this PR" |
claude update | Обновить до последней версии | claude update |
claude mcp | Настроить серверы Model Context Protocol (MCP) | См. документацию Claude Code MCP. |
Флаги CLI
Настройте поведение Claude Code с помощью этих флагов командной строки:
| Флаг | Описание | Пример |
|---|
--add-dir | Добавить дополнительные рабочие каталоги для доступа Claude (проверяет, что каждый путь существует как каталог) | claude --add-dir ../apps ../lib |
--agents | Определить пользовательские подагенты динамически через JSON (см. формат ниже) | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allowedTools | Список инструментов, которые должны быть разрешены без запроса разрешения пользователя, в дополнение к файлам settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Read" |
--disallowedTools | Список инструментов, которые должны быть запрещены без запроса разрешения пользователя, в дополнение к файлам settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Edit" |
--print, -p | Вывести ответ без интерактивного режима (см. документацию SDK для деталей программного использования) | claude -p "query" |
--system-prompt | Заменить весь системный запрос пользовательским текстом (работает в интерактивном и режиме печати; добавлено в v2.0.14) | claude --system-prompt "You are a Python expert" |
--system-prompt-file | Загрузить системный запрос из файла, заменив запрос по умолчанию (только режим печати; добавлено в v1.0.54) | claude -p --system-prompt-file ./custom-prompt.txt "query" |
--append-system-prompt | Добавить пользовательский текст в конец системного запроса по умолчанию (работает в интерактивном и режиме печати; добавлено в v1.0.55) | claude --append-system-prompt "Always use TypeScript" |
--output-format | Указать формат вывода для режима печати (опции: text, json, stream-json) | claude -p "query" --output-format json |
--input-format | Указать формат входных данных для режима печати (опции: text, stream-json) | claude -p --output-format json --input-format stream-json |
--include-partial-messages | Включить события частичной потоковой передачи в вывод (требует --print и --output-format=stream-json) | claude -p --output-format stream-json --include-partial-messages "query" |
--verbose | Включить подробное логирование, показывает полный вывод по ходам (полезно для отладки в режиме печати и интерактивном режиме) | claude --verbose |
--max-turns | Ограничить количество агентских ходов в неинтерактивном режиме | claude -p --max-turns 3 "query" |
--model | Установить модель для текущего сеанса с псевдонимом для последней модели (sonnet или opus) или полным названием модели | claude --model claude-sonnet-4-5-20250929 |
--permission-mode | Начать в указанном режиме разрешений | claude --permission-mode plan |
--permission-prompt-tool | Указать инструмент MCP для обработки запросов разрешений в неинтерактивном режиме | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--resume | Возобновить конкретный сеанс по ID или выбрав в интерактивном режиме | claude --resume abc123 "query" |
--continue | Загрузить самый последний разговор в текущем каталоге | claude --continue |
--dangerously-skip-permissions | Пропустить запросы разрешений (использовать с осторожностью) | claude --dangerously-skip-permissions |
Флаг --output-format json особенно полезен для написания скриптов и
автоматизации, позволяя вам программно анализировать ответы Claude.
Формат флага agents
Флаг --agents принимает объект JSON, который определяет один или несколько пользовательских подагентов. Каждый подагент требует уникального имени (в качестве ключа) и объекта определения со следующими полями:
| Поле | Обязательно | Описание |
|---|
description | Да | Описание на естественном языке того, когда должен быть вызван подагент |
prompt | Да | Системный запрос, который направляет поведение подагента |
tools | Нет | Массив конкретных инструментов, которые может использовать подагент (например, ["Read", "Edit", "Bash"]). Если опущено, наследует все инструменты |
model | Нет | Псевдоним модели для использования: sonnet, opus или haiku. Если опущено, использует модель подагента по умолчанию |
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."
}
}'
Флаги системного запроса
Claude Code предоставляет три флага для настройки системного запроса, каждый служит разной цели:
| Флаг | Поведение | Режимы | Вариант использования |
|---|
--system-prompt | Заменяет весь запрос по умолчанию | Интерактивный + Печать | Полный контроль над поведением и инструкциями Claude |
--system-prompt-file | Заменяет содержимым файла | Только печать | Загрузка запросов из файлов для воспроизводимости и контроля версий |
--append-system-prompt | Добавляет к запросу по умолчанию | Интерактивный + Печать | Добавить конкретные инструкции, сохраняя поведение Claude Code по умолчанию |
-
--system-prompt: Используйте, когда вам нужен полный контроль над системным запросом Claude. Это удаляет все инструкции Claude Code по умолчанию, давая вам чистый лист.
claude --system-prompt "You are a Python expert who only writes type-annotated code"
-
--system-prompt-file: Используйте, когда вы хотите загрузить пользовательский запрос из файла, полезно для согласованности команды или контролируемых версией шаблонов запросов.
claude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
-
--append-system-prompt: Используйте, когда вы хотите добавить конкретные инструкции, сохраняя возможности Claude Code по умолчанию. Это самый безопасный вариант для большинства случаев использования.
claude --append-system-prompt "Always use TypeScript and include JSDoc comments"
--system-prompt и --system-prompt-file являются взаимоисключающими. Вы не можете использовать оба флага одновременно.
Для большинства случаев использования рекомендуется --append-system-prompt, так как она сохраняет встроенные возможности Claude Code, добавляя ваши пользовательские требования. Используйте --system-prompt или --system-prompt-file только когда вам нужен полный контроль над системным запросом.
-p), включая форматы вывода,
потоковую передачу, подробное логирование и программное использование, см.
документацию SDK.
См. также
