> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Guía de terminal para nuevos usuarios

> Una guía paso a paso para instalar Claude Code para usuarios de terminal por primera vez en macOS y Windows.

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.

* [macOS y Linux](#macos-and-linux)
* [Windows](#windows)

<Note>
  ¿No quiere usar la terminal? La aplicación de escritorio Claude Code le permite omitir la terminal por completo. Descárguela para [macOS](https://claude.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=claude_code\&utm_medium=docs), [Windows](https://claude.com/download?utm_source=claude_code\&utm_medium=docs), o [Linux](https://claude.com/download?utm_source=claude_code\&utm_medium=docs), luego consulte el [Inicio rápido de escritorio](/es/desktop-quickstart) para comenzar.
</Note>

<h2 id="macos-and-linux">
  macOS y Linux
</h2>

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](/es/setup#system-requirements) para las distribuciones de Linux compatibles.

<Steps>
  <Step title="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.
  </Step>

  <Step title="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`:

    ```bash theme={null}
    curl -fsSL https://claude.ai/install.sh | bash
    ```

    Esto descarga y ejecuta el instalador de Claude Code desde claude.ai. Verá texto desplazándose mientras funciona. Cuando termine, verá "¡Claude Code instalado correctamente!" Si ve un error en su lugar, consulte la [sección de solución de problemas](#macos-and-linux-troubleshooting) a continuación.
  </Step>

  <Step title="Iniciar Claude Code">
    Escriba `claude` y presione `Enter`:

    ```bash theme={null}
    claude
    ```

    Se le pedirá que [inicie sesión](/es/authentication) con su cuenta de Claude. Siga las instrucciones en pantalla. Se abrirá una ventana del navegador para que inicie sesión.
  </Step>

  <Step title="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` para salir de Claude Code.
    * Escriba `/help` para ver los comandos disponibles.
  </Step>
</Steps>

***

<h2 id="windows">
  Windows
</h2>

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](/es/setup#system-requirements) para obtener detalles completos.

<Steps>
  <Step title="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](https://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.

    <Note>
      ¿Ya tiene Git? Puede omitir este paso. Si no está seguro, instálelo de todas formas. Reinstalar no causará problemas.
    </Note>
  </Step>

  <Step title="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.

    <Note>
      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`
    </Note>
  </Step>

  <Step title="Instalar Claude Code">
    Copie esta línea, péguéla en PowerShell con `Ctrl + V` o haga clic derecho, y presione `Enter`:

    ```powershell theme={null}
    irm https://claude.ai/install.ps1 | iex
    ```

    Esto descarga y ejecuta el instalador de Claude Code. `irm` obtiene el archivo e `iex` lo ejecuta. Verá texto desplazándose mientras funciona. Cuando termine, verá "¡Claude Code instalado correctamente!" Si ve un error en su lugar, consulte la [sección de solución de problemas](#windows-troubleshooting) a continuación.

    <Note>
      Si está en CMD en lugar de PowerShell, use este comando:

      ```batch theme={null}
      curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
      ```
    </Note>
  </Step>

  <Step title="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'](#windows-troubleshooting) a continuación, luego abra una nueva ventana de PowerShell e intente de nuevo.

    ```powershell theme={null}
    claude
    ```

    Se le pedirá que [inicie sesión](/es/authentication) con su cuenta de Claude. Siga las instrucciones en pantalla. Se abrirá una ventana del navegador para que inicie sesión.
  </Step>

  <Step title="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` para salir de Claude Code.
    * Escriba `/help` para ver los comandos disponibles.
  </Step>
</Steps>

***

<h2 id="what’s-next">
  ¿Qué sigue?
</h2>

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.

<h3 id="build-something">
  Construir algo
</h3>

Claude puede crear proyectos a partir de una descripción:

```text theme={null}
make me a simple webpage that says hello world
```

Claude crea los archivos para usted. Haga doble clic en el archivo HTML para abrirlo en su navegador.

<h3 id="work-with-files-on-your-computer">
  Trabajar con archivos en su computadora
</h3>

Claude puede leer y organizar archivos que ya tiene:

```text theme={null}
look at the screenshots on my Desktop and rename them based on what's in each image
```

<h3 id="ask-questions">
  Hacer preguntas
</h3>

Claude puede explicar cosas, ayudarle a aprender o planificar un proyecto:

```text theme={null}
I want to build a personal budget tracker. What would I need?
```

Si aún no tiene un proyecto, no hay problema. Claude puede ayudarle a comenzar uno nuevo.

<h3 id="other-ways-to-use-claude-code">
  Otras formas de usar Claude Code
</h3>

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

* [VS Code](/es/vs-code) y [JetBrains IDEs](/es/jetbrains) como extensiones de editor
* La [aplicación de escritorio](/es/desktop-quickstart), sin terminal requerida
* La [web](/es/claude-code-on-the-web) en claude.ai/code para sesiones remotas
* [GitHub Actions](/es/github-actions) y [GitLab CI/CD](/es/gitlab-ci-cd) para automatización

<h3 id="learn-more">
  Obtener más información
</h3>

* [Inicio rápido](/es/quickstart): un recorrido guiado de su primer proyecto con Claude Code
* [Cómo funciona Claude Code](/es/how-claude-code-works): comprenda cómo Claude lee sus archivos, ejecuta comandos y realiza ediciones
* [Mejores prácticas](/es/best-practices): obtenga mejores resultados con indicaciones efectivas y configuración de proyectos
* [Flujos de trabajo comunes](/es/common-workflows): guías paso a paso para depuración, pruebas, refactorización y más
* [Configuración de terminal](/es/terminal-config): personalice su terminal para la mejor experiencia de Claude Code

***

<h2 id="troubleshooting">
  Solución de problemas
</h2>

<h3 id="macos-and-linux-troubleshooting">
  Solución de problemas de macOS y Linux
</h3>

Si tiene problemas al instalar en macOS o Linux, consulte estos problemas comunes:

<Accordion title="'command not found: claude'">
  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:

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
  source ~/.zshrc
  ```

  Para Bash, el shell predeterminado de Linux:

  ```bash theme={null}
  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
  source ~/.bashrc
  ```

  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](/es/troubleshoot-install#verify-your-path).
</Accordion>

<Accordion title="Error con código HTML o 'syntax error near unexpected token'">
  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](https://www.anthropic.com/supported-countries).

  De lo contrario, intente ejecutar el comando de nuevo. Si sigue sucediendo, instale con [Homebrew](https://brew.sh) en su lugar:

  ```bash theme={null}
  brew install --cask claude-code
  ```
</Accordion>

<Accordion title="Error 'dyld' o 'built for Mac OS X 13.0'">
  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](/es/troubleshoot-install#dyld-cannot-load-on-macos) para más detalles.
</Accordion>

Para otros errores, consulte la [guía completa de solución de problemas de instalación](/es/troubleshoot-install).

<h3 id="windows-troubleshooting">
  Solución de problemas de Windows
</h3>

Si tiene problemas al instalar en Windows, consulte estos problemas comunes:

<Accordion title="'irm is not recognized'">
  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:

  ```batch theme={null}
  curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
  ```
</Accordion>

<Accordion title="Error SSL/TLS o 'Could not create SSL/TLS secure channel'">
  Esto generalmente sucede en sistemas Windows 10 más antiguos. Ejecute esta línea primero, luego reintente la instalación:

  ```powershell theme={null}
  [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
  irm https://claude.ai/install.ps1 | iex
  ```
</Accordion>

<Accordion title="'Claude Code on Windows requires either Git for Windows (for bash) or PowerShell'">
  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](https://aka.ms/powershell), que proporciona `pwsh`.
  2. Si prefiere usar Git Bash, instale [Git for Windows](https://git-scm.com/downloads/win) según el [primer paso en la sección de Windows](#windows).
  3. Si Git está instalado pero Claude Code no puede encontrarlo, dígale dónde buscar:
     ```powershell theme={null}
     $env:CLAUDE_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
     ```
     Luego ejecute `claude` de nuevo. Si su Git está instalado en otro lugar, encuentre la ruta ejecutando:
     ```powershell theme={null}
     Get-Command git | Select-Object Source
     ```
     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](/es/troubleshoot-install#claude-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell).
</Accordion>

<Accordion title="'claude is not recognized'">
  Este error significa que el directorio de instalación no está en su PATH. Ejecute estos comandos en PowerShell para agregarlo:

  ```powershell theme={null}
  $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
  [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
  ```

  Cierre PowerShell, abra una nueva ventana e intente `claude` de nuevo. Consulte [verifique su PATH](/es/troubleshoot-install#verify-your-path) para más detalles.
</Accordion>

Para otros errores, consulte la [guía completa de solución de problemas de instalación](/es/troubleshoot-install).