Configurar¶

Depois do login, configure o N45 onde você vai usar. O N45 funciona em dois modos, escolhidos no init:

Project — um único repositório (um app, um microsserviço, um monorepo).
Workspace — vários repositórios, polyrepo (um frontend e uma api separados, por exemplo).

Pré-requisitos¶

Node.js 22 ou superior — necessário pra rodar npx n45-ai
Git instalado na sua máquina
Conta N45.AI com licença ativa e logada (npx n45-ai@latest login)
Uma das ferramentas suportadas: Claude Code, Cursor ou Codex
Um repositório git (rode git init primeiro se necessário)

Rode o comando¶

Da pasta onde você vai usar (a raiz do repositório, ou a pasta que agrupa os repositórios):

cd /caminho/do/seu/projeto
npx n45-ai@latest init

O init primeiro pergunta o que você está configurando — Project ou Workspace. Se a pasta já tem subpastas que são repositórios git, o N45 detecta um Workspace automaticamente. Depois ele pergunta quais IDEs você usa (Claude Code, Cursor, Codex) e instala as skills.

Project — o que é criado¶

seu-projeto/
├── .n45/              # o que o N45 precisa (config + docs)
├── CLAUDE.md          # se Claude Code está instalado
├── AGENTS.md          # se Codex está instalado
├── .cursor/           # se Cursor está instalado
└── .codex/            # se Codex está instalado

Item	Propósito
`~/.n45/bin/`	Cache do binário do N45 na sua home — baixado no primeiro uso, compartilhado entre projetos
`.n45/`	Config e documentos deste projeto
`CLAUDE.md` / `AGENTS.md` / `.cursor/rules/` / `.codex/`	Bloco de instruções que a IDE lê em toda sessão

E se eu já tiver um CLAUDE.md?

O N45 injeta o bloco dele entre os marcadores  e . Seu conteúdo existente é preservado.

Workspace — o que é criado¶

Um .n45/ de coordenação na pasta do workspace (o nome do workspace é o nome da pasta). No fim do init, o N45 lista as pastas git que encontrou e oferece adicioná-las como membros, todas pré-selecionadas — é só confirmar. Cada membro é preparado automaticamente (ganha o próprio .n45/ e as skills).

Você adiciona mais membros a qualquer momento:

npx n45-ai@latest workspace add ./frontend          # um repositório local
npx n45-ai@latest workspace add git@github.com:acme/api.git   # clonar de uma URL

O fluxo completo do workspace está em Configurar o Workspace.

Verifique a configuração¶

Abra sua IDE e digite / no chat. Você deve ver os slash commands do N45:

/n45 — o hub (retoma o trabalho ou mostra o estado)
/n45-feat — construir uma feature
/n45-fix — investigar e corrigir um bug
/n45-status — ver o estado
/n45-next — avançar a execução
/n45-run — rodar a aplicação

Prefixo por ferramenta

No Claude Code e no Cursor os comandos usam /. No Codex usam $ (ex.: $n45).

Se aparecerem, está pronto. Veja Seu primeiro /n45.