Skip to content

Claude Code Uso: el agente de programación con IA en la terminal ​

En la lección anterior dejaste Claude Code en estado «utilizable»; en esta lección de 15 minutos lo llevarás a «confortable»: iniciar una sesión, asignar tareas con una frase, referenciar archivos con @, activar el modo plan, revisar los cambios y hacer commit. Este tutorial de Claude Code se centra en la terminal CLI, la forma principal —es la forma con más funciones completas de la documentación oficial, y las demás formas (plugin de IDE, versión de escritorio, versión web) comparten el mismo motor; las repasaremos todas juntas más adelante. (Fecha de verificación de hechos 2026-11-04; los comandos y funciones cambian con las versiones, consulta la documentación oficial como referencia.)

Qué podrás hacer al terminar ​

  • Iniciar Claude Code en cualquier directorio de proyecto y entender la versión, el modelo y el directorio de trabajo que aparecen sobre el prompt
  • Con una frase concreta en lenguaje natural, hacer que modifique código, arregle bugs, escriba tests — él mismo lee los archivos y ejecuta comandos
  • Usar @ para «alimentar» la conversación con archivos concretos, usar / comandos rápidos y ! para ejecutar comandos shell directamente
  • Para cambios grandes, activar primero el modo plan (plan mode), revisar el plan y luego dejar que actúe
  • Usar /diff para revisar los cambios, luego pedirle que escriba el mensaje de commit y cree un PR, y al final cerrar la sesión sabiendo interrumpir, limpiar y retomar la conversación

Tu situación actual ​

  • Lo instalaste, pero al abrir la terminal no sabes «qué decir»: envías una frase y la dirección de sus cambios no coincide con lo que pensabas, y vas y vienes sin avanzar
  • Los tutoriales en chino de Claude Code que hay en internet o solo hablan de la instalación, o saltan directamente a MCP, subagentes y otras cosas avanzadas, y de los trucos del día a día nadie explica nada con claridad
  • Modificó un montón de archivos y no sé qué cambió ni cómo revisarlo, no me atrevo a hacer commit directamente; la sesión se alarga cada vez más y parece lenta y cara

Cuándo usar esta técnica ​

Cuando necesitas:

  • Que la IA lea directamente tu proyecto, modifique archivos, ejecute comandos y haga commit desde la terminal — en lugar de copiar y pegar en el chat de una página web
  • Delegar con una frase las tareas cotidianas de desarrollo: arreglar bugs, escribir tests, refactorizar, generar mensajes de commit
  • Cambios bajo control: ver primero el plan, luego modificar el código, poder revisar al terminar y poder revertir si no te convence

Y no quieres:

  • Reabrir una herramienta y volver a explicar el contexto del proyecto cada vez que cambias de tarea
  • Que la IA modifique archivos a escondidas sin que te enteres
  • Rendirte antes de usar las funciones avanzadas (MCP, Skills, subagentes) — esas se explican en el manual avanzado

🎒 Preparativos antes de empezar ​

  • Haber completado la lección anterior Instalación de Claude Code: claude --version imprime el número de versión y ya has hecho el primer inicio de sesión (suscripción o cuenta de Console, elige una de las dos; si no logras instalarlo, ve primero a Qué hacer si no se instala)
  • Una suscripción a Claude (Pro / Max / Ultra / Team / Enterprise) o una cuenta de Console — el requisito oficial para la mayoría de las formas; los precios de cada nivel están en Comparación de precios, y los hechos sobre políticas regionales en el recuadro de la lección de instalación
  • Un proyecto de práctica dentro de un repositorio git (en el paso 5 de esta lección se hace commit; si aún no tienes proyecto, no pasa nada, Claude puede ayudarte a crear uno desde cero)
  • 15 minutos sin interrupciones

💡 ¿Poca experiencia con la terminal?

La documentación oficial incluye una guía específica para principiantes de terminal, cuya primera frase es «incluso si nunca has usado una terminal, puedes usar Claude Code». La terminal es solo una ventana de «escribir → Enter → ejecutar», y cada comando de esta lección se puede copiar y pegar directamente.

Idea central ​

Claude Code es, según la documentación oficial de Anthropic, una agentic coding tool (herramienta de programación agéntica): lee tu repositorio de código, edita archivos, ejecuta comandos y se conecta a tus herramientas de desarrollo — no es un chat de «pegas código y te da una respuesta», sino un agente de «le asignas la tarea y la completa».

La diferencia fundamental con el chat de IA en la web:

Chat de IA en la webClaude Code (terminal)
Código en el contextoCopias y pegas manualmenteÉl mismo lee los archivos del proyecto
Modificar códigoTe da fragmentos y los pegas túEdita los archivos directamente, /diff verificable
VerificaciónTú mismo ejecutas los comandosPuede ejecutar tests, ver los errores y corregirlos solo
CommitTú mismo escribes el commitCon una frase le pides que escriba el mensaje de commit y abra un PR

Cuatro formas, un solo motor. Claude Code no existe solo como terminal; cada forma se conecta al mismo motor subyacente — el CLAUDE.md de tu proyecto, la configuración y los servidores MCP son comunes a todas las formas:

FormaDefinición en una frase
CLI de terminal (hilo principal de esta lección)La forma principal con más funciones: edita archivos, ejecuta comandos y gestiona todo el proyecto
Plugin de VS Code / JetBrainsÚsalo dentro del editor: diff en línea, referencias con @, revisión de planes, historial de sesiones (el plugin de JetBrains requiere instalar la CLI aparte)
Aplicación de escritorioApp independiente fuera del IDE y de la terminal: visualización de diffs, varias sesiones en paralelo, tareas programadas
Versión webAbre claude.ai/code en el navegador, sin instalación local: ejecuta tareas largas y multitarea en paralelo

El principio clave para el uso diario es uno solo: tú explicas con claridad «qué hacer, dónde hacerlo y cómo debe quedar», y Claude se encarga de leer, modificar, ejecutar y verificar. Si se desvía, lo interrumpes con Esc; si cambia algo mal, retrocedes; y al terminar una tarea, limpias con /clear—este ciclo es exactamente el de los seis pasos de esta lección.

Hazlo conmigo ​

Paso 1: entra en el directorio del proyecto e inicia una sesión de Claude Code ​

Por qué: Claude Code trabaja en el directorio donde lo inicias—primero haz cd para entrar en el proyecto, y así lo que lee serán los archivos de este proyecto.

bash
cd /path/to/your/project
claude

Deberías ver: aparece el prompt, y arriba se muestran tres datos: número de versión, modelo actual y directorio de trabajo. Una sesión de terminal recién abierta entra por defecto en modo auto (las operaciones normales se ejecutan directamente; las acciones con riesgo pasan primero por una revisión de seguridad que bloquea lo que debe bloquear), y el modelo predeterminado en la mayoría de las suscripciones es Claude Opus 5.5.

Un punto de entrada útil de inmediato:

text
/help

Deberías ver: la lista de comandos disponibles. Al escribir / se abre un menú de comandos; escribiendo / más unas letras puedes filtrar.

  • Comprobación rápida: arriba del prompt se ven la versión, el modelo y el directorio de trabajo, y /help lista los comandos

Paso 2: el núcleo del tutorial de Claude Code: ¿cómo se usa? Explica una tarea con claridad, como al asignar trabajo ​

Por qué: cuanto más específico es el prompt, menos rondas de rework te ahorras. El ejemplo comparativo de las mejores prácticas oficiales—decir vagamente «arregla el bug del login» obliga a Claude a adivinar; si especificas el archivo, el síntoma y el criterio de «arreglado», da en el blanco a la primera.

❌ Asignación vaga:

text
fix the login bug

✅ Asignación específica (texto original del ejemplo oficial):

text
users report login fails after the session times out. look at token refresh in src/auth/, write a failing test that reproduces it, then fix it

Cómo pedir los tipos de tarea habituales (todos tomados de la guía oficial de flujos de trabajo):

TareaTú dices
Arreglar un bugI'm seeing an error when I run npm test (pega el mensaje de error tal cual)
Escribir testswrite tests for the auth module, run them, and fix any failures
Entender el códigogive me an overview of this codebase
Buscar códigofind the files that handle user authentication

Deberías ver: Claude va por sí mismo a leer los archivos, enumera los puntos a modificar y luego se pone a editar; cuando hace falta ejecutar comandos para verificar, los ejecuta él mismo (por ejemplo, correr de nuevo el test que fallaba, para verlo ponerse en verde).

💡 Si quieres la «versión completa», dilo explícitamente

Las mejores prácticas oficiales mencionan una frase que sigue funcionando: be ambitious. Claude tiende a hacer la versión mínima que «apenas cumple el requisito»—si quieres la versión completa, que también cubra los casos límite y conecte bien el flujo de guardado, añade esta frase al prompt.

  • Comprobación rápida: asigné una tarea concreta y vi a Claude leer archivos, modificarlos y ejecutar comandos por sí mismo

Paso 3: usa @ para meter archivos y directorios en la conversación ​

Por qué: esperar a que Claude encuentre los archivos por sí mismo lleva tiempo; la referencia con @ hace que el contenido del archivo indicado entre directamente en la conversación, y así puede trabajar de inmediato sobre ese archivo.

Referenciar un solo archivo (ejemplo oficial):

text
Explain the logic in @src/utils/auth.js

Referenciar un directorio entero (lo que obtienes es una lista de archivos, no todo el contenido):

text
What's the structure of @src/components?

Deberías ver: al escribir @ se abre un menú de sugerencias de rutas; pulsa Tab o Enter para aceptar la ruta resaltada y luego Enter para enviar; tras el envío, el contenido del archivo entra en la conversación y la respuesta de Claude gira directamente en torno a ese archivo.

Dos límites que conviene conocer (cifras del texto original de la documentación oficial): el contenido de un solo archivo entra en la conversación con un máximo por defecto de 25,000 tokens; los archivos de texto de más de 256KB no se cargan automáticamente.

  • Comprobación rápida: referencié un archivo con @ y la respuesta de Claude se basa claramente en su contenido

Paso 4: para cambios grandes, activa primero el modo plan y revisa el plan antes de actuar ​

Por qué: hay cambios cuyo plan quieres ver antes de que se escriban en disco. En modo plan (plan mode), Claude solo lee archivos y propone un plan, sin modificar ninguno—hasta que tú lo apruebas.

Dos formas de activarlo, a elección:

bash
claude --permission-mode plan

O bien, con la sesión en curso, pulsa Shift+Tab para alternar cíclicamente entre los modos de permisos.

Deberías ver: aparece ⏸ plan mode on en la barra de estado. Claude lee archivos y propone un plan de cambios esperando tu revisión; solo empieza a editar cuando lo apruebas.

De paso, memoriza la fila de modos a la que te lleva Shift+Tab: Manual (cada paso requiere tu visto bueno) → acceptEdits (acepta ediciones automáticamente) → plan (solo planifica, no actúa)—en el día a día empieza con el modo auto predeterminado y cambia a plan para los cambios grandes de los que no estás seguro. La disciplina de «primero planificar, luego actuar» sirve para todas las herramientas de programación con IA; para más detalle, ver Primero planificar, luego actuar: convierte una idea de una frase en una lista de requisitos.

  • Comprobación rápida: sé reconocer ⏸ plan mode on en la barra de estado y sé que en ese momento Claude no modifica archivos

Paso 5: revisa los cambios con /diff y luego pídele hacer commit o abrir un PR ​

Por qué: el código escrito por IA hay que revisarlo antes de integrarlo. /diff te permite ver todos los cambios del área de trabajo sin salir de la terminal—incluidos los que acaba de hacer Claude y los tuyos sin confirmar.

Escribe en la sesión:

text
/diff

Deberías ver: la lista de archivos modificados, cada uno con el número de líneas añadidas/eliminadas, y debajo el diff concreto. Con el renderizado a pantalla completa es un panel persistente (se actualiza automáticamente cada vez que Claude modifica un archivo); con el renderizador antiguo es un diálogo que se cierra con Esc al terminar de verlo.

Si tras revisarlo todo está bien, pídele que haga commit (ejemplo oficial):

text
commit my changes with a descriptive message

Para abrir un PR, continúa diciendo:

text
create a pr

Deberías ver: Claude opera git directamente—prepara los cambios, escribe el mensaje de commit, crea la rama y abre el PR; cuando el PR está creado, te da el enlace. Está integrado de forma nativa con git, así que estos pasos no requieren que escribas ni un comando de git.

  • Comprobación rápida: revisé los cambios con /diff y le pedí a Claude completar un commit o un PR

Paso 6: cierre de sesión—interrumpir, limpiar, retomar ​

Por qué: la gestión de sesiones determina si «al día siguiente sigues con ganas de abrirla». Cuatro acciones cubren los escenarios de cierre más habituales:

EscenarioAcciónEfecto
Claude se desvíapulsa Escinterrumpe al instante, conserva el trabajo ya hecho y tú vuelves a marcar la dirección
Quieres retroceder unos pasoscon la entrada vacía, pulsa dos veces Escabre el menú de retroceso y restaura el código, la conversación o ambos a un punto anterior
Cambias a una tarea no relacionada/clearlimpia el contexto y empieza de cero—recomendación oficial: si corriges lo mismo dos veces y sigue mal, haz /clear y reescribe el prompt, no vayas a la tercera
Mañana sigues con ellotras salir, ejecuta claude --continueretoma la sesión más reciente del directorio actual; claude --resume elige de la lista

Deberías ver: claude --continue vuelve directamente con el contexto de la conversación anterior (si aún no hay sesión en el directorio actual, imprime No conversation found to continue y sale—en ese caso, abre una sesión nueva con claude).

💡 Ponle nombre a las sesiones de tareas largas

Ejecuta en la sesión /rename <名字> (el ejemplo oficial usa /rename oauth-migration); después, en la terminal, con claude --resume <名字> podrás recuperarla con precisión, y los puntos de retroceso también se conservan.

  • Mini verificación: he interrumpido a Claude una vez con Esc y he retomado con éxito una sesión con claude --continue

Punto de control ✅ ​

  • Puedo iniciar Claude Code en el directorio del proyecto y reconocer la versión, el modelo y el directorio de trabajo sobre el prompt
  • Sé asignar tareas concretas: especificar el archivo, el síntoma y el criterio de «quedar arreglado», en lugar de un simple «ayúdame a arreglar el bug»
  • Sé usar @ para referenciar archivos, / para abrir el menú de comandos y ! para ejecutar comandos shell directamente (por ejemplo ! npm test; la salida entra en la conversación y Claude responde automáticamente)
  • Para cambios grandes activo plan mode antes de empezar (claude --permission-mode plan o Shift+Tab), y me quedo tranquilo al ver ⏸ plan mode on
  • Reviso los cambios primero con /diff antes de dejar que los confirme; en las sesiones uso Esc para interrumpir, /clear para limpiar y claude --continue para continuar

Advertencias de errores comunes ​

❌ Una frase demasiado vaga: diez rondas de ida y vuelta sin dar en el blanco ​

Formas de asignar tareas como «optimiza un poco este proyecto» o «arregla este bug» obligan a Claude a adivinar. La comparación de las mejores prácticas oficiales: sustituir "fix the login bug" por «los usuarios reportan que el login falla tras expirar la sesión; revisa la actualización del token en src/auth/, escribe primero un test fallido que reproduzca el problema y luego arréglalo»—con archivo, síntoma y criterio de aceptación, los tres completos, normalmente se acierta en una sola ronda.

❌ No sé qué cambió y lo confirmó directamente ​

Un cambio hecho por IA no equivale a un cambio correcto. El orden correcto: /diff revisar → dejar que confirme solo cuando estés satisfecho. Dos garantías adicionales: primera, gestionar el proyecto con git—la documentación oficial dice claramente que los puntos de retroceso (checkpoint) solo cubren los archivos que Claude modificó con herramientas de archivos, y que los archivos que solo tocó con comandos Bash quedan fuera del alcance de la recuperación, así que git es la red de seguridad; segunda, para cambios grandes activar primero plan mode y escribir en disco solo tras revisar el plan.

❌ Apilar tres tareas no relacionadas en una sola sesión: cada vez más lento y más caro ​

La guía oficial de costes lo explica: cada petición se envía con toda la conversación—le estás entregando el historial de tres tareas a la cuarta ronda. Lo correcto: al cambiar de tarea, usar /clear, con coste cero; cuando una sesión larga necesita conservar lo esencial, usar /compact con una frase que indique el foco (por ejemplo /compact keep the API changes and the test commands).

❌ Quedarse esperando mientras Claude trabaja, o golpear Enter sin parar para interrumpirlo ​

Mientras trabaja puedes seguir escribiendo directamente el siguiente mensaje—Claude Code pone el mensaje en cola y lo procesa en orden al terminar la ronda actual (con Ctrl+Enter se envía la cola al instante). Usa Esc para interrumpir solo cuando quieras cambiar de dirección; interrumpir no pierde el trabajo: todo lo ya completado se conserva.

Técnicas avanzadas (opcional) ​

Deja un «manual de instrucciones» para el proyecto. Coloca un CLAUDE.md en la raíz del proyecto con los comandos de verificación, las convenciones y los escollos—Claude Code lo lee en cada sesión. Ejecutando /init en una sesión se genera un borrador inicial a partir del código base, y /context permite confirmar si se ha cargado. Para una explicación detallada de cómo escribirlo, ver AGENTS.md y CLAUDE.md: deja un manual del proyecto para la IA.

Delega a subagentes las tareas en las que dejarlo investigar por sí mismo resulta demasiado lento. Explorar un código base grande satura el contexto de la conversación principal; la recomendación oficial es delegar el trabajo de investigación:

text
use a subagent to investigate how our auth system handles token refresh

Los subagentes leen archivos en su propia ventana de contexto y solo traen de vuelta las conclusiones.

Abre dos sesiones en paralelo sin pisarse. Usa git worktree para dar a cada sesión un checkout independiente:

bash
claude --worktree feature-auth

Ejecútalo otra vez en una segunda terminal con un nombre distinto y tendrás sesiones paralelas aisladas (el repositorio necesita al menos un commit).

Usa Claude Code como una herramienta Unix. Entrada y salida por tuberías, ideal para procesamiento por lotes y CI:

bash
git log --oneline -20 | claude -p "summarize these recent commits"

Vigila el uso y ajusta la intensidad. En una sesión, /usage muestra en qué se gasta el uso—los planes de suscripción (Pro/Max/Ultra/Team/Enterprise) lo desglosan por habilidades, subagentes, plugins y servidores MCP; /effort high para que piense más (bugs difíciles), /effort low para que entregue borradores rápidos (tú revisas paso a paso al lado).

También puedes pegar imágenes. Pega directamente la captura del error con Ctrl+V (en Windows/WSL usa Alt+V), o arrástrala a la ventana, y luego pregunta Here's a screenshot of the error. What's causing it?.

Resumen de la lección ​

✅ Claude Code: el hilo cotidiano del tutorial = entrar al directorio e iniciar → asignar tareas concretas → @ dar archivos → activar plan para cambios grandes → /diff revisar y confirmar → cerrar con Esc//clear/--continue. Con esos seis pasos en marcha, es un agente de programación en la terminal disponible a todas horas.

✅ Es un agente, no un chatbox: lee el código base por sí mismo, edita archivos, ejecuta comandos y opera git—tú te encargas de dejar claro «qué hacer, dónde y con qué resultado».

✅ Cuatro formas, un mismo motor: CLI de terminal (esta lección), plugins de VS Code/JetBrains, aplicación de escritorio y versión web claude.ai/code; CLAUDE.md, ajustes y MCP funcionan igual en todas las formas.

✅ Trío de controlabilidad: el modo auto intercepta operaciones de riesgo, plan mode permite revisar el plan primero, y /diff + git como red de seguridad para retroceder.

✅ La esencia del prompt: archivo + síntoma + criterio de aceptación; para la versión completa añade be ambitious; si dos correcciones no dan resultado, reescribe con /clear.

Repaso de las operaciones clave:

OperaciónCómoNota
Iniciar sesióncd 项目目录 y luego ejecutar claudeSobre el prompt se muestran versión/modelo/directorio de trabajo
Asignar tareaEscribir directamente la descripción de la tareaEspecificar archivo, síntoma y criterio de aceptación
Dar archivos@src/utils/auth.jsPor defecto, un solo archivo ≤25,000 tokens entra en la conversación
Ejecutar comandos! npm testLa salida entra en la conversación y Claude responde automáticamente
Activar plan modeclaude --permission-mode plan o Shift+TabLa barra de estado muestra ⏸ plan mode on
Ver cambios/diffLista los archivos modificados y las líneas añadidas/eliminadas
Confirmar/abrir PRcommit my changes with a descriptive message / create a prOpera git directamente
Continuar sesiónclaude --continue (la más reciente) / claude --resume (elegir)Sin sesión, imprime No conversation found to continue

Avance de la próxima lección ​

Cuando domines Claude Code, en la próxima lección verás la herramienta equivalente del bando de OpenAI: Codex Uso: el agente de codificación local de OpenAI.

Aprenderás:

  • Codex es: el posicionamiento oficial lo describe como «un agente de codificación que se ejecuta localmente en tu ordenador»; semejanzas y diferencias con el enfoque de agente de Claude Code
  • El proceso para iniciar sesión en la CLI de Codex con una cuenta de ChatGPT (tras codex, elegir Sign in with ChatGPT)
  • Codex en sus cuatro formas: CLI, extensión de IDE, aplicación de escritorio codex app y versión web
  • Cómo elegir entre las dos herramientas y cómo usarlas en conjunto: la tabla completa de costes está en comparación de precios
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.