Cómo instalar Claude Code y terminar tu primer proyecto

Claude Code es la herramienta de Anthropic que vive en tu terminal y trabaja directamente sobre tu proyecto: lee tus archivos, propone cambios, ejecuta pruebas y te muestra cada modificación antes de aplicarla. Esta guía te lleva de cero a un primer proyecto funcional, paso a paso, con los comandos exactos y las decisiones que conviene tomar en cada momento.

Al terminar tendrás Claude Code instalado, una sesión activa con tu cuenta y un pequeño proyecto construido con su ayuda, más las costumbres básicas que hacen que la herramienta rinda desde el primer día.

Qué necesitas antes de empezar

La lista es corta y probablemente ya la cubres:

• Una computadora con macOS, Linux o Windows. En Windows puedes usarlo de forma nativa o a través de WSL.
• Una terminal cualquiera: la de macOS, tu emulador favorito en Linux, o PowerShell y Windows Terminal.
• Una cuenta de Claude. El plan Pro incluye acceso a Claude Code dentro de la suscripción, y los planes Max están pensados para uso intensivo. También existe la ruta de pago por consumo con la consola de API.
• Node.js 18 o superior si eliges la instalación por npm. El instalador nativo lo evita por completo.

Con eso listo, la instalación toma un par de minutos.

Instalación

Una ruta común de instalación usa npm:

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

Anthropic también ofrece un instalador nativo para macOS y Linux que descarga el binario directamente, útil en equipos donde prefieres evitar la dependencia de Node:

curl -fsSL https://claude.ai/install.sh | bash

Al terminar, verifica que todo quedó en su lugar:

claude --version

Si el comando responde con un número de versión, la instalación quedó completa. El comando claude doctor revisa además el entorno y te avisa de cualquier detalle de configuración pendiente.

Primer arranque y vinculación de tu cuenta

Colócate en la carpeta de cualquier proyecto, o crea una vacía para esta práctica:

mkdir mi-primer-proyecto
cd mi-primer-proyecto
claude

La primera vez, Claude Code te pide iniciar sesión. Te lleva al navegador para autorizar con tu cuenta de Claude, y al volver la terminal queda vinculada. Desde ahí, cada sesión dentro de esa carpeta recuerda el contexto del proyecto.

Verás una interfaz de conversación dentro de la terminal: escribes lo que quieres en lenguaje normal y Claude Code responde, lee archivos y propone acciones. Cada acción delicada, como modificar un archivo o ejecutar un comando, pide tu aprobación antes de ejecutarse.

Tu primer proyecto, paso a paso

Para el primer ejercicio conviene algo pequeño y visible: una aplicación web de lista de tareas en un solo archivo HTML. Es suficiente para ver el ciclo completo de trabajo con Claude Code.

### Paso 1: pide la primera versión

Escribe en la sesión:

Crea un archivo index.html con una lista de tareas: campo de texto, botón para agregar, y cada tarea con opción de marcarla como hecha y de eliminarla. Diseño limpio, cero librerías externas.

Claude Code genera el archivo y te muestra un resumen de lo que contiene. Abre el archivo en tu navegador y pruébalo. Ya tienes una aplicación funcional.

### Paso 2: itera con instrucciones concretas

La clave del trabajo con Claude Code es pedir cambios específicos, uno a la vez:

Las tareas marcadas como hechas deben verse tachadas y bajar al final de la lista.

Guarda las tareas en localStorage para que sobrevivan al recargar la página.

Agrega un contador arriba: cuántas tareas hay y cuántas van listas.

Después de cada cambio, la herramienta muestra exactamente qué líneas modificó. Recarga el navegador y verifica. Este ritmo de pedir, revisar y probar es la forma natural de trabajar: cambios pequeños que puedes revisar de un vistazo.

### Paso 3: deja que explore y explique

Claude Code también lee lo que ya existe. Prueba preguntas como:

Explícame cómo funciona la función que guarda en localStorage.

¿Qué pasa si abro el archivo en dos pestañas a la vez?

Responder este tipo de preguntas sobre código real es una de sus fortalezas, y te sirve igual en proyectos ajenos o heredados.

### Paso 4: crea el archivo CLAUDE.md

Ejecuta el comando:

/init

Claude Code analiza la carpeta y genera un archivo CLAUDE.md con una descripción del proyecto, cómo correrlo y las convenciones que detecte. Ese archivo se lee automáticamente en cada sesión futura, así la herramienta arranca con contexto en lugar de preguntarte lo básico cada vez. En proyectos grandes, CLAUDE.md es el lugar para anotar cómo se corren las pruebas, qué estilo sigue el código y qué carpetas son delicadas.

Trabaja con git desde el primer cambio

Antes de pedirle nada a Claude Code en un proyecto que te importa, crea el repositorio:

git init
git add -A
git commit -m "punto de partida"

Con un commit limpio como base, cada cambio que proponga la herramienta se compara contra algo firme: git diff te muestra el estado exacto, y volver atrás cuesta un comando. Claude Code además entiende el historial: puedes pedirle que revise qué cambió desde el último commit, que redacte el mensaje del siguiente, o que explique una línea concreta con su contexto. La combinación de terminal, git y Claude Code es donde la herramienta se siente completa.

Un cuarto hábito llega con la práctica: guarda una nota con las instrucciones que te funcionaron. Los buenos prompts son piezas reutilizables, y juntarlos convierte cada sesión en material de entrenamiento para la siguiente. Con el tiempo formas tu propia biblioteca de formas de pedir, ajustada a tus proyectos y a tu estilo.

Comandos que usarás a diario

• /help muestra la lista completa de comandos.
• /clear limpia la conversación actual para empezar un tema nuevo con contexto fresco.
• /compact resume la conversación cuando se alarga, conservando lo importante.
• /cost muestra el consumo de la sesión cuando trabajas con API.
• claude -c continúa tu sesión anterior desde la terminal.

Con esos cinco cubres el uso cotidiano. El resto lo irás descubriendo conforme lo necesites.

Cómo pedir para obtener mejores resultados

La diferencia entre una sesión productiva y una frustrante casi siempre está en la instrucción. Tres hábitos que ayudan:

Un cambio a la vez. "Agrega validación al formulario" rinde más que una lista de diez cambios juntos. Revisas rápido y cada paso queda claro.

Contexto concreto. Menciona el archivo, la función o el mensaje de la consola que te trajo. "El botón de guardar en index.html deja de responder al recargar" da mucho más material que "algo anda mal".

Revisa antes de aceptar. Claude Code muestra los cambios propuestos. Léelos, sobre todo al principio: es la mejor forma de aprender qué hace la herramienta y de mantener el proyecto bajo tu control.

Planes y límites, verificado a julio de 2026

Al momento de escribir esto, la página oficial de precios de Claude lista el plan Pro en 20 dólares al mes, con Claude Code incluido y límites de uso compartidos con el chat. Los planes Max, en 100 y 200 dólares al mes, amplían esos límites para trabajo intensivo. Desde junio de 2026, el uso interactivo en la terminal y el uso programático con el Agent SDK cuentan contra los mismos límites de la suscripción, así que conviene revisar la página de precios vigente si tu consumo crece. La ruta alternativa es la consola de API con pago por consumo, útil cuando prefieres gasto variable.

Para empezar, el plan Pro alcanza con holgura para seguir esta guía y para proyectos personales de tamaño moderado.

Preguntas del primer día

¿Funciona en cualquier carpeta? Sí. Ábrelo en la raíz de cualquier proyecto y lee lo que encuentre: Python, JavaScript, Go, documentación, lo que sea. Entre más clara la estructura del proyecto, mejor trabaja.

¿Mis archivos se suben a algún lado? La herramienta envía el contenido relevante al modelo para poder razonar sobre él, como parte normal de su funcionamiento. En proyectos con datos delicados, revisa la documentación de privacidad de Anthropic y configura los permisos a tu medida.

¿Necesito saber programar para usarlo? Ayuda, y mucho, porque revisar el código propuesto es parte del ciclo. Dicho eso, mucha gente lo usa para tareas de terminal, documentación y organización de archivos mientras aprende.

¿Puedo usarlo para algo distinto a programar? También organiza notas, redacta documentación, analiza datos y automatiza tareas de terminal. La programación es su punto fuerte, y el resto viene de la misma capacidad de leer, razonar y actuar sobre archivos.

Qué sigue después del primer proyecto

Con la instalación y el primer ciclo dominados, el camino natural es llevar Claude Code a un proyecto real tuyo: ábrelo en esa carpeta, ejecuta /init, y empieza con una tarea pequeña y bien definida, como agregar una prueba o corregir un detalle concreto. La curva de aprendizaje se recorre trabajando sobre código que te importa. También puedes explorar el trabajo en equipo: compartir el CLAUDE.md del proyecto con tu equipo alinea a todos con la misma configuración, y las sesiones sobre ramas separadas mantienen el historial limpio.

Los siguientes temas que vale la pena explorar son los comandos y atajos que más se usan, los proyectos de práctica recomendados para subir de nivel y las extensiones que conectan Claude Code con más herramientas. Cada uno tendrá su propia guía aquí.

Fuentes

• Claude Code Docs, Quickstart
• Claude Code Docs, Setup y requisitos del sistema
• Centro de ayuda de Claude, "Your first day in Claude Code" (abril 2026)
• Centro de ayuda de Claude, "Use Claude Code with your Pro or Max plan"
• Paquete oficial en npm
• Página de precios de Claude