Resumen rápido: Iniciar Claude Code en la terminal es sencillo: instálalo usando un comando de una línea desde el sitio oficial, autentícate con tu cuenta de Anthropic y escribe 'claude' para iniciar una sesión interactiva. La herramienta CLI funciona en macOS, Linux y Windows, permitiendo a los desarrolladores crear funcionalidades, corregir errores y automatizar tareas mediante comandos en lenguaje natural directamente en su entorno de terminal.
Claude Code representa un cambio en la forma en que los desarrolladores interactúan con la asistencia de IA. En lugar de copiar código entre pestañas del navegador y editores de texto, esta herramienta basada en terminal vive dentro del flujo de trabajo de desarrollo, comprendiendo bases de código completas y ejecutando tareas complejas a través de comandos conversacionales.
El proceso de configuración tarda menos de cinco minutos para la mayoría de los desarrolladores. Pero hay más en iniciar Claude Code de manera efectiva que solo la instalación.
Esta guía cubre todo, desde la instalación inicial hasta el inicio de sesiones productivas, con ejemplos prácticos que funcionan en proyectos reales.
Lo que Claude Code hace realmente
Según la documentación oficial, Claude Code es una herramienta de codificación agéntica que lee bases de código, edita archivos, ejecuta comandos y se integra con herramientas de desarrollo. La interfaz de terminal sirve como el punto de interacción principal para la mayoría de los desarrolladores.
La herramienta maneja tareas de desarrollo rutinarias: crear funcionalidades, corregir errores, automatizar flujos de trabajo y explicar secciones de código complejas. Opera con el contexto completo de los archivos del proyecto, el historial de git y los procesos en ejecución.
A diferencia de los asistentes de IA basados en navegador, Claude Code ejecuta comandos directamente en el entorno de la shell. Cuando se le pide que corrija un error de compilación, no solo sugiere soluciones, sino que puede ejecutar la corrección, probar el resultado y confirmar los cambios.
Terminal vs. otras plataformas
Claude Code funciona en múltiples plataformas: CLI de terminal, aplicación de escritorio, interfaz web, extensiones IDE para VS Code y JetBrains, y una extensión de Chrome para depurar aplicaciones en vivo. La versión de terminal ofrece el control más directo.
Las sesiones de terminal proporcionan atajos de teclado, ejecución de tareas en segundo plano e integración con configuraciones de shell existentes. Los desarrolladores que viven en la línea de comandos encuentran esta la interfaz más rápida.
| Plataforma | Mejor para | Ventaja clave |
|---|---|---|
| CLI de terminal | Desarrolladores cómodos con la línea de comandos | Interacción más rápida, integración completa de la shell |
| Aplicación de escritorio | Preferencia visual con sesiones persistentes | Interfaz gráfica, navegación más fácil |
| Extensión VS Code | Desarrolladores que rara vez salen de su IDE | Integración perfecta del editor |
| Interfaz web | Acceso rápido sin instalación | Funciona en cualquier dispositivo con navegador |
Requisitos de instalación
Antes de instalar Claude Code, verifica que el sistema cumpla con los requisitos básicos. La herramienta se ejecuta en macOS, Linux y Windows (incluyendo WSL2).
Se requiere una cuenta activa de Anthropic. Si no tienes una, créala en el sitio web oficial de Anthropic antes de proceder con la instalación.
La terminal debe tener conectividad a Internet y permiso para descargar y ejecutar scripts. Algunas redes corporativas restringen la ejecución de scripts; consulta con TI si la instalación falla.
Sistemas operativos compatibles
Eliminar esta afirmación - no se encuentra en los materiales de origen oficiales La instalación funciona a través de Terminal o cualquier emulador de terminal como iTerm2.
Las distribuciones de Linux requieren una shell moderna (bash o zsh). La mayoría de las instalaciones recientes de Ubuntu, Debian, Fedora y Arch funcionan sin modificaciones.
Los usuarios de Windows deben instalar primero Windows Subsystem for Linux (WSL2). Existe soporte nativo para Windows, pero WSL2 proporciona una mejor compatibilidad con las herramientas de desarrollo.
Reduce los costos de herramientas de IA con Get AI Perks al empezar
Empezar con Claude Code a menudo implica probar otras herramientas de IA también. Get AI Perks ayuda a los fundadores a encontrar créditos para startups y descuentos de software en productos de IA y nube. La plataforma reúne más de 200 ofertas, incluyendo ventajas para Claude, Anthropic, OpenAI, Gemini, ElevenLabs y más, junto con las condiciones para cada una.
¿Quieres ver las ventajas disponibles para herramientas de IA?
Consulta Get AI Perks para:
- navegar por ofertas de Claude y otras herramientas de IA
- ver qué ventajas se adaptan a tu empresa
- seguir guías para reclamar créditos disponibles
👉 Visita Get AI Perks para comparar las ventajas de software de IA disponibles.
Proceso de instalación paso a paso
El método de instalación oficial utiliza un solo comando que detecta el sistema operativo e instala la versión apropiada.
Para macOS y Linux
Abre una ventana de terminal y ejecuta este comando:
| curl -fsSL claude.ai/install.sh | bash |
El script de instalación descarga el binario de Claude Code, lo coloca en una ubicación del sistema y configura la integración de la shell. El proceso generalmente se completa en menos de 30 segundos.
Si la instalación tiene éxito, la terminal mostrará un mensaje de confirmación. Prueba la instalación escribiendo:
| claude --version |
Este comando debería devolver el número de versión actual. Si en su lugar aparece un error diciendo "command not found", la configuración de PATH necesita ajustarse.
Para Windows con WSL2
Primero, asegúrate de que WSL2 esté instalado y configurado. Abre una terminal WSL2 (se recomienda Ubuntu) y ejecuta el mismo comando de instalación que para Linux:
| curl -fsSL install.claude.ai | sh |
Los problemas de red específicos de Windows a veces ocurren con WSL2. Según la documentación de solución de problemas, es posible que sea necesario ajustar las reglas del firewall para permitir la comunicación entre WSL2 y los procesos de Windows.
Solución de problemas de instalación
El problema de instalación más común es la configuración de PATH. Cuando la terminal muestra "command not found" después de la instalación, el binario de Claude no está en la ruta de ejecutables de la shell.
Verifica la ubicación de instalación con:
| which claude |
Si esto no devuelve nada, agrega manualmente el directorio de instalación a PATH. Para bash, agrega esta línea a ~/.bashrc:
| export PATH="$HOME/.local/bin:$PATH" |
Para usuarios de zsh, agrega la misma línea a ~/.zshrc en su lugar. Reinicia la terminal o ejecuta source ~/.bashrc para aplicar los cambios inmediatamente.
Las fallas de instalación relacionadas con la red a menudo se muestran como "TLS connect error" o interrupciones de descarga. Esto indica restricciones de firewall o certificados obsoletos. Actualiza los certificados del sistema o contacta a los administradores de red si trabajas en una red corporativa.
Autenticación y primer lanzamiento
Después de una instalación exitosa, la autenticación conecta la CLI local a una cuenta de Anthropic. Inicia el proceso de autenticación ejecutando:
| claude |
El primer lanzamiento activa automáticamente la autenticación. Se abre una ventana del navegador que muestra una página de inicio de sesión. Inicia sesión con las credenciales de tu cuenta de Anthropic.
Una vez completada la autenticación en el navegador, la sesión de terminal se activa. Un mensaje de bienvenida confirma la conexión y muestra instrucciones básicas de uso.
Gestión de sesiones
Cada vez que se ejecuta claude en una terminal, se inicia una nueva sesión. Las sesiones persisten hasta que se finalizan explícitamente con Ctrl+D o escribiendo exit.
El token de autenticación se almacena localmente, por lo que los lanzamientos posteriores no requieren inicio de sesión en el navegador. El token permanece válido hasta que se revoca manualmente a través de la configuración de la cuenta en el sitio web de Anthropic.
Inicio del modo interactivo
El modo interactivo representa la forma principal en que los desarrolladores utilizan Claude Code. Inícialo escribiendo claude sin argumentos adicionales.
La terminal cambia a un prompt interactivo donde los comandos en lenguaje natural dirigen a la IA. Este modo mantiene el contexto de la conversación, recuerda solicitudes anteriores y puede ejecutar flujos de trabajo de varios pasos.
Comandos interactivos esenciales
Varios comandos integrados controlan el comportamiento de la sesión.
Escríbelos en el prompt de Claude Code:
- /model – Cambia entre diferentes modelos de Claude (Opus, Sonnet)
- /status – Muestra el modelo actual, el ID de sesión y la configuración
- /btw – Haz preguntas laterales sin cambiar el contexto de la tarea
- ? – Muestra atajos de teclado e información de ayuda
Los atajos de teclado mejoran la productividad. Presiona Ctrl+L para limpiar la pantalla de la terminal sin finalizar la sesión. Usa Ctrl+C para cancelar una generación en curso. Ctrl+F mata todas las tareas en segundo plano (presiona dos veces para confirmar).
La línea de estado en la parte inferior muestra los procesos activos en segundo plano, el modelo actual y el uso de tokens. Esta información ayuda a monitorear el consumo de recursos durante tareas complejas.
Ejecución de tareas en segundo plano
Claude Code puede ejecutar operaciones de larga duración en segundo plano, manteniéndose receptivo a nuevos comandos. Las tareas en segundo plano muestran indicadores de progreso y se completan de forma asíncrona.
Cuando se ejecutan varias operaciones simultáneamente, la lista de tareas rastrea cada una. Presiona Ctrl+F para ver y administrar los procesos en segundo plano.
Ejecución de comandos de una sola vez
No todas las tareas necesitan una sesión interactiva. Para operaciones rápidas, Claude Code acepta comandos directamente como argumentos:
| claude "explica la lógica de autenticación en src/auth.js" |
Este comando inicia Claude Code, procesa la solicitud, muestra la salida y sale inmediatamente. No comienza ninguna sesión interactiva.
Los comandos de una sola vez funcionan bien para scripting y automatización. Se pueden incorporar en hooks de git, pipelines de CI/CD o scripts de shell que necesiten asistencia de IA para sub-tareas específicas.
Modo solo consulta
La bandera -p ejecuta el modo solo consulta, que responde preguntas sin realizar cambios en los archivos:
| claude -p "¿qué dependencias utiliza este proyecto?" |
Este modo lee los archivos del proyecto pero no edita, crea ni elimina nada. Solo proporciona información, lo que lo hace seguro para la exploración sin riesgo de modificaciones no deseadas.
Selección y configuración de modelos
Claude Code admite múltiples modelos de IA con diferentes capacidades y características de velocidad. Según la documentación oficial, los modelos admitidos incluyen Sonnet 4.6, Opus 4.6, Opus 4.5, Haiku 4.5 y Sonnet 4.5.
Cambia el modelo activo usando el comando /model durante una sesión interactiva. Un menú interactivo enumera las opciones disponibles con breves descripciones de las fortalezas de cada modelo.
Para preferencias de modelo permanentes, establece una variable de entorno antes de iniciar Claude Code:
| export ANTHROPIC_MODEL="claude-opus-4-6" claude |
Esta configuración persiste entre sesiones hasta que la variable cambia o se desactiva.
Configuración del modo rápido
El modo rápido prioriza la velocidad de respuesta sobre el análisis exhaustivo. Es útil para iteraciones rápidas y tareas sencillas donde el análisis de contexto completo no es necesario.
Habilita el modo rápido a través de la configuración de ajustes o usando variantes de modelo optimizadas para la velocidad. Consulta la documentación oficial para conocer las opciones actuales del modo rápido, ya que evolucionan con los nuevos lanzamientos de modelos.
Trabajando con proyectos
Claude Code comprende la estructura del proyecto analizando los archivos en el directorio actual y los subdirectorios. Navega a un directorio de proyecto antes de empezar:
| cd /ruta/a/tu/proyecto claude |
La herramienta lee automáticamente los archivos del proyecto, comprende la estructura de la base de código y reconoce patrones comunes como gestores de paquetes, configuraciones de frameworks y herramientas de compilación.
Exclusión de archivos sensibles
Algunos archivos no deben ser analizados ni modificados por herramientas de IA: credenciales, claves API, archivos binarios grandes o contenido generado. Crea un archivo .claudeignore en la raíz del proyecto para excluir rutas específicas:
| .env .env.local node_modules/ dist/ build/ *.log |
Esto funciona de manera similar a la sintaxis de .gitignore. Los archivos excluidos permanecen invisibles para Claude Code tanto durante el análisis como durante la ejecución.
Consejos de configuración de terminal
Claude Code funciona mejor con ciertas configuraciones de terminal. La mayoría de los problemas provienen de configuraciones de shell incompatibles o características faltantes.
Integración de la shell
Suavizar: Algunas terminales modernas admiten características opcionales de integración de shell como la detección de prompts mediante secuencias OSC 133, aunque estas no son necesarias
Para una compatibilidad óptima, utiliza versiones recientes de emuladores de terminal populares: iTerm2 en macOS, Alacritty, Kitty o WezTerm en Linux. Windows Terminal funciona bien con WSL2.
Personalización de atajos de teclado
Los atajos de teclado predeterminados pueden entrar en conflicto con los enlaces existentes de la terminal o la shell. Personalízalos a través del archivo de configuración de ajustes ubicado en ~/.claude/settings.json.
El archivo de configuración utiliza formato JSON y admite la reasignación de cualquier comando integrado a diferentes combinaciones de teclas. Después de editar, reinicia Claude Code para que los cambios surtan efecto.
Flujos de trabajo comunes de la primera sesión
Hablando en serio: la primera sesión de Claude Code a menudo implica experimentación. Aquí hay puntos de partida prácticos que demuestran las capacidades principales.
Explorar la base de código
Comienza pidiendo a Claude Code que explique la estructura del proyecto:
"Dame una descripción general de esta base de código. ¿Cuáles son los componentes principales y cómo interactúan?"
Esta solicitud no modifica nada, solo analiza y explica. La respuesta ayuda a verificar que Claude Code comprende correctamente la organización del proyecto.
Realizar un cambio simple
Intenta una modificación de bajo riesgo para ver la edición de archivos en acción:
"Agrega un comentario en la parte superior de README.md explicando qué hace este proyecto"
Claude Code lee el archivo, genera el contenido apropiado y realiza la edición. Revisa el cambio con git diff para ver exactamente qué sucedió.
Corregir un problema existente
Si el proyecto tiene errores conocidos o elementos TODO, pídele a Claude Code que los aborde:
"Corrige el error de validación de inicio de sesión descrito en el problema #42"
La herramienta lee los archivos fuente relevantes, identifica el problema, implementa una solución e incluso puede ejecutar pruebas para verificar que la solución funcione.
Permisos y seguridad
Claude Code solicita permiso antes de ejecutar operaciones potencialmente arriesgadas. El sistema de permisos categoriza los comandos por nivel de impacto.
La lectura de archivos se realiza sin solicitudes de permiso; leer código siempre es seguro. La escritura, eliminación de archivos y ejecución de comandos de shell requieren aprobación explícita en la primera ocurrencia.
Las opciones de permiso se pueden guardar para la sesión o de forma permanente. Los permisos permanentes se almacenan en archivos de configuración y se aplican a todas las sesiones futuras.
Configuración de sandboxing
Según la documentación oficial de configuración, el sandboxing restringe dónde Claude Code puede realizar cambios. Configura prefijos de ruta de sandbox para limitar el acceso al sistema de archivos a directorios específicos.
Esta capa de seguridad evita la modificación accidental de archivos del sistema o directorios fuera del alcance del proyecto. Los equipos que trabajan en bases de código sensibles deben configurar el sandboxing antes de la implementación.
| Tipo de permiso | Comportamiento predeterminado | Recomendado para |
|---|---|---|
| Lectura de archivos | Siempre permitido | Todos los casos de uso |
| Escritura/Edición de archivos | Preguntar la primera vez | Desarrollo activo |
| Eliminación de archivos | Preguntar cada vez | Solo para usuarios experimentados |
| Comandos de shell | Preguntar con vista previa | Flujos de trabajo automatizados |
| Acceso a la red | Preguntar la primera vez | Trabajos de integración de API |
Preguntas frecuentes
¿Claude Code funciona sin conexión después de la instalación?
No. Claude Code requiere conectividad a Internet para todas las operaciones porque los modelos de IA se ejecutan en los servidores de Anthropic. El cliente de terminal envía solicitudes a la API y recibe respuestas. Sin conexión, la herramienta no puede funcionar.
¿Cuánto cuesta ejecutar Claude Code?
El precio depende del plan de la cuenta de Anthropic y el volumen de uso. Consulta el sitio web oficial de Anthropic para conocer los detalles de precios actuales, ya que los planes y las tarifas cambian con el tiempo. El consumo de tokens varía según el tamaño de la base de código y la complejidad de las solicitudes.
¿Puede Claude Code acceder a archivos fuera del directorio actual?
Por defecto, sí. Claude Code puede acceder a cualquier archivo que la cuenta de usuario tenga permiso para leer. Sin embargo, la configuración de sandboxing restringe el acceso a directorios especificados. Para entornos sensibles a la seguridad, configura los ajustes de sandbox antes del primer uso.
¿Qué sucede si Claude Code comete un error?
Todos los cambios en los archivos son visibles a través de los comandos estándar de git diff. Antes de confirmar cualquier modificación de Claude Code, revisa cuidadosamente los cambios. Dado que todo sucede en un repositorio git (recomendado), revertir errores es sencillo con comandos git.
¿Se pueden ejecutar varias sesiones de Claude Code simultáneamente?
Sí. Cada ventana de terminal puede ejecutar una sesión independiente de Claude Code. Las sesiones no interfieren entre sí, aunque las ediciones simultáneas del mismo archivo desde diferentes sesiones podrían causar conflictos.
¿Cómo detengo una tarea en curso de Claude Code?
Presiona Ctrl+C para cancelar la operación actual. Para tareas en segundo plano, presiona Ctrl+F para abrir el administrador de tareas, luego confirma la cancelación. La sesión permanece activa después de cancelar; solo se detiene la tarea específica.
¿Claude Code recuerda conversaciones anteriores?
Dentro de una sola sesión, sí. Claude Code mantiene el contexto de la conversación y recuerda solicitudes y cambios anteriores. Iniciar una nueva sesión (cerrar y reabrir) borra este contexto. Para un conocimiento persistente del proyecto, utiliza las funciones de instrucciones y memorias documentadas en las guías oficiales.
Próximos pasos después de la instalación
Una vez que Claude Code funcione correctamente, explora sus capacidades ampliadas. La documentación oficial cubre temas avanzados como subagentes personalizados, desarrollo de plugins y automatización de tareas programadas.
Las habilidades proporcionan una forma de extender Claude Code con comandos y flujos de trabajo específicos del proyecto. Crear habilidades en el directorio .claude/skills/ agrega capacidades personalizadas adaptadas a necesidades de desarrollo específicas.
La integración del Protocolo de Contexto del Modelo (MCP) permite a Claude Code interactuar con herramientas y servicios externos. Esto abre posibilidades para consultas de bases de datos, pruebas de API y gestión de infraestructura a través de la misma interfaz conversacional.
Las funciones de control remoto permiten continuar sesiones en diferentes dispositivos. Comienza a trabajar en una máquina de escritorio, luego retoma la misma sesión en un portátil o dispositivo móvil. Consulta la documentación de integraciones de plataforma para obtener instrucciones de configuración.
Obtener ayuda cuando estás atascado
La documentación oficial de solución de problemas aborda los problemas más comunes. Cuando ocurran problemas, consulta allí primero antes de profundizar en la configuración del sistema.
Las discusiones de la comunidad en plataformas como Reddit proporcionan soluciones del mundo real de otros desarrolladores. Muchos usuarios comparten sus ajustes de configuración y optimizaciones de flujo de trabajo en estos foros.
Para problemas de instalación o autenticación, verifica el estado de tu cuenta en el sitio web de Anthropic. Las suscripciones expiradas o las restricciones de cuenta impiden una conexión exitosa incluso con una configuración local correcta.
Los problemas específicos de la terminal a menudo se relacionan con la configuración de la shell o la compatibilidad. Probar con una configuración de terminal predeterminada (sin personalizaciones de shell personalizadas) ayuda a aislar si el problema proviene de modificaciones locales.
Conclusión
Iniciar Claude Code en la terminal lleva solo unos minutos una vez que se completa la instalación. La combinación de comandos en lenguaje natural y la integración directa de la base de código crea un flujo de trabajo de desarrollo que maneja tanto consultas simples como refactorizaciones complejas de varios archivos.
La interfaz de terminal mantiene a los desarrolladores en su entorno preferido sin cambios de contexto a pestañas del navegador o aplicaciones separadas. La ejecución de tareas en segundo plano significa que las operaciones de larga duración no bloquean el trabajo.
Al igual que con cualquier herramienta de desarrollo, la competencia se logra con la práctica. Comienza con consultas simples de solo lectura para comprender cómo Claude Code interpreta la estructura del proyecto. Pasa a la edición de archivos y flujos de trabajo automatizados a medida que aumenta la confianza. El sistema de permisos evita errores irreversibles durante la fase de aprendizaje.
¿Listo para transformar tu flujo de trabajo de codificación? Instala Claude Code hoy mismo y experimenta el desarrollo asistido por IA directamente en tu terminal.
