Tu primer proyecto con Claude Code

Claude Code es la CLI oficial de Anthropic para trabajar con Claude directamente desde tu terminal. No es un chatbot — es un agente que puede leer tu código, ejecutar comandos, editar archivos y razonar sobre tu proyecto completo.

La diferencia clave con Cursor o Copilot: Claude Code opera a nivel de proyecto, no de archivo. Puede leer 20 archivos, entender la arquitectura, y hacer cambios coordinados.

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

Verifica:

claude --version

La primera vez te pedirá autenticarte con tu cuenta de Anthropic. Necesitas créditos en la API o una suscripción Claude Max/Team.

Navega a un proyecto existente y arranca Claude Code:

cd mi-proyecto
claude

Claude Code carga automáticamente el contexto del proyecto: lee CLAUDE.md si existe, detecta el stack (package.json, tsconfig, etc.) y está listo para trabajar.

Prueba con algo simple:

Explora el proyecto y dime qué stack usa y cómo está organizado

Verás cómo lee archivos, busca patrones y te da un resumen informado.

Dentro de una sesión de Claude Code:

Comando	Qué hace
/help	Menú de ayuda
/clear	Limpia el contexto de conversación
/cost	Muestra el coste acumulado de la sesión
Ctrl+C	Cancela la operación actual
/compact	Comprime el historial para liberar contexto

Para tareas más ambiciosas:

Crea un endpoint /api/health que devuelva el status del sistema con timestamp

Claude Code leerá tu proyecto, entenderá los patrones existentes, y escribirá el código siguiendo tus convenciones.

Crea un archivo CLAUDE.md en la raíz de tu proyecto:

# Mi Proyecto

## Stack
- Next.js 14 con App Router
- Prisma + PostgreSQL
- Tailwind CSS

## Comandos
- \`npm run dev\` para desarrollo
- \`npm run build\` para producción
- \`npx prisma migrate dev\` para migraciones

## Convenciones
- Componentes en src/components/
- API routes en src/app/api/
- Usar server components por defecto

Claude Code lee este archivo automáticamente al inicio de cada sesión. Es la forma más efectiva de mantener contexto entre sesiones.

Más detalles en CLAUDE.md: la guía definitiva.

Claude Code tiene tres niveles de autonomía:

• Plan mode — te muestra qué va a hacer antes de hacerlo. Ideal para empezar.
• Auto-approve — aprueba automáticamente operaciones seguras (lecturas, búsquedas). Configurable en .claude/settings.json.
• Full autonomous — ejecuta todo sin confirmación. Solo para feature branches donde el riesgo es bajo.

Empieza con plan mode y ve aumentando la autonomía según ganes confianza:

// .claude/settings.json
{
  "permissions": {
    "allow": ["Read", "Glob", "Grep"],
    "deny": []
  }
}

Ya tienes Claude Code funcionando. Desde aquí:

• Instalar oh-my-claudecode — añade orquestación multi-agente sobre Claude Code
• Configurar MCP servers — extiende Claude Code con documentación en vivo y búsqueda web
• De idea a deploy — el flujo completo de desarrollo