@maceo_eth · Buenos Aires 2026

Intro a
Claude Code

Todo lo que necesitás para arrancar hoy.
Copiá, pegá, experimentá.

→ Empezar ↗ Docs oficiales

Terminal — claude

$ npm install -g @anthropic-ai/claude-code

✓ Claude Code instalado correctamente

$ claude login

Abriendo autenticación en el browser...

✓ Autenticado. Listo para usar.

$ claude "Mirá este repo y decime qué mejorarías"

Analizando proyecto...

// la imagen central

Imaginá que tenés un colega que ejecuta las tareas que le pedís, recuerda todo lo que le contaste sobre tu proyecto, y te muestra exactamente lo que está haciendo en cada momento.

Eso es Claude Code. No un asistente que sugiere — un colega que ejecuta.
La pregunta no es "qué línea me sugiere" sino "qué tarea le delego".

Instalar y configurar

// menos de 10 minutos hasta el primer resultado real

Instalá Claude Code

Requiere Node.js 18+. Funciona en Mac, Linux y Windows (WSL).

bash

npm install -g @anthropic-ai/claude-code

Si no tenés Node 18+: nvm install 20 && nvm use 20

Autenticación

Abre el browser y te pide login con tu cuenta Anthropic. Una sola vez. Plan gratuito disponible — sin tarjeta de crédito.

bash

claude login

Crear cuenta: console.anthropic.com → no necesitás tarjeta para el plan gratuito

Verificá que funciona

Si ves la versión, estás listo.

bash

claude --version

Primera tarea

Andá a cualquier directorio de proyecto que tengas y corré esto. Bajo riesgo, alto valor — te da un diagnóstico del proyecto.

bash

claude "Mirá este repo y decime qué mejorarías"

Tip: creá tu CLAUDE.md primero (ver sección más abajo) para mejores resultados

El loop de trabajo

// 4 pasos que se repiten en cualquier tarea, a cualquier escala

PASO 01

Le pedís la tarea

"Ocupate de esto"

En lenguaje natural. Con contexto o sin. Claude puede pedir clarificación si algo no está claro.

PASO 02

Te muestra el plan

"Voy a hacer A, B y C"

Antes de ejecutar nada, propone qué va a tocar. Podés aprobar, cambiar o cancelar.

PASO 03

Lo ejecuta solo

"Se va y vuelve cuando terminó"

Escribe código, instala deps, corre tests. Te muestra cada acción en tiempo real.

PASO 04

Vos revisás

"Code review al colega"

Aprobás o pedís cambios en lenguaje natural. El control siempre es tuyo.

El CLAUDE.md

// el día 1 del colega — lo que le explicás una sola vez y no olvida nunca

// la analogía

Lo que le explicás a un dev nuevo en su primer día = lo que ponés en CLAUDE.md.

Stack · convenciones · comandos · qué no tocar · contexto de negocio.
Un colega humano lo aprende con el tiempo. Claude lo lee en segundos — y no lo olvida nunca.

CLAUDE.md — ejemplo completo para copiar y adaptar

# Mi Proyecto

## Stack
- Runtime: Node.js 20 + TypeScript (strict mode)
- Framework: Express
- Base de datos: PostgreSQL con Prisma ORM
- Tests: Jest + Supertest
- Deploy: Railway / Render / VPS propio

## Convenciones de código
- Nombres en camelCase para variables y funciones
- PascalCase para clases e interfaces
- async/await siempre — nunca callbacks ni .then()
- Tipado estricto — no usar `any` bajo ningún concepto
- Imports con rutas absolutas desde `src/`

## Estructura del proyecto
src/
  routes/      → endpoints de la API
  services/    → lógica de negocio
  models/      → tipos e interfaces
  middleware/  → auth, validación, errores
  utils/       → helpers reutilizables

## Comandos clave
- Tests:   npm test
- Dev:     npm run dev
- Build:   npm run build
- DB:      npx prisma migrate dev
- Seed:    npm run seed

## Flujo de trabajo
- Siempre correr tests antes de terminar una tarea
- Los commits siguen Conventional Commits (feat:, fix:, chore:)
- PRs requieren tests pasando y al menos un reviewer

## NO TOCAR
- /prisma/migrations/ — solo Prisma maneja esto
- .env.production — nunca modificar directamente
- /src/legacy/ — módulo en proceso de deprecación, no agregar código

## Contexto de negocio
- Producto: [descripción breve de qué hace tu app]
- Usuario objetivo: [quién lo usa]
- Métrica clave: [qué importa medir]
- Estado actual: [MVP / crecimiento / mantenimiento]

Guardalo en la raíz del repo como CLAUDE.md — Claude lo lee automáticamente cada vez que arranca.

Prompts para copiar

// tratá a Claude como a un dev senior en su primer día — dale contexto, no adivinanzas

▸ DIAGNÓSTICO

claude "Mirá este repo y hacé un diagnóstico: qué mejorarías, qué está bien, qué riesgos ves."

Ideal para empezar — bajo riesgo, alto valor. Claude analiza todo el proyecto.

▸ API DESDE CERO

claude "Crea una API Node.js con Express: GET /health, POST /echo, GET /time. Tests con Jest para cada endpoint. README con instrucciones de uso."

Scaffold completo desde un directorio vacío. Cambiá los endpoints por los tuyos.

▸ DEBUG ESPECÍFICO

claude "El test auth.test.ts falla en la línea 42 con TypeError: Cannot read properties of undefined. Encontrá la causa raíz y arreglala sin cambiar la firma de la función."

El contexto específico elimina la ambigüedad. Siempre incluí el error exacto.

▸ REFACTOR

claude "Refactorizá /src/payments.ts: separá la lógica de Stripe del modelo de datos en archivos distintos. Mantené la API pública exactamente igual. Corré los tests antes y después de cada cambio."

Scope definido + criterio de éxito explícito = sin sorpresas.

▸ DOCUMENTACIÓN

claude "Generá un README profesional para este repo: descripción clara, badges de CI/estado, instrucciones de instalación, ejemplos de uso con código real del proyecto, y tabla de endpoints si hay API."

Claude lee todos los archivos e infiere el propósito real — no inventa.

▸ TESTS

claude "Escribí tests con Jest para el módulo /src/auth/service.ts. Cobertura de casos felices, casos de error y edge cases. Usá los mismos patrones que ya existen en /src/__tests__/."

Referenciá los tests existentes para que mantenga consistencia de estilo.

▸ CODE REVIEW

claude "Hacé un code review de los cambios en este PR. Buscá: bugs, problemas de seguridad, violaciones de las convenciones del proyecto, y oportunidades de mejora. Priorizá los issues críticos."

Útil antes de mergear. Claude conoce las convenciones del CLAUDE.md.

▸ MIGRACIÓN

claude "Migrá este proyecto de JavaScript a TypeScript. Empezá por los archivos de más impacto. Activá strict mode. No cambies la lógica — solo los tipos. Tests deben seguir pasando en cada paso."

Las restricciones explícitas ("no cambies la lógica") son tu red de seguridad.

// regla de oro

Si podés describir lo que querés en una oración, Claude Code puede hacerlo.

Un prompt efectivo tiene: tarea clara · contexto relevante · restricciones explícitas · criterio de éxito
Tratá a Claude como a un dev senior en su primer día — sabe mucho, pero necesita contexto del proyecto.