Referência
Referência da CLI
Referência
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:*)" "Write" |
--disallowedTools | Uma lista de ferramentas que devem ser negadas sem solicitar permissão do usuário, além dos arquivos settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Write" |
--print, -p | Imprimir resposta sem modo interativo (veja a documentação do SDK para detalhes de uso programático) | claude -p "consulta" |
--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 |
--verbose | Habilitar log detalhado, 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-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, log detalhado 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