Instala Claude Code, entiende cómo trabaja por dentro y aprende a conducirlo: qué escribir, cómo interrumpirlo y cómo hacer que verifique su propio trabajo.
Lección 1.1
¿Qué es Claude Code y dónde corre?
Claude Code es un asistente agéntico. No solo responde texto: usa herramientas para leer tu código, editar archivos, ejecutar comandos y buscar en la web. La documentación lo describe como la capa que rodea al modelo, provee las herramientas y administra el contexto que el modelo ve. A esa capa se le llama harness agéntico.
Aunque brilla programando, sirve para cualquier cosa que puedas hacer desde la línea de comandos: escribir documentación, correr builds, investigar un tema o buscar archivos.
Dónde puedes usarlo
El loop agéntico es idéntico en todas las superficies. Lo que cambia es dónde se ejecuta el código y cómo interactúas.
Entorno
Dónde corre el código
Úsalo para
Local
Tu máquina
El caso por defecto: acceso total a tus archivos, herramientas y entorno
Nube
VMs gestionadas por Anthropic, o entornos self-hosted de tu organización
Delegar tareas que siguen corriendo con el laptop cerrado, o repos que no tienes en local
Remote Control
Tu máquina, controlada desde el navegador o el celular
Seguir una sesión local desde otro dispositivo
Terminal (CLI)La superficie más completa. Todo el curso usa esta como base.
IDE y escritorioExtensiones de VS Code y JetBrains, más la app de escritorio.
Web, Slack y CIclaude.ai/code, la app móvil, Slack, GitHub Actions y GitLab.
La idea claveEn un chat tú eres el puente: copias contexto, pegas respuestas y corres comandos. Con un agente, él recorre ese puente: busca contexto, edita, corre los tests y lee los errores por su cuenta. Tu trabajo pasa a ser dirigir y verificar.
Lección 1.2
Instalación, login y actualización
Necesitas una terminal, un proyecto y una cuenta: suscripción Claude (Pro, Max, Team o Enterprise), una cuenta de Claude Console con créditos de API, o acceso vía un proveedor cloud (Amazon Bedrock, Google Cloud Agent Platform o Microsoft Foundry).
Elige tu sistema
Verifica la instalación e inicia tu primera sesión dentro del proyecto. La primera vez te pide iniciar sesión en el navegador; las credenciales quedan guardadas.
bash
claude --version # imprime la versión seguida de (Claude Code)
cd ~/proyectos/mi-app
claude # sesión interactiva; pide login la primera vez
claude auth status # estado de autenticación (JSON; --text para leerlo)
claude update # actualizar a la última versión
claude install stable # reinstalar en el canal estable
claude doctor # diagnóstico de instalación y settings, sin abrir sesión
Canales y actualizaciónLa instalación nativa se actualiza sola en segundo plano. Homebrew y WinGet no: usa brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode. En Homebrew, claude-code sigue el canal estable (cerca de una semana atrás) y claude-code@latest recibe cada versión al salir.
Si algo fallaSi la shell dice que claude no existe, el directorio de instalación no está en tu PATH: abre una terminal nueva. Dentro de una sesión, /doctor hace un chequeo completo y puede aplicar arreglos tras tu confirmación.
Lección 1.3
El loop agéntico y las herramientas
Cuando le das una tarea, Claude trabaja en tres fases que se mezclan: reunir contexto, actuar y verificar. Se repiten hasta cumplir el objetivo. Una pregunta puede necesitar solo contexto; un bug recorre las tres fases varias veces. Tú también eres parte del loop: puedes interrumpir en cualquier momento.
Las cinco categorías de herramientas
Categoría
Qué puede hacer Claude
Operaciones de archivo
Leer, editar, crear, renombrar y reorganizar archivos
Búsqueda
Encontrar archivos por patrón, buscar contenido con regex, explorar el código
Ejecución
Correr comandos de shell, levantar servidores, tests y git
Web
Buscar en la web, leer documentación, investigar mensajes de error
Inteligencia de código
Ver errores de tipos tras editar, ir a la definición, buscar referencias (requiere un plugin de code intelligence)
Además tiene herramientas para lanzar subagentes, hacerte preguntas y orquestar tareas. Todo lo que verás en Avanzado (skills, MCP, hooks, subagentes) es una capa encima de este loop.
A qué tiene acceso
Tu proyecto: el directorio donde lo lanzaste y sus subdirectorios; archivos de otras rutas con tu permiso.
Tu terminal: cualquier comando que tú podrías correr (builds, git, gestores de paquetes, scripts).
Tu estado de git: rama actual, cambios sin commit e historial reciente.
Tu memoria: CLAUDE.md y la auto memory (lo verás en Intermedio).
Lección 1.4
Tu primera sesión
Practica en este simulador. Escribe comandos o usa las sugerencias. Dentro del input, Shift+Tab cambia el modo de permisos y verás cómo cambia la respuesta del agente.
Simulador de terminal
>
opus · ~/mi-app
Comandos desde tu shell
Comando
Qué hace
claude
Sesión interactiva
claude "explica este proyecto"
Sesión interactiva con un prompt inicial
claude -n auth-refactor
Sesión con nombre, para retomarla después con claude -r auth-refactor
claude -c
Continúa la conversación más reciente en este directorio
claude -r
Abre el selector de sesiones anteriores
claude -p "explica esta función"
Una consulta sin interfaz y termina (modo headless, nivel Experto)
cat logs.txt | claude -p "explica"
Procesa contenido recibido por pipe
Dentro de la sesión: /help lista comandos, /exit (o Ctrl+D dos veces) sale, y /powerup abre lecciones interactivas con demos animadas para descubrir funciones.
Lección 1.5
Prefijos: /!@ y más
El primer carácter de tu mensaje cambia lo que pasa. Son la forma más rápida de darle contexto preciso sin escribir párrafos.
Prefijo
Qué hace
Ejemplo
/ al inicio
Comando o skill. Tab autocompleta.
/compact
! al inicio
Modo shell: corre el comando directo, agrega su salida a la sesión y Claude responde a ella
!git status
@
Menciona un archivo o carpeta con autocompletado; también invoca subagentes
@src/lib/db.ts
? con input vacío
Muestra el panel de atajos
?
:
Shortcode de emoji
:rocket:
Contenido rico
Imágenes: pega con Ctrl+V (en iTerm2 Cmd+V, en Windows Alt+V) o arrastra el archivo. Se inserta un chip [Image #1] que puedes referenciar.
URLs: pásale enlaces a documentación; con /permissions puedes preaprobar dominios frecuentes.
Pipes:cat error.log | claude -p "explica este error".
Deja que busque: no necesitas decirle qué archivos leer; descríbele el problema y él investiga.
TipUn !comando que corres tú entra a la conversación como parte de tu mensaje. Es útil para anclar a Claude en una salida real (por ejemplo, !npm test) sin que tenga que ejecutarla él.
Haz clic en cada tecla para ver qué hace y cuándo usarla. En macOS, los atajos con Option requieren configurar Option como Meta en tu terminal.
Teclado interactivo
↑ elige una tecla
Saltos de líneaPara escribir varias líneas en el input, /terminal-setup instala Shift+Enter en VS Code, Cursor, Alacritty y Zed. Puedes personalizar todos los atajos con /keybindings.
No necesitas prompts perfectos. Claude Code es conversacional: empiezas con lo que quieres y vas corrigiendo. Lo importante es corregir temprano.
Quieres…
Haz esto
Detenerlo ya
Esc. Cancela la herramienta en curso, conserva el trabajo hecho y espera tu instrucción.
Corregir sin detenerlo
Escribe y presiona Enter. El mensaje queda en cola; si Claude está corriendo herramientas, lo lee apenas terminen, dentro del mismo turno.
Enviar ya lo encolado
Ctrl+Enter
Deshacer lo que hizo
EscEsc (con input vacío) o /rewind, o pídele "deshaz eso"
Hacer una pregunta al margen
/btw ¿qué versión de Node usa este repo?. La respuesta no entra al historial, así no crece el contexto.
Recuperar un borrador
Ctrl+S guarda el input en reserva y lo restaura después
Delegar, no dictarTrátalo como a un colega capaz: dale contexto y dirección, y deja que resuelva los detalles. "El checkout falla para usuarios con tarjeta vencida. El código está en src/payments/. ¿Puedes investigar y arreglarlo?" funciona mejor que una lista de archivos a abrir.
Lección 1.8
Prompts que funcionan
Claude infiere intención, pero no lee mentes. Las cuatro estrategias de la guía oficial: acotar la tarea (archivo, escenario, preferencias), apuntar a la fuente que responde la pregunta, referenciar patrones existentes del repo y describir el síntoma (qué pasa, dónde, cómo se ve "arreglado").
Laboratorio de prompts
Precisión del cambio
Acierto a la primera
Cambios seguros (no toca lo que no debe)
Puede verificar solo
valores ilustrativos
Lo vago también tiene su lugarCuando estás explorando y puedes corregir el rumbo, un prompt abierto como "¿qué mejorarías en este archivo?" puede mostrarte cosas que no se te habrían ocurrido preguntar.
Lección 1.9
Verificación: la regla de oro
Claude se detiene cuando el trabajo parece terminado. Sin un chequeo que pueda correr, "parece terminado" es la única señal, y tú te conviertes en el loop de verificación. Con algo que devuelva pasa/falla (tests, código de salida de un build, un linter, un script que compara contra un fixture, una captura de pantalla), el loop se cierra solo.
Estrategia
Antes
Después
Criterios verificables
"implementa una función que valide emails"
"escribe validateEmail. Casos: user@example.com es true, invalid es false, user@.com es false. Corre los tests al terminar"
UI visual
"mejora el dashboard"
"[captura] implementa este diseño, toma una captura del resultado, compáralas, lista diferencias y corrígelas"
Causa raíz
"el build está fallando"
"el build falla con este error: [error]. Arréglalo y verifica que el build pase. Ataca la causa raíz, no suprimas el error"
Cuatro niveles de exigencia
En un prompt: pide que corra el chequeo e itere en el mismo mensaje.
En toda la sesión: fíjalo como condición con /goal; un evaluador revisa después de cada turno (nivel Experto).
Como compuerta determinista: un hook Stop que corre tu chequeo y no deja terminar el turno hasta que pase (nivel Avanzado).
Con segunda opinión: un subagente revisor con contexto limpio intenta refutar el resultado, así quien hizo el trabajo no se califica a sí mismo.
Pide evidenciaPide que muestre la salida de los tests, el comando que corrió y lo que devolvió, o una captura. Revisar evidencia es más rápido que volver a verificar tú, y funciona para sesiones que no estabas mirando. Después de que su chequeo pase, /verify confirma el cambio en la app corriendo.
Lección 1.10
Git conversacional
Claude entiende git y lo usa vía Bash. Pídele operaciones en lenguaje natural: compone los comandos, lee el diff y escribe mensajes de commit descriptivos.
prompts
¿qué archivos cambié?
haz commit de mis cambios con un mensaje descriptivo
crea una rama feature/checkout-v2
muéstrame los últimos 5 commits y resume qué cambió
revisa la historia de git de ExecutionFactory y explica cómo llegó a esa API
ayúdame a resolver los conflictos de merge
/diff muestra los cambios de tu árbol de trabajo, incluidas las ediciones de Claude.
Instala el CLI gh: Claude sabe usarlo para issues, PRs y comentarios, y evita los límites de la API sin autenticar.
Claude agrega líneas de atribución a commits y PRs. Se configuran con el setting attribution.
CuidadoPush y reescribir historia afectan a otros. Mantén esas acciones detrás de reglas ask (Intermedio). En modo auto, el clasificador bloquea por defecto force push, git reset --hard y similares.
Lección 1.11
Haz que Claude te enseñe
Claude Code puede explicar cómo usarse a sí mismo. Hay un subagente incluido, claude-code-guide, dedicado a responder preguntas sobre sus funciones.
prompts
¿cómo configuro hooks?
¿cuál es la mejor forma de estructurar mi CLAUDE.md?
¿cómo creo una skill personalizada?
Para onboarding en un repo nuevo
Hazle las preguntas que le harías a un ingeniero senior del equipo: "¿cómo funciona el logging?", "¿cómo creo un endpoint nuevo?", "¿qué casos borde maneja CustomerOnboardingFlowImpl?", "¿por qué este código llama a foo() en vez de bar() en la línea 333?". No requiere prompts especiales.
/init genera un CLAUDE.md inicial analizando el proyecto.
/powerup enseña funciones con lecciones interactivas.
/insights genera un reporte HTML de cómo usas Claude Code, dónde hay fricción y qué funciones probar.