Ninjō · Onboarding

Empezá a operar Cortex con Claude Code

Mini-guía para dejar tu compu lista en ~20 minutos: instalás Claude Code, descargás el repositorio de Cortex y empezás a armar reportes de contenido como lo hacemos en el equipo.

PLATAFORMA · macOS NIVEL · principiante TIEMPO · ~20 min

Antes de arrancar — checklist

Pedíselo a Lolo / al admin Tres cosas que necesitás tener antes del Paso 2, porque dependen de accesos:
  • Una cuenta de Claude (Pro/Max o Team) para loguear Claude Code.
  • Tu usuario de GitHub invitado a la organización ninjo-ai con acceso al repo cortex (el repo es privado).
  • El archivo .env de Cortex (tiene las credenciales para leer la data). Lolo te lo pasa por un canal seguro — no está en GitHub.

Los pasos

1

Instalá Claude Code

Abrí la app Terminal (Cmd+Espacio → escribí "Terminal" → Enter) y pegá este comando:

curl -fsSL https://claude.ai/install.sh | bash

Cuando termine, cerrá la ventana de Terminal por completo y abrila de nuevo (no solo una pestaña). Verificá que quedó instalado:

claude --version

Si te muestra un número de versión, listo. No necesitás instalar nada más (ni Node, ni configuraciones).

Si dice "command not found: claude" Cerrá Terminal del todo y volvé a abrirlo. Si sigue, reiniciá la Mac — el instalador agrega claude al PATH y a veces necesita el reinicio para tomarlo.
2

Logueate la primera vez

Escribí claude y Enter:

claude

Se te va a abrir el navegador con la pantalla de login de Claude. Entrá con la cuenta que te pasaron y volvé a la Terminal: ya quedás logueado (la sesión se guarda, no lo hacés de nuevo).

Tip Si el navegador no abre solo, apretá c en la Terminal para copiar el link de login y pegalo a mano en el navegador.

Por ahora salí de Claude para hacer el Paso 3: escribí exit o apretá Ctrl+D.

3

Descargá el repositorio de Cortex

Cortex es la carpeta donde vive todo el conocimiento y los agentes de Ninjō. Vas a bajar una copia a tu compu. La forma más simple, sin terminal:

Opción recomendada · GitHub Desktop 1. Descargá GitHub Desktop desde desktop.github.com e instalalo.
2. Abrilo e iniciá sesión con tu cuenta de GitHub (la que invitaron a ninjo-ai).
3. Menú File → Clone repository → pestaña GitHub.com → buscá ninjo-ai/cortex → elegí guardarlo en tu carpeta de usuario → Clone.

Si preferís la terminal (como lo hace Lolo), primero instalá las herramientas de git y después cloná:

# instala git (si te pregunta, aceptá la ventana)
xcode-select --install

# cloná el repo en tu carpeta de usuario
cd ~
git clone https://github.com/ninjo-ai/cortex.git

Si te pide usuario/clave, se abre el login de GitHub en el navegador — autorizalo y la descarga sigue sola.

4

Poné el archivo de credenciales (.env)

Para que Claude pueda leer la data de contenido y conversaciones, necesita el archivo .env que te pasó Lolo. Copialo dentro de la carpeta cortex que acabás de descargar (queda como ~/cortex/.env).

Importante · seguridad El .env tiene llaves de acceso a sistemas de Ninjō. No lo compartas, no lo subas a ningún lado y no lo pegues en chats. Vive solo en tu compu.
5

Empezá a operar

Entrá a la carpeta de Cortex y abrí Claude Code ahí adentro:

cd ~/cortex
claude

Claude lee solo las instrucciones del repo (el archivo CLAUDE.md) y ya entiende cómo está organizado todo. A partir de acá le hablás en español, como a una persona. Cuando quiera cambiar o crear un archivo te muestra la propuesta y vos aprobás antes de que se haga.

Para arrancar con reportes de contenido, probá pedidos así:

¿Qué puedo hacer en este repositorio? Explicame cómo está organizado.
Mostrame un resumen de lo que pasó en mi contenido esta última semana.
Armame un reporte de performance del contenido de los últimos 7 días: qué piezas trajeron más conversaciones y cuáles convirtieron.
¿Qué reportes o comandos (skills) ya existen en este repo para análisis de contenido?
Dos atajos útiles Escribí /help dentro de Claude para ver todos los comandos disponibles. Y si no sabés cómo pedir algo, preguntáselo directo a Claude: él te guía.

Cómo trabajar bien con Claude — 5 tips

  • Pedile contexto, no comandos. Decile qué querés lograr ("armame un reporte de X") y él decide cómo.
  • Revisá antes de aprobar. Cuando propone editar o crear archivos, leé el cambio y recién ahí aceptá.
  • Una tarea a la vez. Si es algo grande, pedíselo por partes; va más prolijo.
  • Si algo no salió, decíselo. "Eso no es lo que quería, hacelo así" — itera al toque.
  • Cerrá cuando termines con exit. Tu progreso de archivos queda guardado en la carpeta.