​
Primeiros passos

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

  • Modo interativo: Execute claude para iniciar uma sessão REPL
  • Modo de uso ú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

ComandoDescriçãoExemplo
claudeIniciar REPL interativoclaude
claude "consulta"Iniciar REPL com prompt inicialclaude "explique este projeto"
claude -p "consulta"Executar consulta única e sairclaude -p "explique esta função"
cat arquivo | claude -p "consulta"Processar conteúdo canalizadocat logs.txt | claude -p "explique"
claude -cContinuar a conversa mais recenteclaude -c
claude -c -p "consulta"Continuar no modo de impressãoclaude -c -p "Verifique erros de tipo"
claude -r "<session-id>" "consulta"Retomar sessão por IDclaude -r "abc123" "Finalize este PR"
claude updateAtualizar para a versão mais recenteclaude update
claude mcpConfigurar servidores de Protocolo de Contexto de ModeloVeja a seção MCP nos tutoriais

​
Flags CLI

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

FlagDescriçãoExemplo
--add-dirAdicionar diretórios de trabalho adicionais para o Claude acessar (valida se cada caminho existe como diretório)claude --add-dir ../apps ../lib
--allowedToolsUma lista de ferramentas que devem ser permitidas sem solicitar permissão ao usuário, além dos arquivos settings.json"Bash(git log:*)" "Bash(git diff:*)" "Write"
--disallowedToolsUma lista de ferramentas que devem ser proibidas sem solicitar permissão ao usuário, além dos arquivos settings.json"Bash(git log:*)" "Bash(git diff:*)" "Write"
--print, -pImprimir resposta sem modo interativo (veja a documentação do SDK para detalhes de uso programático)claude -p "consulta"
--output-formatEspecificar formato de saída para o modo de impressão (opções: text, json, stream-json)claude -p "consulta" --output-format json
--verboseAtivar registro detalhado, mostra saída completa turno a turno (útil para depuração em modos de impressão e interativo)claude --verbose
--max-turnsLimitar o número de turnos agênticos no 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-20250514
--permission-prompt-toolEspecificar uma ferramenta MCP para lidar com solicitações de permissão no modo não interativoclaude -p --permission-prompt-tool mcp_auth_tool "consulta"
--resumeRetomar uma sessão específica por ID, ou escolhendo no modo interativoclaude --resume abc123 "consulta"
--continueCarregar a conversa mais recente no diretório atualclaude --continue
--dangerously-skip-permissionsPular solicitações de permissão (use com cautela)claude --dangerously-skip-permissions

A flag --output-format json é particularmente útil para scripts e automação, permitindo analisar as respostas do Claude programaticamente.

Para informações detalhadas sobre o modo de impressão (-p), incluindo formatos de saída, streaming, registro detalhado e uso programático, consulte a documentação do SDK.

​
Comandos com barra

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

ComandoFinalidade
/bugRelatar bugs (envia a conversa para a Anthropic)
/clearLimpar histórico de conversa
/compact [instruções]Compactar conversa com instruções de foco opcionais
/configVisualizar/modificar configuração
/costMostrar estatísticas de uso de tokens
/doctorVerifica a saúde da sua instalação do Claude Code
/helpObter ajuda de uso
/initInicializar projeto com guia CLAUDE.md
/loginAlternar contas da Anthropic
/logoutSair da sua conta Anthropic
/memoryEditar arquivos de memória CLAUDE.md
/modelSelecionar ou alterar o modelo de IA
/permissionsVisualizar ou atualizar permissões
/pr_commentsVisualizar comentários de pull request
/reviewSolicitar revisão de código
/statusVisualizar status da conta e do sistema
/terminal-setupInstalar vinculação de tecla Shift+Enter para novas linhas (apenas iTerm2 e VSCode)
/vimEntrar no modo vim para alternar entre modos de inserção e comando

​
Atalhos especiais

​
Memória rápida com #

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

# Sempre use nomes de variáveis descritivos

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

​
Quebras de linha no terminal

Insira 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 em configurações para detalhes de configuração.

​
Modo Vim

O Claude Code suporta um subconjunto de atalhos do Vim que podem ser habilitados com /vim ou configurados 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)