Referência da CLI

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

Comandos da CLI

Comando	Descrição	Exemplo
claude	Iniciar REPL interativo	claude
claude "consulta"	Iniciar REPL com prompt inicial	claude "explique este projeto"
claude -p "consulta"	Consultar via SDK, depois sair	claude -p "explique esta função"
cat arquivo | claude -p "consulta"	Processar conteúdo canalizado	cat logs.txt | claude -p "explique"
claude -c	Continuar conversa mais recente	claude -c
claude -c -p "consulta"	Continuar via SDK	claude -c -p "Verificar erros de tipo"
claude -r "<session-id>" "consulta"	Retomar sessão por ID	claude -r "abc123" "Finalizar este PR"
claude update	Atualizar para a versão mais recente	claude update
claude mcp	Configurar servidores do Model Context Protocol (MCP)	Veja a documentação do Claude Code MCP.

Flags da CLI

Personalize o comportamento do Claude Code com estas flags de linha de comando:

Flag	Descrição	Exemplo
--add-dir	Adicionar diretórios de trabalho adicionais para o Claude acessar (valida se cada caminho existe como um diretório)	claude --add-dir ../apps ../lib
--allowedTools	Uma 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"
--disallowedTools	Uma 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, -p	Imprimir resposta sem modo interativo (veja a documentação do SDK para detalhes de uso programático)	claude -p "consulta"
--append-system-prompt	Anexar ao prompt do sistema (apenas com --print)	claude --append-system-prompt "Instrução personalizada"
--output-format	Especificar formato de saída para modo de impressão (opções: text, json, stream-json)	claude -p "consulta" --output-format json
--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
--include-partial-messages	Incluir eventos de streaming parciais na saída (requer --print e --output-format=stream-json)	claude -p --output-format stream-json --include-partial-messages "consulta"
--verbose	Habilitar logging verboso, mostra saída completa turno por turno (útil para depuração em modos de impressão e interativo)	claude --verbose
--max-turns	Limitar o número de turnos agênticos em modo não interativo	claude -p --max-turns 3 "consulta"
--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-20250514
--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 "consulta"
--resume	Retomar uma sessão específica por ID, ou escolhendo em modo interativo	claude --resume abc123 "consulta"
--continue	Carregar a conversa mais recente no diretório atual	claude --continue
--dangerously-skip-permissions	Pular 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.

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

• Modo interativo - Atalhos, modos de entrada e recursos interativos
• Comandos slash - Comandos de sessão interativa
• Guia de início rápido - Começando com o Claude Code
• Fluxos de trabalho comuns - Fluxos de trabalho e padrões avançados
• Configurações - Opções de configuração
• Documentação do SDK - Uso programático e integrações