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

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Команды 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 install [version]Установить или переустановить собственный двоичный файл. Принимает версию, такую как 2.1.118, или stable, или latest. См. Установить конкретную версиюclaude install stable
claude auth loginВойти в свою учетную запись Anthropic. Используйте --email для предварительного заполнения адреса электронной почты, --sso для принудительной аутентификации SSO и --console для входа с помощью Anthropic Console для выставления счетов за использование API вместо подписки Claudeclaude auth login --console
claude auth logoutВыйти из своей учетной записи Anthropicclaude auth logout
claude auth statusПоказать статус аутентификации в формате JSON. Используйте --text для удобочитаемого вывода. Выходит с кодом 0, если вы вошли, 1, если нетclaude auth status
claude agentsОткрыть представление агентов для мониторинга и отправки параллельных фоновых сеансов. Используйте --cwd <path> для отображения только сеансов, запущенных в этом каталогеclaude agents
claude attach <id>Подключиться к фоновому сеансу в этом терминалеclaude attach 7c5dcf5d
claude auto-mode defaultsВывести встроенные правила классификатора auto mode в формате JSON. Используйте claude auto-mode config для просмотра вашей эффективной конфигурации с применяемыми параметрамиclaude auto-mode defaults > rules.json
claude logs <id>Вывести недавний вывод из фонового сеансаclaude logs 7c5dcf5d
claude mcpНастроить серверы Model Context Protocol (MCP)См. документацию Claude Code MCP.
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 respawn 7c5dcf5d
claude rm <id>Удалить фоновый сеанс из спискаclaude rm 7c5dcf5d
claude setup-tokenСоздать долгоживущий OAuth токен для CI и скриптов. Выводит токен в терминал без сохранения. Требует подписку Claude. См. Создать долгоживущий токенclaude setup-token
claude stop <id>Остановить фоновый сеанс. Также принимает claude killclaude 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?.

Флаги CLI

Настройте поведение Claude Code с помощью этих флагов командной строки. claude --help не выводит каждый флаг, поэтому отсутствие флага в --help не означает, что он недоступен.
ФлагОписаниеПример
--add-dirДобавить дополнительные рабочие каталоги для Claude для чтения и редактирования файлов. Предоставляет доступ к файлам; большинство конфигурации .claude/ не обнаруживается из этих каталогов. Проверяет, что каждый путь существует как каталог. Чтобы сохранить эти каталоги между сеансами, установите permissions.additionalDirectories в параметрахclaude --add-dir ../apps ../lib
--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Инструменты, которые выполняются без запроса разрешения. См. синтаксис правила разрешения для сопоставления шаблонов. Чтобы ограничить доступные инструменты, используйте --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
--bareМинимальный режим: пропустить автоматическое обнаружение hooks, skills, plugins, MCP серверов, автоматической памяти и CLAUDE.md, чтобы скриптовые вызовы начинались быстрее. Claude имеет доступ к инструментам Bash, чтения файлов и редактирования файлов. Устанавливает CLAUDE_CODE_SIMPLE. См. bare modeclaude --bare -p "query"
--betasЗаголовки бета-версии для включения в запросы API (только для пользователей API-ключей)claude --betas interleaved-thinking
--bgЗапустить сеанс как фоновый агент и вернуться немедленно. Выводит ID сеанса и команды управления. Комбинируйте с --agent для запуска конкретного subagentclaude --bg "investigate the flaky test"
--channels(Исследовательский предпросмотр) MCP серверы, чьи уведомления channel Claude должен слушать в этом сеансе. Разделенный пробелом список записей plugin:<name>@<marketplace>. Требует аутентификацию Claude.aiclaude --channels plugin:my-notifier@my-marketplace
--chromeВключить интеграцию браузера Chrome для веб-автоматизации и тестированияclaude --chrome
--continue, -cЗагрузить самую последнюю беседу в текущем каталоге. Включает сеансы, которые добавили этот каталог с помощью /add-dirclaude --continue
--dangerously-load-development-channelsВключить channels, которые не находятся в утвержденном списке разрешений, для локальной разработки. Принимает записи plugin:<name>@<marketplace> и server:<name>. Запрашивает подтверждениеclaude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissionsПропустить запросы разрешения. Эквивалентно --permission-mode bypassPermissions. См. режимы разрешения для информации о том, что это пропускает и что не пропускаетclaude --dangerously-skip-permissions
--debugВключить режим отладки с дополнительной фильтрацией категорий (например, "api,hooks" или "!statsig,!file")claude --debug "api,mcp"
--debug-file <path>Записать журналы отладки в конкретный путь файла. Неявно включает режим отладки. Имеет приоритет над CLAUDE_CODE_DEBUG_LOGS_DIRclaude --debug-file /tmp/claude-debug.log
--disable-slash-commandsОтключить все skills и команды для этого сеансаclaude --disable-slash-commands
--disallowedToolsИнструменты, которые удаляются из контекста модели и не могут быть использованы"Bash(git log *)" "Bash(git diff *)" "Edit"
--effortУстановить уровень усилий для текущего сеанса. Опции: low, medium, high, xhigh, max; доступные уровни зависят от модели. Переопределяет параметр 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) в первое пользовательское сообщение. Улучшает повторное использование prompt-cache на разных пользователях и машинах, запускающих одну и ту же задачу. Применяется только с системным приглашением по умолчанию; игнорируется, когда установлены --system-prompt или --system-prompt-file. Используйте с -p для скриптовых многопользовательских рабочих нагрузокclaude -p --exclude-dynamic-system-prompt-sections "query"
--fallback-modelВключить автоматический переход на указанную модель, когда модель по умолчанию перегружена (только режим печати)claude -p --fallback-model sonnet "query"
--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 requestclaude --from-pr 123
--ideАвтоматически подключиться к IDE при запуске, если доступна ровно одна действительная IDEclaude --ide
--initЗапустить Setup hooks с помощью matcher init перед сеансом (только режим печати)claude -p --init "query"
--init-onlyЗапустить Setup и SessionStart hooks, затем выйти без запуска беседыclaude --init-only
--include-hook-eventsВключить все события жизненного цикла hook в выходной поток. Требует --output-format stream-jsonclaude -p --output-format stream-json --include-hook-events "query"
--include-partial-messagesВключить частичные события потоковой передачи в вывод. Требует --print и --output-format stream-jsonclaude -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Запустить Setup hooks с помощью matcher maintenance перед сеансом (только режим печати)claude -p --maintenance "query"
--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) или полным именем модели. Переопределяет параметр model и ANTHROPIC_MODELclaude --model claude-sonnet-4-6
--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. Переопределяет defaultMode из файлов параметровclaude --permission-mode plan
--permission-prompt-toolУказать инструмент MCP для обработки запросов разрешения в неинтерактивном режимеclaude -p --permission-prompt-tool mcp_auth_tool "query"
--plugin-dirЗагрузить plugin из каталога или архива .zip только для этого сеанса. Каждый флаг принимает один путь. Повторите флаг для нескольких plugins: --plugin-dir A --plugin-dir B.zipclaude --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"
--remoteСоздать новый веб-сеанс на claude.ai с предоставленным описанием задачи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-jsonclaude -p --input-format stream-json --output-format stream-json --replay-user-messages
--resume, -rВозобновить конкретный сеанс по ID или имени, или показать интерактивный выбор для выбора сеанса. Включает сеансы, которые добавили этот каталог с помощью /add-dirclaude --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. Значения, которые вы устанавливаете здесь, переопределяют те же ключи в ваших файлах settings.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Установить способ отображения товарищей по команде агентов: auto (по умолчанию), in-process или tmux. Переопределяет параметр teammateMode для этого сеанса. См. выбор режима отображенияclaude --teammate-mode in-process
--tmuxСоздать сеанс tmux для worktree. Требует --worktree. Использует встроенные панели iTerm2, если доступны; передайте --tmux=classic для традиционного tmuxclaude -w feature-auth --tmux
--toolsОграничить, какие встроенные инструменты может использовать Claude. Используйте "" для отключения всех, "default" для всех или имена инструментов, такие как "Bash,Edit,Read"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 по системным приглашениям охватывает то же решение более подробно.

См. также