--add-dir | Adicionar diretórios de trabalho adicionais para Claude acessar (valida se cada caminho existe como um diretório) | claude --add-dir ../apps ../lib |
--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. Usa os mesmos nomes de campo que o frontmatter de subagent, mais um campo prompt para as instruções do agente | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allow-dangerously-skip-permissions | Ativar bypass de permissão como uma opção sem ativá-la imediatamente. Permite compor com --permission-mode (use com cuidado) | claude --permission-mode plan --allow-dangerously-skip-permissions |
--allowedTools | 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 | "Bash(git log *)" "Bash(git diff *)" "Read" |
--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 |
--bare | Modo mínimo: pular auto-descoberta de hooks, skills, plugins, servidores MCP, memória automática e CLAUDE.md para que chamadas com script iniciem mais rapidamente. 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 |
--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 Claude.ai | claude --channels plugin:my-notifier@my-marketplace |
--chrome | Ativar integração do navegador Chrome para automação web e testes | claude --chrome |
--continue, -c | Carregar a conversa mais recente no diretório atual | 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 todos os prompts de permissão (use com cuidado). Veja modos de permissão para o que isso faz e não faz | claude --dangerously-skip-permissions |
--debug | Ativar modo de depuração com filtragem de categoria opcional (por exemplo, "api,hooks" ou "!statsig,!file") | claude --debug "api,mcp" |
--disable-slash-commands | Desativar todas as skills e comandos para esta sessão | claude --disable-slash-commands |
--disallowedTools | Ferramentas que são removidas do contexto do modelo e não podem ser usadas | "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, max (apenas Opus 4.6). Escopo de sessão e não persiste nas configurações | claude --effort high |
--fallback-model | Ativar fallback automático para modelo especificado quando o modelo padrão está sobrecarregado (apenas modo print) | claude -p --fallback-model sonnet "query" |
--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 |
--from-pr | Retomar sessões vinculadas a um PR específico do GitHub. Aceita um número de PR ou URL. As sessões são vinculadas automaticamente quando criadas via gh pr create | 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 inicialização e iniciar modo interativo | claude --init |
--init-only | Executar hooks de inicialização e sair (sem sessão interativa) | claude --init-only |
--include-partial-messages | Incluir eventos de streaming parcial na saída (requer --print e --output-format=stream-json) | claude -p --output-format stream-json --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 -p --json-schema '{"type":"object","properties":{...}}' "query" |
--maintenance | Executar hooks de manutenção e sair | claude --maintenance |
--max-budget-usd | Valor máximo em dólares a gastar em chamadas de API antes de parar (apenas modo print) | 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 | claude -p --max-turns 3 "query" |
--mcp-config | Carregar servidores MCP de arquivos JSON ou strings (separados por espaço) | claude --mcp-config ./mcp.json |
--model | Define o modelo para a sessão atual com um alias para o modelo mais recente (sonnet ou opus) ou o nome completo de um modelo | claude --model claude-sonnet-4-6 |
--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) | 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 |
--enable-auto-mode | Desbloquear auto mode no ciclo Shift+Tab. Requer um plano Team (suporte Enterprise e API em breve) e Claude Sonnet 4.6 ou Opus 4.6 | claude --enable-auto-mode |
--permission-mode | Começar em um modo de permissão especificado | claude --permission-mode plan |
--permission-prompt-tool | Especificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativo | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--plugin-dir | Carregar plugins de um diretório apenas para esta sessão. Cada sinalizador leva um caminho. Repita o sinalizador para vários diretórios: --plugin-dir A --plugin-dir B | claude --plugin-dir ./my-plugins |
--print, -p | Imprimir resposta sem modo interativo (veja documentação do Agent SDK para detalhes de uso programático) | claude -p "query" |
--remote | Criar uma nova sessão web em claude.ai com a descrição de tarefa fornecida | 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" |
--resume, -r | Retomar uma sessão específica por ID ou nome, ou mostrar um seletor interativo para escolher uma sessão | claude --resume auth-refactor |
--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) | claude --setting-sources user,project |
--settings | Caminho para um arquivo JSON de configurações ou uma string JSON para carregar configurações adicionais | claude --settings ./settings.json |
--strict-mcp-config | Usar apenas servidores MCP de --mcp-config, ignorando todas as outras configurações de MCP | 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 |
--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: auto (padrão), in-process ou tmux. Veja configurar equipes de agentes | claude --teammate-mode in-process |
--tools | Restringir quais ferramentas integradas Claude pode usar. Use "" para desativar todas, "default" para todas, ou nomes de ferramentas como "Bash,Edit,Read" | claude --tools "Bash,Edit,Read" |
--verbose | Ativar logging detalhado, mostra saída completa turno por turno | 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 nenhum nome for fornecido, um será gerado automaticamente | claude -w feature-auth |
