English 中文 العربية 日本語 Português

Claude Code: Estilos de Saída

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

Estilos de saída controlam como o Claude Code "fala" — de conciso a verboso, texto simples a JSON, escolher o estilo certo torna a informação mais digerível.

💡 Dica: Estilos de saída não afetam as capacidades do Claude Code, apenas como apresenta resultados. Use default para dev diário, JSON para scripts de automação.

📋 Pré-requisitos: Capítulo 16 - Agent Skills e skill-creator

1. O Que Você Vai Aprender

2. Estilos de Saída Integrados

(1) Lista de Estilos

Estilo Descrição Caso de Uso
default Informação equilibrada Desenvolvimento diário
concise Saída mais compacta Consultas rápidas
verbose Explicações detalhadas Aprendizado/debug
code Focado em código Geração pura de código
plan Planejar antes de executar Tarefas complexas

(2) Troca de Estilo

BASH 
# Linha de comando
claude --style concise
claude --style verbose

# Na sessão
> /style concise
> /style verbose

# No CLAUDE.md
## Output Preferences
- Use concise style
- Show diff for code modifications

▶ Exemplo 1: Comparação de Saída por Estilo

TEXT 📖 Somente leitura 
# Default: informação equilibrada sobre alterações e resultados
# Concise: apenas ✅ Added resetPassword() to user.service.ts, 4 tests, 2 files changed
# Verbose: análise passo-a-passo completa, detalhes de implementação, descrições de testes

3. Formatos de Saída Customizados

(1) Definir no CLAUDE.md

MARKDOWN 
## Output Preferences
- Apenas mostrar diff para mudanças de código, não arquivo completo
- Usar inglês para código, idioma nativo para descrições
- Auto-executar testes após modificação de arquivo
- Mostrar motivo de falha e plano de correção quando testes falham
- Sem necessidade de explicar cada passo (a menos que solicitado)

(2) Controle de Formato em Nível de Tarefa

TEXT 📖 Somente leitura 
> List all TODO comments, output in JSON format
> Compare Express vs Fastify performance, show as table
> Generate API documentation, Markdown format
> Refactor this function, only output modified code

▶ Exemplo 2: Saída Formatada

TEXT 📖 Somente leitura 
> List test coverage for all services under src/services/, show as table

Claude Code:
  | Service | Coverage | Missing |
  |:--------|:---------|:--------|
  | user.service.ts | 92% | delete method |
  | auth.service.ts | 85% | refresh token |
  | payment.service.ts | 0% | **no tests** |

  Average: 64% | Below 80%: 3 services

4. Saída JSON para Scripts

(1) Saída JSON por Linha de Comando

BASH 
claude -p "List all TypeScript errors" --output json

# Estrutura da saída
{
  "task": "list TypeScript errors",
  "result": { "errors": [...], "total": 1 },
  "usage": { "tokens": 15420, "cost_usd": 0.31 }
}

▶ Exemplo 3: Script Automatizado de Code Review

BASH 
#!/bin/bash
# auto-review.sh - Auto-review de mudanças no git

CHANGED_FILES=$(git diff --name-only HEAD~1)

for file in $CHANGED_FILES; do
  RESULT=$(claude -p "Review $file code quality, focus on security" --output json)
  ISSUES=$(echo "$RESULT" | jq '.result.issues | length')
  if [ "$ISSUES" -gt 0 ]; then
    echo "⚠️ Found $ISSUES issues in $file"
  else
    echo "✅ $file looks good"
  fi
done

5. Configuração de Estilo de Saída

(1) Estilo Padrão Global

JSON 
// ~/.claude/settings.json
{
  "output": {
    "defaultStyle": "concise",
    "showDiff": true,
    "language": "en",
    "autoTest": true
  }
}

(2) Troca Dinâmica

TEXT 📖 Somente leitura 
> From now on use verbose style
> /style concise  # Trocar de volta
> This task use JSON output  # Especificação de tarefa única

6. Exemplo Completo: Estratégia de Estilo Multi-Cenário

TEXT 📖 Somente leitura 
# Desenvolvimento diário (default)
claude
> Refactor UserService

# Correção rápida (concise)
claude --style concise
> Fix this typo

# Aprendendo novo projeto (verbose)
claude --style verbose
> Explain this project's architecture

# Scripts de automação (JSON)
claude -p "Code review" --output json | jq '.result'

❓ Perguntas Frequentes

P: Estilos diferentes consomem Tokens diferentes? R: Sim. verbose consome mais, concise menos. A diferença pode ser 2-3x. Uso diário: default ou concise.

P: O formato de saída JSON é estável? R: Na maioria estável mas pode mudar com versões. Adicione tratamento de erros em scripts.

P: Posso customizar templates Markdown? R: Pode descrever requisitos de formato de saída no CLAUDE.md; o Claude Code tentará seguir. Sem sistema de templates rígido.

P: Como fazer a saída mais concisa? R: Use estilo concise + instruções precisas + CLAUDE.md dizendo "não precisa explicar passos".

📖 Resumo

📝 Exercícios

  1. Básico (⭐): Complete a mesma tarefa em três estilos diferentes, compare diferenças de saída.
  2. Intermediário (⭐⭐): Escreva um script simples de code review usando formato de saída JSON.
  3. Avançado (⭐⭐⭐): Desenhe padrões de estilo de saída para equipe no CLAUDE.md para experiência consistente.
Web-Tutorial.com

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.

100%