Claude Code

Asistente de IA de Anthropic para desarrollo desde la terminal. Analiza tu codebase, genera código, ejecuta comandos y se integra con herramientas externas mediante MCP.

Requisitos

Suscripción: Requiere plan Max de Anthropic.
Node.js: Necesario para los MCP servers que usan npx.

Instalación

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

Verificar:

claude --version

Actualizar:

claude update

Primer uso (Autenticación)

Ejecuta Claude Code por primera vez en cualquier directorio de proyecto:

claude

Te guiará para iniciar sesión en tu consola de Anthropic
Autoriza tu dispositivo
Comenzará a analizar tu codebase

Uso básico

# Sesión interactiva
claude

# Pregunta directa
claude "explícame la arquitectura de este proyecto"

# Continúar la conversación anterior
claude --continue

# Resume tu última sesión incluso después de cerrar la terminal
claude --resume

Configuración: CLAUDE.md

El archivo CLAUDE.md en la raíz de tu proyecto actúa como la "constitución" de Claude Code. Se carga automáticamente en cada sesión.

Buenas prácticas

Mantenlo bajo 200 líneas — cada línea consume contexto
Incluye: comandos del proyecto (dev, test, build), convenciones de arquitectura, reglas de "nunca/siempre"
No incluyas: documentación completa ni descripciones archivo por archivo

Ejemplo básico:

# CLAUDE.md

## Proyecto
App web con Vue 3 + Laravel 11. Frontend en /client, Backend en /api.

## Comandos
- Dev: `cd client && npm run dev`
- API: `cd api && php artisan serve`
- Tests: `cd api && php artisan test`
- Lint: `cd client && npm run lint`

## Reglas
- SIEMPRE escribir tests para lógica nueva
- NUNCA modificar migraciones existentes, crear nuevas
- Usar Composition API, nunca Options API
- Código y commits en inglés, comentarios en español

Pro tip

Si Claude comete un error recurrente, dile: "Agrega esta regla a CLAUDE.md" y lo hará automáticamente.

MCP Servers (Model Context Protocol)

Los MCP servers extienden las capacidades de Claude Code conectándolo con herramientas externas. Se configuran con claude mcp add.

Comandos de gestión

claude mcp list              # Ver MCPs instalados
claude mcp get <nombre>       # Detalles de un MCP
claude mcp remove <nombre>    # Eliminar un MCP

Dentro de una sesión de Claude Code, usa /mcp para ver el estado de los servidores conectados.

MCP 1: Context7 — Documentación actualizada

Provee documentación actualizada y específica por versión de cualquier librería. Evita que Claude use información obsoleta o alucine sobre APIs.

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp@latest

Uso

Una vez instalado, Claude lo usa automáticamente cuando necesita consultar documentación de librerías (Flutter, Vue, Laravel, etc.).

MCP 2: Brave Search — Búsqueda web

Permite a Claude buscar en internet en tiempo real. Útil para errores oscuros, documentación reciente o investigar soluciones.

Obtén una API key gratuita en brave.com/search/api
Instala el MCP:

claude mcp add --scope user brave-search \
  -e BRAVE_API_KEY=tu_api_key_aqui \
  -- npx -y @modelcontextprotocol/server-brave-search

MCP 3: Supabase — Base de datos

Si usas Supabase, este MCP permite a Claude interactuar directamente con tu base de datos: tablas, funciones, migraciones, etc.

claude mcp add --scope user supabase \
  --transport http \
  -- https://mcp.supabase.com/mcp

Autenticación

Se autentica mediante un flujo de navegador la primera vez que se conecta.

MCP 4: Sequential Thinking — Razonamiento profundo

Ayuda a Claude a descomponer problemas complejos en pasos lógicos secuenciales. Mejora significativamente la calidad de las respuestas para tareas de arquitectura o debugging complejo.

claude mcp add --scope user sequential-thinking \
  -- npx -y @modelcontextprotocol/server-sequential-thinking

MCP 5: Playwright — Testing en navegador

Permite a Claude automatizar navegadores para testing end-to-end, debugging de apps web y scraping.

claude mcp add --scope user playwright \
  -- npx -y @anthropic/mcp-server-playwright

Custom Commands (Slash Commands)

Crea comandos personalizados reutilizables para tareas repetitivas.

Comandos de proyecto (versionados con Git)

mkdir -p .claude/commands

Ejemplo — .claude/commands/commit.md:

Analiza los cambios staged (git diff --cached) y genera un commit message
siguiendo Conventional Commits. El mensaje debe ser en inglés, conciso y
descriptivo. Ejecuta el commit automáticamente.

Argumento opcional: $ARGUMENTS (contexto adicional sobre el cambio)

Uso: /project:commit "refactored auth module"

Comandos personales (globales)

mkdir -p ~/.claude/commands

Ejemplo — ~/.claude/commands/review.md:

Revisa el código actual buscando:
1. Bugs potenciales
2. Problemas de seguridad
3. Oportunidades de optimización
4. Violaciones de buenas prácticas

Presenta los hallazgos ordenados por severidad con sugerencias de corrección.

Uso: /user:review

Tips de productividad

Tip	Comando / Acción
Compactar contexto (~80% uso)	`/compact`
Limpiar contexto por completo	`/clear`
Referenciar archivo específico	`@src/auth/config.ts` en tu mensaje
Permisos para comandos frecuentes	`/permissions` → allowlist
Worktrees para tareas paralelas	`claude --worktree feature-auth`
Ver costo de la sesión	`/cost`
Cambiar modelo	`/model`

Comandos de referencia rápida

# Iniciar sesión interactiva
claude

# Pregunta directa sin entrar a sesión
claude "¿cómo optimizo esta query?"

# Continuar última conversación
claude --continue

# Resumir sesión anterior
claude --resume

# Modo pipe (para scripts)
echo "explica este error" | claude

# Actualizar a última versión
claude update

# Ver MCPs instalados
claude mcp list

Notas

Claude Code también está disponible como extensión de IDE para VS Code y JetBrains.
Los costos de uso se reflejan en tu suscripción de Anthropic según los límites de tu plan.
Los MCP con --scope user son globales (todos los proyectos). Sin ese flag, son solo para el proyecto actual.