Skip to main content
Puede usar Claude Code incluso si nunca ha usado una terminal antes. Esta guía le explica cómo abrir una terminal, instalar Claude Code e interactuar por primera vez.
¿No quiere usar la terminal? La aplicación de escritorio Claude Code le permite omitir la terminal por completo. Descárguela para macOS o Windows, luego consulte la Guía de inicio rápido de escritorio para comenzar. En Linux, instale la aplicación con apt siguiendo las instrucciones de instalación de Linux.

​
Instalar Claude Code en macOS o Linux

Siga estos pasos para instalar e iniciar Claude Code desde una terminal de macOS o Linux. Claude Code requiere macOS 13.0 o posterior. Consulte los requisitos del sistema para las distribuciones de Linux compatibles.
1

Abrir una terminal

macOS: Presione Cmd + Space para abrir Spotlight Search, escriba Terminal y presione Enter.Linux: Abra su aplicación de terminal. En la mayoría de las distribuciones, presione Ctrl + Alt + T o busque “Terminal” en su menú de aplicaciones.Aparecerá una ventana con un cursor parpadeante. Esta es su terminal, donde escribe comandos.
2

Instalar Claude Code

Copie esta línea, péguéla en su terminal (Cmd + V en macOS, Ctrl + Shift + V en Linux) y presione Enter:
Esto descarga y ejecuta el instalador de Claude Code desde claude.ai. El comando no muestra ningún progreso mientras Claude Code se descarga, así que deja la ventana abierta y espera. Cuando el instalador termine, verás “Claude Code successfully installed!”. Si en su lugar ves un error, consulta la sección de solución de problemas a continuación.
3

Iniciar Claude Code

Escriba claude y presione Enter:
Si ve command not found: claude, el directorio de instalación aún no está en su PATH. Siga la corrección de ‘command not found: claude’ a continuación, luego abra una nueva ventana de terminal e intente de nuevo.Se le pedirá que inicie sesión con su cuenta de Claude. Siga las instrucciones en pantalla. Se abrirá una ventana del navegador para que inicie sesión.
4

Comenzar a usar Claude Code

Una vez que haya iniciado sesión, puede comenzar a hacer preguntas a Claude sobre su código o cualquier otra cosa. Claude Code se ejecuta completamente en texto. Escribe mensajes y presiona Enter para enviarlos. Algunas cosas que debe saber:
  • No puede hacer clic en cosas en la terminal. Use las teclas de flecha para moverse.
  • Presione Esc para interrumpir a Claude si se está ejecutando.
  • Escriba exit o presione Ctrl + D dos veces en un símbolo del sistema vacío para salir de Claude Code.
  • Escriba /help para ver los comandos disponibles.

​
Instalar Claude Code en Windows

Siga estos pasos para instalar opcionalmente Git para Windows, configurar PowerShell e iniciar Claude Code en Windows. Claude Code requiere Windows 10 versión 1809 o posterior. Consulte los requisitos del sistema para obtener detalles completos.
1

Instalar Git para Windows (opcional)

Git para Windows proporciona Git Bash, que habilita la herramienta Bash. Sin él, Claude Code usa PowerShell en su lugar. No necesitará aprender Git usted mismo.Si aún no lo tiene:
  1. Vaya a git-scm.com/downloads/win y descargue el instalador
  2. Ejecute el instalador. Haga clic en Siguiente en cada pantalla para aceptar los valores predeterminados. El instalador tiene muchas pantallas, pero no necesita cambiar nada.
  3. Si le pide que elija un editor, mantenga el predeterminado y haga clic en Siguiente.
  4. Cuando vea “Ajustando su entorno PATH”, mantenga la opción recomendada seleccionada.
¿Ya tiene Git? Puede omitir este paso. Si no está seguro, instálelo de todas formas. Reinstalar no causará problemas.
2

Abrir PowerShell

PowerShell es la terminal integrada de Windows para escribir comandos. Viene preinstalado en todas las computadoras Windows.Presione Win + X y seleccione Windows PowerShell (o Terminal) del menú. Aparecerá una ventana con un cursor parpadeante. Aquí es donde escribirá comandos.
Windows tiene dos programas de línea de comandos: PowerShell y CMD. Se ven similares pero usan comandos diferentes. Asegúrese de estar en PowerShell para el siguiente paso.Cómo saber en cuál está:
  • PowerShell: muestra PS C:\Users\YourName> al inicio de cada línea
  • CMD: muestra C:\Users\YourName> sin el PS
3

Instalar Claude Code

Copie esta línea, péguéla en PowerShell con Ctrl + V o haga clic derecho, y presione Enter:
Esto descarga y ejecuta el instalador de Claude Code. irm obtiene el archivo e iex lo ejecuta. El comando no muestra ningún progreso mientras Claude Code se descarga, así que deja la ventana abierta y espera. Cuando el instalador termine, verás “Claude Code successfully installed!” Si en su lugar ves un error, consulta la sección de solución de problemas a continuación.
Si está en CMD en lugar de PowerShell, use este comando:
4

Iniciar Claude Code

Ejecute claude. Si PowerShell dice 'claude' is not recognized, el directorio de instalación aún no está en su PATH. Siga la corrección ‘claude is not recognized’ a continuación, luego abra una nueva ventana de PowerShell e intente de nuevo.
Se le pedirá que inicie sesión con su cuenta de Claude. Siga las instrucciones en pantalla. Se abrirá una ventana del navegador para que inicie sesión.
5

Comenzar a usar Claude Code

Una vez que haya iniciado sesión, puede comenzar a hacer preguntas a Claude sobre su código o cualquier otra cosa. Claude Code se ejecuta completamente en texto. Escribe mensajes y presiona Enter para enviarlos. Algunas cosas que debe saber:
  • No puede hacer clic en cosas en la terminal. Use las teclas de flecha para moverse.
  • Presione Esc para interrumpir a Claude si se está ejecutando.
  • Escriba exit o presione Ctrl + D dos veces en un símbolo del sistema vacío para salir de Claude Code.
  • Escriba /help para ver los comandos disponibles.

​
¿Qué sigue?

Una vez que vea la pantalla de bienvenida de Claude Code, está listo para comenzar. No necesita saber cómo codificar. Describa lo que desea en inglés simple, y Claude escribe el código por usted.

​
Construir algo

Claude puede crear proyectos a partir de una descripción:
Si Claude te pide permiso antes de crear o modificar archivos, presiona Enter para elegir Yes y aprobar. Una vez que Claude crea los archivos, haz doble clic en el archivo HTML para abrirlo en tu navegador.

​
Trabajar con archivos en su computadora

Claude puede leer y organizar archivos que ya tiene:

​
Hacer preguntas

Claude puede explicar cosas, ayudarle a aprender o planificar un proyecto:
Si aún no tiene un proyecto, no hay problema. Claude puede ayudarle a comenzar uno nuevo.

​
Otras formas de usar Claude Code

No tiene que usar la terminal. Claude Code también está disponible en:

​
Obtener más información

​
Solución de problemas

​
Solución de problemas de macOS y Linux

Si tiene problemas al instalar en macOS o Linux, consulte estos problemas comunes:
Si ve command not found: claude después de instalar, la carpeta donde el instalador colocó claude no está en su PATH. El instalador imprime la solución exacta bajo Setup notes al final de la instalación, así que ejecute ese comando, o use el de su shell a continuación.Para Zsh, el shell predeterminado de macOS:
Para Bash en Linux:
Para Bash en macOS, siga el paso de Bash de macOS en arregle su PATH en su lugar.Luego abra una nueva terminal e intente claude de nuevo. Si aún no se encuentra, verifique que el archivo ~/.local/bin/claude exista. Si no existe, la instalación no se completó. Para más detalles, consulte arregle su PATH.
Si ve bash: line 1: syntax error near unexpected token '<' o código HTML como <!DOCTYPE html> en su terminal, la URL de instalación devolvió una página web en lugar del script del instalador.Si la página dice “App unavailable in region”, Claude Code no está disponible en su país. Consulte países compatibles.De lo contrario, intente ejecutar el comando de nuevo. Si sigue sucediendo, instale con Homebrew en su lugar:
Cuando termine, abra una nueva ventana de terminal, escriba claude --version y presione Intro: el comando imprime un número de versión como 2.1.211 (Claude Code) cuando la instalación funcionó.
Si ve dyld: cannot load, dyld: Symbol not found, o built for Mac OS X 13.0, su versión de macOS probablemente sea más antigua de lo que Claude Code admite.Abra el menú de Apple y seleccione Acerca de esta Mac para verificar su versión. Si es anterior a 13.0, actualice macOS a través de Software Update. Consulte la guía de solución de problemas de macOS para más detalles.
Para otros errores, consulte la guía completa de solución de problemas de instalación.

​
Solución de problemas de Windows

Si tiene problemas al instalar en Windows, consulte estos problemas comunes:
Está en CMD, no en PowerShell. Cierre esta ventana y abra PowerShell en su lugar (Win + X luego seleccione Windows PowerShell).Alternativamente, use el comando de instalación de CMD:
Esto generalmente sucede en sistemas Windows 10 más antiguos. Ejecute esta línea primero, luego reintente la instalación:
No se encontró PowerShell ni Git Bash. Claude Code necesita al menos un shell.
  1. Asegúrese de que powershell.exe esté en su PATH. Su ubicación predeterminada es C:\Windows\System32\WindowsPowerShell\v1.0\. Alternativamente, instale PowerShell 7, que proporciona pwsh.
  2. Si prefiere usar Git Bash, instale Git for Windows según el primer paso en la sección de Windows.
  3. Si Git está instalado pero Claude Code no puede encontrarlo, dígale dónde buscar:
    Luego ejecute claude de nuevo. Si su Git está instalado en otro lugar, encuentre la ruta ejecutando:
    Busque la carpeta Git\bin en esa ruta y úsela en su lugar.
Para hacer esto permanente para que no tenga que configurarlo cada vez, consulte configurar la ruta de Git Bash.
Si el error comenzó justo después de que Claude Code se actualizara, consulta primero restaurar claude.exe desde su copia de seguridad.Si el directorio de instalación no está en tu PATH, agrégalo ejecutando estos comandos en PowerShell:
Cierre PowerShell, abra una nueva ventana e intente claude de nuevo. Debería ver la pantalla de bienvenida de Claude Code. Consulte verifique su PATH para más detalles.
En una máquina de 64 bits, este error significa que abrió Windows PowerShell (x86) en lugar de Windows PowerShell. La entrada x86 se ejecuta como un proceso de 32 bits. Ciérrela, abra la entrada del menú Inicio sin (x86) en su nombre, y ejecute el comando de instalación de nuevo. Si no está seguro de que su máquina sea de 64 bits, o el error persiste, consulte la explicación completa.
Para otros errores, consulte la guía completa de solución de problemas de instalación.