IA by DNACX

#4 no GitHub · Pacotes prontos

Como usar o ECC no Claude Code: passo a passo

ECC é um pacote grande que dá ao Claude Code um sistema de trabalho: planeja antes de construir, verifica com testes, revisa o próprio trabalho com contexto novo e guarda o que importa. Traz 71 agentes, 314 habilidades e 98 comandos, além de hooks, regras, memória e um verificador de segurança.

Para quem
Quem usa o Claude Code todo dia e quer um pacote completo, com processo pronto. O README recomenda começar pelo fluxo de que você precisa, não pelo catálogo inteiro.
Estrelas (02/11/2026)
295.631, #4 no ranking
Licença
MIT
Repositório
affaan-m/ECC

Passo a passo

Antes de começar: Node.js 18 ou mais novo; Git; Claude Code 2.1 ou mais novo, acessível no terminal (PATH).

  1. Confira os pré-requisitos

    Abra o terminal (no Windows, o PowerShell) e rode os três comandos. Cada um deve mostrar um número de versão. Se algum disser que não encontrou o programa, instale ou conserte esse item antes de continuar.

    Comando
    node --version
git --version
claude --version

  2. Rode o assistente de instalação

    Este comando baixa o pacote ECC pelo npm e abre um assistente no terminal. O README diz que não é preciso clonar o repositório.

    Comando
    npx ecc-universal@2.2.3 setup

  3. Escolha as opções do assistente

    Para um uso pessoal típico, o README manda escolher Global user, depois hooks Standard, e confirmar.

  4. Abra uma sessão nova e confira

    Inicie uma sessão nova do Claude Code e rode o comando abaixo. O plugin ecc@ecc deve aparecer como habilitado.

    Comando
    /plugin list

  5. Peça um plano com o /ecc:plan

    Os comandos do plugin usam o prefixo ecc:. Depois do comando, escreva entre aspas o que você quer construir. O README mostra que isso aciona o agente planejador.

    Comando
    /ecc:plan "Add authentication"

Primeiro teste

Numa sessão do Claude com a skill instalada, cole:

Primeiro teste
/ecc:plan "Add authentication"

Segundo o README, o agente planejador (planner) cria um roteiro de implementação (implementation blueprint).

Cuidados

  • O assistente roda um pacote npm (ecc-universal) no seu computador. O próprio README avisa que fixar a versão não é auditoria de segurança nem checagem de integridade, e pede para revisar o código da versão antes de rodar.
  • O README manda instalar somente pelos canais oficiais (repositório affaan-m/ECC no GitHub, pacotes npm ecc-universal e ecc-agentshield, plugin ecc@ecc, site ecc.tools). Cópias de terceiros podem conter malware.
  • O pacote instala hooks, que são scripts que rodam sozinhos durante as sessões do Claude Code. A escolha Standard é a que o README indica para uso pessoal.
  • Instale por um caminho só. Empilhar métodos (por exemplo, plugin e instalação manual completa) duplica habilidades, comandos e hooks.
  • O pacote é grande. O README traz o comando /context-budget para quando o contexto ficar pesado, e avisa que o recurso Agent Teams gasta tokens em cada colaborador.
  • Há um plano pago opcional (ECC Pro, GitHub App para repositórios privados, a partir de US$ 19 por usuário por mês). Ele não é necessário para a instalação descrita.
  • O comando /astra-review envia o código escrito pelo Claude para a OpenAI (usa o Codex CLI com o login do ChatGPT). Só acontece se você invocar esse comando.

Como desfazer

Rode a partir da mesma pasta usada na instalação. Primeiro a simulação (--dry-run), depois a remoção. Se instalou como plugin, remova também o plugin dentro do Claude Code e apague só as pastas de regras que você copiou à mão e não quer mais.

Desfazer
npx ecc-universal@2.2.3 uninstall --dry-run
npx ecc-universal@2.2.3 uninstall

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • O README mostra /ecc:plan "Add authentication" como exemplo de comando, mas não descreve a saída exata que um leigo verá na tela.
  • O exemplo do /ecc:plan é de desenvolvimento de software. O README não traz exemplo de uso fora de código.
  • O README não detalha o que cada perfil de hooks (Standard e os outros) faz na prática no assistente. Só diz que Standard é o padrão.
  • A versão 2.2.3 é a que o README pede hoje (02/11/2026). Ela pode mudar.

Dúvidas

Posso instalar sem o assistente?

Pode. Dentro do Claude Code, use /plugin marketplace add https://github.com/affaan-m/ECC e depois /plugin install ecc@ecc. O README diz que os dois caminhos instalam o mesmo plugin e que você deve escolher só um.

Por onde começo, com tanta coisa?

O README diz para começar pelo fluxo de que você precisa. Para construir algo novo, o ponto de partida dele é o /ecc:plan com a descrição do que você quer, seguido da habilidade tdd-workflow.

Funciona no Windows?

Sim. O README tem um passo a passo para Windows pelo PowerShell: instalar Node.js, Git e Claude Code, conferir as versões e rodar o mesmo comando npx.

A DNACX já usou o ECC?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próxima da lista

← #3 Matt Pocock Skills · #5 Skills da Anthropic →

Ver as 15 skills

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de affaan-m/ECC, lido em . A DNACX não rodou cada passo desta página. A skill é de terceiros e a DNACX não a criou.