Claude Code para principiantes: instala, inicia sesión y haz tu primera tarea

La mayoría de la gente conoce Claude Code como conoce cualquier herramienta nueva: abre una terminal, se siente perdida y vuelve a pegar código en una ventana de chat. Eso funciona, pero desperdicia lo único que hace distinto a Claude Code. No necesita que pegues nada.

Esta guía te lleva desde cero hasta una primera tarea terminada. Vas a instalarlo, iniciar sesión, hacer preguntas sobre un proyecto real, hacer un cambio pequeño y aprender los pocos comandos que cubren la mayor parte de tu primera semana.

Qué es realmente Claude Code

Claude Code es un asistente que se ejecuta en tu terminal, dentro de la carpeta de tu proyecto. Cuando le das una tarea, trabaja en un ciclo de tres fases: reúne contexto, actúa y verifica el resultado. Repite ese ciclo hasta terminar la tarea, y puedes interrumpirlo en cualquier momento.

La diferencia con un chat son las herramientas. Un chat solo puede responder con texto. Claude Code puede leer tus archivos, editarlos, buscar en el proyecto, ejecutar comandos como tus pruebas y usar git. Cada resultado alimenta la siguiente decisión.

Digamos que le pides que arregle las pruebas que fallan. Lo normal es que ejecute las pruebas para ver qué falla, lea el mensaje de error, busque los archivos involucrados, los lea, los edite y vuelva a ejecutar las pruebas. Tú escribiste una sola frase. Él hizo seis pasos.

Si todavía estás decidiendo si Claude Code es la herramienta correcta para lo que haces, lee primero Claude Code frente a Proyectos frente a Chat. Esta guía supone que ya decidiste.

Antes de empezar

Necesitas tres cosas, y ninguna es difícil de conseguir.

Claude Code no forma parte del plan gratuito de Claude, así que necesitas una de esas cuentas. Si nunca has abierto una terminal, la guía oficial de la terminal te muestra cómo abrir una y pegar un comando. Toma unos dos minutos.

Paso 1: instala Claude Code

Hay varias formas de instalarlo. El instalador nativo es el recomendado, porque se actualiza solo en segundo plano.

Elige el que corresponda a tu sistema, pégalo en la terminal y presiona Enter. El instalador no muestra progreso mientras descarga, así que no supongas que se congeló.

En Linux también puedes instalarlo con apt, dnf o apk en Debian, Fedora, RHEL y Alpine. En Windows nativo se recomienda Git for Windows para que Claude Code pueda usar la herramienta Bash. Sin él, Claude Code usa PowerShell. Si usas WSL, no necesitas Git for Windows.

Comprueba que funcionó

Cuando el instalador termine, abre una ventana de terminal nueva. Esto importa: la ventana anterior todavía no conoce el programa nuevo. Luego ejecuta el comando de versión.

$ claude --version2.1.283 (Claude Code)

Si tu shell dice que claude no se encuentra o no se reconoce, la carpeta de instalación todavía no está en tu PATH. Cerrar y volver a abrir la terminal lo arregla la mayoría de las veces. Si no, la página oficial de solución de problemas de instalación relaciona cada mensaje de error con su arreglo.

Paso 2: inicia tu primera sesión

Ve a la carpeta de tu proyecto y escribe el nombre del programa.

$ cd ~/projects/my-website$ claude

La primera vez, Claude Code te pide iniciar sesión. Con una suscripción a Claude o una cuenta de Console abre tu navegador, apruebas el inicio de sesión ahí y regresas a la terminal. Tus credenciales quedan guardadas, así que no tendrás que repetirlo.

Puedes iniciar sesión con cualquiera de estas opciones:

• Una cuenta de Claude Pro, Max, Team o Enterprise, que es la vía recomendada.
• Una cuenta de Claude Console. La primera vez que inicias sesión se crea automáticamente un espacio de trabajo "Claude Code" para que puedas ver cuánto cuesta.
• Amazon Bedrock, Google Cloud o Microsoft Foundry, para quienes tienen acceso mediante su empresa.

Si tienes definida la variable de entorno ANTHROPIC_API_KEY y apruebas la clave cuando te lo pide, Claude Code se salta el paso de inicio de sesión.

Una vez adentro, ves un prompt con la versión, el modelo actual y la carpeta en la que trabajas. Escribe /help para ver la lista de comandos, /resume para continuar una conversación anterior o /login más adelante si necesitas cambiar de cuenta.

Paso 3: pregunta antes de cambiar nada

Tus primeros prompts no deberían cambiar nada. Las preguntas son la forma más segura de ver cómo lee Claude Code tu proyecto, y te enseñan lo que ya sabe.

Claude lee los archivos que necesita y responde. No tienes que agregar archivos a mano, él los encuentra. Sigue con preguntas más específicas, una a la vez:

> ¿qué hace este proyecto?Reading package.json, README.md, src/ ...Es un sitio de marketing estático hecho con Next.js. Las páginas están en src/app, los componentes compartidos en src/components y el contenido en la carpeta content/.

También puedes preguntarle a Claude Code sobre sí mismo. Preguntas como "¿qué puede hacer Claude Code?" o "¿cómo creo habilidades personalizadas en Claude Code?" reciben respuestas reales, porque conoce su propia documentación.

Dentro de Claude Tutorial

Preguntar antes de actuar es un hábito que vale la pena construir

Lograr que el asistente explique lo que ve antes de pedirle cambios es la misma disciplina que la app enseña para todo tipo de trabajo, no solo para el código.

Muy pronto

Descárgalo en elApp Store

DISPONIBLE ENGoogle Play

Paso 4: haz tu primer cambio

Ahora pide algo pequeño y fácil de deshacer.

Claude Code encuentra el archivo correcto y te muestra el cambio que quiere hacer. Según tu configuración, puede pedir tu aprobación primero. Si lo hace, lee lo que propone y elige Yes.

Ese prompt es pequeño a propósito. El objetivo de este paso no es la función. Es ver el ciclo completo una vez: pides, Claude encuentra el archivo, muestra la edición, tú apruebas y el archivo cambia.

Lo que Claude Code puede hacer sin preguntar lo controla el modo de permisos (permission mode) de la sesión. Presiona Shift+Tab en cualquier momento para alternar entre modos. Las versiones nuevas inician las sesiones interactivas de terminal en modo auto, donde una revisión en segundo plano bloquea las acciones riesgosas en lugar de preguntarte por cada una, y las versiones anteriores u otras configuraciones preguntan con más frecuencia. Mira la línea de estado para saber en qué modo estás. La siguiente guía, Modos de permisos de Claude Code y modo plan, explicados, cubre todos los modos y cuándo usar cada uno.

Paso 5: usa git hablándole

Si tu proyecto usa git, puedes manejarlo por conversación. Todo esto funciona tal como está escrito.

Aun cuando confíes en él, lee el mensaje del commit y el diff antes de aceptar. Tú eres quien revisa todo lo que produce Claude Code.

Paso 6: corrige un error o agrega una función

Las tareas reales salen mejor con detalles reales. Compara estas dos maneras de pedir el mismo arreglo.

Las mejores versiones nombran el síntoma, el lugar y cómo se ve algo terminado. Claude Code puede encontrar archivos por sí mismo, así que no tienes que listarlos, pero no puede adivinar a cuál problema te refieres.

Para trabajos más grandes, divide el trabajo en pasos con una lista numerada.

Y cuando todavía no conoces el código, deja que Claude explore primero: pídele que analice el esquema de la base de datos, o cómo funciona el pago, antes de pedirle que cambie cualquiera de los dos. Unos minutos de lectura suelen evitar un cambio equivocado.

Los comandos que usarás todos los días

Algunos comandos se ejecutan en tu shell, antes de que inicie Claude Code, y otros dentro de una sesión.

Unas cuantas teclas ahorran mucho tiempo. Escribe / para ver todos los comandos y habilidades que tienes. Presiona Tab para completar un comando, ↑ para recuperar prompts anteriores y Shift+Tab para alternar el modo de permisos. Presiona Esc para detener a Claude de inmediato si va en la dirección equivocada.

Cuando el primer día sale mal

Estos son los problemas más comunes y lo que significa cada uno.

Cuando nada de eso aplica, pregúntale al propio Claude Code. Escribe algo como "¿cómo arreglo este error?" con el mensaje pegado. El comando /doctor también ejecuta una revisión de la configuración que diagnostica problemas de instalación y configuración.

No tienes que usar la terminal

La terminal es el hogar original de Claude Code, y todo lo anterior aplica ahí. El mismo asistente también está disponible como app de escritorio, dentro de los editores VS Code y JetBrains, en la web en claude.ai/code, en Slack y en flujos automatizados con GitHub Actions y GitLab. La interfaz cambia cómo lo ves y le hablas. El ciclo de reunir contexto, actuar y verificar es el mismo en todos lados.

Preguntas frecuentes

¿Claude Code es gratis?

No. Necesita una suscripción a Claude Pro, Max, Team o Enterprise, una cuenta de Claude Console con créditos de API, o acceso mediante un proveedor de nube compatible. El plan gratuito de Claude no lo incluye.

¿Necesito saber programar para usar Claude Code?

Necesitas un proyecto al cual apuntarlo, y mientras mejor entiendas el proyecto, mejor podrás juzgar su trabajo. No necesitas escribir el código tú. Quienes empiezan sacan más provecho del hábito de preguntar primero del Paso 3: pídele a Claude que explique antes de pedirle que cambie.

¿Es seguro dejar que edite mis archivos?

Tú controlas lo que puede hacer sin preguntar mediante el modo de permisos, y las ediciones de archivos se pueden retroceder con Esc dos veces. Trata lo que produce como el pull request de un colega: lee el diff antes de hacer commit. Mantén tu proyecto en git para que cada cambio sea fácil de revisar o revertir.

¿Cuál es la diferencia entre Claude Code y Claude en un chat?

Un chat responde con texto sobre lo que le pegas. Claude Code trabaja dentro de tu proyecto: lee los archivos por sí mismo, los edita, ejecuta comandos y comprueba su propio trabajo. Usa el chat para pensar, usa Claude Code para hacer.

¿Claude Code recuerda mi proyecto entre sesiones?

Cada sesión empieza con un contexto nuevo. Para llevar conocimiento de una sesión a otra lo escribes en un archivo llamado CLAUDE.md, y Claude Code también guarda notas propias sobre tus preferencias. La guía que sigue a la siguiente, CLAUDE.md explicado, te muestra cómo.

Tu lista de verificación del primer día

Sigue leyendo

• Modos de permisos de Claude Code y modo plan, explicados para decidir cuánto puede hacer Claude Code sin preguntar.
• CLAUDE.md explicado: enséñale tu proyecto a Claude Code una sola vez para que dejes de repetir las mismas instrucciones en cada sesión.
• Buenas prácticas de Claude Code: hábitos que dan mejores resultados para prompts, verificaciones y manejo del contexto.
• Cómo hacer cambios en varios archivos con Claude Code para tu primer cambio que toca muchos archivos.
• Conectar Claude a tus propios datos y herramientas con MCP para llegar más allá de tu propia carpeta.