Principiante a PRO

Por @iaempresa | Guía práctica para founders y equipos que quieren sacarle el máximo partido a Claude Code sin perder el tiempo en teoría.

¿Qué es exactamente Claude Code?

Claude Code

A shared Claude Code session on claude.ai/code

claude.ai

La mayoría usa la IA como ventana de chat. Claude Code la convierte en un sistema operativo completo que trabaja directamente sobre tus archivos.

La diferencia clave: Claude Code no vive en un chat. Vive en tu terminal y tiene acceso real a tu sistema de archivos.

Cómo funciona técnicamente

Claude Code es una herramienta de línea de comandos creada por Anthropic. Se instala una vez y funciona dentro de tu terminal, integrada con tu flujo de desarrollo.

Lo que puede hacer:

• Leer, escribir, crear y organizar archivos en tu computadora
• Ejecutar comandos en tu terminal
• Sin límites de subida de archivos
• Sin sesiones que expiran
• Sin copiar y pegar código entre ventanas

Instalación básica:

bash

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

Luego ejecutas claude en cualquier carpeta de tu proyecto y empieza a trabajar.

El flujo de trabajo óptimo (los 7 pasos)

⚠️ Error #1: empezar directamente escribiendo prompts. El flujo correcto es este:

Paso 1 — Activa el Plan Mode

Presiona Shift + Tab dos veces al iniciar una sesión. Claude no ejecuta nada todavía, solo piensa.

Paso 2 — Escribe tu objetivo de forma clara

No "hazme una app". Sí: "Quiero un dashboard en React que muestre las ventas por producto del último mes, conectado a mi base de datos PostgreSQL."

Paso 3 — Deja que Claude divida en pasos

Claude genera un plan detallado. Léelo completo antes de continuar.

Paso 4 — Revisa y ajusta el plan

Este es el momento de corregir. Cambiar aquí cuesta 10 segundos. Cambiar después puede costar horas.

Paso 5 — Cambia a modo auto-accept edits

Ahora sí, le das permiso para ejecutar. Claude trabaja de forma autónoma mientras tú supervisas.

Paso 6 — Claude ejecuta el plan completo

De principio a fin, sin interrupciones. Monitorea desde otra pantalla.

Paso 7 — Revisa el resultado y refina

Siempre hay ajustes. Itera hasta que esté listo.

Regla de oro: Mientras más claro sea tu brief inicial, menos revisiones necesitas al final.

Las 3 funciones más potentes

🔗 MCP — Model Context Protocol

Conecta Claude con todas tus herramientas actuales. Piénsalo como el USB-C de la IA: una sola interfaz para todo tu stack.

Herramientas que puedes conectar:

• GitHub (lee tus repos, crea PRs, revisa issues)
• Notion (lee y escribe páginas)
• Slack (envía mensajes, revisa canales)
• Jira (gestiona tickets)
• Bases de datos PostgreSQL, MySQL, Supabase
• APIs externas via REST

Cómo activar un MCP:

bash

# Ejemplo para conectar con GitHub claude mcp add github

Un protocolo. Cientos de conexiones posibles.

📄 CLAUDE.md — La memoria del proyecto

Es un archivo Markdown que le da a Claude contexto permanente sobre tu proyecto. Sin esto, tienes que repetir instrucciones en cada sesión.

Qué incluir en tu CLAUDE.md:

markdown

# Mi Proyecto ## Visión general [Describe qué hace tu producto en 2-3 oraciones] ## Stack tecnológico - Frontend: React + TypeScript - Backend: Node.js + Express - Base de datos: PostgreSQL - Hosting: Vercel + Railway ## Comandos clave - `npm run dev` — Servidor de desarrollo - `npm run build` — Build de producción - `npm run test` — Tests ## Guías de estilo - Usa nombres de variables en inglés - Siempre añade comentarios en español - Prefer functional components en React ## Contexto importante [Decisiones de arquitectura, cosas que NO hacer, dependencias críticas]

Dónde colocarlo:

• Global (aplica a todos tus proyectos): ~/.claude/CLAUDE.md
• Por proyecto (aplica solo a ese): /tu-proyecto/CLAUDE.md

⚡ Skills — Automatizaciones reutilizables

Son paquetes de instrucciones para tareas específicas que Claude carga automáticamente cuando las necesita. Si haces algo más de dos veces, conviértelo en una skill.

Cómo crear una skill:

bash

# Estructura de carpetas ~/.claude/skills/ └── revisar-pr/ └── SKILL.md └── generar-tests/ └── SKILL.md └── documentar-funcion/ └── SKILL.md

Ejemplo de skill para revisar PRs:

markdown

# SKILL: Revisar Pull Request ## Cuándo usar esta skill Cuando el usuario pida revisar un PR, código nuevo, o cambios recientes. ## Proceso 1. Lee todos los archivos modificados 2. Revisa: lógica, edge cases, performance, seguridad 3. Genera un reporte con: ✅ Lo que está bien | ⚠️ Sugerencias | 🚫 Problemas críticos 4. Propón mejoras concretas con ejemplos de código

Prompts copy-paste para founders

Para analizar feedback de clientes

Tengo [X] respuestas de encuesta en el archivo feedback.csv. Léelo, categoriza los temas principales y dame: 1. Los 3 problemas más frecuentes con % de menciones 2. Las 3 solicitudes de feature más pedidas 3. El nivel de satisfacción general (1-10) con justificación Formato: tabla + párrafo de resumen ejecutivo

Para construir un MVP rápido

Quiero un [tipo de app] que haga [función principal]. Stack: [tu stack preferido] Usuarios: [quiénes lo van a usar] Flujo principal: [describe el flujo paso a paso] Empieza en Plan Mode. No ejecutes nada hasta que apruebe el plan.

Para automatizar reportes recurrentes

Cada lunes necesito un reporte de [métrica] desde [fuente de datos]. El reporte debe incluir: [secciones] Formato de salida: [PDF / Notion / Slack / email] Crea un script que pueda ejecutar con un solo comando.

Para crear un CLAUDE.md desde cero

Analiza todos los archivos de este proyecto. Luego genera un CLAUDE.md completo que incluya: - Descripción del proyecto - Stack técnico detectado - Comandos importantes - Patrones de código que usamos - Cosas importantes a recordar

Para investigar competencia

Tengo estos 5 competidores: [lista]. Para cada uno, busca y analiza: - Propuesta de valor principal - Precios y modelo de negocio - Puntos débiles más mencionados en reviews - Features únicas que nosotros no tenemos Formato: tabla comparativa + sección de oportunidades

Cómo usarlo si eres founder (sin ser developer)

✅ Hábitos que deberías adoptar

• Empieza siempre en Plan Mode — Define el objetivo antes de ejecutar
• Usa Opus 4.6 con thinking activado — Es el mejor modelo para tareas complejas. Más lento, pero menos correcciones
• Crea un CLAUDE.md por proyecto — El contexto inicial determina la calidad de todo lo que sigue
• Convierte tareas repetitivas en skills — Si lo haces más de dos veces, conviértelo en skill
• Usa múltiples pantallas — Una para la terminal de Claude, otra para revisar el resultado en tiempo real
• Comparte tu CLAUDE.md con el equipo — Si varias personas lo actualizan semanalmente, mejora exponencialmente

🚫 Errores que debes evitar

• Saltarte el plan — Ir directo a ejecutar es el error #1. Perderás tiempo corrigiendo errores evitables
• Usarlo como ChatGPT — No copies y pegues prompts en un chat. Claude Code trabaja directamente sobre tu sistema
• Olvidarte de las múltiples pantallas — Las sesiones paralelas visibles te hacen trabajar mucho más rápido
• Trabajar en aislamiento — Comparte tu CLAUDE.md con el equipo. No lo guardes solo para ti
• Pensar que ya está terminado — La herramienta evoluciona rápido. Tu flujo de trabajo también debería hacerlo

Comparativa rápida: Claude Code vs alternativas

Recursos adicionales

• 📖 Documentación oficial: docs.anthropic.com/claude-code
• 🎥 Más guías prácticas: @iaempresa en Instagram