--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 (veja abaixo o formato) | 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á-lo 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 (funciona em modos interativo e de impressã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 (apenas modo de impressão) | claude -p --append-system-prompt-file ./extra-rules.txt "query" |
--betas | Cabeçalhos beta para incluir em solicitações de API (apenas usuários com chave de API) | claude --betas interleaved-thinking |
--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-skip-permissions | Pular todos os prompts de permissão (use com cuidado) | 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" |
--fallback-model | Ativar fallback automático para modelo especificado quando o modelo padrão está sobrecarregado (apenas modo de impressão) | 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 de impressão (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 concluir seu fluxo de trabalho (apenas modo de impressão, 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 de impressão) | claude -p --max-budget-usd 5.00 "query" |
--max-turns | Limitar o número de turnos agênticos (apenas modo de impressão). 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 |
--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 de impressão) | claude -p --no-session-persistence "query" |
--output-format | Especificar formato de saída para modo de impressão (opções: text, json, stream-json) | claude -p "query" --output-format json |
--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 diretórios apenas para esta sessão (repetível) | 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" |
--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 para 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 (funciona em modos interativo e de impressão) | claude --system-prompt "You are a Python expert" |
--system-prompt-file | Carregar prompt do sistema de um arquivo, substituindo o prompt padrão (apenas modo de impressão) | claude -p --system-prompt-file ./custom-prompt.txt "query" |
--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 (funciona em modos interativo e de impressão). 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 (útil para depuração em modos de impressão e interativo) | 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 |
