Claude Code: qué es, cómo instalarlo y cómo usarlo en 2026

Qué es Claude Code y en qué se diferencia de un autocompletado

Voy a empezar por lo que más confusión genera. Cuando alguien busca qué es Claude Code, suele imaginarse un asistente que sugiere la siguiente línea mientras escribes. Eso existe desde hace años y tiene su lugar, pero pertenece a otra categoría de producto.

Claude Code es un agente de programación. La diferencia práctica está en la unidad de trabajo. Un autocompletado opera a nivel de línea o de función: tú tienes el plan en la cabeza y él te ahorra tecleo. Claude Code opera a nivel de tarea. Le dices quiero un formulario de registro que guarde los usuarios en la base de datos y les mande un email de bienvenida, y él sale a leer tu proyecto, entiende cómo está armado, decide qué archivos tocar, los edita, ejecuta el comando para levantar el servidor y, si algo revienta, lee el error y lo arregla.

Lo que hace distinto a un agente

Antes de escribir una sola línea, explora la estructura de carpetas y busca los patrones que ya usas. Por eso su código termina pareciéndose al tuyo en lugar de parecer copiado de un tutorial. Tampoco se queda encerrado en un archivo suelto. Una función nueva casi nunca vive en un solo lugar: hay una ruta, un componente, un estilo, una migración de base de datos. Él los toca todos en la misma pasada, porque entiende la tarea completa y sabe qué piezas la componen.

La otra mitad de la historia es que ejecuta comandos y ve el resultado. Puede correr tu proyecto, tus tests o tu build, leer la salida y actuar en consecuencia. Ahí deja de ser un chat que escupe código y pasa a ser alguien que trabaja. Y todo ocurre dentro de tu carpeta real, con tu git y tu historial, sin cajas de arena separadas de las que después tengas que copiar y pegar nada.

Por qué esto me importa a mí

Llevo más de diecisiete años en marketing digital y construyendo negocios online. Fundé mi agencia en 2008, Google la reconoció en 2014 y en 2016 vendí mi primera empresa. En todo ese recorrido, el cuello de botella siempre fue el mismo: tenía la idea, tenía el cliente, tenía la oferta, y me faltaba el programador. Cada validación costaba semanas y presupuestos.

Hoy construyo software real con Claude Code todos los días. Landing pages, dashboards internos, herramientas para mi comunidad, automatizaciones que me ahorran horas. Esa es la lente con la que está escrita esta guía: la de alguien que factura con lo que construye ahí adentro, y que por eso te va a contar también lo que falla. Si quieres el panorama completo de la familia de productos, empieza por la guía de qué es Claude y para qué sirve.

Una aclaración de vocabulario antes de seguir. La filosofía de trabajo que hay detrás de todo esto, la de describir en lenguaje natural y dejar que la IA escriba el código, se llama vibe coding. Claude Code es la herramienta; el vibe coding es el método. Ahí desarrollo la teoría para no repetirla acá.

Dónde se usa Claude Code: CLI, escritorio, web e IDE

Mucha gente abandona en el primer paso porque cree que solo existe la versión de terminal y le da miedo la pantalla negra. Hay cuatro formas de usarlo y todas ejecutan el mismo motor, así que puedes empezar por la que menos te intimide y migrar después.

1. Claude Code CLI (la terminal)

El Claude Code CLI es la forma original y la que más uso. Abres una terminal dentro de la carpeta de tu proyecto, escribes claude y empiezas a hablarle. Suena intimidante y es lo contrario: una conversación normal en la que escribes en español lo que quieres.

Ventajas reales de la terminal: arranca en segundos, no depende de que abras un programa pesado, puedes tener varias sesiones abiertas en carpetas distintas y funciona igual en cualquier máquina, incluso en un servidor remoto. Si vas a hacer de esto un hábito, aprende la terminal aunque sea a nivel básico. Es media hora de incomodidad a cambio de años de velocidad.

2. App de escritorio para Mac y Windows

Existe una app de escritorio de Claude Code para Mac y Windows. Es la puerta de entrada más amable si nunca tocaste una consola: interfaz gráfica, ventanas, todo visible. Para alguien que viene del mundo del marketing o del negocio y no del desarrollo, este es el camino que recomiendo para las primeras semanas.

3. Claude Code en la web

También corre en el navegador, desde claude.ai/code. Sirve para revisar o avanzar en algo cuando no estás en tu computadora de siempre, o cuando quieres delegar una tarea y seguir con otra cosa mientras el agente trabaja.

4. Extensiones para VS Code y JetBrains

Si ya programas o ya tienes un editor abierto todo el día, hay extensiones para VS Code y para los IDEs de JetBrains. Trabajas dentro de tu editor de siempre y tienes al agente al lado, sin cambiar de ventana.

Cuál elegir

Mi consejo depende de dónde vengas. Si nunca programaste, empieza por la app de escritorio y pásate al CLI cuando le pierdas el miedo. Si ya usas un editor, instala la extensión. Si quieres velocidad máxima y control total, vive en el CLI. Y ojo con algo importante: si lo que buscas es que la IA te ayude con archivos, documentos y tareas de oficina en vez de con código, la herramienta correcta es Claude Cowork, que está pensada exactamente para eso.

Cómo instalar Claude Code paso a paso

Esta es la sección que más se busca: instalar Claude Code, o como aparece en Google, claude code install. Te la doy en orden y sin saltarme nada. La instalación completa toma unos diez minutos la primera vez.

Paso 1: revisa los requisitos

Necesitas tres cosas antes de empezar. Una cuenta de Claude activa, que creas gratis en claude.com. Node.js instalado en tu computadora, porque la instalación se hace con npm, el gestor de paquetes que viene con Node. Y una terminal: en Mac es la app Terminal, en Windows es PowerShell o la Terminal de Windows.

Para verificar si ya tienes Node, abre la terminal y ejecuta:

node --version

Si te devuelve un número, estás listo. Si te dice que el comando no existe, descarga Node desde su sitio oficial e instálalo con siguiente, siguiente, siguiente.

Paso 2: instala Claude Code con npm

Con la terminal abierta, copia este comando exacto y presiona Enter:

npm install -g @anthropic-ai/claude-code

La bandera -g significa global: lo instala en todo el sistema, así puedes usarlo desde cualquier carpeta. Vas a ver texto corriendo durante un minuto. Cuando pare y te devuelva el cursor, terminó. Si buscabas descargar Claude Code, ese comando es la descarga: para la versión de terminal no hay ningún archivo .exe que bajar. La app de escritorio sí se descarga desde el sitio oficial de Anthropic.

Paso 3: autentícate con tu cuenta

Ahora arranca el programa escribiendo esto en la terminal:

claude

La primera vez te va a pedir que inicies sesión y te va a abrir el navegador para conectar tu cuenta de Claude. Autorizas, vuelves a la terminal y ya estás dentro. Esto se hace una sola vez por máquina.

Paso 4: entra en la carpeta de tu proyecto

Este paso es el que más se ignora y el que más problemas causa. Claude Code trabaja sobre la carpeta desde la que lo abriste. Si lo abres en el escritorio, va a creer que tu proyecto es el escritorio.

Usa cd seguido de la ruta de tu carpeta para entrar en ella, y recién ahí ejecuta claude. Si el proyecto todavía no existe, crea una carpeta vacía con un nombre claro, entra en ella y ábrelo ahí. Él se encarga del resto.

Paso 5: escribe tu primer prompt útil

Aquí está el truco que separa una buena primera sesión de una frustrante. Evita pedirle que construya en el primer mensaje. Pídele que entienda.

En un proyecto que ya existe, mi primer mensaje siempre es del estilo: Explora este proyecto y explícame en lenguaje simple qué hace, con qué está construido y cómo está organizado. No modifiques nada todavía. En un proyecto nuevo: Quiero construir una app web que haga X para este tipo de usuario. Antes de escribir código, hazme las preguntas que necesites y propón un plan por etapas.

Paso 6: deja el contexto por escrito

Cuando tengas claro el proyecto, pídele que cree un archivo de instrucciones en la raíz (el clásico CLAUDE.md) con las reglas de la casa: qué tecnologías usas, cómo se levanta el proyecto, qué cosas nunca debe tocar, qué estilo de código quieres. Ese archivo lo lee en cada sesión nueva y es lo que hace que la calidad suba de golpe. Cinco minutos de escribirlo te ahorran cincuenta de corregir.

Cómo saber que quedó bien instalado

Pídele algo mínimo, del tipo crea un archivo notas.txt con tres ideas para mi app. Si ese archivo aparece en tu carpeta, la instalación está terminada y ya viste al agente tocar tu disco de verdad.

Claude Code en Windows: lo que cambia

Recibo esta pregunta todas las semanas, así que le doy sección propia. Claude Code en Windows funciona, y tienes dos caminos.

El primero es la app de escritorio para Windows. La descargas, la instalas como cualquier programa y no tocas la terminal en ningún momento. Para la mayoría de la gente de negocio que llega a mi comunidad, este es el camino correcto.

El segundo es el CLI, con el mismo comando npm install -g @anthropic-ai/claude-code ejecutado desde PowerShell o desde la Terminal de Windows. Requiere tener Node.js instalado, igual que en Mac.

Los tres tropiezos más comunes en Windows

El primero aparece justo después de instalar: escribes claude y la terminal responde que el comando no se reconoce. Casi siempre se resuelve cerrando la terminal y abriéndola de nuevo, para que tome la instalación nueva. Es un clásico y asusta más de lo que dura.

El segundo son los permisos. Si la instalación global te tira un error de ese tipo, abre la terminal como administrador y repite el comando. Con eso suele alcanzar.

El tercero es más traicionero: las rutas con espacios o con acentos. Carpetas del tipo Mis Documentos/Proyecto Ñandú generan problemas raros que después cuesta diagnosticar. Trabaja en rutas cortas y sin caracteres especiales, del estilo C:\proyectos\miapp, y te evitas toda esa familia de errores.

Si te topas con algo que no está acá, no adivines: la documentación oficial de Anthropic tiene las guías de instalación actualizadas por sistema operativo, y cambian más rápido de lo que se actualiza cualquier artículo.

Cómo usar Claude Code de verdad: el flujo que uso todos los días

Instalarlo es fácil. Lo difícil es usarlo bien. La diferencia entre quien construye algo que funciona y quien abandona a los tres días está menos en saber programar que en cómo le habla al agente. Este es el flujo con el que trabajo, y es literalmente cómo usar Claude Code cuando el objetivo es terminar un producto.

1. Dale contexto antes de pedirle nada

El error número uno es abrir la terminal y disparar hazme una app de gimnasios. El agente va a construir algo, sí, pero será su interpretación, y probablemente se aleje bastante de la tuya. El contexto es el combustible de la calidad.

Antes de la primera línea de código, dile: para quién es, qué problema resuelve, qué tiene que poder hacer el usuario y qué explícitamente no quieres. Si ya tienes una decisión tomada (base de datos, sistema de pagos, dónde se publica), dila desde el principio. Ese archivo CLAUDE.md del que hablamos arriba es contexto permanente y vale más que cualquier prompt largo.

2. Pide plan antes que código

Regla que aplico sin excepción en tareas medianas o grandes: antes de tocar archivos, dame el plan de lo que vas a hacer. Lees el plan en treinta segundos. Si está mal, lo corriges en una frase. Corregir un plan cuesta una frase; corregir cuatrocientas líneas de código cuesta una tarde.

3. Trabaja en tareas chicas

Una tarea grande, tal como la formulas en tu cabeza, funciona más como un deseo que como una instrucción. En lugar de construye el panel de administración, ve por partes: primero la pantalla de login, la pruebas, funciona; después la lista de usuarios, la pruebas, funciona; después la edición. Cada bloque terminado y verificado es terreno ganado que ya no se pierde.

4. Prueba tú, sin confiar en el reporte

Cuando el agente dice que terminó, ábrelo y úsalo. Haz clic en el botón. Manda el formulario vacío. Escribe un email inválido. La IA es excelente construyendo y bastante optimista evaluando su propio trabajo. Tu rol de fundador incluye ser el primer usuario molesto de tu propio producto.

5. Cuando algo falla, pega el error tal cual

Sin traducirlo ni resumirlo. Copia el texto completo, pégalo y agrega qué estabas haciendo cuando ocurrió. Con eso suele resolverlo en un intento. Y si se queda dando vueltas sobre el mismo problema tres veces, para: dile que se detenga, que te explique en lenguaje simple qué cree que está pasando y que proponga dos caminos distintos. Cambiar de ángulo destraba más que insistir.

6. Usa git como red de seguridad

Pídele que haga un commit cada vez que algo queda funcionando. Es el equivalente a guardar la partida. Si mañana un cambio rompe todo, vuelves al último punto bueno sin perder nada. Es la mejor costumbre que puedes agarrar desde el día uno.

7. Ajusta la velocidad al tipo de tarea

No todas las tareas necesitan el mismo nivel de reflexión. Para trabajo repetitivo o cambios sencillos existe el fast mode, que activas escribiendo /fast. Para decisiones de arquitectura o problemas enredados, deja que se tome su tiempo y piense. Elegir bien esto cambia tanto la experiencia como el consumo de tu plan.

8. Automatiza lo que repites

Cuando notes que le explicas el mismo procedimiento por quinta vez, ese procedimiento debería vivir fuera de tu cabeza. Para eso están las Skills de Claude: capacidades reutilizables que le enseñan a hacer una tarea concreta siempre igual. Ahí te cuento cómo se arman.

Lo resumo así: tu trabajo acá es dirigir. Das contexto, apruebas el plan, revisas el resultado y decides qué sigue. El que sabe qué construir y para quién vale más que el que sabe teclear rápido.

Claude Code vs Cursor y otros editores con IA

La comparación Claude Code vs Cursor aparece en cuanto empiezas a investigar, y casi siempre se plantea mal, como si fueran dos productos idénticos peleando por el mismo puesto. En realidad son dos enfoques distintos del mismo problema.

Cursor es un editor de código con IA integrada: el centro de la experiencia es el editor, y la IA vive dentro de él ayudándote mientras escribes. Claude Code es un agente que vive donde tú trabajes, sea la terminal, una app de escritorio, el navegador o dentro de tu editor a través de una extensión. El editor es un lugar más donde puede estar, y el producto es el agente en sí.

Cuál te conviene según quién eres

Si vienes del negocio, del marketing o de una idea que quieres poner en la calle, y no tienes intención de convertirte en programador, Claude Code te sirve más, porque el flujo natural es delegar una tarea y revisar el resultado. Puedes empezar sin dominar ningún editor.

Si ya programas y tu día pasa dentro de un editor, la conversación cambia: probablemente quieras las dos cosas. Muchos desarrolladores usan un editor con IA para lo fino y un agente para lo grueso. Y como Claude Code tiene extensiones de VS Code y JetBrains, la convivencia es real, comprobable en el día a día.

Lo que sí te pido: evita elegir por comparativas de números que circulan por ahí. Dale a cada uno una tarea real de tu proyecto y quédate con el que te deje más cerca de publicar.

Claude Code gratis y precio: qué necesitas para empezar

Dos búsquedas gemelas: Claude Code gratis y Claude Code precio. Voy a ser honesto y general a la vez, porque los planes cambian y prefiero mandarte a la fuente antes que darte un dato viejo.

Claude se organiza en cinco planes: Free, Pro, Max, Team y Enterprise. La lógica es simple: cuanto más alto el plan, más capacidad de uso tienes y más margen para sesiones largas de trabajo. El uso de Claude Code va asociado a tu suscripción de Claude, así que la pregunta que de verdad importa es otra: qué plan necesitas para el ritmo con el que vas a trabajar.

Mi recomendación práctica

Si estás explorando, empieza por lo más bajo que te permita probar y comprueba si la herramienta encaja con tu forma de trabajar antes de pagar nada. Nadie construye un hábito por haber pagado una suscripción; se construye usándola.

Si vas a construir un producto en serio, un plan pago se paga solo. Vengo del mundo de presupuestar desarrollos, y te lo digo con esa memoria fresca: lo que cuesta un mes de suscripción no compra ni una hora de un programador senior en muchos mercados.

Y si trabajas todo el día con esto, mira los planes superiores. Quedarte sin capacidad a mitad de una tarea es la peor forma de perder tiempo, sobre todo cuando estás con el problema cargado en la cabeza.

El detalle de qué se puede hacer sin pagar lo desarrollo en la guía de Claude gratis, para no duplicar información acá. Y los importes vigentes, siempre, en la página oficial de precios de Claude. Desconfía de cualquier artículo que te dé una cifra cerrada sin fecha, incluido este si algún día se queda viejo.

Los 7 errores típicos de principiante

Estos los veo una y otra vez en la gente que arranca. Si los evitas, te ahorras las dos semanas de frustración que hacen abandonar a la mayoría.

1. Pedir la app completa en un mensaje

Escribir hazme un Instagram para veterinarias y esperar un producto terminado. Vas a recibir algo que se ve bien y falla por dentro. Divide y verifica cada parte.

2. No verificar nunca lo que dice que hizo

Aceptar el reporte de que todo salió bien sin abrir la aplicación. Los problemas se acumulan en silencio y después es imposible saber cuál fue el cambio que rompió todo.

3. Trabajar en la carpeta equivocada

Abrirlo desde el escritorio o desde la carpeta de descargas y que empiece a crear archivos donde no van. Siempre entra primero a la carpeta del proyecto.

4. Insistir con el mismo prompt cuando falla

Repetir sigue sin funcionar cinco veces seguidas. Si dos intentos no lo resolvieron, cambia de estrategia: pídele que te explique el problema, que agregue mensajes de diagnóstico o que proponga otro camino.

5. No usar control de versiones

Sin commits, un cambio malo se lleva puesto el trabajo de tres días. Con commits, retrocedes en diez segundos. Pídele que guarde cada vez que algo queda andando.

6. Poner claves y contraseñas dentro del código

Las credenciales van en variables de entorno y el archivo que las contiene queda fuera del repositorio. Pídele explícitamente que te lo configure así desde el inicio, sobre todo si vas a publicar el proyecto.

7. Construir sin haber validado la idea

Este es el más caro de todos y no tiene nada que ver con la herramienta. Claude Code te permite construir tan rápido que puedes pasarte un mes puliendo un producto que nadie pidió. Antes de escribir la primera línea, lee cómo validar tu idea antes de construir. Es el pilar del método High Value que más dinero le ahorra a la gente.

Qué puedes construir con Claude Code

Termino con lo concreto, porque toda esta explicación no sirve de nada si no ves el destino. Esto es lo que gente sin formación técnica está construyendo hoy con Claude Code.

Lo primero son aplicaciones web con usuarios y base de datos: registro, login, un panel donde cada usuario ve lo suyo, pagos con una pasarela. Es el esqueleto de cualquier SaaS, y la versión chica de eso, el micro SaaS para un nicho específico, es el modelo con el que más veo arrancar a la gente de mi comunidad. Una herramienta que resuelve un dolor puntual de un sector puntual. El camino completo está detallado en cómo crear un SaaS con IA.

Después vienen las herramientas internas para tu propio negocio, el caso más subestimado de todos. Ese Excel monstruoso que usas todos los días puede convertirse en una app decente en un par de tardes, y te devuelve horas cada semana. En la misma familia entran las automatizaciones que conectan lo que ya usas: que un formulario dispare un email, actualice una planilla y avise por mensaje, sin depender de una plataforma de automatización que te cobre por cada ejecución.

También salen de aquí sitios, landings y páginas de venta, aunque para esa parte conviene que mires además Claude Design, que está pensado específicamente para diseñar sitios, presentaciones y prototipos describiéndolos. Y quizás lo más valioso de todo: prototipos para validar antes de invertir. Algo funcional en un fin de semana para mostrarle a diez clientes potenciales y ver si pagan. Esto cambia la economía de emprender de raíz.

Tu siguiente paso

Lo único que falta es hacerlo. Instala, abre una carpeta, pídele algo pequeño y comprueba con tus ojos que funciona.

Si prefieres no ir a ciegas y aprender el camino completo, desde la instalación hasta un producto publicado y cobrando, ese es exactamente el recorrido del curso de Claude. Y si quieres ver primero cómo empiezan otros sin saber programar, la guía de cómo crear una app con IA sin programar es un buen punto de partida.