Cómo usar Claude Code: guía para empezar

Cómo usar Claude Code: instálalo con un solo comando, inicia sesión, abre una sesión en la carpeta de tu proyecto con claude y pide lo que quieras en lenguaje normal. Claude Code es el agente de programación de Anthropic: lee tu proyecto, edita archivos, ejecuta comandos y trabaja con Git desde la terminal, y también funciona en VS Code y JetBrains, en la web y en una aplicación de escritorio. Esta guía sigue la documentación del inicio rápido y de la memoria de Anthropic, comprobada el 6 de octubre de 2026, y añade consejos prácticos nuestros donde lo decimos. Para saber lo que cuesta y cómo se compara con otras herramientas, mira el precio de Claude y Claude Code vs Cursor.

¿Qué necesitas antes de empezar?

Anthropic lista tres requisitos: una terminal o un símbolo del sistema, un proyecto de código con el que trabajar y una cuenta, de una de estas formas: una suscripción a Claude (Pro, Max, Team o Enterprise), una cuenta de la consola de Claude o acceso a través de un proveedor de nube admitido. El plan gratuito de Claude no incluye Claude Code. Si nunca has usado una terminal, Anthropic tiene una guía de la terminal que explica cómo abrir una y pegar un comando.

Paso 1: instala Claude Code

Ejecuta el comando de tu sistema. Son los comandos de instalación nativa del inicio rápido de Anthropic:

Tabla: comandos de instalación

También se admiten Homebrew y WinGet, y en Debian, Fedora, RHEL y Alpine puedes usar apt, dnf o apk. Cuando termine el instalador, abre una ventana de terminal nueva y ejecuta claude --version: una instalación correcta imprime un número de versión. Si tu shell dice que claude no se encuentra, la carpeta de instalación todavía no está en tu PATH, y la documentación de Anthropic explica cómo arreglarlo. En Windows nativo, Anthropic recomienda instalar Git para Windows para que Claude Code pueda usar la herramienta Bash; sin él, Claude Code usa PowerShell. Las instalaciones nativas se actualizan solas en segundo plano. Una confusión habitual: si ves el error «The token '&&' is not a valid statement separator», estás en PowerShell y no en CMD, y si ves «'irm' is not recognized», estás en CMD y no en PowerShell.

Paso 2: inicia sesión

Arranca el programa con claude y sigue las indicaciones para iniciar sesión desde el navegador la primera vez. Si has definido la variable de entorno ANTHROPIC_API_KEY, Claude Code se salta la petición de inicio de sesión y te pide que apruebes la clave. Para cambiar de cuenta más adelante, escribe /login dentro de una sesión. Anthropic lista estos tipos de cuenta: Claude Pro, Max, Team o Enterprise (la recomendada), la consola de Claude (acceso a la API con créditos de prepago, que crea un espacio de trabajo «Claude Code» para seguir los costes) y Amazon Bedrock, Google Cloud o Microsoft Foundry para organizaciones.

Paso 3: abre tu primera sesión

Abre la terminal en la carpeta del proyecto y arranca Claude Code:

cd /ruta/a/tu/proyecto
claude

Verás un indicador con la versión, el modelo actual y el directorio de trabajo. Escribe /help para ver los comandos disponibles o /resume para continuar una conversación anterior.

Paso 4: pregunta antes de cambiar nada

Los mejores primeros prompts son preguntas: «¿qué hace este proyecto?», «¿qué tecnologías usa?», «¿dónde está el punto de entrada principal?» o «explícame la estructura de carpetas» (los ejemplos de la documentación están en inglés y en español funcionan igual). Claude Code lee los archivos de tu proyecto cuando los necesita, así que no tienes que pegar el contexto a mano. También puedes preguntarle por sus propias capacidades, por ejemplo «¿qué puede hacer Claude Code?».

Paso 5: haz tu primer cambio

Pide una tarea pequeña, como «añade una función hola mundo al archivo principal». Claude Code encuentra el archivo adecuado y te muestra el cambio. Si te pregunta antes, elige Sí para aprobarlo. Qué acciones necesitan tu aprobación depende del modo de permisos. Según el inicio rápido, con Claude Code versión 2.1.283 o posterior, el modo automático es el modo de permisos de partida en las sesiones interactivas de la terminal: un clasificador revisa las acciones en tu lugar y Claude edita la mayoría de los archivos y ejecuta la mayoría de los comandos sin preguntar; en versiones anteriores se aplica a los planes Pro, Max y Team. Tus ajustes o tu organización pueden fijar otro modo de partida, y Mayús+Tab cambia el modo de la sesión en cualquier momento. Consejo nuestro: hasta que confíes en la configuración de un proyecto, cambia a un modo que pregunte antes de editar, trabaja en una rama de Git y lee cada cambio antes de confirmarlo.

Paso 6: usa Git hablando

Claude Code hace conversacional el trabajo con Git: «qué archivos he cambiado», «confirma mis cambios con un mensaje descriptivo», «crea una rama nueva llamada feature/quickstart», «muéstrame los últimos 5 commits» y «ayúdame a resolver conflictos de fusión» son ejemplos de la documentación.

Arreglar un fallo, añadir una función, refactorizar, probar

Describe lo que quieres en lenguaje natural: «añade validación de entrada al formulario de registro de usuarios» o «hay un fallo por el que los usuarios pueden enviar formularios vacíos, arréglalo». Claude Code localiza el código relevante, entiende el contexto, implementa una solución y ejecuta las pruebas si las hay. La lista de tareas habituales de Anthropic incluye además refactorizar («refactoriza el módulo de autenticación para usar async/await en lugar de callbacks»), escribir pruebas, actualizar la documentación y revisar código («revisa mis cambios y sugiere mejoras»).

Los comandos que usarás cada día

Tabla: comandos esenciales

Enséñale tu proyecto con CLAUDE.md

Cada sesión de Claude Code empieza con una ventana de contexto nueva. Dos mecanismos llevan el conocimiento de una sesión a otra: los archivos CLAUDE.md, que escribes tú, y la memoria automática, notas que escribe el propio Claude a partir de tus correcciones y preferencias. Anthropic dice que hay que tratar CLAUDE.md como el lugar donde escribes lo que de otro modo tendrías que volver a explicar, como los comandos de compilación, las convenciones, la organización del proyecto y las reglas de «haz siempre X», y que conviene añadirle cosas cuando Claude comete el mismo error dos veces o cuando un compañero nuevo necesitaría el mismo contexto.

Los archivos pueden estar en varios ámbitos: tu ~/.claude/CLAUDE.md para todos los proyectos, un ./CLAUDE.md (o ./.claude/CLAUDE.md) compartido para el proyecto y un ./CLAUDE.local.md privado que no subes a Git. Ejecuta /init para generar un archivo de partida: Claude analiza tu código y escribe los comandos de compilación, las instrucciones de prueba y las convenciones que encuentra. La guía de Anthropic para escribirlo: instrucciones lo bastante concretas para poder comprobarlas («Usa sangría de 2 espacios», no «Da formato correcto al código»; «Ejecuta npm test antes de confirmar», no «Prueba tus cambios»), cada archivo por debajo de unas 200 líneas porque los más largos consumen contexto y reducen el cumplimiento, instrucciones agrupadas bajo encabezados y sin contradicciones entre sí. Claude trata estos archivos como contexto, no como configuración de obligado cumplimiento.

Consejos para empezar

La lista breve de Anthropic: sé específico en tus peticiones, da instrucciones paso a paso, deja que Claude explore primero y ahorra tiempo con los atajos de teclado. Trata a Claude como a un colega servicial: di qué quieres lograr. Valen las mismas ideas que hacen que cualquier prompt funcione; mira nuestra guía de ingeniería de prompts. Como Claude Code es un agente que actúa sobre tus archivos, lee qué es un agente para conocer los riesgos y qué es MCP para saber cómo se conecta con otras herramientas.

¿Cuánto consume de tu plan?

Claude Code viene incluido en todos los planes de pago de Claude y comparte con tus chats los límites de uso del plan, así que las sesiones largas de programación gastan el mismo saldo que las conversaciones. Al llegar a un límite puedes esperar al reinicio, subir de plan o activar créditos de uso a tarifa de API; los detalles están en el precio de Claude.