gh-wasabeef-claude-code-cookbook-plugins-pt/commands/token-efficient.md

Modo Eficiência de Tokens

Reduz o uso de contexto nas respostas da IA em 30-50% através do modo de eficiência por compressão.

Visão Geral

O Modo Eficiência de Tokens utiliza sistemas de símbolos visuais e abreviações para comprimir as respostas do Claude. A qualidade do código gerado e o conteúdo permanecem inalterados. Apenas o método de explicação é alterado.

Como Usar

# Ativar modo
"Responda no Modo Eficiência de Tokens"
"--uc mode"
"Modo conciso"

Como Funciona

1. Sistema de Símbolos

Lógica e Fluxo

Símbolo	Significado	Exemplo
→	leva a, causa	auth.js:45 → 🛡️ risco de segurança
⇒	converte para	entrada ⇒ saida_validada
←	reversão, voltar	migration ← rollback
⇄	bidirecional	sync ⇄ remoto
&	e, combinar	🛡️ segurança & ⚡ performance
|	ou, separador	react|vue|angular
:	definir, especificar	escopo: arquivo|módulo
»	então, sequência	build » test » deploy
∴	portanto	testes ❌ ∴ código quebrado
∵	porque	lento ∵ algoritmo O(n²)

Status e Progresso

Símbolo	Significado	Uso
✅	completo, sucesso	Tarefa concluída normalmente
❌	falhou, erro	Ação imediata necessária
⚠️	aviso	Revisão recomendada
🔄	em andamento	Atualmente ativo
⏳	pendente	Agendado para depois
🚨	urgente, crítico	Alta prioridade

Domínios Técnicos

Símbolo	Domínio	Uso
⚡	Performance	Velocidade, otimização
🔍	Análise	Busca, investigação
🔧	Configuração	Setup, ferramentas
🛡️	Segurança	Proteção, segurança
📦	Deploy	Pacote, bundle
🎨	Design	UI, frontend
🏗️	Arquitetura	Estrutura do sistema
🗄️	Banco de Dados	Persistência de dados
⚙️	Backend	Processamento do servidor
🧪	Testes	Garantia de qualidade

2. Sistema de Abreviações

Sistema e Arquitetura

• cfg → configuração
• impl → implementação
• arq → arquitetura
• perf → performance
• ops → operações
• env → ambiente

Processo de Desenvolvimento

• req → requisitos
• deps → dependências
• val → validação
• auth → autenticação
• docs → documentação
• std → padrões

Qualidade e Análise

• qual → qualidade
• seg → segurança
• err → erro
• rec → recuperação
• sev → severidade
• opt → otimização

Exemplos de Comparação

Exemplo 1: Relatório de Erro

Modo Normal (95 caracteres)

Vulnerabilidade de segurança encontrada na função de validação do usuário na linha 45 do sistema auth.

Token Eficiente (44 caracteres)

auth.js:45 → 🛡️ vuln seg na val() usuário

Exemplo 2: Status de Build

Modo Normal (118 caracteres)

Processo de build foi concluído com sucesso. Testes estão sendo executados atualmente, seguidos pelo deploy.

Token Eficiente (38 caracteres)

build ✅ » teste 🔄 » deploy ⏳

Exemplo 3: Análise de Performance

Modo Normal (105 caracteres)

Análise de performance revelou processamento lento devido à complexidade do algoritmo O(n²).

Token Eficiente (46 caracteres)

⚡ perf: lento ∵ O(n²) → otimizar para O(n)

Casos de Uso

✅ Cenários Efetivos

• Sessões longas de debug: Manter histórico eficientemente
• Revisões grandes de código: Análise concisa de muitos arquivos
• Monitoramento CI/CD: Atualizações de status em tempo real
• Relatórios de progresso de projeto: Visão geral de múltiplos estados de tarefa
• Rastreamento de erros: Representação visual de cadeias de problemas

❌ Cenários a Evitar

• Explicações para iniciantes
• Criação de documentação detalhada
• Definição de requisitos iniciais
• Comunicação com stakeholders não-técnicos

Exemplos de Implementação

Sessão de Debug

[14:23] breakpoint → vars: {user: null, token: expirado}
[14:24] step → auth.validate() ❌
[14:25] check → token.exp < Date.now() ∴ expirado
[14:26] fix → refresh() → ✅
[14:27] continue → fluxo principal 🔄

Resultados de Análise de Arquivos

/src/auth/: 🛡️ problemas × 3
/src/api/: ⚡ gargalo no handler()
/src/db/: ✅ limpo
/src/utils/: ⚠️ métodos deprecated
/tests/: 🧪 cobertura 78%

Status do Projeto

Frontend: 🎨 ✅ 100%
Backend: ⚙️ 🔄 75%
Database: 🗄️ ✅ migrado
Testes: 🧪 ⚠️ 68% (meta: 80%)
Deploy: 📦 ⏳ agendado
Segurança: 🛡️ 🚨 1 crítico

Opções de Configuração

// Níveis de compressão
--uc; // Ultra Comprimido: Máxima compressão
--mc; // Moderadamente Comprimido: Compressão média
--lc; // Levemente Comprimido: Compressão leve

// Específico do domínio
--dev; // Compressão focada em desenvolvimento
--ops; // Compressão focada em operações
--seg; // Compressão focada em segurança

Benefícios

1. Economia de contexto: Redução de 30-50% nos tokens
2. Compreensão visual: Compreensão intuitiva através de símbolos
3. Densidade de informação: Mais informação no mesmo espaço
4. Retenção de histórico: Manter conversas mais longas no histórico
5. Reconhecimento de padrões: Detecção mais fácil de problemas através de padrões visuais

Observações

• Este modo apenas muda o estilo de resposta da IA
• Qualidade do código permanece inalterada
• Pode alternar com "explicar no modo normal" conforme necessário
• Modo normal recomendado para iniciantes e usuários não-técnicos

Exemplos de Comandos

# Ativar
"Modo Eficiência de Tokens ligado"
"Responder de forma concisa"
"Analisar com --uc"

# Desativar
"Voltar ao modo normal"
"Explicar em detalhes"
"Modo Eficiência de Tokens desligado"

Impacto da Implementação

Item	Impacto
Qualidade do código gerado	Sem mudança ✅
Precisão da implementação	Sem mudança ✅
Funcionalidade	Sem mudança ✅
Método de explicação da IA	Comprimido 🔄
Uso de contexto	Redução de 30-50% ⚡

---

💡 Dica Pro: Para sessões de trabalho longas, comece com o modo normal para construir entendimento, depois mude para o Modo Eficiência de Tokens para otimizar a eficiência e retenção de contexto.