Справочное руководство по Claude Code CLI
I. Команды 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>" "query" |
Возобновить сеанс по ID/имени | claude -r "auth-refactor" "Finish this PR" |
claude update |
Обновить до последней версии | claude update |
claude mcp |
Настроить MCP-сервер | См. подробностиДокументация Claude Code по MCP |
II. Флаги CLI
Следующие флаги настраивают поведение Claude Code во время выполнения:
| Флаг | Описание | Пример |
|---|---|---|
--add-dir |
Добавить рабочий каталог (автоматически проверяет путь) | claude --add-dir ../apps ../lib |
--agent |
Указать агента сеанса (переопределяет стандартнуюagentнастройку) |
claude --agent my-custom-agent |
--agents |
Определить пользовательских субагентов в JSON | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allowedTools |
Инструменты, доступные без запросов разрешения (для ограничения инструментов с--tools) |
"Bash(git log:*)" "Bash(git diff:*)" "Read" |
--append-system-prompt |
Добавить содержимое к системному промпту по умолчанию (работает как в интерактивном, так и в режиме печати) | claude --append-system-prompt "Always use TypeScript" |
--betas |
Добавлять заголовки Beta к API-запросам (только для пользователей с ключом API) | claude --betas interleaved-thinking |
--chrome |
Включить интеграцию с браузером Chrome (веб-автоматизация/тестирование) | claude --chrome |
--continue, -c |
Загрузить последний диалог в текущем каталоге | claude --continue |
--dangerously-skip-permissions |
Пропускать запросы разрешений (использовать с осторожностью) | claude --dangerously-skip-permissions |
--debug |
Включить режим отладки с фильтрацией по категориям (например,"api,hooks") |
claude --debug "api,mcp" |
--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 |
--ide |
Автоматически подключаться к доступной IDE | claude --ide |
--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 Schema (только в режиме печати) | claude -p --json-schema '{"type":"object","properties":{...}}' "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-5-20250929 |
--no-chrome |
Отключить интеграцию с Chrome | claude --no-chrome |
--output-format |
Формат вывода в режиме печати (необязательноtext/json/stream-json) |
claude -p "query" --output-format json |
--permission-mode |
Запуск с указанным режимом разрешений | claude --permission-mode plan |
--permission-prompt-tool |
Указать инструмент обработки запросов разрешений в неинтерактивном режиме | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--plugin-dir |
Загрузить плагины из указанного каталога (повторно используемый) | claude --plugin-dir ./my-plugins |
--print, -p |
Вывести ответ и выйти (неинтерактивный режим) | claude -p "query" |
--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 | claude --settings ./settings.json |
--strict-mcp-config |
Использовать только--mcp-configконфигурацию, игнорировать другие настройки MCP |
claude --strict-mcp-config --mcp-config ./mcp.json |
--system-prompt |
Заменить системный промпт по умолчанию (действует в обоих режимах: интерактивном и print) | claude --system-prompt "You are a Python expert" |
--system-prompt-file |
Загрузить системный промпт из файла (заменяет стандартный, только в print-режиме) | claude -p --system-prompt-file ./custom-prompt.txt "query" |
--tools |
Ограничить доступные встроенные инструменты (""отключить все,"default"включить все) |
claude --tools "Bash,Edit,Read" |
--verbose |
Включить подробное логирование, чтобы отображать полный пошаговый вывод | claude --verbose |
--version, -v |
Вывести номер версии | claude -v |
Примечание:
--output-format jsonФлаги идеально подходят для скриптинга и автоматизации; вы можете программно парсить вывод ответа Claude.
III. Расширенные примечания
3.1 Формат флага агента
--agentsФлаг принимает JSON-объект для определения одного или нескольких пользовательских субагентов. Для каждого субагента требуется уникальное имя в качестве ключа, а значение — это объект, содержащий следующие поля:
| Поле | Обязательный | Описание |
|---|---|---|
description |
Да | Опишите сценарии применения субагента |
prompt |
Да | Системный промпт, определяющий поведение субагента |
tools |
нет | Список инструментов для конкретного субагента (например,["Read", "Edit"], если не указан, наследует все инструменты) |
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 предоставляет 3 способа настройки системного промпта для удовлетворения различных потребностей использования:
| Флаг | Поведение | Применимый режим | Типичный сценарий использования |
|---|---|---|---|
--system-prompt |
Заменить системный промпт по умолчанию | Интерактивный + вывод | Полная настройка инструкций поведения Claude |
--system-prompt-file |
Загрузить промпт из файла и заменить | Только вывод | Общие командные шаблоны промптов, контроль версий |
--append-system-prompt |
Добавить содержимое к промпту по умолчанию | Интерактивный + вывод | Сохранить функциональность по умолчанию, добавить персонализированные инструкции |
Сценарии использования и примеры
--system-prompt: Полностью перехватить системный промпт и очистить инструкции по умолчанию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 --append-system-prompt "Always use TypeScript and include JSDoc comments"
Примечание:
--system-promptи--system-prompt-fileВзаимоисключающие, нельзя использовать одновременно.
Совет: предпочитайте использовать--append-system-prompt, так как он сохраняет встроенные возможности Claude Code, одновременно удовлетворяя потребности в настройке; используйте два других флага только тогда, когда требуется полная настройка.
Режим печати (-p) подробное использование (формат вывода, потоковая передача, программная интеграция и т. д.), см.документацию SDK。