SpyBara
Go Premium

cli-reference.md 2026-10-21 23:02 UTC to 2026-10-22 22:58 UTC

This page contains 81 additions and 81 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Tue 6 23:59 Wed 7 23:59 Fri 9 23:02 Sat 10 23:01 Sat 17 23:57 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Thu 29 23:57

Referência de CLI

Referência completa para a interface de linha de comando Claude Code, incluindo comandos e sinalizadores.

Comandos CLI

Você pode iniciar sessões, canalizar conteúdo, retomar conversas e gerenciar atualizações com estes comandos:

Comando Descrição Exemplo
claude Iniciar sessão interativa claude
claude "query" Iniciar sessão interativa com prompt inicial claude "explain this project"
claude -p "query" Consultar via SDK e sair claude -p "explain this function"
cat file | claude -p "query" Processar conteúdo canalizado cat logs.txt | claude -p "explain"
claude -c Continuar a conversa mais recente no diretório atual claude -c
claude -c -p "query" Continuar via SDK claude -c -p "Check for type errors"
claude -r "<session>" "query" Retomar sessão por ID ou nome claude -r "auth-refactor" "Finish this PR"
claude update Atualizar para a versão mais recente claude update
claude gateway Iniciar o servidor gateway de aplicativos Claude auto-hospedado, para administradores implantando SSO e política na frente do Claude Code no Amazon Bedrock, Google Cloud's Agent Platform ou Microsoft Foundry. Requer --config apontando para um gateway.yaml. claude gateway --config gateway.yaml
claude install [version] Instalar ou reinstalar o binário nativo. Aceita uma versão como 2.1.118, ou stable ou latest. Veja Instalar uma versão específica claude install stable
claude auth login Faça login em sua conta Anthropic. Use --email para preencher previamente seu endereço de email, --sso para forçar autenticação SSO e --console para fazer login com Anthropic Console para faturamento de uso de API em vez de uma assinatura Claude claude auth login --console
claude auth logout Fazer logout de sua conta Anthropic claude auth logout
claude auth status Mostrar status de autenticação como JSON. Use --text para saída legível por humanos. Sai com código 0 se conectado, 1 se não. O JSON inclui um campo configDirectory nomeando o diretório de configuração que a CLI usa. O campo requer Claude Code v2.1.268 ou posterior. O campo authMethod do JSON é um de none, claude.ai, oauth_token, api_key, api_key_helper ou third_party claude auth status
claude agents Abrir visualização de agente para monitorar e despachar sessões de fundo paralelas. Use --cwd <path> para mostrar apenas sessões iniciadas nesse diretório, ou --json para imprimir sessões ativas como um array JSON para scripts (--json --all também inclui sessões de fundo concluídas). Passe --permission-mode, --model, --effort ou --agent para definir padrões para sessões despachadas. Aceita --settings, --add-dir, --plugin-dir e --mcp-config como o comando claude de nível superior. Abrir visualização de agente requer um terminal interativo claude agents --json
claude attach <id|name> Anexar a uma sessão de fundo neste terminal. Passar parte do nome de uma sessão em execução no lugar do ID requer Claude Code v2.1.290 ou posterior claude attach 7c5dcf5d
claude auto-mode defaults Imprimir as regras do classificador do modo auto integradas como JSON. Use claude auto-mode config para ver sua configuração efetiva com as configurações aplicadas. --label <prefix> imprime apenas as regras cujo rótulo começa com esse prefixo, correspondência sem distinção de maiúsculas e minúsculas. Requer Claude Code v2.1.208 ou posterior claude auto-mode defaults --label 'Git Destructive'
claude auto-mode reset Restaurar a configuração padrão do modo auto removendo a seção autoMode do seu arquivo de configurações do usuário. Solicita confirmação antes de escrever; passe -y/--yes para pular o prompt. As regras de configurações gerenciadas ou a flag --settings ainda se aplicam. Requer Claude Code v2.1.212 ou posterior. Veja Inspecionar os padrões e sua configuração efetiva claude auto-mode reset --yes
claude daemon logs Acompanhar o arquivo de log do supervisor de sessão de fundo, ~/.claude/daemon.log, imprimindo novas linhas à medida que chegam até você pressionar Ctrl+C claude daemon logs
claude daemon run Executar o supervisor de sessão de fundo em primeiro plano neste terminal, imprimindo seu log claude daemon run
claude daemon status Imprimir o estado do supervisor de sessão de fundo, versão, diretório de socket e contagem de workers para diagnósticos. Sai com 1 se o supervisor não estiver em execução claude daemon status
claude daemon stop --any Parar o supervisor de sessão de fundo e as sessões que ele hospeda. Passe --keep-workers para deixar as sessões de fundo em execução para que o próximo supervisor se reconecte a elas. --any confirma a parada de um supervisor sob demanda, que é o padrão. Use isto para recuperar de um supervisor não responsivo claude daemon stop --any --keep-workers
claude doctor Imprimir diagnósticos de instalação e configurações somente leitura do terminal sem iniciar uma sessão, incluindo saúde da instalação, erros de validação de arquivo de configurações e elegibilidade de Remote Control. Para a verificação de configuração em sessão que também pode aplicar correções, execute /doctor claude doctor
claude import [source] Iniciar uma sessão interativa que executa /import para trazer configuração de outros agentes de codificação para Claude Code. Aceita as mesmas opções --dry-run e --yes do comando. Não disponível no Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry ou Claude Platform na AWS. Também indisponível quando você desativa busca de feature-flag. Requer Claude Code v2.1.213 ou posterior claude import codex --dry-run
claude logs <id|name> Imprimir saída recente de uma sessão de fundo. Passar parte do nome de uma sessão no lugar do ID requer Claude Code v2.1.290 ou posterior claude logs 7c5dcf5d
claude mcp Configurar servidores Model Context Protocol (MCP) Veja a documentação Claude Code MCP.
claude mcp login <name> Executar o fluxo OAuth de um servidor MCP configurado sem abrir o painel interativo /mcp. Funciona para servidores HTTP, SSE e conectores claude.ai. Adicione --no-browser via SSH para imprimir a URL de autorização em vez de abrir um navegador. Para um servidor HTTP ou SSE, cole a URL de redirecionamento de volta no prompt. Para um conector claude.ai, veja Autorizar um conector novamente a partir do seu shell. Veja Autenticar a partir da linha de comando claude mcp login sentry
claude mcp logout <name> Limpar credenciais OAuth armazenadas para um servidor MCP claude mcp logout sentry
claude plugin Gerenciar Claude Code plugins. Alias: claude plugins. Veja referência de plugin para subcomandos claude plugin install code-review@claude-plugins-official
claude purge [path] Excluir todo o estado local do Claude Code para um projeto: transcrições, listas de tarefas, logs de depuração, histórico de edição de arquivo, linhas de histórico de prompt e a entrada do projeto em ~/.claude.json. Omita [path] para escolher em uma lista interativa. Flags: --dry-run para visualizar, -y/--yes para pular confirmação, -i/--interactive para confirmar cada item, --all para cada projeto. Veja Limpar dados locais claude purge ~/work/repo --dry-run
claude remote-control Iniciar um servidor Remote Control para controlar Claude Code a partir de Claude.ai ou do aplicativo Claude. Executa em modo servidor (sem sessão interativa local). Veja Flags de modo servidor. Depois de parar o servidor, você pode trazer de volta as sessões que ele estava servindo. Veja Retomar sessões após parar o servidor claude remote-control --name "My Project"
claude respawn <id> Reiniciar uma sessão de fundo, em execução ou parada, com sua conversa intacta. Use --all para reiniciar cada sessão em execução, por exemplo, para pegar um binário Claude Code atualizado claude respawn 7c5dcf5d
claude rm <id> Remover uma sessão de fundo da lista. Quando a remoção é recusada por causa do worktree da sessão e um segundo claude rm pode resolvê-la, a recusa imprime a flag exata e o valor a passar: --discard-unpushed <commit>@<worktree-id> descarta um worktree que tem commits não enviados junto com esses commits, e --force-remove-worktree <worktree-id> exclui um diretório de worktree que o git ou o hook WorktreeRemove não conseguiu remover. --discard-unpushed requer Claude Code v2.1.260 ou posterior, e --force-remove-worktree requer v2.1.268 ou posterior. A transcrição da conversa permanece em sua máquina local, disponível através de claude --resume claude rm 7c5dcf5d
claude self-hosted-runner Iniciar um processo de runner que registra esta máquina ou contêiner com um ambiente auto-hospedado e hospeda sessões na nuvem do Claude Code em sua infraestrutura. Execute claude self-hosted-runner setup para um passo a passo do operador guiado, claude self-hosted-runner doctor para diagnosticar um runner implantado e claude self-hosted-runner orchestrator para gerar runners sob demanda. Requer Claude Code v2.1.224 ou posterior claude self-hosted-runner setup
claude setup-token Gerar um token OAuth de longa duração para CI e scripts. Imprime o token no terminal sem salvá-lo. Requer uma assinatura Claude. Veja Gerar um token de longa duração claude setup-token
claude stop <id> Parar uma sessão de fundo. Também aceita claude kill claude stop 7c5dcf5d
claude ultrareview [target] Executar ultrareview de forma não interativa. Imprime descobertas para stdout e sai com 0 em caso de sucesso ou 1 em caso de falha. Use --json para o payload bruto e --timeout <minutes> para sobrescrever o padrão de 45 minutos. Use --post em um alvo de pull request github.com para postar as descobertas concluídas para o PR como um comentário simples de sua conta GitHub. --no-post é o padrão. --post e --no-post requerem Claude Code v2.1.227 ou posterior. Veja Postar descobertas para o pull request claude ultrareview 1234 --json

Se você digitar incorretamente um subcomando, Claude Code sugere a correspondência mais próxima e sai sem iniciar uma sessão. Por exemplo, claude udpate imprime Did you mean claude update?.

claude --dangerously-skip-permissions daemon <subcommand> executa o subcomando daemon, então o subcomando funciona quando claude é aliasado para incluir a flag. Apenas um --dangerously-skip-permissions ou --allow-dangerously-skip-permissions à frente roteia para daemon desta forma; com qualquer outra flag antes de daemon, o subcomando não é executado.

Sinalizadores CLI

Personalize o comportamento do Claude Code com estes sinalizadores de linha de comando. claude --help não lista todos os sinalizadores, portanto a ausência de um sinalizador em --help não significa que ele não está disponível.

Sinalizador Descrição Exemplo
--add-dir Adicionar diretórios de trabalho adicionais para Claude ler e editar arquivos. Concede acesso a arquivos; Claude Code não descobre a maioria da configuração .claude/ desses diretórios. Valida se cada caminho existe como um diretório. Você não pode adicionar a maioria dos caminhos de rede, como \\server\share. Para persistir esses diretórios entre sessões, defina permissions.additionalDirectories nas configurações claude --add-dir ../apps ../lib
--advisor <model> Ativar a ferramenta advisor do lado do servidor para esta sessão com um alias de modelo, fable, opus ou sonnet, ou um ID de modelo completo. Tem precedência sobre a configuração advisorModel para a sessão. fable requer acesso a Fable claude --advisor opus
--agent Especificar um agente para a sessão atual (substitui a configuração agent) claude --agent my-custom-agent
--agents Definir subagents personalizados dinamicamente via JSON. Aceita os campos listados para subagents definidos via CLI. Com --print, o valor pode ser o caminho para um arquivo JSON contendo o objeto; a forma de arquivo requer Claude Code v2.1.281 ou posterior. Claude Code valida o valor na inicialização e sai em um valor inválido; veja Invalid --agents configuration para a mensagem e para os sinalizadores e variável de ambiente que pulam a validação. A validação requer Claude Code v2.1.242 ou posterior claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissions Adicionar bypassPermissions ao ciclo de modo Shift+Tab sem iniciar nele. Permite começar em um modo diferente como plan e mudar para bypassPermissions depois. Veja modos de permissão claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedTools, --allowed-tools Ferramentas que executam sem solicitar permissão, exceto leituras de caminhos de rede. Veja sintaxe de regra de permissão para correspondência de padrões. Para restringir quais ferramentas estão disponíveis, use --tools em vez disso. Se você nomear uma das ferramentas de rastreamento de tarefas aqui, Claude Code também as habilita na sessão "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt Anexar texto personalizado ao final do prompt do sistema de cada subagent, incluindo subagents aninhados, exceto um subagent bifurcado, que reutiliza o prompt da conversa. Aplica-se apenas em modo não interativo com -p. Requer Claude Code v2.1.205 ou posterior claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"
--append-subagent-system-prompt-file Carregar texto de um arquivo e anexá-lo aos prompts do sistema de subagent. Uma alternativa a --append-subagent-system-prompt para texto muito longo para passar na linha de comando. Os dois sinalizadores não podem ser combinados. Aplica-se apenas em modo não interativo com -p. Requer Claude Code v2.1.261 ou posterior claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"
--append-system-prompt Anexar texto personalizado ao final do prompt do sistema padrão claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Carregar texto de prompt do sistema adicional de um arquivo e anexar ao prompt padrão claude --append-system-prompt-file ./extra-rules.txt
--autocompact <auto|tokens> Definir a janela auto-compact para esta sessão sem alterar suas configurações salvas. Aceita os mesmos valores que /autocompact; essa seção cobre as formas de valor e o que substitui o sinalizador. Requer Claude Code v2.1.221 ou posterior claude --autocompact 500k
--ax-screen-reader Renderizar saída amigável ao leitor de tela: texto simples sem bordas decorativas ou animações. Força o renderizador clássico, portanto a configuração tui não tem efeito; sessões de fundo anexadas ainda renderizam em tela cheia. Tem precedência sobre CLAUDE_AX_SCREEN_READER e a configuração axScreenReader. Requer Claude Code v2.1.181 ou posterior claude --ax-screen-reader
--bare Modo mínimo: pular auto-descoberta de hooks, skills, comandos personalizados, subagents, plugins instalados, servidores MCP, memória automática e CLAUDE.md para que chamadas com script iniciem mais rapidamente. Skills em um diretório que você passa com --add-dir ainda carregam. Claude tem acesso a ferramentas Bash, leitura de arquivo e edição de arquivo. Define CLAUDE_CODE_SIMPLE. Veja modo bare claude --bare -p "query"
--betas Cabeçalhos beta para incluir em solicitações de API (apenas usuários de chave de API) claude --betas interleaved-thinking
--bg, --background Iniciar a sessão como um agente de fundo e retornar imediatamente. Imprime o ID da sessão e comandos de gerenciamento. Combine com --exec para executar um comando shell como um trabalho de fundo em vez de uma sessão Claude, ou com --agent para executar um subagent específico. Verifica confiança do workspace para o diretório antes de iniciar. Não pode ser combinado com -p/--print; veja a referência de erro claude --bg "investigate the flaky test"
--channels (Visualização de pesquisa) Servidores MCP cujas notificações de channel Claude deve ouvir nesta sessão. Lista separada por espaço de entradas plugin:<name>@<marketplace>. Requer autenticação Anthropic através de claude.ai ou uma chave de API do Console claude --channels plugin:my-notifier@my-marketplace
--chrome Ativar integração do navegador Chrome para automação web e testes claude --chrome
--cloud Com uma descrição de tarefa, criar uma nova sessão na nuvem. Com um ID de sessão (session_... ou cse_...) ou uma URL claude.ai/code, enfileirar uma mensagem nessa sessão existente em vez disso, com -p. Veja enviar uma mensagem de acompanhamento. claude --cloud "Fix the login bug"
--continue, -c Carregar a conversa mais recente no diretório atual, incluindo uma sessão de fundo que terminou; abrir sessões de fundo terminadas requer Claude Code v2.1.257 ou posterior. Pula sessões criadas com claude -p ou o Agent SDK, e sessões cujo primeiro prompt foi /loop. claude -p --continue inclui sessões -p, SDK e /loop. Inclui sessões que adicionaram este diretório com /add-dir claude --continue
--dangerously-load-development-channels Ativar canais que não estão na allowlist aprovada, para desenvolvimento local. Aceita entradas plugin:<name>@<marketplace> e server:<name>. Solicita confirmação, portanto entra em vigor em sessões interativas. Com -p, Claude Code ignora a flag claude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissions Pular prompts de permissão. Equivalente a --permission-mode bypassPermissions. Veja modos de permissão para o que isso faz e não faz. Para sessões iniciadas com --bg, o modo persiste quando o supervisor reinicia a sessão claude --dangerously-skip-permissions
--debug Ativar modo de depuração com filtragem de categoria opcional, como --debug='mcp,startup' ou --debug='!mcp'. O filtro se vincula apenas na forma =; um filtro separado por espaço ativa o modo de depuração sem filtragem claude --debug='mcp,startup'
--debug-file <path> Escrever logs de depuração em um caminho de arquivo específico. Ativa implicitamente o modo de depuração. Tem precedência sobre CLAUDE_CODE_DEBUG_LOGS_DIR claude --debug-file /tmp/claude-debug.log
--desktop Abrir o aplicativo Claude Desktop no diretório atual e sair sem iniciar uma sessão no terminal. Adicione --continue ou --resume com um ID de sessão para abrir essa sessão no Desktop em vez disso. --resume aqui leva apenas um ID de sessão, não um nome ou caminho de transcrição. Não leva prompt e nenhum outro sinalizador exceto --verbose e os sinalizadores --debug, já que o aplicativo inicia a sessão em si. Disponível em macOS e Windows x64 quando você está conectado com uma assinatura Claude. Requer Claude Code v2.1.285 ou posterior claude --desktop
--disable-slash-commands Desativar todas as skills e comandos para esta sessão claude --disable-slash-commands
--disallowedTools, --disallowed-tools Regras de negação. Um nome de ferramenta simples remove as ferramentas correspondentes do contexto do Claude: "Edit" remove Edit, "*" remove todas as ferramentas e "mcp__*" remove todas as ferramentas MCP. Uma regra com escopo como Bash(rm *) deixa a ferramenta disponível e nega apenas chamadas correspondentes conforme escrito. Uma regra nomeando EndConversation não pode removê-la enquanto qualquer outra ferramenta permanecer "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort Definir o nível de esforço para a sessão atual. Opções: low, medium, high, xhigh, max ou ultracode. Os níveis disponíveis dependem do modelo. ultracode inicia a sessão em esforço xhigh com ultracode ativado e requer Claude Code v2.1.203 ou posterior. Substitui as configurações modelSettings e effortLevel para esta sessão e não persiste claude --effort high
--enable-auto-mode Removido em v2.1.111. Auto mode agora está no ciclo Shift+Tab por padrão; use --permission-mode auto para iniciar nele claude --permission-mode auto
--environment <environment-id> Criar uma nova sessão em nuvem que é executada no ambiente auto-hospedado com o ID fornecido. IDs de ambiente começam com ccpool_. Veja comportamento de dispatch de --environment para comportamento de dispatch e as combinações de sinalizadores que ele rejeita. Requer Claude Code v2.1.224 ou posterior claude -p "Fix the login bug" --environment ccpool_abc123
--exclude-dynamic-system-prompt-sections Mover contexto por usuário, como a localização de memória automática, para fora do prompt do sistema e para a primeira mensagem do usuário. Melhora a reutilização de prompt-cache em diferentes usuários e máquinas executando a mesma tarefa. Aplica-se apenas com o prompt do sistema padrão; ignorado quando --system-prompt ou --system-prompt-file está definido. Use com -p para cargas de trabalho com script e multi-usuário claude -p --exclude-dynamic-system-prompt-sections "query"
--exec Executar um comando shell como um trabalho de fundo com suporte PTY em vez de iniciar uma sessão Claude. Use com --bg para iniciar a partir do shell claude --bg --exec 'pytest -x'
--fallback-model Ativar fallback automático para o(s) modelo(s) especificado(s) quando o modelo primário está sobrecarregado ou não está disponível, por exemplo um modelo descontinuado. Aceita uma lista separada por vírgula tentada em ordem. Veja Cadeias de modelo fallback. Para persistir uma cadeia entre sessões, use a configuração fallbackModel, que este sinalizador substitui claude --fallback-model sonnet,haiku
--fork-session Ao retomar, criar um novo ID de sessão em vez de reutilizar o original (use com --resume ou --continue) claude --resume abc123 --fork-session
--forward-subagent-text Emitir blocos de texto e pensamento de subagentes no fluxo de saída como mensagens assistant e user com parent_tool_use_id definido, para que você possa reconstruir a transcrição de cada subagente. Sem esta flag, Claude Code omite os blocos de texto e pensamento de um subagente que é executado em primeiro plano. Requer --print e --output-format stream-json. Para subagentes aninhados, skills bifurcadas e a versão que cada um requer, veja Acompanhar mensagens de subagentes. A variável de ambiente CLAUDE_CODE_FORWARD_SUBAGENT_TEXT ativa o mesmo comportamento. Requer Claude Code v2.1.211 ou posterior claude -p --output-format stream-json --verbose --forward-subagent-text "query"
--from-pr Abrir o seletor de sessão filtrado para sessões vinculadas a um pull request específico. Aceita um número de PR, uma URL de PR do GitHub ou GitHub Enterprise, uma URL de merge request do GitLab ou uma URL de pull request do Bitbucket. As sessões são vinculadas automaticamente quando Claude cria o pull request claude --from-pr 123
--ide Conectar automaticamente ao IDE na inicialização se exatamente um IDE válido estiver disponível claude --ide
--init Executar hooks de Setup com o matcher init antes da sessão (apenas modo print) claude -p --init "query"
--init-only Executar hooks de Setup e SessionStart, depois sair sem iniciar uma conversa claude --init-only
--include-hook-events Incluir eventos do ciclo de vida do hook no fluxo de saída. Eventos de hook SessionStart e Setup são sempre incluídos e não precisam deste sinalizador. Alguns eventos de hook, como Notification, SessionEnd, PreCompact e PostCompact, nunca produzem um evento hook_started, mesmo com este sinalizador. Para esses eventos, Claude Code ainda emite hook_progress enquanto um hook de comando que é executado por mais de um segundo produz saída, e emite hook_response apenas quando um hook que é executado em segundo plano termina. Requer --output-format stream-json claude -p --output-format stream-json --verbose --include-hook-events "query"
--include-partial-messages Incluir eventos de streaming parcial na saída. Requer --print e --output-format stream-json claude -p --output-format stream-json --verbose --include-partial-messages "query"
--input-format Especificar formato de entrada para modo print (opções: text, stream-json) claude -p --output-format json --input-format stream-json
--json-schema Obter saída JSON validada correspondendo a um JSON Schema após o agente completar seu fluxo de trabalho (apenas modo print). Veja saídas estruturadas. Claude Code sai com um erro em um schema inválido e aceita a palavra-chave format como uma anotação sem validação do lado do cliente claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenance Executar hooks de Setup com o matcher maintenance antes da sessão (apenas modo print) claude -p --maintenance "query"
--max-budget-usd Interromper a execução quando o gasto estimado em chamadas de API atingir este valor (apenas modo print). Claude Code compara o limite com sua estimativa de custo do lado do cliente, que pode diferir da sua fatura. Gastos de subagentes contam para o limite. O gasto pode ultrapassar o limite, portanto deixe uma margem. Quando você retorna a uma conversa com --continue ou --resume, totais restaurados de execuções anteriores não contam para ele. Uma vez que o gasto atinge o limite, gerar outro subagente falha com Budget limit reached, e Claude Code para subagentes de fundo que ainda estão em execução; os comportamentos de aplicação do limite requerem Claude Code v2.1.217 ou posterior claude -p --max-budget-usd 5.00 "query"
--max-turns Limitar o número de turnos de agente (apenas modo print). Sai com um erro quando o limite é atingido. Sem limite por padrão. Com --input-format stream-json, uma mensagem ainda enfileirada quando o limite termina um turno permanece enfileirada e inicia um novo turno com seu próprio limite claude -p --max-turns 3 "query"
--mcp-config Carregar servidores MCP de arquivos JSON ou strings (separados por espaço). Quando você passa este sinalizador com -p, Claude Code aguarda servidores ainda pendentes se conectarem antes de executar o primeiro turno, até o timeout de inicialização MCP_TIMEOUT, 30 segundos por padrão; um servidor com uma lista de ferramentas em cache pula a espera e se conecta no primeiro uso. Em um ambiente auto-hospedado, uma espera mais curta se aplica em vez disso. A espera requer Claude Code v2.1.221 ou posterior claude --mcp-config ./mcp.json
--model Define o modelo para a sessão atual com um alias de modelo como sonnet, opus, haiku ou fable, ou o nome completo de um modelo. Substitui a configuração model e ANTHROPIC_MODEL claude --model claude-sonnet-5
--name, -n Definir um nome de exibição para a sessão, mostrado em /resume e no título do terminal. Você pode retomar uma sessão nomeada com claude --resume <name>. /rename altera o nome durante a sessão e também o mostra na barra de prompt claude -n "my-feature-work"
--no-chrome Desativar integração do navegador Chrome para esta sessão claude --no-chrome
--no-session-persistence Desativar persistência de sessão para que as sessões não sejam salvas em disco e não possam ser retomadas. Apenas modo print. A variável de ambiente CLAUDE_CODE_SKIP_PROMPT_HISTORY faz o mesmo em qualquer modo claude -p --no-session-persistence "query"
--output-format Especificar formato de saída para modo print (opções: text, json, stream-json) claude -p "query" --output-format json
--permission-mode Começar em um modo de permissão especificado. Aceita default, acceptEdits, plan, auto, dontAsk, bypassPermissions ou manual como um alias para default. O alias manual seleciona o modo de permissão que a UI rotula como Manual e requer Claude Code v2.1.200 ou posterior; claude --help o lista no lugar de default e ambos os valores funcionam. Substitui defaultMode dos arquivos de configuração. Sem este sinalizador ou --dangerously-skip-permissions, uma nova sessão inicia no modo de permissão descrito em qual modo de permissão uma sessão inicia, que também cobre o que uma execução -p inicia claude --permission-mode plan
--permission-prompt-tool Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo. Passe o nome completo, como mcp__<server>__<tool>, de uma ferramenta em um servidor MCP que a execução carrega. Claude Code aguarda a conexão do servidor MCP dessa ferramenta antes de executar o primeiro turno, até o timeout de inicialização MCP_TIMEOUT, 30 segundos por padrão. A ferramenta de prompt não pode aprovar uma ferramenta MCP marcada como exigindo interação do usuário: Claude Code converte um resultado allow para uma em uma negação. Esta restrição requer Claude Code v2.1.199 ou posterior claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"
--permission-prompts Definir quem responde prompts de permissão em modo print. Com o padrão host, Claude Code os envia para o host do Agent SDK ou a ferramenta --permission-prompt-tool. Passe none quando ninguém puder responder, e Claude Code os nega em vez disso. Veja Desativar prompts de permissão em execuções sem supervisão. Requer Claude Code v2.1.259 ou posterior claude -p --permission-prompts none "query"
--plugin-dir Carregar um plugin de um diretório ou arquivo .zip, ou vários de uma pasta de plugins, apenas para esta sessão. Cada sinalizador leva um caminho. Repita o sinalizador para mais caminhos: --plugin-dir A --plugin-dir B.zip. Passar uma pasta de plugins requer Claude Code v2.1.265 ou posterior claude --plugin-dir ./my-plugin
--plugin-url Buscar um arquivo .zip de plugin de uma URL apenas para esta sessão. Repita o sinalizador para vários plugins, ou passe URLs separadas por espaço em um único valor entre aspas claude --plugin-url https://example.com/plugin.zip
--print, -p Imprimir resposta sem modo interativo (veja a documentação do Agent SDK para detalhes de uso programático). Para --resume em uma sessão em segundo plano que ainda está em execução, veja Retomar uma sessão em segundo plano em execução claude -p "query"
--prompt-suggestions Emitir uma mensagem prompt_suggestion com um prompt de usuário previsto após cada turno que gera um; conversas muito curtas podem não produzir nenhum. Requer --print, --output-format stream-json e --verbose. Veja Sugestões de prompt claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--ref <branch> Com --environment, basear o checkout da nova sessão em uma ref nomeada em vez de HEAD local claude -p "Run the smoke test" --environment ccpool_abc123 --ref main
--remote Alias descontinuado para --cloud, incluindo o formulário de sessão existente claude --remote "Fix the login bug"
--remote-control, --rc Iniciar uma sessão interativa com Remote Control ativado para que você também possa controlá-la a partir de claude.ai ou do aplicativo Claude. Opcionalmente, passe um nome para a sessão claude --remote-control "My Project"
--remote-control-session-name-prefix <prefix> Prefixo para nomes de sessão Remote Control gerados automaticamente quando nenhum nome explícito está definido. Padrão é o nome do host da sua máquina, produzindo nomes como myhost-graceful-unicorn. Defina CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX para o mesmo efeito claude remote-control --remote-control-session-name-prefix dev-box
--replay-user-messages Re-emitir mensagens do usuário de stdin de volta em stdout para confirmação. Requer --input-format stream-json e --output-format stream-json claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages
--restricted Iniciar em modo restrito. Use-o quando um harness de avaliação dirige claude em uma máquina compartilhada e Claude Code não deve executar comandos ou ler configurações de usuário e projeto dessa máquina. Claude Code remove as ferramentas integradas que executam comandos ou código, e WebFetch, a menos que você as nomeie individualmente em --tools, não através do preset default. Também confina as ferramentas de arquivo integradas aos diretórios de trabalho, carrega apenas configurações gerenciadas e --settings, recusa bypassPermissions e recusa criar sessões em nuvem. Requer Claude Code v2.1.248 ou posterior claude --restricted -p "query"
--resume, -r Retomar uma sessão específica por ID ou nome, ou mostrar um seletor interativo para escolher uma sessão. No lugar de um ID, você pode passar o caminho absoluto para o arquivo de transcrição .jsonl de uma sessão. O seletor e a busca por nome incluem sessões que adicionaram este diretório com /add-dir. Quando você passa um ID de sessão, Claude Code pesquisa o diretório do projeto atual e seus git worktrees, depois todos os outros projetos nesta máquina. Antes de v2.1.223, a busca de ID cobria apenas o diretório do projeto atual e seus git worktrees. Sessões de fundo aparecem no seletor marcadas com bg. Retomar uma que ainda está em execução abre essa sessão neste terminal através de claude attach, e um prompt que você passa na linha de comando vai para ela como seu próximo turno. Antes de v2.1.285, Claude Code recusava e imprimia o comando claude attach para executar em vez disso claude --resume auth-refactor
--safe-mode Iniciar com todas as personalizações desativadas para solucionar problemas de uma configuração quebrada: CLAUDE.md, skills, plugins, hooks, servidores MCP, comandos e agentes personalizados, estilos de saída, workflows, temas personalizados, atalhos de teclado personalizados, comandos de linha de status e sugestão de arquivo, servidores LSP e memória automática não carregam. Autenticação, seleção de modelo, ferramentas integradas e permissões funcionam normalmente, o que difere de --bare. A política de configurações gerenciadas ainda se aplica, incluindo hooks configurados por política, linha de status e comandos de sugestão de arquivo; plugins gerenciados, skills gerenciadas, CLAUDE.md gerenciado e servidores MCP configurados por política não. Útil para verificar se uma personalização é o que dispara fallback automático de modelo. Define CLAUDE_CODE_SAFE_MODE claude --safe-mode
--session-id Usar um ID de sessão específico para a conversa (deve ser um UUID válido) claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sources Lista separada por vírgula de fontes de configuração a carregar (user, project, local). Veja agent view e agent teams para as sessões que você inicia a partir desta que herdam a lista claude --setting-sources user,project
--settings Caminho para um arquivo JSON de configurações ou uma string JSON para carregar configurações adicionais. Os valores que você define aqui substituem as mesmas chaves em seus arquivos settings.json para esta sessão. As chaves que você omite mantêm seus valores baseados em arquivo. O arquivo deve ser um arquivo regular com no máximo 2 MiB. Veja precedência de configurações claude --settings ./settings.json
--strict-mcp-config Usar apenas servidores MCP de --mcp-config, ignorando todas as outras configurações de MCP. Veja Controle exclusivo com managed-mcp.json para o que o sinalizador faz sob um arquivo MCP gerenciado claude --strict-mcp-config --mcp-config ./mcp.json
--system-prompt Substituir todo o prompt do sistema por texto personalizado claude --system-prompt "You are a Python expert"
--system-prompt-file Carregar prompt do sistema de um arquivo, substituindo o prompt padrão claude --system-prompt-file ./custom-prompt.txt
--system-prompt-snapshot Passar off para reconstruir o prompt do sistema em cada solicitação em vez de reutilizar o prompt registrado na primeira solicitação da conversa, por exemplo enquanto você itera no texto --append-system-prompt em execuções --continue. Requer Claude Code v2.1.257 ou posterior claude --system-prompt-snapshot off
--teleport Retomar uma sessão na nuvem em seu terminal local claude --teleport
--teammate-mode Definir como equipe de agentes colegas de equipe são exibidos: in-process (padrão), auto, tmux ou iterm2. Substitui a configuração teammateMode para esta sessão. Veja Escolher um modo de exibição claude --teammate-mode auto
--tmux Criar uma sessão tmux para o worktree. Requer --worktree. Usa painéis nativos do iTerm2 quando disponível; passe --tmux=classic para tmux tradicional claude -w feature-auth --tmux
--tools Restringir quais ferramentas integradas Claude pode usar. Use "" para desativar todas, "default" para o conjunto padrão, ou nomes de ferramentas como "Bash,Edit,Read". Em macOS, Linux e WSL, o conjunto padrão deixa de fora Glob e Grep, conforme descrito em Comportamento da ferramenta Glob. Se você nomear uma das ferramentas de rastreamento de tarefas aqui, Claude Code também as habilita na sessão. O sinalizador não afeta ferramentas MCP; para negar essas também, use --disallowedTools "mcp__*". Uma lista que omite EndConversation não a remove; "" a remove apenas quando nenhuma ferramenta MCP permanecer claude --tools "Bash,Edit,Read"
--verbose Ativar logging detalhado, mostra saída completa turno por turno. Substitui a configuração viewMode para esta sessão claude --verbose
--version, -v Exibir o número da versão claude -v
--worktree, -w Iniciar Claude em um git worktree isolado em <repo>/.claude/worktrees/<name>. Se você não der um nome, Claude Code gera um. Passe #<number>, uma URL de pull request do GitHub ou uma URL de merge request do GitLab para buscar esse PR ou MR de origin e ramificar o worktree a partir dele. Ramificar a partir de um merge request do GitLab requer Claude Code v2.1.233 ou posterior claude -w feature-auth

Sinalizadores de prompt do sistema

Claude Code fornece cinco sinalizadores para personalizar o prompt do sistema. Quatro definem seu texto, e com --system-prompt-snapshot você controla se uma conversa mantém o texto com o qual começou. Todos os cinco funcionam em modos interativo e não interativo.

Sinalizador Comportamento Exemplo
--system-prompt Substitui todo o prompt padrão claude --system-prompt "You are a Python expert"
--system-prompt-file Substitui pelo conteúdo do arquivo claude --system-prompt-file ./prompts/review.txt
--append-system-prompt Anexa ao prompt padrão claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Anexa conteúdo do arquivo ao prompt padrão claude --append-system-prompt-file ./style-rules.txt
--system-prompt-snapshot Com off, reconstrói o prompt em cada solicitação. Com on, o padrão, reutiliza um prompt registrado onde o registro se aplica claude --append-system-prompt "Draft rules" --system-prompt-snapshot off

Você pode combinar essas flags. Para substituir o prompt padrão e ainda anexar seu próprio texto, passe --append-system-prompt ou --append-system-prompt-file junto com --system-prompt ou --system-prompt-file. Com Claude Code v2.1.283 ou posterior, você também pode passar uma flag junto com sua própria forma de arquivo, como --append-system-prompt com --append-system-prompt-file, e Claude Code usa ambas.

Por exemplo, execute o seguinte no seu shell para anexar tanto um guia de estilo de um arquivo quanto uma instrução extra:

claude -p --append-system-prompt-file ./style.md --append-system-prompt "Always reply in French" "Summarize README.md"

Claude recebe o system prompt padrão seguido do conteúdo de style.md, uma linha em branco e então Always reply in French. O conteúdo do arquivo vem primeiro mesmo se você passar --append-system-prompt antes de --append-system-prompt-file.

Quando o texto de substituição combina instruções que são as mesmas em cada execução com contexto que muda por execução, adicione uma linha contendo apenas __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ entre as instruções e o contexto. Claude Code divide o prompt na primeira linha assim e remove essa linha, portanto a parte acima dela permanece em cache enquanto a parte abaixo muda. Requer Claude Code v2.1.275 ou posterior. Cache a parte estática de um prompt personalizado lista as configurações onde a divisão se aplica.

Escolha com base em se a identidade padrão do Claude Code ainda se adequa à sua tarefa. Use um sinalizador de anexação quando Claude deve permanecer um assistente de codificação que também segue suas regras extras: instruções por invocação, formatação de saída ou contexto de domínio para um script -p. Anexar preserva a orientação de ferramentas padrão, instruções de segurança e convenções de codificação, portanto você fornece apenas o que difere. Use um sinalizador de substituição quando a superfície, identidade ou modelo de permissão diferir do Claude Code, como um agente não codificador em um pipeline que nenhum humano observa. Substituir descarta todo o prompt padrão, incluindo orientação de ferramentas e instruções de segurança, portanto você assume a responsabilidade por tudo o que sua tarefa ainda precisa.

Para personas persistentes que você pode alternar e compartilhar em um projeto, use estilos de saída. Para convenções de projeto que Claude deve sempre seguir, use CLAUDE.md. O guia do Agent SDK sobre prompts do sistema cobre a mesma decisão com mais profundidade.

Sinalizadores de prompt do sistema em conversas retomadas

Por padrão, Claude Code constrói o prompt do sistema uma vez, na primeira solicitação de uma conversa, com o texto de quaisquer sinalizadores de prompt do sistema aplicados, e o registra na sessão. Até que a conversa seja compactada, cada solicitação posterior usa esse prompt registrado, incluindo depois que você retorna à conversa com --resume ou --continue. Se você passar texto de sinalizador de prompt do sistema diferente, ou nenhum, nesse lançamento posterior, ele entra em vigor uma vez que a conversa é compactada ou quando você inicia uma nova conversa.

Fora de sessões em nuvem, se você iniciar Claude Code em modo bare, passando --bare ou definindo CLAUDE_CODE_SIMPLE=1, o registro permanece desativado a menos que você passe --system-prompt-snapshot on. Antes de v2.1.268, sessões que não buscam sinalizadores de recurso, incluindo sessões no Amazon Bedrock, na Plataforma de Agentes do Google Cloud e no Microsoft Foundry, reconstruíram o prompt em cada solicitação e --system-prompt-snapshot não tinha efeito.

Para reconstruir o prompt em cada solicitação em vez disso, por exemplo enquanto você itera em sua redação em execuções --continue, passe --system-prompt-snapshot off. Antes de v2.1.265, passar qualquer um dos sinalizadores de prompt do sistema também desativava o registro a menos que você passasse --system-prompt-snapshot on.

Veja também