Справочное руководство по 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 Добавить содержимое к промпту по умолчанию Интерактивный + вывод Сохранить функциональность по умолчанию, добавить персонализированные инструкции

Сценарии использования и примеры

  1. --system-prompt: Полностью перехватить системный промпт и очистить инструкции по умолчанию
    claude --system-prompt "You are a Python expert who only writes type-annotated code"
  2. --system-prompt-file: Читать промпт из файла, подходит для стандартизированных сценариев
    claude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
  3. --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。

Другие расширения