> ## Documentation Index
> Fetch the complete documentation index at: https://cli.fuxicode.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 Fuxi Code para usuarios de terminal por primera vez en macOS y Windows.

Puede usar Fuxi Code incluso si nunca ha usado una terminal antes. Esta guía le explica cómo abrir una terminal, instalar Fuxi 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 Fuxi Code le permite omitir la terminal por completo. Descárguela para [macOS](https://fuxi.ai/api/desktop/darwin/universal/dmg/latest/redirect?utm_source=fuxi_code\&utm_medium=docs) o [Windows](https://fuxi.com/download?utm_source=fuxi_code\&utm_medium=docs), luego consulte la [Guía de inicio rápido de escritorio](/es/desktop-quickstart) para comenzar. En Linux, instale la aplicación con apt siguiendo las [instrucciones de instalación de Linux](/es/desktop-linux).
</Note>

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

Siga estos pasos para instalar e iniciar Fuxi Code desde una terminal de macOS o Linux. Fuxi 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 Fuxi 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://fuxi.ai/install.sh | bash
    ```

    Esto descarga y ejecuta el instalador de Fuxi Code desde fuxi.ai. Verá texto desplazándose mientras funciona. Cuando termine, verá "¡Fuxi 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 Fuxi Code">
    Escriba `fuxi` y presione `Enter`:

    ```bash theme={null}
    fuxi
    ```

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

  <Step title="Comenzar a usar Fuxi Code">
    Una vez que haya iniciado sesión, puede comenzar a hacer preguntas a Fuxi sobre su código o cualquier otra cosa. Fuxi 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 Fuxi si se está ejecutando.
    * Escriba `exit` o presione `Ctrl + D` para salir de Fuxi 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 Fuxi Code en Windows. Fuxi 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, Fuxi 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 Fuxi 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://fuxi.ai/install.ps1 | iex
    ```

    Esto descarga y ejecuta el instalador de Fuxi Code. `irm` obtiene el archivo e `iex` lo ejecuta. Verá texto desplazándose mientras funciona. Cuando termine, verá "¡Fuxi 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://fuxi.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
      ```
    </Note>
  </Step>

  <Step title="Iniciar Fuxi Code">
    Ejecute `fuxi`. Si PowerShell dice `'fuxi' is not recognized`, el directorio de instalación aún no está en su PATH. Siga la corrección ['fuxi is not recognized'](#windows-troubleshooting) a continuación, luego abra una nueva ventana de PowerShell e intente de nuevo.

    ```powershell theme={null}
    fuxi
    ```

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

  <Step title="Comenzar a usar Fuxi Code">
    Una vez que haya iniciado sesión, puede comenzar a hacer preguntas a Fuxi sobre su código o cualquier otra cosa. Fuxi 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 Fuxi si se está ejecutando.
    * Escriba `exit` o presione `Ctrl + D` para salir de Fuxi 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 Fuxi Code, está listo para comenzar. No necesita saber cómo codificar. Describa lo que desea en inglés simple, y Fuxi escribe el código por usted.

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

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

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

Fuxi 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>

Fuxi 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>

Fuxi 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. Fuxi puede ayudarle a comenzar uno nuevo.

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

No tiene que usar la terminal. Fuxi 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/fuxi-code-on-the-web) en fuxi.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 Fuxi Code
* [Cómo funciona Fuxi Code](/es/how-fuxi-code-works): comprenda cómo Fuxi 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 Fuxi 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: fuxi'">
  Si ve `command not found: fuxi` después de instalar, la carpeta donde el instalador colocó `fuxi` 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 `fuxi` de nuevo. Si aún no se encuentra, verifique que el archivo `~/.local/bin/fuxi` 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", Fuxi 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 fuxi-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 Fuxi 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://fuxi.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://fuxi.ai/install.ps1 | iex
  ```
</Accordion>

<Accordion title="'Fuxi Code on Windows requires either Git for Windows (for bash) or PowerShell'">
  No se encontró PowerShell ni Git Bash. Fuxi 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 Fuxi Code no puede encontrarlo, dígale dónde buscar:
     ```powershell theme={null}
     $env:FUXI_CODE_GIT_BASH_PATH="C:\Program Files\Git\bin\bash.exe"
     ```
     Luego ejecute `fuxi` 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#fuxi-code-on-windows-requires-either-git-for-windows-for-bash-or-powershell).
</Accordion>

<Accordion title="'fuxi 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 `fuxi` 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).
