Herramientasclaude code
Configurar Claude Code en terminal: primeros pasos
Configura Claude Code en tu terminal: comprueba requisitos, inicia una sesión y ajusta los permisos antes de trabajar con archivos o comandos.
- Autor: humAIns
- 9 min de lectura
índice · 7 apartados
Configurar Claude Code en terminal consiste en instalar la CLI, iniciar sesión y abrirla desde una carpeta de trabajo: ejecuta claude --version para comprobar la instalación y claude para empezar. Necesitas acceso mediante una suscripción compatible, Claude Console o un proveedor admitido; el plan gratuito de claude.ai no se debe confundir con acceso gratuito a Claude Code. Para comenzar con control, conserva el modo Manual y revisa cada cambio y comando que solicite.
Esta guía cubre la herramienta de línea de comandos, no la extensión visual de Claude Code en VS Code. Si ya la tienes instalada y buscas actualizarla, consulta cómo actualizar Claude Code. Para ampliar el entorno más adelante, puedes ver cómo instalar skills de Claude Code.
Requisitos y elección de interfaz
Claude Code funciona en macOS 13 o posterior, Windows 10 versión 1809 o posterior, Windows Server 2019 o posterior, Ubuntu 20.04 o posterior, Debian 10 o posterior y Alpine Linux 3.19 o posterior. Anthropic indica como requisitos 4 GB o más de RAM, procesador x64 o ARM64, conexión a Internet y un shell compatible: Bash, Zsh, PowerShell o CMD. También debes encontrarte en un país compatible con Anthropic; las condiciones pueden variar y conviene verificarlas en la lista oficial antes de instalar.
La terminal no es la única interfaz disponible: la documentación también describe aplicación de escritorio, web, editores y otras integraciones. Aquí usaremos la CLI. En Windows nativo puedes emplear PowerShell o CMD; la documentación recomienda instalar Git for Windows para que Claude Code pueda usar Bash. Si no está instalado, utiliza PowerShell como shell. WSL es otra opción, pero sigue sus instrucciones específicas para Linux.
Para iniciar sesión se requiere una suscripción Claude compatible —Pro, Max, Ultra, Team o Enterprise—, una cuenta de Claude Console o acceso mediante un proveedor de nube compatible. Una instalación correcta no significa que el uso del servicio esté incluido en un plan gratuito: consulta las condiciones, límites y facturación de la cuenta elegida en sus páginas oficiales. No pegues claves, tokens ni contraseñas en el chat ni en archivos del proyecto.
Instalar e iniciar desde terminal
La guía oficial recomienda la instalación nativa. Abre la terminal correspondiente a tu sistema y utiliza solo el comando que corresponda:
macOS, Linux o WSL
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
No intercambies los dos comandos de Windows: irm es para PowerShell y el comando con && está indicado para CMD. Si recibes un error que dice que && no es un separador válido, probablemente abriste PowerShell; si irm no se reconoce, probablemente estás en CMD. La documentación ofrece alternativas y diagnóstico si falla la instalación.
Cuando termine, abre una ventana nueva de terminal y comprueba la versión:
claude --version
Debe mostrar un número de versión. Después, entra en la carpeta del proyecto que quieres trabajar y ejecuta la CLI:
cd ruta/de/tu/proyecto
claude
cd cambia el directorio de trabajo; claude inicia una sesión en ese contexto. Si no tienes experiencia con terminal, puedes empezar con una carpeta ficticia vacía y consultar la guía oficial de terminal. No abras por primera vez un repositorio con datos de clientes o información confidencial.
La primera sesión solicita autenticación. Completa el inicio de sesión oficial en el navegador con la cuenta que corresponda. No compartas las credenciales con Claude Code ni las guardes en un prompt. Si después de instalar el comando no aparece, no reinstales a ciegas: abre un terminal nuevo y comprueba el PATH según la documentación de solución de problemas de instalación.
Primer proyecto ficticio: lectura y cambio pequeño
Crea una carpeta local de prueba con un archivo README.md sencillo, por ejemplo con la descripción de una biblioteca ficticia. Desde esa carpeta inicia claude y empieza con una solicitud de solo lectura:
Lee solo README.md. Resume en cinco puntos qué describe este proyecto ficticio. No modifiques archivos ni ejecutes comandos. Si falta información, indícalo en vez de inventarla.
Comprueba que el resumen se apoya en el texto que has escrito. Después puedes probar un cambio pequeño y acotado:
Propón una sección “Cómo colaborar” para README.md con tres pasos genéricos. No añadas comandos ni enlaces. Muéstrame el cambio y espera mi aprobación antes de escribir el archivo.
Revisa el diff (la comparación entre el contenido anterior y el propuesto) línea a línea. Comprueba que solo cambia el archivo solicitado y que no introduce afirmaciones, enlaces o instrucciones no verificadas. Si no coincide con lo que pediste, rechaza el cambio o pide una corrección concreta. En un proyecto de trabajo, utiliza además el control de versiones y el flujo de revisión de tu equipo.
Configurar permisos con criterio
Claude Code aplica permisos por tipo de acción. Según la documentación oficial, en el modo Manual las lecturas dentro del directorio de trabajo no requieren aprobación; las ediciones de archivos sí la requieren, al igual que los comandos Bash salvo un conjunto integrado de comandos de solo lectura. Las solicitudes muestran qué acción está pendiente y permiten aprobarla o rechazarla.
Para revisar o ajustar permisos durante una sesión, el comando de barra diagonal /permissions abre la interfaz de gestión de permisos descrita por Anthropic. Verifica siempre el modo activo indicado en la sesión; las opciones pueden cambiar según la versión. No desactives las protecciones ni cambies a un modo automático para evitar confirmaciones. Los modos distintos de Manual modifican quién o qué evalúa determinadas acciones.
Claude Code permite definir reglas de permisos. Una decisión de “Sí, no preguntar de nuevo” puede guardarse en los ajustes locales del repositorio para comandos o dominios, según el tipo de herramienta. Esto hace especialmente importante leer el alcance de la aprobación: no es necesariamente un permiso de un solo uso. En equipos, utiliza las políticas administradas y consulta a quien administra el entorno antes de cambiar reglas compartidas.
Una rutina segura al aprender:
- Trabaja en una carpeta de prueba o una rama separada.
- Pide primero explicaciones sin modificaciones ni comandos.
- Limita cada edición a un archivo y un resultado verificable.
- Lee la solicitud de permiso completa antes de aceptar.
- Revisa el diff y ejecuta pruebas solo cuando entiendas qué hace el comando.
Ajustes del proyecto y solución de problemas
La configuración puede estar asociada al usuario, al proyecto o ser administrada por la organización. Para conocer los nombres, precedencia y ubicaciones aplicables a tu versión, sigue la referencia oficial de ajustes; no copies un archivo de configuración de otra máquina sin entender qué permisos y rutas contiene. En un equipo corporativo, una política administrada puede prevalecer sobre tus preferencias locales.
El comando claude no se reconoce. Abre una terminal nueva y sigue la guía oficial para añadir la instalación al PATH. Comprueba también si estás en CMD, PowerShell, Bash o Zsh: un comando válido en una consola puede no serlo en otra.
La instalación muestra un error o una respuesta HTML. No vuelvas a ejecutar comandos alternativos al azar. La guía de solución de problemas de instalación relaciona los mensajes habituales con las soluciones y métodos alternativos oficiales.
No puedes iniciar sesión o la cuenta no tiene acceso. Comprueba que utilizas una de las opciones de acceso compatibles y que la cuenta elegida está autorizada. Los requisitos y costes pueden cambiar; verifica la información en precios y planes de Claude o en Claude Console, según el tipo de acceso.
Quieres actualizar. La instalación nativa se actualiza automáticamente en segundo plano según la guía de instalación. Otros métodos, como Homebrew o WinGet, tienen procedimientos propios; sigue la guía de actualización de Claude Code para identificar el método instalado y no mezclar gestores.
Privacidad y control del coste
Claude Code trabaja con el contenido del proyecto para responder y realizar las tareas que autorizas. Antes de abrir una carpeta, revisa si contiene claves, datos personales, documentos de clientes o material restringido. Practica con información ficticia; en un entorno profesional aplica las reglas de tu empresa y las condiciones del servicio y cuenta que has elegido. No subas secretos a una conversación ni a un repositorio.
El coste depende de la vía de acceso y sus condiciones. Una suscripción y el uso mediante Claude Console o un proveedor de nube no son intercambiables: revisa los límites y la facturación en la cuenta correspondiente antes de automatizar tareas repetidas. Empieza con encargos pequeños, revisa el uso y configura cualquier límite disponible desde el proveedor, sin asumir una tarifa o cuota universal.
Si tu objetivo es aplicar IA en campañas, contenidos y análisis de marketing, puedes consultar la formación en IA para marketing. Es formación profesional general en IA aplicada, no un curso específico de Claude Code. También puedes evaluar tu punto de partida con el test ¿Cuánto te queda?.
Preguntas frecuentes
¿Cómo abro Claude Code?
Abre una terminal en la carpeta del proyecto y ejecuta claude. Si aún no lo instalaste, utiliza el comando oficial para tu sistema y confirma primero con claude --version.
¿Qué cuenta necesito?
La documentación oficial contempla una suscripción Claude compatible (Pro, Max, Ultra, Team o Enterprise), una cuenta de Claude Console o un proveedor de nube compatible. El acceso y la facturación dependen de la opción elegida; comprueba las condiciones actuales antes de usarla.
¿Se puede usar en Windows?
Sí. Se admite Windows 10 versión 1809 o posterior y Windows Server 2019 o posterior. Usa el comando indicado para PowerShell o CMD; Git for Windows es recomendado para disponer de Bash.
¿Cómo evito cambios automáticos?
Mantén el modo Manual y no apruebes solicitudes de edición o ejecución que no hayas revisado. Comprueba el diff y el comando antes de aceptar cada acción; no actives un modo más automático solo para acelerar el flujo.
¿Qué hago si el comando no se reconoce?
Abre una terminal nueva y comprueba el PATH con la solución oficial para tu sistema operativo. Si acabas de instalar, asegúrate también de que estás usando el tipo de terminal correcto.
Fuentes oficiales: requisitos e instalación, inicio rápido, permisos, ajustes y centro de ayuda de Claude.