--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. 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 ativa a 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, 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 web. 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 channels que não estão na lista de permissões aprovada, para desenvolvimento local. Aceita entradas plugin:<name>@<marketplace> e server:<name>. Solicita confirmação | 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='!1p'. 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 |
--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 subagent 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 subagent. Sem este sinalizador, Claude Code omite os blocos de texto e pensamento de um subagent que é executado em primeiro plano. Requer --print e --output-format stream-json. Claude Code também encaminha mensagens de subagents aninhados, definindo parent_tool_use_id para o ID da chamada da ferramenta Agent ou Skill que gerou cada um; isso requer Claude Code v2.1.219 ou posterior, e mensagens de subagents que uma skill bifurcada gera, e de skills bifurcadas aninhadas, requerem v2.1.275 ou posterior. 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 | Valor máximo em dólares a gastar em chamadas de API antes de parar (apenas modo print). Gastos de subagents contam para o limite. Quando você retorna a uma conversa com --continue ou --resume, totais restaurados de execuções anteriores não contam para isso. Uma vez que o gasto atinge o limite, gerar outro subagent falha com Budget limit reached, e Claude Code para subagents de fundo que ainda estão em execução; os comportamentos de aplicação de 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 tempo limite 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. 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>. Em uma sessão interativa, se outra sessão ativa nesta máquina já usar o nome, Claude Code aplica uma variante dele em vez disso.
/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. Para -p, isso é default quando nada está configurado | claude --permission-mode plan |
--permission-prompt-tool | Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo. Claude Code aguarda a conexão do servidor MCP dessa ferramenta antes de executar o primeiro turno, até o tempo limite 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 --permission-prompt-tool mcp_auth_tool "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 documentação do Agent SDK para detalhes de uso programático) | 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 | 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 web 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 ativa a 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 |
