Introducción a Claude Code
Qué es, qué puede hacer y en qué se diferencia realmente de ChatGPT / Copilot / Cursor
📚 Navegación de la serie: Este es el primer artículo del "Tutorial para principiantes de Claude Code". Desde aquí, lo instalaremos, nos familiarizaremos con él y, finalmente, lo integraremos en tu flujo de trabajo diario de desarrollo. En el próximo artículo procederemos con la instalación.
Hermanos, hoy hablaremos de Claude Code.
Supongo que si hiciste clic aquí, probablemente te encuentres en este estado: siempre hay alguien hablando de "lo increíble que es Claude Code", y en X (Twitter) a menudo ves capturas de pantalla de "lo hice refactorizar el proyecto con una sola frase", pero abres su sitio web oficial y, después de mirar un buen rato, aún no entiendes: ¿En qué se diferencia exactamente del ChatGPT que uso todos los días? ¿Y en qué se diferencia del Copilot con autocompletado en mi editor?
En pocas palabras, al tener la palabra "Code" en el nombre, es fácil pensar que es solo una "caja de chat que puede escribir código". Pero una vez que lo uses, descubrirás que esta idea está bastante lejos de la realidad.
Este artículo no te enseñará a instalarlo ni a escribir comandos (eso es para el próximo artículo). Este artículo solo hace una cosa: explicarte claramente "qué es exactamente Claude Code", para que tengas un mapa general en tu mente: saber qué puede hacer, qué no puede hacer y en qué escenarios deberías usarlo en lugar de otras herramientas. Con el mapa, no te perderás en los siguientes pasos.
Después de leer este artículo, obtendrás:
- Una frase para explicar claramente "qué es Claude Code" a los demás
- Una lista de "lo que puede hacer / lo que no puede hacer", para conocer su límite superior
- Una tabla de comparación, para que nunca más lo confundas con ChatGPT / Copilot / Cursor
- Un criterio de juicio: qué tareas deberías delegarle y para cuáles no deberías depender de él
01 ¿Qué es exactamente Claude Code?
Primero la conclusión: Claude Code es el "compañero de programación de IA en versión de línea de comandos" oficial de Anthropic: puede leer todo tu proyecto, modificar archivos directamente y ejecutar comandos, en lugar de simplemente responderte con un bloque de código en una caja de chat.
Anthropic es la empresa detrás del modelo grande Claude (puedes entenderlo como un competidor de OpenAI, la empresa detrás de ChatGPT). Claude Code es una herramienta creada por esta empresa específicamente para el escenario de "escribir código".
Aquí hay una diferencia clave donde los principiantes suelen equivocarse:
Analogía: Consultor vs. Compañero a tu lado. La versión web de Claude (o ChatGPT) es como un consultor: tomas una captura de pantalla del código, copias y pegas para él, él echa un vistazo y te da ideas, pero la tarea de modificar el código todavía tienes que hacerla tú mismo manualmente. Claude Code es diferente, es como un compañero real sentado junto a tu escritorio: todo tu proyecto está extendido frente a él, puede revisar archivos directamente, modificarlos por sí mismo e incluso ejecutarlo para ver si es correcto.
Esta diferencia, en la práctica, es una gran diferencia en la experiencia.
Por ejemplo. Al modificar un pequeño proyecto de Python con la versión web de Claude, el flujo de trabajo es el siguiente: copias el mensaje de error y lo pegas en el cuadro de diálogo → te dice en qué archivo podría estar el problema → cambias de nuevo a tu editor para encontrar ese archivo → copias el código relevante y lo pegas de nuevo → te da sugerencias de modificación → lo copias manualmente de vuelta al editor. Un pequeño bug implica cambiar de ventana cinco o seis veces, y media hora se esfuma. Con Claude Code, para la misma tarea, solo dices "revisa la causa raíz de este error y arréglalo", y él mismo revisará todos los archivos relevantes, localizará el problema, lo arreglará, y en lo que tardas en tomar un sorbo de agua, estará listo.
Con esto, puedes sentir el peso de la palabra "Agente (Agent)": no te da sugerencias, actúa por ti.
💡 Resumen en una frase: Claude Code = Un compañero de programación de IA que puede leer todo tu proyecto y modificarlo directamente, no una "caja de chat que sabe escribir código".
02 Dónde se ejecuta: Más que una terminal oscura
Al mencionar "línea de comandos" o "terminal", la imagen de una ventana negra y oscura viene inmediatamente a la mente de muchos principiantes, lo cual es disuasorio al instante. No entres en pánico, este es un malentendido común.
La terminal (Terminal, la ventana donde escribes comandos en tu computadora) es de hecho la forma más central y completa de Claude Code, pero ya no vive solo en la terminal. Según la documentación oficial, Claude Code ahora tiene varias "identidades":
| Dónde lo usas | Forma | Para quién es adecuado / Qué escenario |
|---|---|---|
| Terminal | CLI (interfaz de línea de comandos) con funciones completas | Aquellos que quieren usar todas las capacidades, escribir scripts y hacer automatizaciones |
| VS Code / Cursor | Extensión del editor, ver cambios en línea | Aquellos que normalmente escriben código en VS Code |
| JetBrains | Plugin para IntelliJ / PyCharm, etc. | Usuarios intensivos de Java / Python |
| App de escritorio | Aplicación independiente, ver diff visualmente, múltiples sesiones paralelas | Aquellos que no quieren tocar la línea de comandos y prefieren interfaces con clics |
| Web / Móvil | Se ejecuta en el navegador o en la App de iOS de Claude | Iniciar una tarea larga temporalmente, verificar el progreso desde el móvil mientras estás fuera |
Aquí hay un punto clave que la documentación oficial enfatiza repetidamente, y lo destaco por separado en negrita:
Todas estas formas están impulsadas por el mismo motor de Claude Code subyacente. Es decir, tu CLAUDE.md (archivo de descripción del proyecto), tu configuración, los servicios MCP (Model Context Protocol) que conectas: configurados en la terminal, tendrán el mismo efecto cuando cambies a VS Code o a tu teléfono. Configúralo una vez, úsalo en todas partes.
Mucha gente usa la terminal como su principal herramienta (están acostumbrados a ella, es la más útil), pero cuando están fuera de casa, pueden usar la versión web para iniciar una tarea larga como "ejecutar pruebas + arreglar casos fallidos", y abrir su teléfono en el camino para echar un vistazo al progreso. Esta experiencia de "continuar trabajando en otro lugar" es algo que la caja de chat web no puede ofrecer.
Recordatorio amistoso: Esta serie asume la terminal como punto de partida por defecto, porque tiene las funciones más completas y puede explicar mejor los principios. Una vez que te familiarices con él, cambiar a VS Code o a la App de escritorio será algo natural.
💡 Resumen en una frase: Claude Code tiene cinco formas: terminal, extensión de editor, App de escritorio, web/móvil, pero es el mismo motor subyacente y la configuración es universal en todas las plataformas.
03 Qué puede hacer: Una lista de "Puede / No puede"
Esta parte es la más práctica. Veamos primero lo que puede hacer: lo he organizado según la documentación oficial, seleccionando las categorías que los principiantes notarán más:
- Entender tu código: "¿Qué hace esta función?" "¿Por qué esto da error?" Responde teniendo en cuenta el contexto de todo el proyecto, no mirando una parte de forma aislada.
- Modificar código en varios archivos: "Cambia todos los
varporlet" "Divide esta función grande en tres pequeñas": realmente lo cambia, no solo da sugerencias. - Arreglar bugs: Lánzale el error, él seguirá la base de código para encontrar la causa raíz, localizar el problema y arreglarlo.
- Hacer las tareas tediosas que siempre pospones: Escribir pruebas para código que no las tiene, limpiar errores de lint, resolver conflictos de fusión, actualizar dependencias, escribir notas de la versión.
- Interactuar con Git: Preparar cambios, escribir mensajes de commit, crear ramas, abrir PRs (Pull Requests) todo en un solo paso.
- Conectarse a herramientas externas: A través de MCP (un estándar abierto, del cual hablaremos en un artículo dedicado más adelante) leer documentos de Google Drive, actualizar tickets de Jira, extraer datos de Slack.
Solo hablar de ello no es lo suficientemente intuitivo. Aquí tienes un comando real de la documentación oficial para que sientas cómo es "dirigir con una sola frase":
claude "write tests for the auth module, run them, and fix any failures"Traducido significa: "Escribe pruebas para el módulo auth, ejecútalas y arregla los fallos por ti mismo". En una sola frase, se encarga de los tres pasos: escribir pruebas, ejecutarlas y arreglar los fallos. Esta es la diferencia fundamental entre "Agente" y "Autocompletado".
Sin embargo, más importante que "lo que puede hacer" es reconocer lo que no puede hacer. Esto es crucial y agregaré mis observaciones:
| ❌ Lo que no deberías esperar | Por qué |
|---|---|
| Que tome decisiones técnicas por ti | Elegir el plan A o el plan B, si vale la pena refactorizar: el juicio y las concesiones son tu trabajo |
| Que garantice que el código no tenga bugs al 100% | Ofrece candidatos de alta calidad, no respuestas absolutamente correctas, tienes que revisarlo tú mismo |
| Que adivine la lógica de negocio que no explicaste claramente | Si no explicas claramente los requisitos, solo puede adivinar |
| Que aloje tu proyecto de forma totalmente automática cuando no lo entiendes en absoluto | Si no lo entiendes, no puedes juzgar si lo modificó correctamente, es como conducir a ciegas |
El error más fácil de cometer es el segundo. Confiar demasiado en él, pedirle que agregue el manejo de errores en lote a un proyecto, modificó rápidamente más de una docena de archivos y lo confirmó sin mirar detenidamente. Como resultado, modificó la lógica por "iniciativa propia" en dos lugares, que solo se descubrieron después de salir a producción. Así que es mejor establecer una regla de oro: por cada línea que modifique, debes al menos echar un vistazo al diff antes de confirmarlo.
La mentalidad fundamental para usar bien Claude Code se resume en una frase:
Deja que Claude Code proporcione soluciones candidatas de alta calidad, no respuestas absolutamente correctas.
Para decirlo sin rodeos: en una frase, el humano establece la dirección, controla la calidad y toma decisiones; la IA se encarga de la ejecución, el análisis y el trabajo repetitivo. Esta es su filosofía de diseño: colaboración, no reemplazo.
💡 Resumen en una frase: Puede leer proyectos, modificar archivos, ejecutar comandos y hacer tareas tediosas, pero tomar decisiones, controlar la calidad y agregar lógica de negocio siempre será tu trabajo: es un compañero, no un sustituto que se hace cargo de todo.
04 En qué se diferencia realmente de ChatGPT / Copilot / Cursor
Esta es la pregunta que más hacen los principiantes y vamos a aclararla de una vez por todas. Primero, una tabla de resumen:
| Dimensión | ChatGPT (Chat web) | Copilot / Cursor (En el editor) | Claude Code |
|---|---|---|---|
| Forma | Caja de chat en Web / App | Extensión en el editor | Disponible en Línea de comandos / Extensión / Escritorio / Web |
| Cómo trabaja | Tú preguntas, él responde | Escribes la mitad, él completa el resto | Das la instrucción, él lo hace por sí mismo |
| Si puede ver tu proyecto | No puede, debes pegar manualmente | Puede ver el archivo actual / parte del contexto | Lee automáticamente todo el proyecto |
| Si puede modificar archivos | No puede, te da sugerencias y tú mismo modificas | Principalmente autocompletado y sugerencias | Puede modificar directamente y ejecutar comandos |
| Más adecuado para | Preguntar conceptos, buscar información, escribir código disperso | Acelerar el proceso en tiempo real al escribir código | Comprensión, refactorización, reparación de bugs y automatización en proyectos reales |
Usemos tres oraciones simples para grabarlo en tu mente:
- ChatGPT es como un consultor: puede hablar un poco de todo, pero está ciego ante tu proyecto; tienes que hacer el trabajo tú mismo.
- Copilot / Cursor es como un teclado predictivo inteligente: mientras escribes código, adivina qué quieres escribir a continuación, ayudándote a escribir más rápido, pero tú sigues siendo el sujeto principal.
- Claude Code es como un compañero que puede trabajar de forma independiente: si explicas claramente lo que quieres, él se encarga del resto, como revisar archivos, modificar código y ejecutar pruebas. Y cuando termina, tú lo aceptas.
Nota: El Cursor / Copilot aquí se refiere a su posicionamiento más clásico de "autocompletado dentro del editor". En los últimos dos años, también han estado desarrollando funciones más orientadas a "agentes" (como el modo Agente de Cursor), por lo que los límites se están difuminando. Pero para comprenderlo desde un nivel principiante, basta con recordar el posicionamiento central de estas tres oraciones. (Las funciones de los productos se actualizan rápidamente, y los detalles están sujetos a las versiones oficiales de cada empresa).
Entonces, ¿cuáles son los puntos fuertes y débiles de Claude Code? En pruebas prácticas:
Sus puntos fuertes: Su capacidad para comprender todo el proyecto es realmente fuerte. Especialmente cuando te haces cargo de un proyecto antiguo incomprensible, pedirle que "primero me explique la arquitectura de este proyecto" es mucho más rápido que leer la documentación tú mismo; la refactorización a gran escala y los cambios entre archivos también son su punto fuerte. Además, puedes usar CLAUDE.md y Skills para "entrenarlo" para que se adapte a tus hábitos (lo cual se explicará en detalle en un artículo posterior).
Sus puntos débiles: No es tan "transparente" como Copilot. Con Copilot, a medida que escribes, él te va completando sin ningún costo operativo; con Claude Code, tienes que iniciar activamente la instrucción y la curva de aprendizaje es un poco más pronunciada. Por lo tanto, no son sustitutos el uno del otro, son complementos: una buena combinación es mantener Copilot activado para el autocompletado mientras escribes código, y cambiar a Claude Code cuando encuentres una tarea que requiera "grandes cambios en muchas partes".
💡 Resumen en una frase: ChatGPT es un consultor, Copilot es un teclado predictivo inteligente, Claude Code es un compañero que puede actuar: asigna el trabajo según la tarea, no tienes que elegir solo uno.
05 Práctica: 30 segundos para confirmar si tu computadora lo reconoce
Aunque dijimos que este artículo no enseña cómo instalarlo, te dejo un pequeño paso de costo cero para confirmar tu entorno (ya sea que lo hayas instalado o no, este comando se ejecutará sin dar errores ni estropear nada).
Abre tu terminal (usa "Terminal" en Mac y PowerShell en Windows), escribe esta línea y presiona Enter:
claude --versionHay dos resultados esperados, y ambos son normales:
- Caso 1: Aparece una cadena con el número de versión, similar a
2.x.x (Claude Code): ¡Felicidades!, ya lo habías instalado antes. Puedes saltar directamente al siguiente artículo "Cómo usarlo". - Caso 2: Error
command not found: claude(en Windows puede ser'claude' no se reconoce como un comando interno o externo): Esto es completamente normal, significa que aún no lo has instalado. Esto es exactamente lo primero que resolveremos en el próximo artículo.
Te adelanto los comandos de instalación que usaremos en el próximo artículo (no te apresures a escribirlos ahora, solo familiarízate con ellos). La versión oficial original es así:
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Lo que esta imagen intenta expresar es: si tomamos "¿Puede comprender automáticamente todo tu proyecto?" y "¿Puede modificar directamente los archivos?" como dos ejes y colocamos las cuatro herramientas, solo Claude Code se mantiene firme en la esquina de "comprender todo y poder actuar". ChatGPT depende de lo manual para ambas cosas, y Copilot/Cursor entiende a nivel local y se basa principalmente en el autocompletado. No importa si no puedes ver la imagen, basta con recordar las tres oraciones de la sección anterior.
Un recordatorio: los usuarios en China continental a menudo necesitan "magia de internet (VPN)" para instalar e iniciar sesión en Claude Code. Explicaremos cómo hacerlo y cómo iniciar sesión en un artículo dedicado, así que no entraremos en detalles aquí.
💡 Resumen en una frase: Un simple
claude --versionconfirmará si tu computadora lo reconoce; no entres en pánico si da error, esa es precisamente la tarea inicial del próximo artículo.
06 Resumen
En este artículo, no escribimos muchos comandos, pero aclaramos lo más importante:
- Qué es: El compañero de programación de IA en versión de línea de comandos oficial de Anthropic, que puede leer todo el proyecto, modificar archivos directamente y ejecutar comandos, no es una "caja de chat que sabe escribir código".
- Dónde usarlo: Terminal, extensión de VS Code/JetBrains, App de escritorio, web/móvil, cinco formas con el mismo motor y configuración universal.
- Puede / No puede: Puede leer código, modificar archivos, arreglar bugs, hacer tareas tediosas y conectarse a herramientas externas; pero tomar decisiones, controlar la calidad y completar la lógica de negocio siempre será tu trabajo.
- Diferencia con otros: ChatGPT es un consultor, Copilot es un teclado predictivo inteligente, él es un compañero que puede trabajar de forma independiente. Asigna el trabajo según la tarea, no hay necesidad de elegir uno sobre otro.
Ahora deberías poder: Explicar claramente a tus colegas qué es Claude Code en una sola oración y también evaluar si "esta tarea debería delegársele". Esta es la "sensación de mapa" que debes tener primero al empezar; todas las funciones posteriores se basan en este mapa.
Siguiente artículo 02 "Instalación y uso": Empezaremos de verdad, instalándolo en tu computadora (lo explicaremos por separado para Mac / Windows / Linux / WSL, sin omitir un solo paso), completaremos el primer inicio de sesión y haremos que el comando claude cobre vida en tu terminal. Primero, ve a ejecutar ese claude --version para ver si estás en el "Caso 1" o el "Caso 2"; el próximo artículo abordará exactamente eso.