Claude Code: Manual de Referência CLI

Q: P: Diferença entre -p e modo pipeline?

R: -p é abreviação de print mode, saída direta sem interação. Modo pipeline passa input via stdin, também não-interativo.

Q: P: Como resetar toda configuração?

R: Delete o diretório ~/.claude/, reinicie o Claude Code. Restaura padrões.

Q: P: /compact vs /clear ?

R: /compact preserva contexto mas reduz Tokens; /clear recomeça completamente.

Última atualização: 2026-08-31

Este é o guia de referência rápida de comandos do Claude Code — todo comando, parâmetro e comando slash para uso diário.

💡 Dica: Não precisa memorizar tudo. O uso diário só requer claude, claude "instrução" e alguns comandos slash comuns; o resto pode ser consultado.

📋 Pré-requisitos: Capítulo 18 - Sistema de Hooks

1. O Que Você Vai Aprender

Lista completa de parâmetros de lançamento CLI
Referência rápida de comandos slash
Controle e troca de modos
Opções de configuração
Combinações de comandos comuns

2. Parâmetros de Lançamento CLI

(1) Uso Básico

BASH

claude                           # Modo interativo
claude "your instruction"        # Com instrução
echo "instruction" | claude      # Modo pipeline
claude -p "quick query"          # Modo print

(2) Lista Completa de Parâmetros

Parâmetro	Descrição	Exemplo
`-p, --print`	Modo não-interativo	`claude -p "query"`
`--model`	Especificar modelo	`--model claude-opus-4-20250514`
`--resume`	Retomar última sessão	`claude --resume`
`--headless`	Modo sem UI	`claude --headless "task"`
`--output`	Formato de saída	`--output json`
`--style`	Estilo de saída	`--style concise`
`--allowed-tools`	Limitar ferramentas	`--allowed-tools Read,Write`
`--allow-full-auto`	Modo totalmente automático	`--allow-full-auto`
`--mcp-config`	Arquivo de config MCP	`--mcp-config ./mcp.json`
`--no-hooks`	Desabilitar hooks	`--no-hooks`
`--sandbox`	Modo sandbox	`--sandbox`
`--version`	Mostrar versão	`claude --version`
`--help`	Mostrar ajuda	`claude --help`

3. Comandos Slash

(1) Controle de Sessão

Comando	Descrição
`/help`	Mostrar ajuda
`/clear`	Limpar histórico de conversa
`/compact`	Comprimir histórico de conversa
`/cost`	Ver uso de Tokens e custo
`/exit`	Sair do Claude Code

(2) Arquivo e Projeto

Comando	Descrição
`/init`	Inicializar projeto, gerar CLAUDE.md
`/files`	Ver arquivos carregados
`/diff`	Ver alterações de arquivo da sessão atual
`/search <pattern>`	Buscar padrão no projeto

(3) Configuração e Ferramentas

Comando	Descrição
`/model <name>`	Trocar modelo
`/style <name>`	Trocar estilo de saída
`/mcp`	Ver status dos servidores MCP
`/hooks`	Ver configuração de hooks
`/skills`	Listar Skills disponíveis
`/skill <name>`	Executar Skill especificada
`/config`	Ver configuração atual

(4) Integração Git

Comando	Descrição
`/commit`	Commit das alterações atuais
`/undo`	Desfazer última operação

▶ Exemplo 1: Uso de Comandos Slash

TEXT 📖 Somente leitura

> /cost
Token usage: 45,230 / 200,000 (22.6%)
Session cost: $0.91

> /files
Loaded: src/index.ts, src/routes/user.ts, src/services/user.service.ts

> /model claude-opus-4-20250514
Model switched to claude-opus-4-20250514

> /diff
Modified: src/routes/user.ts (+12 -3), src/services/user.service.ts (+28 -0)

4. Controle e Modos

(1) Controles Interativos

Operação	Tecla	Descrição
Enviar instrução	Enter	Enviar input atual
Nova linha	Shift+Enter	Input de múltiplas linhas
Interromper	Ctrl+C	Parar operação atual
Sair	Ctrl+D	Sair do Claude Code
Histórico	↑/↓	Navegar no histórico

(2) Opções de Confirmação de Permissão

Opção	Descrição
`y`	Sim (desta vez)
`n`	Não
`a`	Always (nesta sessão)
`e`	Editar antes de aplicar

5. Localização dos Arquivos de Configuração

Arquivo	Localização	Propósito
`~/.claude/CLAUDE.md`	Global	Preferências pessoais
`~/.claude/settings.json`	Global	Configurações globais
`~/.claude/hooks.json`	Global	Hooks globais
`~/.claude/mcp_settings.json`	Global	Config MCP
`project/CLAUDE.md`	Projeto	Convenções do projeto
`project/.claude/hooks.json`	Projeto	Hooks do projeto
`project/.claudeignore`	Projeto	Excluir arquivos

Variáveis de Ambiente

Variável	Descrição	Exemplo
`ANTHROPIC_API_KEY`	API key	`sk-ant-api03-xxx`
`ANTHROPIC_BASE_URL`	API URL	`https://api.deepseek.com`
`CLAUDE_MODEL`	Modelo padrão	`claude-sonnet-4-20250514`
`CLAUDE_STYLE`	Estilo padrão	`concise`

6. Referência Rápida: Comandos Comuns

BASH

# Desenvolvimento diário
claude                                    # Modo interativo
claude "Fix login bug"                    # Com instrução
claude --resume                            # Retomar sessão

# Automação
claude -p "Review code" --output json     # Pipeline + JSON
claude --headless "Run tests, fix bugs"   # Modo CI

# Controle
claude --allowed-tools Read,Write         # Limitar ferramentas
claude --style concise                    # Saída concisa
claude --model claude-opus-4-20250514     # Trocar modelo

# Na sessão
/cost    # Ver custo
/clear   # Limpar histórico
/diff    # Ver alterações
/commit  # Commit código

❓ Perguntas Frequentes

P: Como verificar a versão do Claude Code? R: claude --version.

P: Diferença entre -p e modo pipeline? R: -p é abreviação de print mode, saída direta sem interação. Modo pipeline passa input via stdin, também não-interativo.

P: Como resetar toda configuração? R: Delete o diretório ~/.claude/, reinicie o Claude Code. Restaura padrões.

P: /compact vs /clear? R: /compact preserva contexto mas reduz Tokens; /clear recomeça completamente.

P: Como listar todas as sessões históricas? R: claude --list-sessions.

📖 Resumo

Parâmetros centrais de lançamento: --model, --resume, --headless, --output
Comandos slash comuns: /cost, /clear, /diff, /commit
Ctrl+C interrompe, Ctrl+D sai
Arquivos de config: global (~/.claude/) e projeto (.claude/)
Variáveis de ambiente controlam API, modelo, estilo

📝 Exercícios

Básico (⭐): Use claude --help para ver todos os parâmetros, experimente 3 novos.
Intermediário (⭐⭐): Use 5 comandos slash diferentes em uma sessão, registre efeitos.
Avançado (⭐⭐⭐): Escreva um Shell script usando claude -p --output json para pipeline automatizado de code review.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós