01
Nivel 01 · Básico

Primeros pasos

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.

EntornoDónde corre el códigoÚsalo para
LocalTu máquinaEl caso por defecto: acceso total a tus archivos, herramientas y entorno
NubeVMs gestionadas por Anthropic, o entornos self-hosted de tu organizaciónDelegar tareas que siguen corriendo con el laptop cerrado, o repos que no tienes en local
Remote ControlTu máquina, controlada desde el navegador o el celularSeguir 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íaQué puede hacer Claude
Operaciones de archivoLeer, editar, crear, renombrar y reorganizar archivos
BúsquedaEncontrar archivos por patrón, buscar contenido con regex, explorar el código
EjecuciónCorrer comandos de shell, levantar servidores, tests y git
WebBuscar en la web, leer documentación, investigar mensajes de error
Inteligencia de códigoVer 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

ComandoQué hace
claudeSesión interactiva
claude "explica este proyecto"Sesión interactiva con un prompt inicial
claude -n auth-refactorSesión con nombre, para retomarla después con claude -r auth-refactor
claude -cContinúa la conversación más reciente en este directorio
claude -rAbre 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.

PrefijoQué haceEjemplo
/ al inicioComando o skill. Tab autocompleta./compact
! al inicioModo 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íoMuestra 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.
A fondoTodos los comandosCada comando con sus opciones y ejemplos, buscable.→
Lección 1.6

Atajos de teclado esenciales

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.
A fondoTodos los atajosAtajos de teclado agrupados, flags y subcomandos de la CLI.→
Lección 1.7

Interrumpir y redirigir

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 yaEsc. Cancela la herramienta en curso, conserva el trabajo hecho y espera tu instrucción.
Corregir sin detenerloEscribe y presiona Enter. El mensaje queda en cola; si Claude está corriendo herramientas, lo lee apenas terminen, dentro del mismo turno.
Enviar ya lo encoladoCtrl+Enter
Deshacer lo que hizoEsc Esc (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 borradorCtrl+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.

EstrategiaAntesDespué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.
  • /release-notes muestra el changelog por versión.
Quiz final

Quiz · Nivel Básico

Responde todas correctamente para aprobar