34 Consejos para Usar Claude Code

# Claude Code puede ejecutar todas las operaciones CLI estándar
claude --help
claude --version
claude --list-sessions

# Pasar prompts directamente para ejecutar tareas
claude -P "analiza package.json y lista todas las dependencias"

# Modo no interactivo, salida directa de resultados
claude -P "genera un componente React" --no-interactive

# Usar en combinación con otras herramientas
git diff | claude -P "explica estos cambios de código"
npm test 2>&1 | claude -P "analiza las razones de fallo de las pruebas"

# Transferencia de datos por pipeline
cat error.log | claude -P "analiza el registro de errores y proporciona soluciones"
curl https://api.example.com | claude -P "analiza esta respuesta de API"

# Terminal 1
claude --session frontend-work

# Terminal 2
claude --session backend-api

# Terminal 3
claude --session testing

Por favor ejecuta las pruebas en una nueva instancia de Claude e infórmame los resultados.

[Pegar imagen de diseño]
Por favor genera componentes React correspondientes basados en este diseño, incluyendo:
- Diseño responsive
- Adaptación móvil
- Uso de Tailwind CSS

// Ejemplo de script de captura automatizada
const puppeteer = require('puppeteer')

async function captureScreenshots() {
  const browser = await puppeteer.launch()
  const page = await browser.newPage()

  // Capturar screenshots de diferentes estados
  await page.goto('https://localhost:3000')
  await page.screenshot({ path: 'homepage.png' })

  await page.click('.login-button')
  await page.screenshot({ path: 'login-page.png' })

  await browser.close()
}

Por favor analiza todas las capturas en el directorio screenshots/ e identifica inconsistencias en la UI.

// Ejemplo de configuración MCP
{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres"]
    }
  }
}

Después de conectar a la base de datos, por favor:
1. Analiza estructuras de tablas existentes
2. Genera definiciones de tipos TypeScript
3. Crea interfaces API CRUD

Por favor obtén la última documentación de Workers API de Cloudflare MCP y crea un proyecto de ejemplo.

https://docs.example.com/api/v2

Por favor crea un SDK TypeScript correspondiente basado en la documentación anterior.

https://en.wikipedia.org/wiki/Chess_rules

Basándote en las reglas anteriores, implementa la lógica central de un juego de ajedrez.

# Estructura de ejemplo de CLAUDE.md

## Descripción General del Proyecto

Breve descripción del propósito del proyecto y stack tecnológico

## Estándares de Desarrollo

- Guías de estilo de código
- Convenciones de nomenclatura
- Estructura de organización de archivos

## Comandos Comunes

Lista comandos comunes del proyecto

## Notas

Notas específicas del proyecto y limitaciones

# Ejecutar en el directorio raíz del proyecto
> /init

# Claude Code analizará el proyecto y generará el archivo de configuración

## Reglas del Proyecto

- Todas las respuestas API deben incluir campos status y data
- Usa camelCase para nombres de variables, PascalCase para componentes
- Prohíbe el uso del tipo any, define tipos TypeScript explícitos

## Plantillas de Código

### Plantilla de Componente React

\```tsx
import React from 'react';

interface Props {
// definición de props
}

export const ComponentName: React.FC<Props> = ({ }) => {
return <div></div>;
};
\```

## Registro de Decisiones Arquitectónicas

### ADR-001: Usar Redux Toolkit

- **Fecha**: 2024-01-15
- **Decisión**: Adoptar Redux Toolkit como solución de gestión de estado
- **Razón**: Simplifica el uso de Redux, reduce código boilerplate

## Dependencias Clave

| Paquete | Versión  | Propósito        | Notas                   |
| ------- | -------- | ---------------- | ----------------------- |
| react   | ^18.0.0  | Framework UI     | Usa características concurrentes |
| next    | ^14.0.0  | Framework Full-Stack | App Router          |

## Estrategia de Pruebas

- Cobertura de pruebas unitarias > 80%
- Todos los endpoints API deben tener pruebas de integración
- Usa Jest + React Testing Library
- Pruebas E2E con Playwright

// .claude/commands/test-all.js
module.exports = {
  name: 'test-all',
  description: 'Ejecuta todas las pruebas y genera reporte de cobertura',
  execute: async () => {
    await runCommand('npm test -- --coverage')
    await runCommand('npm run e2e')
  }
}

// .claude/commands/aliases.js
module.exports = {
  c: 'commit',
  p: 'push',
  ta: 'test-all',
  dev: 'npm run dev'
}

// .claude/commands/deploy.js
module.exports = {
  name: 'deploy',
  description: 'Proceso completo de despliegue',
  execute: async () => {
    await runCommand('npm test')
    await runCommand('npm run build')
    await runCommand('npm run deploy:prod')
  }
}

// .claude/commands/create-component.js
module.exports = {
  name: 'create-component',
  description: 'Crea nuevo componente',
  parameters: ['name', 'type'],
  execute: async (name, type = 'functional') => {
    // Genera componente basado en parámetros
  }
}

// .claude/commands/smart-test.js
module.exports = {
  name: 'smart-test',
  execute: async () => {
    const files = await getChangedFiles()
    if (files.some((f) => f.endsWith('.tsx'))) {
      await runCommand('npm run test:components')
    }
    if (files.some((f) => f.includes('api/'))) {
      await runCommand('npm run test:api')
    }
  }
}

// .claude/commands/scaffold.js
module.exports = {
  name: 'scaffold',
  interactive: true,
  execute: async () => {
    const type = await prompt('Elige tipo: component/page/api')
    const name = await prompt('Ingresa nombre:')
    // Genera código basado en entrada
  }
}

# Crear espacio de trabajo de desarrollo frontend
claude --workspace frontend --dir ./src/components

# Crear espacio de trabajo de desarrollo backend
claude --workspace backend --dir ./src/api

# Crear espacio de trabajo de pruebas
claude --workspace testing --dir ./tests

# Ver historial de sesiones
claude --history

# Restaurar sesión específica
claude --resume <session-id>

# Exportar registro de sesión
claude --export-session > session-backup.json