Claude Code Setup PT-BR

Curadoria e instalacao automatizada das melhores ferramentas open source para Claude Code. Um comando instala tudo. Focado na comunidade brasileira de desenvolvimento.

Aviso: Este projeto e uma curadoria e script de automacao de instalacao. Nao somos afiliados a Anthropic nem aos projetos incluidos. Todo o credito vai para os autores originais — veja CREDITS.md.

---

Por que este projeto existe?

Configurar o Claude Code com todas as melhores ferramentas da comunidade leva horas de pesquisa e instalacao manual. Este projeto resolve isso com um unico comando, documentacao completa em PT-BR e curadoria das ferramentas mais impactantes.

O que este projeto oferece:

• Script de instalacao automatica (Windows + Linux + macOS)
• Documentacao completa em portugues de cada ferramenta
• Curadoria das ferramentas com maior impacto real no workflow
• Guia de uso de agentes e comandos com exemplos praticos

---

Estatisticas das ferramentas incluidas

Ferramenta	Stars	Forks	O que faz
GSD	⭐ 53k+	🍴 4.5k	Workflow spec-driven, previne context rot
SuperClaude	⭐ 20k+	🍴 2k	31 comandos + 20 agentes especializados
repomix	⭐ 20k+	🍴 1k	Empacota codebase para IA, economiza tokens
task-master	⭐ 20k+	🍴 2k	Gerenciamento de tarefas com IA
claude-squad	⭐ 8k+	🍴 500	Multi-agente paralelo com tmux
ccusage	⭐ 3k+	🍴 200	Dashboard de consumo de tokens
context7 MCP	⭐ 15k+	🍴 800	Docs atualizadas em tempo real
MCP Servers	⭐ 14k+	🍴 1.5k	Sequential thinking + filesystem

Total de stars curadas: ~153k+ — o melhor do ecossistema Claude Code em um lugar so.

---

Instalacao — 1 comando

Pre-requisitos: Node.js 18+ · Python 3.10+ · git · Claude Code CLI

git clone https://github.com/FalvesDev/ultimate-claude-setup.git
cd ultimate-claude-setup

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -File setup.ps1

Linux / macOS / WSL2:

chmod +x setup.sh && ./setup.sh

Reinicie o Claude Code apos a instalacao. Pronto.

---

O que e instalado automaticamente

GSD — Get Shit Done

github.com/gsd-build/get-shit-done · ⭐ 53k+

O sistema mais importante do setup. Resolve o maior problema do Claude Code: context rot — degradacao da qualidade conforme o contexto enche. Divide o trabalho em fases com contexto fresco a cada execucao.

Instala automaticamente 8 hooks, 73 skills e statusline customizada.

/gsd-new-project        → cria PROJECT.md, REQUIREMENTS.md, ROADMAP.md
/gsd-plan-phase 1       → pesquisa + plano detalhado
/gsd-execute-phase 1    → executa em ondas paralelas
/gsd-verify-work 1      → verifica contra os objetivos
/gsd-ship 1             → cria PR
/gsd-quick "tarefa"     → tarefa rapida sem overhead

---

SuperClaude Framework

github.com/SuperClaude-Org/SuperClaude_Framework · ⭐ 20k+

Adiciona 31 comandos /sc: e 20 agentes especializados ao Claude Code.

Comandos:

/sc:implement "adicionar autenticacao JWT"
/sc:research  "melhores praticas para rate limiting"
/sc:analyze   src/auth/middleware.ts
/sc:test      src/services/userService.ts
/sc:troubleshoot "erro 500 no login OAuth"
/sc:design    "arquitetura de microservicos"
/sc:document  src/api/

Agentes — use com @nome:

@backend-architect     @frontend-architect    @security-engineer
@performance-engineer  @quality-engineer      @devops-architect
@python-expert         @refactoring-expert    @root-cause-analyst
@technical-writer      @deep-research-agent   @system-architect
@socratic-mentor       @requirements-analyst  @self-review

---

claude-squad — Multi-agente paralelo

github.com/smtg-ai/claude-squad · ⭐ 8k+

Gerencia multiplas instancias do Claude Code ao mesmo tempo, cada uma com workspace git isolado.

Windows: requer WSL2 (wsl --install no PowerShell Admin + restart). O script detecta e instala automaticamente.

cs   # abre o painel

# Atalhos:
# n        → nova sessao
# j/k ↑↓  → navegar
# Enter    → entrar na sessao
# s        → commit + push
# D        → deletar

Exemplo — 3 agentes em paralelo:

→ n → "backend"  → "CRUD de usuarios com FastAPI"
→ n → "frontend" → "tela de usuarios com Next.js"
→ n → "tests"    → "testes para a API de usuarios"
# Todos rodam ao mesmo tempo!

---

repomix

github.com/yamadashy/repomix · ⭐ 20k+

Empacota toda a codebase num arquivo otimizado para IA. Reduz drasticamente o uso de tokens.

npx repomix                          # projeto inteiro
npx repomix --include "src/**/*.ts"  # so o que importa
npx repomix --compress               # ainda menor

---

MCP Servers

context7 — docs sempre atualizadas:

"como usar App Router do Next.js 15? use context7"

sequential-thinking — ativa automaticamente em tarefas complexas.

Adicionar mais MCPs quando precisar:

claude mcp add github   -- npx -y "@modelcontextprotocol/server-github"
claude mcp add postgres -- npx -y "@modelcontextprotocol/server-postgres" "postgresql://..."
claude mcp list

---

Dicas para economizar tokens

Tecnica	Economia estimada	Como usar
repomix	40-60% em contexto	npx repomix antes de iniciar
context7 MCP	Elimina docs de memoria	Adicione use context7 no prompt
GSD wave execution	30-50% em sessoes longas	Usar /gsd-execute-phase
/gsd-quick	Sem overhead de planejamento	Tarefas simples e rapidas
CLAUDE.md por projeto	Claude nao precisa perguntar	Arquivo na raiz do projeto

---

CLAUDE.md — template para seu projeto

Crie na raiz de cada projeto. Claude le automaticamente a cada sessao:

# Nome do Projeto

## Stack
- Backend: FastAPI + PostgreSQL
- Frontend: Next.js 15 + Tailwind
- Deploy: Railway + Vercel

## Comandos
- `npm run dev`   → dev server
- `npm test`      → testes
- `npm run lint`  → lint + format

## Convencoes
- Commits em ingles: feat/fix/docs/refactor
- camelCase para variaveis, UPPER_SNAKE para constantes
- Testes obrigatorios para nova logica de negocio

---

Estrutura apos o setup

~/.claude/
├── settings.json      # hooks GSD + statusline
├── CLAUDE.md          # instrucoes globais
├── commands/sc/       # 31 comandos SuperClaude
├── agents/            # 20 agentes SuperClaude + GSD
├── skills/            # 73 skills GSD
├── hooks/             # 8 hooks GSD (context monitor, guards, etc.)
└── memory/            # auto-memoria do Claude Code
~/.claude.json         # MCP servers (context7, sequential-thinking, filesystem)

---

Atualizando

# GSD
npx get-shit-done-cc@latest --claude --global

# SuperClaude (Windows)
pip install --upgrade superclaude
$env:PYTHONIOENCODING='utf-8'; superclaude install

# SuperClaude (Linux/Mac)
pip install --upgrade superclaude
PYTHONIOENCODING=utf-8 superclaude install

---

Contribuindo

Encontrou uma ferramenta que deveria estar aqui? Abra uma issue ou PR!

Por favor inclua:

• Link do repositorio original
• O que a ferramenta faz e por que merece estar no setup
• Como instalar

---

Creditos

Todo o credito vai para os criadores das ferramentas originais. Veja CREDITS.md para a lista completa com links.

---

Documentacao

• docs/ultimate-claude.md — guia completo de uso de todos os comandos e agentes
• docs/INSTALL_LOG.md — referencia tecnica da instalacao

Este projeto contribui com: scripts de automacao, curadoria, documentacao em PT-BR.

---

Licenca

MIT — use, modifique e distribua livremente. Veja LICENSE.