🔧 Hands-on — Como Usar Cada Repo

Pré-requisito

macOS ou Linux com Homebrew. Se não tiver brew, baixe o binário direto da página de releases.

Setup

brew install rtk

# opcional: alias permanente no shell
echo "alias cargo='rtk cargo'" >> ~/.zshrc
echo "alias pytest='rtk pytest'" >> ~/.zshrc

Sem alias, você precisa prefixar rtk a cada comando. Com alias, vira transparente.

Primeiro uso

# dentro do Claude Code, peça:
"Rode os testes do projeto e me mostre só os que falharam"

# Claude executa:
rtk npm test

Pré-requisito

Claude Code com suporte a marketplace de plugins (versão recente). Teste com claude --version.

Setup

# dentro de uma sessão Claude Code
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode

# verifique que está ativo
/plugin list

Primeiro uso

Você: "Research https://github.com/modelcontextprotocol/servers —
       arquitetura, stack tech, contribuidores, issues abertas."

[Claude usa MCPs pesados; Context Mode intercepta]

Você: /context-mode:ctx-stats

Pré-requisito

Python 3.9+. Repositório em estado estável (idealmente pós-commit). Linguagens suportadas via Tree-sitter: JS/TS, Python, Go, Rust, Java, C/C++.

Setup

pip install code-review-graph

# registra como MCP
code-review-graph install

# indexa o repo (rode na raiz)
code-review-graph build

O build leva 1–3 min em repos médios. Re-rode após mudanças estruturais grandes.

Primeiro uso

Você: "Build the code review graph for this project"
Claude: [carrega o grafo]

Você: "Quais arquivos são afetados se eu mudar
       a assinatura de UserService.updateProfile?"
Claude: [lê apenas os 4 arquivos que chamam updateProfile]

Pré-requisito

uv instalado — instalador Python ultrarrápido da Astral.

curl -LsSf https://astral.sh/uv/install.sh | sh

Setup

Adicione ao ~/.claude.json:

{
  "mcpServers": {
    "token-savior": {
      "command": "uvx",
      "args": ["token-savior-recall"]
    }
  }
}

Primeiro uso

Você: "Find the definition of processPayment function"
Claude: [usa symbol search do Token Savior —
         não lê o arquivo inteiro]

# sessão seguinte (após /clear ou reinicialização)
Você: "Lembra do processPayment que analisamos?"
Claude: [recupera da memória persistente]

Pré-requisito

Claude Code com suporte a plugins marketplace. Nada de Python/Node — é uma skill pura.

Setup

claude plugin marketplace add JuliusBrussee/caveman
claude plugin install caveman@caveman

Primeiro uso

Ative a skill (comando do plugin) e peça qualquer coisa técnica:

Você: "Por que meu componente React re-renderiza?"

Claude normal: "A razão pela qual seu componente está
sofrendo re-renderizações é provavelmente porque você
está criando uma nova referência de objeto a cada
render. Quando você passa um objeto inline como prop,
o React interpreta isso como uma mudança..."

Claude caveman: "Novo ref cada render. Inline obj prop
= novo ref = re-render. Wrap em useMemo."

Pré-requisito

Se você já tem uma CLAUDE.md no projeto, faça backup antes. O comando abaixo sobrescreve.

Setup

# backup primeiro (se tiver algo)
cp CLAUDE.md CLAUDE.md.bak 2>/dev/null

# baixa o template
curl -o CLAUDE.md \
  https://raw.githubusercontent.com/drona23/claude-token-efficient/main/CLAUDE.md

# opcional: mescle com o antigo
cat CLAUDE.md.bak >> CLAUDE.md

Primeiro uso

# dentro do Claude Code
/clear   # recomeça a sessão para carregar nova CLAUDE.md

# pede algo com resposta tipicamente longa
"Revise este componente e aponte problemas"

Pré-requisito

Node 18+ e npm. Espaço em disco para cache (~100MB para sessões longas).

Setup

git clone https://github.com/ooples/token-optimizer-mcp
cd token-optimizer-mcp
npm install
npm run build

# registra como MCP
claude mcp add token-optimizer -- node /caminho/completo/dist/server.js

Primeiro uso

Você: "Busque issues abertas no repo X com label 'bug'"
Claude: [chama tool GitHub — resultado grande]

Você: "Mesma busca, mas com label 'enhancement'"
Claude: [chama tool GitHub; segunda chamada
         com argumentos similares vem do cache]

Pré-requisito

Projeto com documentação inflada: CLAUDE.md > 200 linhas, múltiplos READMEs, pasta /docs grande.

Setup

# na raiz do projeto
curl -fsSL https://raw.githubusercontent.com/nadimtuhin/claude-token-optimizer/main/init.sh | bash

O script reorganiza: 4 arquivos essenciais (~800 tokens) sempre carregam; o resto vira "carregável sob demanda".

Primeiro uso

# antes
/context
# "CLAUDE.md: 11.200 tokens"

# rodar init.sh, depois /clear

# depois
/context
# "CLAUDE.md: 1.300 tokens"

Pré-requisito

Sessão com histórico significativo — idealmente pós-/compact. Ghost tokens aparecem só em contexto maduro.

Setup

/plugin marketplace add alexgreensh/token-optimizer
/plugin install token-optimizer@alexgreensh-token-optimizer

Alternativa via bash: git clone + bash install.sh.

Primeiro uso

# auditoria completa (6 agentes em paralelo)
/token-optimizer

# ou check rápido via Python
python3 measure.py quick

# dashboard live
open http://localhost:24842

Pré-requisito

• • Node.js 20 ou 22 (23 não funciona no momento)
• • Conta Zilliz Cloud (free tier suporta ~1M vetores)
• • Chave OpenAI (para gerar embeddings — custo baixo)

Setup

claude mcp add claude-context \
  -e OPENAI_API_KEY=sk-proj-... \
  -e MILVUS_TOKEN=... \
  -- npx @zilliz/claude-context-mcp@latest

# confirme
claude mcp list

Primeiro uso

Você: "Index this codebase"
Claude: [indexa — pode levar 5–20 min em repo grande]

Você: "Find functions that handle user authentication"
Claude: [retorna 5 arquivos relevantes por similaridade
         semântica, não por grep literal]

Você: "Find code related to rate limiting"
Claude: [encontra middleware mesmo que nunca use
         exatamente a palavra 'rate limit']