Configurar¶
Después del login, configurá N45 donde lo vas a usar. N45 funciona en dos modos, elegidos en el init:
- Project — un único repositorio (una app, un microservicio, un monorepo).
- Workspace — varios repositorios, polyrepo (un
frontendy unaapiseparados, por ejemplo).
Requisitos previos¶
- Node.js 22 o superior — necesario para correr
npx n45-ai - Git instalado en tu máquina
- Cuenta N45.AI con licencia activa, con login hecho (
npx n45-ai@latest login) - Una de las herramientas soportadas: Claude Code, Cursor o Codex
- Un repositorio git (corré
git initprimero si hace falta)
Corré el comando¶
Desde la carpeta donde lo vas a usar (la raíz de tu repositorio, o la carpeta que agrupa los repositorios):
init primero pregunta qué estás configurando — Project o Workspace. Si la carpeta ya tiene subcarpetas que son repositorios git, N45 detecta un Workspace automáticamente. Luego pregunta qué IDEs usás (Claude Code, Cursor, Codex) e instala las skills.
Project — qué se crea¶
tu-proyecto/
├── .n45/ # lo que N45 necesita (config + docs)
├── CLAUDE.md # si Claude Code está instalado
├── AGENTS.md # si Codex está instalado
├── .cursor/ # si Cursor está instalado
└── .codex/ # si Codex está instalado
| Ítem | Propósito |
|---|---|
~/.n45/bin/ |
El caché del binario de N45 en tu home — descargado en el primer uso, compartido entre proyectos |
.n45/ |
Config y documentos de este proyecto |
CLAUDE.md / AGENTS.md / .cursor/rules/ / .codex/ |
El bloque de instrucciones que tu IDE lee en cada sesión |
¿Y si ya tengo un CLAUDE.md?
N45 inyecta su bloque entre los marcadores <!-- n45:start --> y <!-- n45:end -->. Tu contenido existente se preserva.
Workspace — qué se crea¶
Un .n45/ de coordinación en la carpeta del workspace (el nombre del workspace es el nombre de la carpeta). Al final del init, N45 lista las carpetas git que encontró y ofrece agregarlas como miembros, todas preseleccionadas — solo confirmás. Cada miembro se prepara automáticamente (obtiene su propio .n45/ y las skills).
Podés agregar más miembros en cualquier momento:
npx n45-ai@latest workspace add ./frontend # un repositorio local
npx n45-ai@latest workspace add git@github.com:acme/api.git # clonar desde una URL
El flujo completo del workspace está en Configurar el Workspace.
Verificá la configuración¶
Abrí tu IDE y escribí / en el chat. Deberías ver los slash commands de N45:
/n45— el hub (retoma el trabajo o muestra el estado)/n45-feat— construir una feature/n45-fix— investigar y corregir un bug/n45-status— ver el estado/n45-next— avanzar la ejecución/n45-run— correr la aplicación
Prefijo por herramienta
En Claude Code y Cursor los comandos usan /. En Codex usan $ (ej.: $n45).
Si aparecen, estás listo. Mirá Tu primer /n45.