SpyBara
Go Premium

cli-reference.md 2026-08-03 20:02 UTC to 2026-08-04 22:59 UTC

68 added, 68 removed.

2026
Thu 6 15:02 Wed 5 22:02 Tue 4 22:59 Mon 3 20:02 Sun 2 19:00

Справочник 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 gateway Запустить сервер самостоятельно размещаемого Claude apps gateway, для администраторов, развертывающих SSO и политику перед Claude Code на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Требует --config, указывающий на gateway.yaml. Доступно в Claude Code v2.1.195 и позже. claude gateway --config gateway.yaml
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 Открыть представление агентов для мониторинга и отправки параллельных фоновых сеансов. Используйте --cwd <path> для отображения только сеансов, запущенных в этом каталоге, или --json для вывода активных сеансов в виде массива JSON для написания скриптов (--json --all также включает завершенные фоновые сеансы). Передайте --permission-mode, --model, --effort или --agent для установки значений по умолчанию для отправленных сеансов. Принимает --settings, --add-dir, --plugin-dir и --mcp-config как команда верхнего уровня claude. Открытие представления агентов требует интерактивный терминал claude agents --json
claude attach <id> Подключиться к фоновому сеансу в этом терминале claude attach 7c5dcf5d
claude auto-mode defaults Вывести встроенные правила классификатора auto mode в формате JSON. Используйте claude auto-mode config для просмотра вашей эффективной конфигурации с применяемыми параметрами. Флаг --label <prefix> выводит только правила, метка которых начинается с этого префикса, сопоставляя без учета регистра. Требует Claude Code v2.1.208 или позже claude auto-mode defaults --label 'Git Destructive'
claude daemon status Вывести состояние супервизора фонового сеанса, версию, каталог сокета и количество рабочих процессов для диагностики. Выходит с кодом 1, если супервизор не запущен claude daemon status
claude daemon stop --any Остановить супервизора фонового сеанса и размещаемые им сеансы. Передайте --keep-workers для сохранения работающих фоновых сеансов, чтобы следующий супервизор переподключился к ним. --any подтверждает остановку супервизора по требованию, который используется по умолчанию. Используйте это для восстановления после неответчивого супервизора claude daemon stop --any --keep-workers
claude doctor Вывести диагностику установки и параметров только для чтения из терминала без запуска сеанса, включая проверку здоровья установки, ошибки валидации файла параметров и приемлемость Remote Control. Для проверки настройки в сеансе, которая также может применять исправления, запустите /doctor claude doctor
claude logs <id> Вывести недавний вывод из фонового сеанса claude logs 7c5dcf5d
claude mcp Настроить серверы Model Context Protocol (MCP) См. документацию Claude Code MCP.
claude mcp login <name> Запустить поток OAuth настроенного сервера MCP без открытия интерактивной панели /mcp. Работает для HTTP, SSE и серверов соединителя claude.ai. Добавьте --no-browser через SSH для вывода URL авторизации вместо открытия браузера, затем вставьте URL перенаправления обратно в приглашение. Требует Claude Code версии 2.1.186 или позже. См. Аутентификация из командной строки claude mcp login sentry
claude mcp logout <name> Очистить сохраненные учетные данные OAuth для сервера MCP. Требует Claude Code версии 2.1.186 или позже claude mcp logout sentry
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 respawn <id> Перезапустить фоновый сеанс, работающий или остановленный, с сохранением его беседы. Используйте --all для перезапуска каждого работающего сеанса, например для применения обновленного двоичного файла Claude Code claude respawn 7c5dcf5d
claude rm <id> Удалить фоновый сеанс из списка. Стенограмма беседы остается на вашем локальном компьютере, доступная через claude --resume claude rm 7c5dcf5d
claude setup-token Создать долгоживущий OAuth токен для CI и скриптов. Выводит токен в терминал без сохранения. Требует подписку Claude. См. Создать долгоживущий токен claude setup-token
claude stop <id> Остановить фоновый сеанс. Также принимает claude kill claude stop 7c5dcf5d
claude ultrareview [target] Запустить ultrareview неинтерактивно. Выводит результаты в stdout и выходит с кодом 0 при успехе или 1 при ошибке. Используйте --json для необработанного полезного груза и --timeout <minutes> для переопределения 30-минутного значения по умолчанию claude ultrareview 1234 --json

Если вы неправильно введете подкоманду, Claude Code предложит ближайшее совпадение и выйдет без запуска сеанса. Например, claude udpate выводит Did you mean claude update?.

Начиная с версии v2.1.199, claude --dangerously-skip-permissions daemon <subcommand> запускает подкоманду daemon. В более ранних версиях daemon <subcommand> рассматривалась как приглашение для нового интерактивного сеанса, поэтому подкоманда никогда не запускалась, когда флаг шел первым, что является распространенной настройкой, когда claude имеет псевдоним, включающий флаг. Только ведущий --dangerously-skip-permissions или --allow-dangerously-skip-permissions маршрутизирует к daemon таким образом; любой другой ведущий флаг по-прежнему запускает интерактивный сеанс.

Флаги CLI

Настройте поведение Claude Code с помощью этих флагов командной строки. claude --help не выводит каждый флаг, поэтому отсутствие флага в --help не означает, что он недоступен.

Флаг Описание Пример
--add-dir Добавить дополнительные рабочие каталоги для Claude для чтения и редактирования файлов. Предоставляет доступ к файлам; большинство конфигурации .claude/ не обнаруживается из этих каталогов. Проверяет, что каждый путь существует как каталог. Чтобы сохранить эти каталоги между сеансами, установите permissions.additionalDirectories в параметрах claude --add-dir ../apps ../lib
--advisor <model> Включить инструмент advisor на стороне сервера для этого сеанса с псевдонимом модели: opus, sonnet или fable (v2.1.170+), или полный ID модели. Имеет приоритет над параметром advisorModel для сеанса claude --advisor opus
--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, --allowed-tools Инструменты, которые выполняются без запроса разрешения. См. синтаксис правила разрешения для сопоставления шаблонов. Чтобы ограничить доступные инструменты, используйте --tools вместо этого "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt Добавить пользовательский текст в конец системного приглашения каждого subagent, включая вложенные subagents. Применяется только в неинтерактивном режиме с -p. Требует Claude Code v2.1.205 или позже claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"
--append-system-prompt Добавить пользовательский текст в конец системного приглашения по умолчанию claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Загрузить дополнительный текст системного приглашения из файла и добавить к приглашению по умолчанию claude --append-system-prompt-file ./extra-rules.txt
--ax-screen-reader Отрендерить вывод, удобный для программ чтения с экрана: плоский текст без декоративных границ или анимаций. Принудительно использует классический рендерер, поэтому параметр tui не имеет эффекта; присоединённые фоновые сеансы по-прежнему отрендериваются в полноэкранном режиме. Имеет приоритет над CLAUDE_AX_SCREEN_READER и параметром axScreenReader. Требует Claude Code v2.1.181 или позже claude --ax-screen-reader
--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
--bg, --background Запустить сеанс как фоновый агент и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с --exec для запуска команды shell как фонового задания вместо сеанса Claude, или с --agent для запуска конкретного subagent. Не может быть скомбинирован с -p/--print; см. справочник ошибок claude --bg "investigate the flaky test"
--channels (Исследовательский предпросмотр) MCP серверы, чьи уведомления channel Claude должен слушать в этом сеансе. Разделенный пробелом список записей plugin:<name>@<marketplace>. Требует аутентификацию Claude.ai claude --channels plugin:my-notifier@my-marketplace
--chrome Включить интеграцию браузера Chrome для веб-автоматизации и тестирования claude --chrome
--cloud Создать новый веб-сеанс на claude.ai с предоставленным описанием задачи claude --cloud "Fix the login bug"
--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. См. режимы разрешения для информации о том, что это пропускает и что не пропускает. Для сеансов, запущенных с --bg, режим сохраняется при перезапуске сеанса супервизором 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, --disallowed-tools Правила отрицания. Простое имя инструмента удаляет соответствующие инструменты из контекста модели: "Edit" удаляет Edit, "*" удаляет каждый инструмент, и "mcp__*" удаляет каждый MCP инструмент. Правило с областью действия, такое как Bash(rm *), оставляет инструмент доступным и отрицает только совпадающие вызовы "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort Установить уровень усилий для текущего сеанса. Опции: low, medium, high, xhigh, max или }ultracode. Доступные уровни зависят от модели. ultracode запускает сеанс с усилием xhigh с включенным ultracode и требует Claude Code v2.1.203 или позже. Переопределяет параметр effortLevel для этого сеанса и не сохраняется claude --effort high
--enable-auto-mode Удалено в v2.1.111. Auto mode теперь находится в цикле Shift+Tab по умолчанию; используйте --permission-mode auto для запуска в нем claude --permission-mode auto
--exclude-dynamic-system-prompt-sections Переместить разделы для каждой машины из системного приглашения (рабочий каталог, информация об окружении, пути памяти, флаг git-repo) в первое пользовательское сообщение. Улучшает повторное использование prompt-cache на разных пользователях и машинах, запускающих одну и ту же задачу. Применяется только с системным приглашением по умолчанию; игнорируется, когда установлены --system-prompt или --system-prompt-file. Используйте с -p для скриптовых многопользовательских рабочих нагрузок claude -p --exclude-dynamic-system-prompt-sections "query"
--exec Запустить команду shell как фоновое задание с поддержкой PTY вместо запуска сеанса Claude. Используйте с --bg для запуска из shell claude --bg --exec 'pytest -x'
--fallback-model Включить автоматический переход на указанную модель (модели) при перегрузке или недоступности основной модели, например снятая с производства модель. Принимает разделенный запятыми список, пробуемый по порядку. См. Цепочки резервных моделей. Чтобы сохранить цепочку между сеансами, используйте параметр fallbackModel, который этот флаг переопределяет claude --fallback-model sonnet,haiku
--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 из каждого события hook в выходной поток. События SessionStart и Setup hook всегда включены и не требуют этого флага. Требует --output-format stream-json claude -p --output-format stream-json --verbose --include-hook-events "query"
--include-partial-messages Включить частичные события потоковой передачи в вывод. Требует --print и --output-format stream-json claude -p --output-format stream-json --verbose --include-partial-messages "query"
--input-format Указать формат входных данных для режима печати (опции: text, stream-json) claude -p --output-format json --input-format stream-json
--json-schema Получить проверенный вывод JSON, соответствующий JSON Schema после завершения рабочего процесса агента (только режим печати). См. структурированные выходы. Claude Code выходит с ошибкой при недействительной схеме и принимает ключевое слово format как аннотацию без проверки на стороне клиента. До v2.1.205 недействительная схема выдавала неструктурированный вывод без ошибки, и схемы, использующие format, рассматривались как недействительные 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 Ограничить количество агентских ходов (только режим печати). Выходит с ошибкой при достижении лимита. По умолчанию нет лимита. С --input-format stream-json сообщение, отправленное во время работы Claude, остается в очереди и выполняется как собственный ход с собственным лимитом, когда лимит заканчивает текущий. До v2.1.205 Claude Code отбрасывал это сообщение claude -p --max-turns 3 "query"
--mcp-config Загрузить MCP серверы из JSON файлов или строк (разделенные пробелом) claude --mcp-config ./mcp.json
--model Устанавливает модель для текущего сеанса с псевдонимом для последней модели (sonnet, opus, haiku или fable) или полным именем модели. Переопределяет параметр model и ANTHROPIC_MODEL claude --model claude-sonnet-5
--name, -n Установить отображаемое имя для сеанса, показываемое в /resume и в заголовке терминала. Вы можете возобновить именованный сеанс с помощью claude --resume <name>.

/rename изменяет имя во время сеанса и также показывает его на панели приглашения		 claude -n "my-feature-work"
--no-chrome Отключить интеграцию браузера Chrome для этого сеанса claude --no-chrome
--no-session-persistence Отключить сохранение сеанса, чтобы сеансы не сохранялись на диск и не могли быть возобновлены. Только режим печати. Переменная окружения CLAUDE_CODE_SKIP_PROMPT_HISTORY делает то же самое в любом режиме 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 или }manual как псевдоним для default. Псевдоним manual выбирает режим, который UI обозначает как Manual и требует Claude Code v2.1.200 или позже; claude --help выводит его вместо default, и оба значения работают. Переопределяет defaultMode из файлов параметров claude --permission-mode plan
--permission-prompt-tool Указать инструмент MCP для обработки запросов разрешения в неинтерактивном режиме. Claude Code ждет подключения MCP сервера этого инструмента перед запуском первого хода, до MCP_TIMEOUT стартового таймаута в 30 секунд. До v2.1.206 медленно запускающийся сервер мог привести к выходу с ошибкой, что инструмент MCP не найден.

Инструмент приглашения не может одобрить инструмент MCP, отмеченный как требующий взаимодействия пользователя: Claude Code преобразует результат allow для одного в отрицание. Это ограничение требует Claude Code v2.1.199 или позже		 claude -p --permission-prompt-tool mcp_auth_tool "query"
--plugin-dir Загрузить plugin из каталога или архива .zip только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких plugins: --plugin-dir A --plugin-dir B.zip claude --plugin-dir ./my-plugin
--plugin-url Получить plugin архив .zip из URL только для этого сеанса. Повторите флаг для нескольких plugins или передайте разделенные пробелом URL в одном значении в кавычках claude --plugin-url https://example.com/plugin.zip
--print, -p Вывести ответ без интерактивного режима (см. документацию Agent SDK для деталей программного использования) claude -p "query"
--prompt-suggestions Выдать сообщение prompt_suggestion после каждого хода с предсказанным следующим приглашением пользователя. Требует --print, --output-format stream-json и --verbose. См. Предложения приглашений claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--remote Устаревший псевдоним для --cloud 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 --verbose --replay-user-messages
--resume, -r Возобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Выбор и поиск по имени включают сеансы, которые добавили этот каталог с помощью /add-dir; передача ID сеанса ищет только текущий каталог проекта и его git worktrees. Начиная с v2.1.144, фоновые сеансы появляются в выборе, отмеченные как bg claude --resume auth-refactor
--safe-mode Запустить со всеми отключенными настройками для устранения неполадок в нарушенной конфигурации: CLAUDE.md, skills, plugins, hooks, MCP серверы, пользовательские команды и агенты, стили вывода, рабочие процессы, пользовательские темы, пользовательские сочетания клавиш, строка состояния и команды предложения файлов, LSP серверы и автоматическая память не загружаются. Аутентификация, выбор модели, встроенные инструменты и разрешения работают нормально, что отличается от --bare. Политика управляемых параметров все еще применяется, включая настроенные политикой hooks, строку состояния и команды предложения файлов; управляемые plugins, управляемые skills, управляемый CLAUDE.md и настроенные политикой MCP серверы не загружаются. Полезно для проверки того, является ли настройка причиной автоматического переключения с Fable 5. Устанавливает CLAUDE_CODE_SAFE_MODE claude --safe-mode
--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. Значения, которые вы устанавливаете здесь, переопределяют те же ключи в ваших файлах settings.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 Установить способ отображения товарищей по команде агентов: in-process (по умолчанию), auto, tmux или }iterm2 (добавлено в v2.1.186). Значение по умолчанию изменилось с auto в v2.1.179. Переопределяет параметр teammateMode для этого сеанса. См. выбор режима отображения claude --teammate-mode auto
--tmux Создать сеанс tmux для worktree. Требует --worktree. Использует встроенные панели iTerm2, если доступны; передайте --tmux=classic для традиционного tmux claude -w feature-auth --tmux
--tools Ограничить, какие встроенные инструменты может использовать Claude. Используйте "" для отключения всех, "default" для всех или имена инструментов, такие как "Bash,Edit,Read". MCP инструменты не затронуты; чтобы отрицать и их, используйте --disallowedTools "mcp__*" или передайте --strict-mcp-config без --mcp-config, чтобы не загружались MCP серверы claude --tools "Bash,Edit,Read"
--verbose Включить подробное логирование, показывает полный вывод по ходам. Переопределяет параметр viewMode для этого сеанса claude --verbose
--version, -v Вывести номер версии claude -v
--worktree, -w Запустить Claude в изолированном git worktree в <repo>/.claude/worktrees/<name>. Если имя не указано, оно генерируется автоматически. Передайте #<number> или URL GitHub pull request для получения этого PR из origin и ветвления worktree из него 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 для вашей задачи. Используйте флаг добавления, когда Claude должен оставаться помощником по кодированию, который также следует вашим дополнительным правилам: инструкции для каждого вызова, форматирование вывода или контекст домена для скрипта -p. Добавление сохраняет стандартное руководство по инструментам, инструкции безопасности и соглашения кодирования, поэтому вы предоставляете только то, что отличается. Используйте флаг замены, когда поверхность, идентичность или модель разрешения отличаются от Claude Code, например некодирующий агент в конвейере, который не смотрит ни один человек. Замена удаляет весь стандартный запрос, включая руководство по инструментам и инструкции безопасности, поэтому вы берете на себя ответственность за все, что вашей задаче все еще нужно.

Эти флаги применяются только к текущему вызову. Для постоянных персон, которые вы можете переключать и делиться между проектом, используйте стили вывода. Для соглашений проекта, которые Claude должен всегда соблюдать, используйте CLAUDE.md. Руководство Agent SDK по системным приглашениям охватывает то же решение более подробно.

См. также