​
Comandos da CLI

ComandoDescriçãoExemplo
claudeIniciar REPL interativoclaude
claude "consulta"Iniciar REPL com prompt inicialclaude "explique este projeto"
claude -p "consulta"Consultar via SDK, depois sairclaude -p "explique esta função"
cat arquivo | claude -p "consulta"Processar conteúdo canalizadocat logs.txt | claude -p "explique"
claude -cContinuar conversa mais recenteclaude -c
claude -c -p "consulta"Continuar via SDKclaude -c -p "Verificar erros de tipo"
claude -r "<session-id>" "consulta"Retomar sessão por IDclaude -r "abc123" "Finalizar este PR"
claude updateAtualizar para a versão mais recenteclaude update
claude mcpConfigurar servidores do Model Context Protocol (MCP)Veja a documentação do Claude Code MCP.

​
Flags da CLI

Personalize o comportamento do Claude Code com essas flags de linha de comando:
FlagDescriçãoExemplo
--add-dirAdicionar diretórios de trabalho adicionais para o Claude acessar (valida se cada caminho existe como um diretório)claude --add-dir ../apps ../lib
--agentsDefinir subagentes personalizados dinamicamente via JSON (veja abaixo o formato)claude --agents '{"reviewer":{"description":"Revisa código","prompt":"Você é um revisor de código"}}'
--allowedToolsUma lista de ferramentas que devem ser permitidas sem solicitar permissão do usuário, além dos arquivos settings.json"Bash(git log:*)" "Bash(git diff:*)" "Read"
--disallowedToolsUma lista de ferramentas que devem ser proibidas sem solicitar permissão do usuário, além dos arquivos settings.json"Bash(git log:*)" "Bash(git diff:*)" "Edit"
--print, -pImprimir resposta sem modo interativo (veja a documentação do SDK para detalhes de uso programático)claude -p "consulta"
--append-system-promptAnexar ao prompt do sistema (apenas com --print)claude --append-system-prompt "Instrução personalizada"
--output-formatEspecificar formato de saída para modo de impressão (opções: text, json, stream-json)claude -p "consulta" --output-format json
--input-formatEspecificar formato de entrada para modo de impressão (opções: text, stream-json)claude -p --output-format json --input-format stream-json
--include-partial-messagesIncluir eventos de streaming parciais na saída (requer --print e --output-format=stream-json)claude -p --output-format stream-json --include-partial-messages "consulta"
--verboseHabilitar logging verboso, mostra saída completa turno por turno (útil para depuração em modos de impressão e interativo)claude --verbose
--max-turnsLimitar o número de turnos agênticos em modo não interativoclaude -p --max-turns 3 "consulta"
--modelDefine o modelo para a sessão atual com um alias para o modelo mais recente (sonnet ou opus) ou o nome completo de um modeloclaude --model claude-sonnet-4-5-20250929
--permission-modeComeçar em um modo de permissão especificadoclaude --permission-mode plan
--permission-prompt-toolEspecificar uma ferramenta MCP para lidar com prompts de permissão em modo não interativoclaude -p --permission-prompt-tool mcp_auth_tool "consulta"
--resumeRetomar uma sessão específica por ID, ou escolhendo em modo interativoclaude --resume abc123 "consulta"
--continueCarregar a conversa mais recente no diretório atualclaude --continue
--dangerously-skip-permissionsPular prompts de permissão (use com cautela)claude --dangerously-skip-permissions
A flag --output-format json é particularmente útil para scripts e automação, permitindo que você analise as respostas do Claude programaticamente.

​
Formato da flag agents

A flag --agents aceita um objeto JSON que define um ou mais subagentes personalizados. Cada subagente requer um nome único (como a chave) e um objeto de definição com os seguintes campos:
CampoObrigatórioDescrição
descriptionSimDescrição em linguagem natural de quando o subagente deve ser invocado
promptSimO prompt do sistema que orienta o comportamento do subagente
toolsNãoArray de ferramentas específicas que o subagente pode usar (ex.: ["Read", "Edit", "Bash"]). Se omitido, herda todas as ferramentas
modelNãoAlias do modelo a usar: sonnet, opus, ou haiku. Se omitido, usa o modelo padrão do subagente
Exemplo: 
claude --agents '{
  "code-reviewer": {
    "description": "Revisor de código especialista. Use proativamente após mudanças no código.",
    "prompt": "Você é um revisor de código sênior. Foque na qualidade do código, segurança e melhores práticas.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Especialista em depuração para erros e falhas de teste.",
    "prompt": "Você é um especialista em depuração. Analise erros, identifique causas raiz e forneça correções."
  }
}'
Para mais detalhes sobre criação e uso de subagentes, veja a documentação de subagentes. Para informações detalhadas sobre o modo de impressão (-p) incluindo formatos de saída, streaming, logging verboso e uso programático, veja a documentação do SDK.

​
Veja também