Uso e controles da CLI

​

Começando

O Claude Code oferece duas maneiras principais de interação:

• Modo interativo: Execute claude para iniciar uma sessão REPL
• Modo único: Use claude -p "consulta" para comandos rápidos

# Iniciar modo interativo
claude

# Iniciar com uma consulta inicial
claude "explique este projeto"

# Executar um único comando e sair
claude -p "o que esta função faz?"

# Processar conteúdo canalizado
cat logs.txt | claude -p "analise estes erros"

​

Comandos CLI

​

Flags CLI

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

​

Detalhes do modo de impressão

A flag -p (ou --print) ativa o modo não interativo no Claude Code, permitindo que você canalize entrada e saída para uso programático. Esta flag suporta vários formatos de saída para diferentes casos de uso.

​

Uso básico

# Modo de impressão básico - exibe apenas o texto da resposta final
claude -p "Explique como usar a flag de impressão"

# Com entrada stdin
echo "Quanto é 2+2?" | claude -p

# Retomar uma sessão no modo de impressão com um prompt
claude -p --resume <session-id> "Retomar sessão com este prompt"

​

Formatos de saída

A opção --output-format (usada com -p) suporta três formatos:

1. Saída de Texto (padrão)

claude -p "Explique os formatos de saída"
# Exibe apenas o texto da resposta

2. Saída JSON

claude -p --output-format json "Explique como usar a saída JSON"

Produz um objeto JSON estruturado:

{
  "cost_usd": 0.003,
  "duration_ms": 1234,
  "duration_api_ms": 800,
  "result": "O texto da resposta aqui...",
  "session_id": "abc123"
}

3. Saída JSON em Streaming

claude -p --output-format stream-json "Crie um script Python"

No modo de streaming, cada mensagem é exibida como um objeto JSON separado conforme é recebida:

• Mensagens de uso de ferramentas
• Mensagens de texto do assistente
• Mensagens de resultado de ferramentas
• Mensagem final do sistema com estatísticas

​

Saída detalhada com modo de impressão

Ao usar --verbose com -p, deve ser combinado com --output-format json ou --output-format stream-json:

claude -p --verbose --output-format json "Depure este código"

No modo JSON detalhado, a saída inclui a transcrição completa da conversa:

[
  {
    "role": "user",
    "content": "Depure este código"
  },
  {
    "role": "assistant",
    "content": "Vou ajudar você a depurar esse código..."
  },
  {
    "role": "system",
    "cost_usd": 0.003,
    "duration_ms": 1234,
    "duration_api_ms": 800,
    "result": "O texto da resposta aqui...",
    "session_id": "abc123"
  }
]

​

Opções adicionais para modo de impressão

Máximo de Turnos

claude -p --max-turns 3 "Corrija este código" < file.py

Limita o número de turnos agênticos no modo não interativo.

Ferramenta de Prompt de Permissão

claude -p --permission-prompt-tool mcp_auth_tool "Criar um arquivo"

Especifica uma ferramenta MCP para lidar com prompts de permissão no modo não interativo.

Retomar Sessão

claude -p --resume abc123 "Retomar sessão com este prompt"

Retoma uma sessão específica por ID no modo de impressão com um novo prompt.

​

Continuar Sessão

claude -c -p "Continuar com esta próxima tarefa"

Continua a última conversa neste projeto.

​

Comandos com barra

Controle o comportamento do Claude durante uma sessão interativa:

​

Atalhos especiais

​

Memória rápida com #

Adicione memórias instantaneamente começando sua entrada com #:

# Sempre use nomes descritivos para variáveis

Você será solicitado a selecionar em qual arquivo de memória armazenar isso.

​

Quebras de linha no terminal

Digite comandos de múltiplas linhas usando:

• Escape rápido: Digite \ seguido de Enter
• Atalho de teclado: Option+Enter (ou Shift+Enter se configurado)

Para configurar Option+Enter em seu terminal:

Para Mac Terminal.app:

1. Abra Configurações → Perfis → Teclado
2. Marque “Usar Option como tecla Meta”

Para iTerm2 e terminal VSCode:

1. Abra Configurações → Perfis → Teclas
2. Em Geral, defina a tecla Option Esquerda/Direita para “Esc+”

Dica para usuários de iTerm2 e VSCode: Execute /terminal-setup dentro do Claude Code para configurar automaticamente Shift+Enter como uma alternativa mais intuitiva.

Veja configuração do terminal nas configurações para detalhes de configuração.

​

Modo Vim

O Claude Code suporta um subconjunto de atalhos do Vim que pode ser ativado com /vim ou configurado via /config.

O subconjunto suportado inclui:

• Alternância de modo: Esc (para NORMAL), i/I, a/A, o/O (para INSERT)
• Navegação: h/j/k/l, w/e/b, 0/$/^, gg/G
• Edição: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (repetir)