Resumen Rápido: Claude Code es un asistente de codificación de IA basado en terminal que se ejecuta nativamente en macOS y Linux, o en Windows a través de WSL2. Su configuración requiere la creación de una clave API de Anthropic, la ejecución de un instalador específico de la plataforma, la autenticación con la clave y la verificación de la instalación con un comando de prueba.
Claude Code representa el asistente de codificación oficial de Anthropic basado en terminal. Vive directamente en la línea de comandos y maneja todo, desde la generación de código hasta la corrección de errores a través de comandos en lenguaje natural.
Pero el proceso de configuración no siempre es sencillo. Los usuarios de Windows necesitan WSL2. La autenticación de la API puede confundir a los principiantes. Los conflictos de versiones ocurren.
Esta guía detalla el proceso completo de configuración para todas las plataformas, desde los requisitos del sistema hasta tu primera sesión de codificación.
Qué es Claude Code en realidad
Claude Code es una aplicación de terminal agent que se integra con entornos de desarrollo. Comprende bases de código, ejecuta tareas rutinarias y gestiona flujos de trabajo de git a través de comandos conversacionales.
A diferencia de las herramientas basadas en navegador, Claude Code se ejecuta localmente en la terminal. Accede a los archivos del proyecto directamente, mantiene el contexto a través de las sesiones y se integra con los flujos de trabajo de desarrollo existentes. Según la documentación oficial de Claude Code, la herramienta se conecta a la API de Anthropic y admite la integración con Amazon Bedrock, Google Cloud Vertex AI y Azure AI.
La herramienta funciona de manera diferente a los asistentes de codificación tradicionales. Hablando francamente: es más como tener un programador par en tu terminal que una herramienta de autocompletado de código.
Requisitos del sistema para Claude Code
Antes de la instalación, los sistemas deben cumplir requisitos específicos. Esto es lo que cada plataforma necesita:
| Plataforma | Requisitos | Notas |
|---|---|---|
| macOS | macOS 13.0 o posterior | Soporte nativo, instalación sencilla |
| Linux | Distribución de 64 bits con glibc 2.28+ | Soporte nativo para la mayoría de las distribuciones modernas |
| Windows | Windows 10 Build 19041+ o Windows 11 | Requiere instalación previa de WSL2 |
Todas las plataformas necesitan una conexión a Internet estable para las llamadas a la API. Las descargas de Claude Code suelen requerir unos 50 MB, y WSL2 en Windows añade aproximadamente 500 MB para el subsistema Linux.
En cuanto al almacenamiento, espera al menos 4 GB de espacio libre. La aplicación en sí es pequeña, pero el espacio para dependencias y archivos de proyecto es importante.
Requisitos específicos de Windows
Claude Code puede ejecutarse en Windows a través de PowerShell o Command Prompt si Node.js está instalado. La herramienta requiere Windows Subsystem for Linux 2 para crear un entorno Linux.
Según las guías de instalación de claude.ai, los sistemas Windows 10 necesitan la versión 1903 o posterior con Build 19041 o superior. Los usuarios de Windows 11 tienen WSL2 integrado. Se requieren privilegios de administrador para la configuración inicial de WSL2.
El proceso implica habilitar la virtualización en la BIOS, activar las funciones de Windows e instalar una distribución de Linux. Ubuntu 22.04 LTS es la distribución recomendada para compatibilidad.
Instalación de Claude Code: Proceso paso a paso
El proceso de instalación varía según la plataforma. Así es como puedes ejecutar Claude Code en cada sistema operativo.
Instalación en macOS y Linux
Las instalaciones de macOS y Linux siguen el mismo patrón. Ambas plataformas admiten la instalación nativa sin configuración adicional.
El proceso comienza con la descarga del instalador. Abre una terminal y ejecuta:
curl -fsSL claude.ai/install.sh | sh
El script detecta el sistema operativo, descarga el binario apropiado e instala Claude Code en el directorio bin local. La instalación suele completarse en menos de dos minutos con una conexión estable.
Para sistemas sin curl, wget funciona como alternativa. El instalador agrega Claude Code al PATH del sistema automáticamente.
Instalación en Windows a través de WSL2
La instalación en Windows requiere primero la configuración de WSL2. Aquí está el proceso completo:
Abre PowerShell como Administrador y habilita WSL:
wsl –install
Este comando habilita las características de Windows requeridas, descarga el kernel WSL2 e instala Ubuntu por defecto. El sistema te pedirá reiniciar. Después de reiniciar, Ubuntu se inicia automáticamente para completar la configuración del usuario.
Crea un nombre de usuario y una contraseña cuando se te solicite. Estas credenciales son para el entorno Linux, separadas de los detalles de inicio de sesión de Windows.
Una vez que WSL2 esté en funcionamiento, se aplica el proceso de instalación de Linux. En la terminal de Ubuntu, ejecuta el comando curl de la sección de macOS/Linux anterior.
El instalador se encarga del resto. Claude Code se instala dentro del entorno WSL2 y se ejecuta a través de la terminal de Ubuntu.
Obtener una clave API de Anthropic
Claude Code requiere una clave API de Anthropic para la autenticación. La clave conecta la instalación local con los servidores de Anthropic.
Visita la Consola de Anthropic en console.anthropic.com. Crea una cuenta o inicia sesión con tus credenciales existentes. Navega a Claves API en la configuración de la cuenta.
Haz clic en "Crear clave" para generar una nueva clave API. La clave aparece una vez; cópiala inmediatamente. Anthropic no vuelve a mostrar la clave completa después de salir de la página.
Almacena la clave de forma segura. Proporciona acceso completo a la API de Anthropic y a cualquier facturación asociada.
Comprensión de los costos de la API
Claude Code opera con un modelo de pago por uso a través de la API de Anthropic. Basado en datos de las guías de instalación de claude.ai, los costos varían según el modelo:
| Modelo | Costo de entrada | Costo de salida |
|---|---|---|
| Claude Opus 4.6 | 5 $ por millón de tokens | 25 $ por millón de tokens |
| Claude Sonnet 4.6 | 3 $ por millón de tokens | 15 $ por millón de tokens |
La compra mínima para activar la facturación es de 5 $, aunque las discusiones en la comunidad sugieren que 20-30 $ proporcionan un mejor margen para las pruebas. Las opciones de suscripción alternativas incluyen Claude Pro por 20 $ al mes o Claude Max por 100 $ al mes para un uso intensivo.
El comportamiento predeterminado utiliza Opus hasta alcanzar el 50% de los límites de uso, luego cambia a Sonnet para mayor eficiencia de costos.
Autenticación y primer lanzamiento
Después de la instalación, Claude Code necesita autenticación antes de su primer uso. Inicia Claude Code ejecutando:
claude
El primer lanzamiento te pedirá la clave API. Pega la clave de la Consola de Anthropic y presiona Enter. Claude Code valida la clave y la almacena de forma segura en los archivos de configuración locales.
La autenticación persiste entre sesiones. La clave API no necesita reingresarse a menos que se elimine explícitamente o al cambiar de cuenta.
Para verificar que la autenticación funcionó, Claude Code muestra un mensaje de bienvenida y un prompt de comando. La interfaz muestra los comandos disponibles y confirma la conexión a la API de Anthropic.
Configuración de preferencias de modelo
Claude Code utiliza la selección automática de modelo por defecto, pero la configuración manual es posible. Según la documentación oficial, los usuarios pueden ajustar la selección del modelo a través del comando /model o configurando la variable de entorno CLAUDE_CODE_EFFORT_LEVEL.
El nivel de esfuerzo controla la profundidad de pensamiento para los modelos Opus 4.6 y Sonnet 4.6: bajo, medio o alto. Los niveles de esfuerzo más altos aumentan la profundidad de razonamiento pero también el costo y el tiempo de respuesta.
Para proyectos que requieren análisis profundos, incluir "ultrathink" en los prompts establece temporalmente el esfuerzo en alto para ese turno específico.
Verificación del éxito de la instalación
Después de la autenticación, verifica que Claude Code funciona correctamente. Ejecuta estas pruebas básicas:
claude –help
claude –version
El comando help muestra las opciones y comandos disponibles. La salida de version confirma qué versión está instalada. Ambos comandos deberían ejecutarse sin errores.
A continuación, prueba Claude Code en un directorio de proyecto. Crea una carpeta de prueba:
mkdir test-project
cd test-project
echo “# Proyecto de prueba” > README.md
claude
Dentro de la sesión de Claude Code, intenta interacciones básicas:
- Escribe "help" para ver los comandos disponibles
- Pregunta "¿explícame qué puedes hacer"
- Solicita "resume este proyecto"
- Prueba el comando /help
Estas interacciones confirman que Claude Code puede leer los archivos del proyecto y responder a los prompts. Las respuestas exitosas significan que la instalación es funcional.
Configuración de Claude Code para proyectos
Claude Code almacena la configuración específica del proyecto en archivos de configuración. Estos archivos personalizan el comportamiento, definen la memoria y establecen flujos de trabajo.
El archivo de configuración principal es CLAUDE.md en la raíz del proyecto. Este archivo contiene instrucciones, contexto y pautas específicas del proyecto que Claude Code referencia durante las sesiones.
Crea un archivo CLAUDE.md básico:
# Contexto del proyecto
Esto es un [tipo de proyecto] construido con [tecnologías].
## Directrices clave
– [Regla importante 1]
– [Regla importante 2]
## Estructura del proyecto
[Breve explicación de la organización de carpetas]
El archivo acepta formato Markdown. Claude Code lee este contexto al inicio de la sesión y lo mantiene durante toda la conversación.
Opciones de configuración avanzada
Más allá del contexto básico, Claude Code admite configuración avanzada a través del directorio .claude. Este directorio puede contener:
- Habilidades: Capacidades especializadas definidas en .claude/skills/SKILL.md
- Comandos: Comandos de barra personalizados en .claude/commands/*.md
- Hooks: Flujos de trabajo automatizados activados por eventos
- Plugins: Funcionalidad extendida a través de integración programática
Según la documentación oficial del Agent SDK, estas características permiten una personalización sofisticada. Las habilidades definen capacidades reutilizables. Los comandos crean atajos para tareas comunes. Los hooks automatizan respuestas a cambios de archivos o uso de herramientas.
Uso de Claude Code: Flujos de trabajo básicos
Con la instalación completa, Claude Code maneja tareas de desarrollo comunes a través del lenguaje natural.
Inicia una sesión navegando a un directorio de proyecto y ejecutando:
claude
El prompt acepta solicitudes en lenguaje natural. Algunos flujos de trabajo comunes:
- Generación de código: "Crea una función de Python que valide direcciones de correo electrónico con manejo adecuado de errores."
- Corrección de errores: "Esta función está lanzando una excepción de puntero nulo. ¿Puedes identificar y corregir el problema?"
- Refactorización: "Refactoriza este componente para usar inyección de dependencias en lugar de instanciación directa."
- Operaciones de Git: "Crea una nueva rama, commite estos cambios con un mensaje descriptivo y haz push al origen."
Claude Code mantiene el contexto a través de la sesión. Recuerda interacciones anteriores, rastrea modificaciones de archivos y comprende la estructura general del proyecto.
Comprensión del modo Plan
Para cambios complejos, Claude Code ofrece el Modo Plan. Este modo crea un plan de ejecución detallado antes de realizar modificaciones.
Activa el Modo Plan prefijando las solicitudes con "plan:" o usando el comando /plan. Claude Code luego describe los cambios propuestos, explica el razonamiento y espera la aprobación antes de la ejecución.
El Modo Plan es particularmente útil para refactorización, cambios arquitectónicos o modificaciones que afectan a varios archivos. Proporciona visibilidad de lo que Claude Code pretende hacer antes de confirmar los cambios.
Integración con VS Code y IDEs
Si bien Claude Code se ejecuta en la terminal, la integración con editores de código mejora el flujo de trabajo. La extensión oficial de VS Code trae las capacidades de Claude Code directamente al editor.
Instala la extensión desde el mercado de VS Code. Busca "Claude Code" y haz clic en Instalar. La extensión agrega un panel de Claude Code a la barra lateral.
Según la documentación oficial de VS Code, la extensión admite:
| Característica | Atajo | Descripción |
|---|---|---|
| Enfoque de entrada | Cmd+Esc / Ctrl+Esc | Alterna entre editor y Claude |
| Abrir en nueva pestaña | Cmd+Shift+Esc / Ctrl+Shift+Esc | Inicia una nueva conversación como pestaña |
| Abrir en Terminal | – | Inicia el modo terminal desde VS Code |
La extensión mantiene la paridad de características con la versión de terminal, al tiempo que agrega conveniencias específicas de IDE como diffs en línea y referencias de archivos con @-menciones.
Actualización y gestión de Claude Code
Claude Code se actualiza automáticamente por defecto. La aplicación busca nuevas versiones periódicamente e instala actualizaciones en segundo plano.
Para actualizar manualmente, ejecuta:
claude –update
Esto fuerza una comprobación e instalación inmediatas de la última versión. El proceso de actualización conserva los archivos de configuración y las credenciales de autenticación.
Para organizaciones que requieren control de versiones, las actualizaciones automáticas se pueden deshabilitar. Configura la variable de entorno CLAUDE_CODE_AUTO_UPDATE a false o configúrala a través de ajustes administrados por el servidor.
Para instalar una versión específica, usa:
curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z
Reemplaza X.Y.Z con el número de versión deseado.
Problemas comunes de configuración y soluciones
Varios problemas ocurren comúnmente durante la configuración. Así es como resolverlos:
- Rechazo de clave API: Si Claude Code rechaza la clave API, verifica que no haya espacios o caracteres adicionales. Vuelve a copiar la clave de la Consola de Anthropic. Comprueba que la facturación esté activada; las claves no funcionarán sin un método de pago registrado.
- Fallos de instalación de WSL2: Los sistemas Windows a veces fallan la instalación de WSL2 debido a la configuración de virtualización. Entra en la BIOS y habilita la virtualización (Intel VT-x o AMD-V). Asegúrate de que la versión de Windows cumpla los requisitos mínimos.
- Comando no encontrado: Si la terminal no reconoce el comando claude, el PATH no se actualizó correctamente. Cierra y vuelve a abrir la terminal. Para problemas persistentes, agrega manualmente el directorio de instalación al PATH.
- Tiempos de espera de conexión: Las restricciones de red o los firewalls pueden bloquear las llamadas a la API. Claude Code requiere acceso HTTPS a api.anthropic.com. Las redes corporativas pueden necesitar configuración de proxy.
- Errores de permisos: Las instalaciones de Linux y macOS ocasionalmente encuentran problemas de permisos. Ejecuta el instalador con los permisos apropiados o instala en un directorio de usuario en lugar de ubicaciones a nivel de sistema.
Verifica los créditos de IA disponibles antes de configurar Claude Code
Configurar Claude Code generalmente implica experimentar: ejecutar prompts, probar integraciones y construir prototipos pequeños antes de que algo vaya a producción. Esa etapa inicial a menudo conduce a un uso intensivo de la API. En lugar de pagar por cada solicitud de inmediato, muchos desarrolladores primero buscan créditos disponibles o programas de inicio que ayuden a reducir esos costos iniciales.
Get AI Perks recopila estas oportunidades en un solo lugar. La plataforma enumera créditos de IA, descuentos y programas de socios en proveedores de IA, plataformas en la nube y herramientas para desarrolladores, con guías paso a paso que explican cómo reclamarlos. En total, la base de datos incluye ventajas de más de 200 herramientas y millones de dólares en créditos disponibles que las startups y los constructores pueden solicitar.
Antes de terminar de configurar Claude Code, consulta Get AI Perks y reclama los créditos de IA que pueden cubrir tus primeros experimentos.
Preguntas frecuentes
¿Tengo que pagar por Claude Code?
Claude Code en sí es software gratuito, pero requiere una clave API de Anthropic que opera con un modelo de pago por uso. La activación mínima de la cuenta es de 5 $, aunque el uso práctico generalmente requiere entre 20 y 30 $ en créditos. Los planes de suscripción alternativos como Claude Pro (20 $/mes) o Claude Max (100 $/mes) ofrecen diferentes estructuras de precios para usuarios intensivos.
¿Puede Claude Code funcionar completamente sin conexión?
No. Claude Code requiere una conexión a Internet activa para comunicarse con los servidores de la API de Anthropic. La aplicación procesa las solicitudes localmente pero envía los prompts a los modelos Claude que se ejecutan en la infraestructura de Anthropic. No hay modo sin conexión ni opción de modelo local.
¿Cuál es la diferencia entre Claude Code y Claude.ai?
Claude.ai es una interfaz de chat web para interacciones generales de Claude. Claude Code es una aplicación de terminal especializada diseñada específicamente para el desarrollo de software. Claude Code se integra con git, lee archivos de proyecto directamente, mantiene un contexto de desarrollo más largo e incluye funciones específicas de codificación como el Modo Plan y capacidades de edición de archivos.
¿Cómo cambio entre modelos de Claude?
Usa el comando /model dentro de una sesión de Claude Code para cambiar entre los modelos disponibles. La configuración predeterminada utiliza Opus hasta alcanzar el 50% de uso, y luego cambia a Sonnet. La selección manual permite elegir modelos específicos según los requisitos de la tarea: Opus para razonamiento complejo, Sonnet para respuestas rápidas y rentables.
¿Puedo usar Claude Code en VS Code?
Sí. Una extensión oficial de VS Code integra la funcionalidad de Claude Code en el editor. Instálala desde el mercado de VS Code. La extensión proporciona las mismas capacidades que la versión de terminal con integraciones adicionales de IDE como diffs en línea, paneles laterales y atajos de teclado para un acceso rápido.
¿Claude Code almacena mi código o mis conversaciones?
Según las políticas de uso de datos de Anthropic, las interacciones de la API no se utilizan para entrenar modelos. Las organizaciones pueden configurar políticas de retención de datos cero a través de configuraciones empresariales. El código y los prompts se transmiten a los servidores de Anthropic para su procesamiento, pero el manejo depende de la configuración de la cuenta y las políticas de retención de datos.
¿Qué sucede si Claude Code comete un error?
Claude Code incluye características de seguridad como la integración con git y el Modo Plan para minimizar errores. Para los errores que ocurren, se aplican las prácticas estándar de control de versiones: el historial de git proporciona capacidad de reversión. El sistema de permisos requiere aprobación para operaciones sensibles. Algunas discusiones de la comunidad sugieren tasas de éxito en el rango del 80-90% para tareas rutinarias, con supervisión recomendada para cambios críticos.
Avanzando con Claude Code
Claude Code transforma el desarrollo basado en terminal al integrar asistencia de IA directamente en la línea de comandos. La configuración requiere instalación específica de la plataforma, autenticación de API y configuración básica, pero el proceso es sencillo si se siguen los pasos adecuados.
La herramienta sobresale en tareas de desarrollo rutinarias, generación de código y gestión de flujos de trabajo de git. El Modo Plan proporciona seguridad para operaciones complejas. La integración con IDE extiende las capacidades más allá de la terminal.
Comienza con tareas simples para entender cómo Claude Code interpreta las solicitudes. Incrementa hasta flujos de trabajo más complejos a medida que ganes familiaridad. Usa el comando /clear entre tareas distintas para mantener un contexto limpio. Configura los archivos CLAUDE.md para guías específicas del proyecto.
Los equipos pueden explorar configuraciones administradas por el servidor y mercados de plugins. Los desarrolladores individuales pueden beneficiarse de habilidades y comandos personalizados adaptados a patrones frecuentes.
El repositorio de GitHub en anthropics/claude-code contiene ejemplos adicionales, plugins comunitarios y recursos de solución de problemas. La documentación oficial en docs.anthropic.com proporciona referencias técnicas completas.
Ahora es el momento de empezar a codificar. Navega a un proyecto, inicia Claude Code y observa cómo el desarrollo asistido por IA cambia tu flujo de trabajo.
