guía completa · de cero a avanzado
Claude Code, Bien Usado
El 90% de la gente usa Claude Code como chatbot y se queja de que “la IA no funciona”. El problema no es la IA — es cómo la estás usando. Esta guía te lleva desde el primer claude en la terminal hasta orquestar agentes que cierran tareas mientras tú tomas café. Setup, contexto, skills, subagentes, deploy y proceso — en un solo lugar, en 2026.
01 fundamentos
Claude Code No Es un Chatbot
Entiéndelo así:
Claude Code es un agente con acceso a tu computadora. No le escribes texto para que te lo regrese bonito como en ChatGPT — le das una instrucción y él la ejecuta. Abres la terminal, le dices “crea una extensión de Chrome con un checklist basado en @course.md” y mientras tomas agua Claude ya te creómanifest.json,sidepanel.html,styles.css yapp.js.
Si sigues copiando código de ChatGPT y pegándolo a mano, estás trabajando en 2023. Este es el momento de dejar eso atrás.
- Lee, crea, modifica y borra archivos en tu computadora.
- Abre páginas web, busca en internet y saca información de ahí.
- Corre comandos en la terminal como si fueras tú tecleando.
- Le dices “créame una carpeta” y la crea. Cero magia, pura herramienta.
Dos formas de usarlo
- Extensión de IDE (VS Code, Cursor, Windsurf) — se ve más bonito pero pierdes funciones.
- Terminal (recomendado) — status line, voz, comandos btw, split screen para varias sesiones en paralelo.
- Para terminal: Warp o iTerm2. La mayoría le tiene miedo a la terminal — por eso sus resultados son peores.
Lo primero después de instalar
Pega esto en tu ~/.zshrc
# ~/.zshrc
# ── Claude Code ──────────────────
alias claude='claude --dangerously-skip-permissions'
# ── shortcuts ────────────────────
alias cc='claude'
alias ccr='claude --resume'
# Aplicar cambios:
source ~/.zshrcInstala Claude Code y abre tu terminal favorita (Warp o iTerm2).
Pega el bloque de arriba en tu ~/.zshrc — el alias de bypass permissions hace que deje de pedirte confirmación a cada rato.
Sí, suena agresivo. No, en 6+ meses de uso diario no pasa nada grave. Es más fácil que tú borres tu carpeta raíz a que Claude la borre.
Instala Whisper Flow o Aqua Voice. Hablar es 40% más rápido que escribir. Si sigues tecleando prompts a mano estás perdiendo velocidad.
Precio — por dónde empezar
Pro
$20/mes
Punto de partida — empieza aquí.
Max 5x
$100/mes
Suficiente para la mayoría.
Max 20x
$200/mes
Múltiples proyectos + Agent Teams.
Haz las cuentas:
Las mismas tareas vía API directa salen en ≈ $500 USD al mes. Una suscripción de $100 al mes es 5x más barata. Si sigues pagando API, haz las cuentas otra vez.
02 contexto y CLAUDE.md
Si No Entiendes Contexto, No Entiendes Nada
Cada sesión nueva = pizarra en blanco.
Sin un CLAUDE.md, el agente llega sin saber nada de tu proyecto y se gasta tokens escaneando todo antes de contestarte siquiera. En proyectos chicos son ~33K tokens desperdiciados. En proyectos grandes, cientos de miles.
El costo real de abrir sesión sin CLAUDE.md
# Sin CLAUDE.md:
❯ claude
Escaneando estructura del proyecto...
Leyendo package.json...
Leyendo tsconfig.json...
Analizando 47 archivos...
Tokens: 33K gastados solo para entender tu proyecto
Tus mensajes: 0
# Con CLAUDE.md:
❯ claude
CLAUDE.md cargado (86 líneas)
Listo.
Tokens: 1.2K
Tus mensajes: 0
→ 27x más barato cada vez que abres sesiónLa solución — corre /init
El comando /init revisa tu proyecto y te arma un CLAUDE.md inicial. La siguiente sesión ya arranca con el contexto cargado.
Genera tu primer CLAUDE.md
❯ /init
⠋ Analizando estructura del proyecto...
Created: CLAUDE.md
# Mi Proyecto
## Overview
Extensión de Chrome — markdown a checklist
## Arquitectura
├── chrome-extension/
│ ├── manifest.json
│ ├── sidepanel.html
│ └── app.js
├── landing/
└── CLAUDE.md
## Reglas
- Siempre actualiza la versión de la extensión en cada cambio
- Usa conventional commits
✓ CLAUDE.md guardado · 86 líneasRegla de oro: CLAUDE.md < 500 líneas.
Lo que va ahí es lo que el agente TIENE que saber en CADA sesión — nada más. Si te pasas de 500 líneas, algo está mal. Probablemente estás metiendo cosas que deberían vivir en docs o en skills.
Auto Memory — úsalo, pero no lo ames
Claude tiene memoria automática que guarda notas por su cuenta. Honestamente: no lo ames demasiado. Vive a nivel usuario/proyecto, no lo puedes compartir con tu equipo, y es difícil controlar qué se acuerda y qué no. Deja que corra en el fondo, pero lo importante ponlo explícito en CLAUDE.md. Magia es cuando no entiendes lo que pasa. Y cuando no entiendes, no puedes arreglar.
Zonas de contexto — tu presupuesto real
Monitorea el fill con un status line
Contexto: ██████████████████████░░░░░░░░░ 67%
0%━━━━━━50%━━━━━━70%━━━━━━85%━━━100%
# Tu status line:
❯ ~/mi-proyecto · opus-4 · 1M ctx · 67% ■■■■■■░░
# Las 3 reglas de oro:
1. CLAUDE.md < 500 líneas
2. 1 tarea = 1 sesión → /clear
3. Herramientas por proyecto, no globales- 0–50 % trabajo efectivo — estás fresco, el agente piensa bien.
- 50–70 % cuidado — empieza a olvidar detalles viejos.
- 70–85 % problemas en camino — las respuestas se degradan.
- 85 %+ auto-compact — pérdida de contexto, empieza otra sesión.
Instala un status line que te muestre el porcentaje de llenado en tiempo real. Si no ves ese número, manejas con los ojos vendados.
Las 3 reglas que te salvan cientos de dólares en tokens
CLAUDE.md < 500 líneas, sin contradicciones, solo tools necesarios.
Come al elefante mordida por mordida: 1 tarea = 1 sesión → /clear → sesión nueva.
Instala herramientas por proyecto, no globalmente. Global = solo lo que necesitas SIEMPRE.
Rompe una y pierdes contexto, dinero y paciencia.
Rompe las tres y vas a ser el que tuitea “la IA es puro hype”.
03 MCP → Skills
De MCP a Skills — El Salto Que Nadie Te Cuenta
¿Qué es un MCP?
Piénsalo como un manual de endpoints que el agente puede llamar. Instalas el MCP de Chrome DevTools y Claude puede abrir pestañas, tomar screenshots, darle click a elementos. Instalas el de Supabase y puede leer y modificar tu base de datos. Todo sin que tú programes nada por encima.
Instala MCPs con scope user o scope project
# Instalación global (solo lo que usas SIEMPRE):
❯ claude mcp add chrome-devtools \
--scope user \
npx @anthropic/chrome-devtools-mcp
# Instalación por proyecto (lo demás):
❯ claude mcp add supabase \
--scope project \
npx supabase-mcp
# Verificar:
❯ /mcp
chrome-devtools ✓ connected (user)
exa-search ✓ connected (user)
supabase ✓ connected (project)Regla:
Instala global SOLO lo que usas en TODO (Exa, Chrome DevTools). Per-project todo lo demás (Supabase, Playwright, etc.). El error de rookie es instalar 15 MCPs globales y preguntarse por qué el contexto muere al tercer mensaje.
El problema de MCP del que casi nadie habla
- Infla el contexto (sobre todo en herramientas que no son Claude Code).
- Escenarios fijos — no puedes personalizar qué trae.
- Quieres 1 tarea del tracker y el MCP te trae TODAS. El agente busca entre la basura.
La evolución — Skills
Un skill es una carpeta con instrucciones y archivos helper. Solo el header (nombre + descripción) se mete al contexto; el resto se carga bajo demanda cuando el agente lo necesita. Resultado: escalas tu caja de herramientas sin inflar nada.
Skills vs MCP — a nivel tokens
# MCP (enfoque viejo):
→ Todos los endpoints en contexto
→ Escenarios fijos
→ No personalizable
→ ~5.7K–11.4K tokens por MCP
# Skills (enfoque nuevo):
→ Solo el header en contexto (~50 tokens)
→ Cargados bajo demanda
→ Editables y combinables
→ Cualquier API = skill sin MCP
# Ejemplo real:
❯ Crea una landing para la app
Skill cargado: Landing Page Creator
Skill cargado: Frontend Design
Combinado: 2 skills · 0.3K tokens
vs MCP: 11.4K tokens para cargar las mismas tools¿Dónde los encuentras? En skills.sh — el marketplace de skills mantenido por Vercel, con 100+ soluciones listas para instalar. Si una herramienta ofrece Skill + CLI, úsala en lugar del MCP. Más flexible, más eficiente. Todas las tools top se están moviendo a skills. Si tú no, te estás quedando atrás.
Crea tus propios skills
Instala Skill Creator desde el marketplace oficial (lo encuentras en skills.sh).
Descríbele qué necesitas — por ejemplo: “crea un skill para generar landings desde una imagen de referencia”.
Itera. No va a quedar perfecto al primer intento — eso es parte del proceso.
Combina skills: Landing Creator + Frontend Design = landing con gran diseño, sin esfuerzo extra.
Cualquier API con documentación puede convertirse en un skill.
Sin MCP de por medio. Si pagas por un MCP que un skill gratis puede reemplazar, estás pagando por flojera.
04 subagentes y agent teams
Lo Que Separa Principiantes de Avanzados
Dos problemas de la sesión principal:
No puede paralelizar tareas y el contexto es finito. Los subagentes resuelven ambos: cada uno tiene contexto aislado, corren en paralelo, y los resultados vuelven al orquestador principal sin contaminar tu ventana.
La diferencia real en tiempo y tokens
# Sin subagentes (secuencial):
Landing v1 ████████░░ 5 min · 100K tokens
Landing v2 ████████░░ 5 min · 100K tokens
Landing v3 ████████░░ 5 min · 100K tokens
─────────────────────────────────────
Total: 15 min · 300K tokens
Ctx main: 300K (desbordado ☠)
# Con subagentes (paralelo):
Sub 1 → v1 ████████░░ 5 min · 100K (aislado)
Sub 2 → v2 ████████░░ 5 min · 100K (aislado)
Sub 3 → v3 ████████░░ 5 min · 100K (aislado)
─────────────────────────────────────
Total: 5 min · 50K en el contexto principal
Ctx main: 50K ✓ limpio
→ 3x más rápido, 6x más barato.Tres landings secuenciales: 15 min y 300K tokens. Las mismas tres por subagentes: 5 min y solo 50K en tu contexto principal. 3x más rápido, 6x más barato. Y aun así, ¿sigues haciendo todo en una sola sesión?
Cómo configurar un subagente
Los subagentes tienen funcionalidad limitada — solo reciben el contexto que tú les pasas. A cambio, puedes fijarles el modelo y preload de skills desde el archivo de definición.
.claude/agents/landing-creator.md
# .claude/agents/landing-creator.md
---
name: landing-creator
model: sonnet
color: yellow
skills:
- landing-page
- frontend-design
---
# Selección de modelo:
Opus → planes, arquitectura, decisiones
Sonnet → escribir código
Haiku → buscar documentación
# Opus sin plan = Ferrari en terracería.
# Sonnet con buen plan = tiro al centro.Selección de modelo por subagente
- Opus — planes, decisiones complejas, orquestación. Default si no tienes límites.
- Sonnet — escribir código (con un buen plan encima).
- Haiku — buscar documentación y tareas de lectura.
- Effort: low / medium / high. Default es medium.
Opus sin plan = Ferrari en terracería.
Sonnet con buen plan = tiro al centro. Si no tienes límites, quédate en Opus. Si los tienes, usa Opus para planificar y Sonnet para escribir código dentro de los subagentes.
Dos formas de lanzar subagentes
- Al vuelo — “lanza dos subagentes con dos versiones de diseño”. Rápido pero improvisado.
- Pre-definidos — un archivo en
.claude/agents/que controla nombre, modelo, skills. Los que pre-definen sus agentes controlan el resultado. Los que esperan que “se acomode solo” reciben basura.
Agent Teams — cuándo sí, cuándo no
A diferencia de los subagentes, cada miembro de un Agent Team es una sesión completa de Claude, con lista de tareas compartida y comunicación entre ellos. Suena como un sueño, pero tiene su trampa — son pesados en contexto y sin proceso es dinero tirado.
Úsalos para:
- Research con múltiples perspectivas (cada miembro ataca un ángulo).
- Discusión de ideas entre varios puntos de vista.
- Hipótesis en competencia que quieres validar antes de construir.
Evítalos para:
- Escribir código como principiante — terminas con un equipo de caos.
- Flujos donde no entiendes el proceso todavía — gastas contexto en humo.
05 deploy y git
Deja de Compartir Links de localhost
Aquí se separan los vibe coders de los que hacen dinero.
Los primeros comparten links de localhost:3000. Los segundos tienen un dominio en producción, git como salvavidas y secretos manejados como adultos. Esta sección te mete en el segundo grupo.
El camino más rápido a producción — Vercel
npx vercel — deploy en menos de un minuto
❯ npx vercel
? Set up and deploy? Yes
? Which scope? mi-equipo
? Link to existing project? No
? What's your project's name? mi-app
? In which directory is your code? ./landing
🔗 https://mi-app.vercel.app
✓ Production deployedPara backend: Railway, Supabase o Directus. Cada uno cubre distintos niveles de control — pero los tres te sacan de localhost hoy mismo.
Si tu servicio es público con datos de usuarios:
Piensa en backups, permisos, endpoints cerrados y riesgos legales antes de abrirlo al mundo. Puedes validar una hipótesis en una hora — pero si filtras la base de datos de tus usuarios, esa hora no te salva.
Git = save points en un videojuego
Sin Git, no tienes saves. Suerte empezando desde cero cada vez que algo truena. git init, commits, push, pull. GitHub = almacenamiento en la nube + colaboración + automatizaciones.
Flujo mínimo de Git
❯ git init
❯ git add .
❯ git commit -m "feat: primera versión de la extensión"
# Ramas:
❯ git checkout -b feature/landing-v2
Switched to new branch 'feature/landing-v2'Git Worktree — dos Claudes en paralelo sin conflictos
Worktree crea copias físicas de tu proyecto en carpetas separadas. Cada una apunta a una rama distinta. Dos terminales, dos Claudes, cero choques. Si no usas worktree, estás haciendo fila contra tu propio proyecto.
Dos sesiones de Claude trabajando al mismo tiempo
# Crea copias físicas en paralelo:
❯ git worktree add ./worktrees/v2 feature/landing-v2
❯ git worktree add ./worktrees/v3 feature/landing-v3
# Dos Claudes al mismo tiempo:
[Terminal 1] ~/worktrees/v2 ❯ claude
[Terminal 2] ~/worktrees/v3 ❯ claude
→ No se estorban entre ellos.
→ No hacen fila contra tu propio proyecto.Repos privados obligatorios
Busca en Google “github leaked api keys”. Miles de personas que pensaron “a nadie le importa mi proyecto” y terminaron con su OpenAI key en Pastebin. No seas uno de ellos.
Secretos — mal vs bien
# ✗ MAL (secretos en el código):
.env
├── OPENAI_KEY=sk-proj-abc123...
├── VERCEL_TOKEN=vrl_def456...
└── DB_PASSWORD=supersecreto
# ✓ BIEN (secretos en GitHub):
Settings → Secrets → Actions
├── OPENAI_KEY ••••••••
├── VERCEL_TOKEN ••••••••
└── DB_PASSWORD ••••••••
→ Local: solo llaves de prueba
→ Producción: CI/CD nada másGitHub Actions = automatización.
Push a main → corren tests → deploy a Vercel. Los secretos viven en GitHub Secrets, nunca en el código ni en local. Tener llaves de producción en tu máquina local no es pregunta de si se filtran, sino de cuándo se filtran. CI/CD únicamente.
06 proceso
La Diferencia No Es el Modelo, Es el Proceso
DORA Report 2025:
Los equipos fuertes con IA se hacen más fuertes. Los equipos débiles descubren más problemas. El mayor ROI no viene de las herramientas — viene de la calidad del proceso. Si no tienes proceso, lo único que estás automatizando es caos. Y caos rápido sigue siendo caos.
El pipeline mínimo
Planificación — el agente propone cómo va a atacar la tarea.
Revisión del plan — tú leas y ajustas antes de gastar un solo token en código.
Descomposición — el plan se parte en tareas chicas y ejecutables.
Implementación vía subagentes — cada tarea corre aislada y paraleliza cuando puede.
Code review — antes de mergear, un paso explícito de revisión.
Cada etapa empieza con un plan. Sin excepciones. Si arrancas a escribir código sin plan, acabas quemando tokens y contexto en una dirección que ni tú mismo defendiste al principio.
Superpowers — el proceso listo para usar
Más de 109 mil devs ya corren este pipeline: Brainstorm → Specification → Plan → Subagent Driven Development → Code Review → Merge/PR. No tienes que inventarlo de cero — lo instalas y lo usas.
El caso real: 9 tareas, 9% de contexto
# Sin proceso:
❯ Constrúyeme una app
... 300K tokens después ...
✗ Contexto desbordado
✗ El código no jala
✗ Empezar de nuevo
# Con proceso (Superpowers):
❯ /brainstorm
❯ /plan
❯ /implement (subagent driven)
❯ /review
Resultado:
├── 9 tareas completadas
├── 9% de contexto usado
├── Tests passing
└── PR listo para merge
→ La diferencia no es el modelo. Es el proceso.Mismo modelo. Resultado totalmente distinto.
Uno termina 9 tareas con 9% de contexto. Otro hace una sola y ya va en 85%. La diferencia no es el modelo ni los MCPs. La diferencia es el proceso.
07 toolkit y ruta
Tu Kit Mínimo y el Camino de 0 a Avanzado
El kit mínimo para dejar de trabajar a media máquina.
Cada herramienta de esta lista es gratuita o está incluida en tu suscripción. Ya no hay excusas.
Exa MCP
Búsqueda — mejor que la built-in.
Context7 Skill + CLI
Docs frescos de librerías siempre al día.
Chrome DevTools MCP
Automatización del browser desde el agente.
Frontend Design Skill
Diseño sin el “purple AI look” de siempre.
Skill Creator
Crea tus propios skills en minutos.
Find Skills
Busca skills desde Claude Code sin abrir el navegador.
Superpowers
Proceso completo de desarrollo — 109K+ devs lo usan.
La ruta de 0 → avanzado
La barra de progreso que todo el mundo debería tener en mente
0 ░░░░░░░░░░ agente ≠ chatbot
1 ██░░░░░░░░ instalar + bypass + whisper
2 ████░░░░░░ CLAUDE.md
3 ██████░░░░ MCP → Skills → Subagentes
4 ████████░░ contexto
5 █████████░ deploy
6 █████████░ git
7 ██████████ proceso
Nivel secreto: ██████████ no existe.
Keep learning.- 0 · Entender que es un agente, no un chatbot.
- 1 · Instalar + bypass permissions + Whisper.
- 2 · CLAUDE.md — ahorro de contexto desde el minuto uno.
- 3 · MCP → Skills → Subagentes → Agent Teams.
- 4 · Entender y monitorear el contexto.
- 5 · Deploy de un click.
- 6 · Git para seguridad y trabajo en paralelo.
- 7 · Proceso: plan → decompose → implement → review.
Nivel secreto: no existe.
No hay truco escondido. No hay atajo. Sigue aprendiendo — la gente que domina estas herramientas hoy es la que empezó a estudiar hace 6 meses y no paró.
Estudia enfoques, no herramientas.
Si Claude Code desaparece mañana, tú solo mueves tu proceso a la siguiente. Los que aprendieron los botones empiezan de cero. Otra vez.