Configuración y primer inicio

Configurar Claude Code

En la masterclass «Agentic Coding» aprendiste a trabajar con agentes de programación, independientemente de la herramienta. En este curso lo pones en práctica con Claude Code, el agente de programación de Anthropic. Lo configuras, descubres dónde están los conceptos de la masterclass en Claude Code, lo ajustas de forma segura y recorres paso a paso el proyecto de práctica.

Actualizado a octubre de 2026 Claude Code se desarrolla de forma continua, a menudo cada semana. Este curso describe el estado de octubre de 2026 y se basa en la documentación oficial en code.claude.com/docs. Si una pantalla o un comando se ve distinto en tu caso, prevalece la documentación. En Claude Code, /help te muestra siempre los comandos actuales.

Lo que necesitas

Una suscripción: Claude Code está incluido en los planes Pro, Max, Ultra, Team y Enterprise de Anthropic. La cuenta gratuita no basta. Como alternativa, puedes pagar por uso a través de la Claude Console. Para empezar, basta con el plan Pro (a octubre de 2026: 20 dólares estadounidenses al mes con facturación mensual). Los precios actuales están en claude.com/pricing.
Un ordenador: macOS 13 o posterior, o Windows 10 (versión 1809 o posterior) o Windows 11, al menos 4 GB de memoria RAM y conexión a Internet.
Git para el proyecto de práctica. Cómo comprobar si Git está instalado se explica en la lección de la masterclass «Entorno de trabajo y conceptos básicos».

Dos caminos: aplicación de escritorio o terminal

Claude Code existe en varias variantes. Dos son importantes para este curso:

Recomendada para empezar. La aplicación Claude para Mac y Windows tiene un área «Code». Allí eliges una carpeta de proyecto, chateas con Claude Code y ves los cambios como diff en color. No necesitas terminal ni instalar nada más.

Descarga la aplicación en claude.com/download e instálala.
Inicia sesión con tu cuenta de Anthropic.
Haz clic arriba en Code. Si la aplicación te pide mejorar tu plan, no tienes el plan adecuado.

Más posibilidades. En el terminal inicias Claude Code con el comando claude. Esta variante admite todas las funciones y es la base de la documentación oficial. La instalación lleva dos minutos (ver más abajo).

La aplicación de escritorio y el terminal leen los mismos archivos de configuración y el mismo CLAUDE.md. Así que puedes cambiar en cualquier momento.

También hay extensiones para los editores de código Visual Studio Code y JetBrains, además de una versión web. Los conceptos de este curso valen en todas partes.

Instalar en el terminal

Abre el terminal (Mac: el programa «Terminal»; Windows: «PowerShell») y pega el comando correspondiente. Procede de la documentación oficial:

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

Como alternativa con Homebrew: brew install --cask claude-code. Eso sí, esta variante no se actualiza sola.

irm https://claude.ai/install.ps1 | iex

El comando es para PowerShell (el indicador empieza por PS C:\). No necesitas derechos de administrador. También se recomienda «Git for Windows». Sin Git for Windows, Claude Code ejecuta los comandos con PowerShell.

Mientras descarga, el instalador no muestra ningún progreso. Después abre una ventana de terminal nueva y comprueba:

claude --version

Si aparece un número de versión, todo está listo. Si el terminal indica «command not found» o «no se reconoce», todavía no encuentra el programa. La documentación describe la solución en «Solucionar problemas de instalación». El comando claude doctor comprueba la instalación en detalle.

Consejo práctico: la versión instalada de este modo se actualiza sola en segundo plano. No tienes que ocuparte de las actualizaciones. Si prefieres una versión algo más antigua y probada, puedes elegir el canal «stable» en la configuración.

Primer inicio y acceso

En el terminal, ve a una carpeta de proyecto, por ejemplo cd Proyectos/hike-planner.
Inicia Claude Code con claude.
En el primer inicio se abre el navegador para iniciar sesión. Inicia sesión con tu cuenta de Anthropic. Si el navegador no se abre, pulsa c para copiar el enlace de acceso.
Claude Code pregunta si confías en los archivos de esta carpeta. Confírmalo solo en carpetas cuyo origen conozcas.

Después ves una línea de entrada. Aquí escribes tus encargos en español, igual que en un chat. /status muestra versión, cuenta y modelo; /help, todos los comandos. Sales de Claude Code pulsando dos veces Ctrl+C o con el comando /exit.

Suscripción, costes y protección de datos

Con una suscripción pagas un precio mensual fijo. El uso está limitado por ventanas de tiempo: si trabajas mucho, en algún momento llegas al límite y tienes que esperar. /usage muestra qué parte de tu cuota has usado y qué consume más. La facturación por uso a través de la Claude Console está pensada para equipos y empresas. Allí puedes fijar límites de gasto por espacio de trabajo.

Revisa tu configuración de protección de datos Con los planes personales (Free, Pro, Max, Ultra) eliges si Anthropic puede usar tus datos para entrenar modelos futuros. Esto afecta también al código que lee Claude Code. Si la opción está activada, Anthropic está autorizada a conservar los datos mucho más tiempo y a usarlos para el entrenamiento. Cambias la configuración en claude.ai/settings/data-privacy-controls. Con los planes empresariales (Team, Enterprise) y la API, Anthropic indica que no entrena con tus datos. Si trabajas con código de clientes, aclara antes si el cliente está de acuerdo y qué plan y qué configuración son adecuados. Más información en el curso «IA y protección de datos en la empresa».

Ejercicio: configuración y primer encargo

Instala Claude Code como aplicación de escritorio o en el terminal e inicia sesión.
Revisa la configuración de protección de datos de tu cuenta.
Abre la carpeta hike-planner del proyecto de práctica de la masterclass (escritorio: elegir la carpeta; terminal: cd a la carpeta, luego claude).
Da el encargo: «Explícame este proyecto: ¿para qué sirve, qué archivos hay y qué hace cada uno? No cambies nada.»
Escribe /usage y mira cuánto ha consumido este primer encargo. En la aplicación de escritorio también encuentras los comandos escribiendo /.

¿Qué cuenta no basta para usar Claude Code?

Correcto. Claude Code requiere Pro, Max, Ultra, Team, Enterprise o una cuenta de Claude Console. La cuenta gratuita no incluye Claude Code.

No exactamente. Pro y Team incluyen Claude Code. Solo la cuenta gratuita no basta.

Puntos clave:

Claude Code necesita una suscripción (Pro, Max, Ultra, Team, Enterprise) o una cuenta de Claude Console.
Aplicación de escritorio para empezar fácilmente, terminal para todas las funciones. Ambos usan la misma configuración.
Instalación con un comando, comprobación con claude --version. Las actualizaciones llegan automáticamente.
En el primer inicio: acceso en el navegador y la pregunta de si confías en la carpeta.
Revisar la configuración de protección de datos de la cuenta antes de trabajar con código ajeno.

Esta lección forma parte de un curso con examen final y certificado. Ver el curso «Claude Code en la práctica»