Instalación de Amazon Q para la línea de comandos - Amazon Q Developer
macOSLinux AppImageUbuntuDesinstalaciónDebugging

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Instalación de Amazon Q para la línea de comandos

Puede instalar Amazon Q para la línea de comandos para macOS iniciando la descarga de un archivo para la aplicación Amazon Q. Para obtener más información, consulte Entornos de línea de comandos compatibles .

Hay dos modalidades a tener en cuenta al instalar Amazon Q para la línea de comandos. La instalación mínima solo distribuye los binarios necesarios en Linux para el chat de Amazon Q y para que la función de autocompletar funcione a través de SSH (y). q qterm La distribución completa contiene la aplicación de escritorio y requiere el uso de la función de autocompletar. Si solo quieres usar el chat de Amazon Q, ten en cuenta que la distribución mínima también se envía e instala qterm en tu shell. Puedes usar qterm for zsh para completar contenido en línea y no es necesaria una versión completa. Para obtener más información, consulte Instalación con un archivo zip .

nota

Para obtener información sobre el uso de la CLI de Amazon Q con Windows, consulte esta entrada de blog en dev.to.

macOS

Puedes instalar Amazon Q para la línea de comandos para macOS descargando la aplicación o usando Homebrew.

Tras instalar Amazon Q para la línea de comandos para macOS, puede activar la integración de SSH para poder utilizar la función de autocompletar en más de 500 herramientas de línea de comandos. Para obtener más información, consulte Uso de la función de autocompletar en lugar de SSH .

Para instalar Amazon Q para la línea de comandos en macOS

  1. Descarga Amazon Q para la línea de comandos para macOS.

  2. (Opcional) Verifica el archivo descargado de Amazon Q para la línea de comandos en macOS. Para obtener más información, consulte Para verificar la descarga (opcional).

  3. Haga doble clic en el archivo.dmg descargado y arrastre la aplicación a la carpeta de aplicaciones.

  4. En la carpeta de aplicaciones, haga doble clic en Amazon Q. Se abrirá la interfaz gráfica.

  5. Habilite las integraciones de shell. Esto le permitirá ejecutar Amazon Q desde el shell y también permitirá que Amazon Q le ayude a completar automáticamente los comandos del shell.

  6. Autentíquese con ID de creador o con IAM Identity Center mediante la URL de inicio que le proporcionó el administrador de la cuenta.

  7. Sigue las instrucciones para instalar las integraciones de shell y conceder permisos de accesibilidad a macOS.

Linux AppImage

aviso

Este método de instalación requiere una interfaz gráfica de usuario. Si va a realizar la instalación en Linux sin una interfaz gráfica de usuario, consulteInstalación con un archivo zip.

Puede instalar Amazon Q para la línea de comandos para Linux mediante el AppImage formato, que es un formato portátil que funciona en la mayoría de las distribuciones de Linux sin necesidad de instalación.

Para instalar Amazon Q para la línea de comandos para Linux mediante AppImage

  1. Descarga Amazon Q para la línea de comandos para Linux AppImage.

  2. Haga que el AppImage ejecutable:

    chmod +x amazon-q.appimage

  3. Ejecute AppImage:

    ./amazon-q.appimage

  4. Autentíquese con ID de creador o con IAM Identity Center mediante la URL de inicio que le proporcionó el administrador de la cuenta.

Ubuntu

aviso

Este método de instalación requiere una interfaz gráfica de usuario. Si va a realizar la instalación en Linux sin una interfaz gráfica de usuario, consulteInstalación con un archivo zip.

Puede instalar Amazon Q para la línea de comandos de Ubuntu mediante el paquete .deb.

Para instalar Amazon Q para la línea de comandos en Ubuntu

  1. Descarga Amazon Q para la línea de comandos para Ubuntu. 

    wget https://desktop-release.q.us-east-1.amazonaws.com/latest/amazon-q.deb

  2. Instale el paquete :

    sudo apt-get install -f
sudo dpkg -i amazon-q.deb

  3. Inicie Amazon Q para la línea de comandos:

    q

  4. Autentíquese con ID de creador o con IAM Identity Center mediante la URL de inicio que le proporcionó el administrador de la cuenta.

Desinstalación de Amazon Q para la línea de comandos

Puedes desinstalar Amazon Q para la línea de comandos si ya no lo necesitas.

Para desinstalar Amazon Q para la línea de comandos en macOS

  1. Abre la carpeta Aplicaciones en Finder.

  2. Busca la aplicación Amazon Q.

  3. Arrastra la aplicación a la papelera o haz clic con el botón derecho del ratón y selecciona «Mover a la papelera».

  4. Vacíe la papelera para completar la desinstalación.

Para desinstalar Amazon Q para la línea de comandos en Ubuntu

  1. Usa el administrador de paquetes apt para eliminar el paquete:

    sudo apt-get remove amazon-q

  2. Elimine los archivos de configuración restantes:

    sudo apt-get purge amazon-q

Depuración de Amazon Q Developer para la línea de comandos

Si tienes problemas con Amazon Q Developer para la línea de comandos, ejecuta q doctor para identificar y solucionar problemas comunes.

Resultado previsto

$ q doctor

✔ Everything looks good!

Amazon Q still not working? Run q issue to let us know!

Si el resultado no se parece al esperado, sigue las instrucciones para resolver el problema. Si sigue sin funcionar, úsala q issue para informar del error.

Problemas comunes

Estos son algunos de los problemas más comunes que pueden surgir al usar Amazon Q para la línea de comandos:

Errores de autenticación

Si tienes problemas para autenticarte, intenta ejecutar q login para volver a autenticarte.

La función de autocompletar no funciona

q doctorEjecute para asegurarse de que la integración del shell esté instalada correctamente.

Problemas de integración de SSH

Compruebe que su servidor SSH esté configurado correctamente para aceptar las variables de entorno requeridas.

Pasos para la solución de problemas

Sigue estos pasos para solucionar problemas con Amazon Q para la línea de comandos:

  1. Ejecute q doctor para identificar y solucionar problemas comunes.

  2. Compruebe la conexión a Internet.

  3. Comprueba que estás utilizando un entorno compatible. Para obtener más información, consulte Entornos de línea de comandos compatibles .

  4. Intenta volver a instalar Amazon Q para la línea de comandos.

  5. Si el problema persiste, repórtalo medianteq issue.