Installazione di Amazon Q per riga di comando - Amazon Q Developer
macOSLinux AppImageUbuntuHomebrewDisinstallazioneDebug

Installazione di Amazon Q per riga di comando

Puoi installare Amazon Q per la riga di comando per macOS avviando il download di un file per l’applicazione Amazon Q. Per ulteriori informazioni, consulta Ambienti a riga di comando supportati.

Sono disponibili due modalità da considerare quando si installa Amazon Q per la riga di comando. L’installazione minima distribuisce solo i file binari necessari su Linux per la chat di Amazon Q e per il funzionamento della funzionalità di completamento automatico tramite SSH (q e qterm). La distribuzione completa contiene l’applicazione desktop e richiede l’utilizzo della funzionalità di completamento automatico. Se desideri utilizzare solo la chat di Amazon Q, considera che la distribuzione minima installa qterm anche nella tua shell. Puoi utilizzare qterm per zsh per supportare i completamenti in linea e non è richiesta una versione completa. Per ulteriori informazioni, consulta Installazione con un file zip.

Nota

Per informazioni sull’uso della CLI di Amazon Q con Windows, consulta questo post di blog su dev.to.

macOS

Puoi installare Amazon Q per la riga di comando di macOS scaricando l’applicazione o utilizzando Homebrew.

Dopo aver installato Amazon Q per la riga di comando per macOS, puoi abilitare l’integrazione SSH per poter utilizzare il completamento automatico per oltre 500 strumenti da riga di comando. Per ulteriori informazioni, consulta Integrazione locale con macOS.

Per installare Amazon Q per la riga di comando di macOS

  1. Scarica Amazon Q per la riga di comando di macOS.

  2. (Facoltativo) Verifica del file scaricato per Amazon Q per riga di comando su macOS. Per ulteriori informazioni, consulta Per verificare il download (facoltativo).

  3. Fai doppio clic sul file .dmg scaricato e trascina l’app nella cartella delle applicazioni.

  4. Nella cartella delle applicazioni, fai doppio clic su Amazon Q. Si aprirà la GUI.

  5. Abilita le integrazioni con la shell. Ciò ti consentirà di eseguire Amazon Q dalla shell e consentirà inoltre ad Amazon Q di aiutarti con il completamento automatico dei comandi shell.

  6. Effettua l’autenticazione con ID Builder o con il Centro identità IAM utilizzando l’URL di avvio fornito dall’amministratore del tuo account.

  7. Segui le istruzioni per installare le integrazioni shell e concedere i permessi di accessibilità a macOS.

    Interface showing automated checks with Shell integrations enabled and accessibility disabled.

Linux AppImage

avvertimento

Questo metodo di installazione richiede una GUI. Se si esegue l’installazione su Linux senza una GUI, consulta Installazione con un file zip.

Puoi installare Amazon Q per la riga di comando di Linux utilizzando il formato AppImage, un formato portatile che funziona sulla maggior parte delle distribuzioni Linux senza richiedere installazione.

Per installare Amazon Q per la riga di comando di Linux con AppImage

  1. Scarica Amazon Q per la riga di comando di Linux AppImage.

  2. Rendi eseguibile AppImage:

    chmod +x amazon-q.appimage

  3. Esegui AppImage:

    ./amazon-q.appimage

  4. Effettua l’autenticazione con ID Builder o con il Centro identità IAM utilizzando l’URL di avvio fornito dall’amministratore del tuo account.

Ubuntu

avvertimento

Questo metodo di installazione richiede una GUI. Se si esegue l’installazione su Linux senza una GUI, consulta Installazione con un file zip.

Puoi installare Amazon Q per la riga di comando di Ubuntu con il pacchetto .deb.

Per installare Amazon Q per la riga di comando di Ubuntu

  1. Scarica Amazon Q per la riga di comando di Ubuntu. 

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

  2. Installare il pacchetto :

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

  3. Avvia Amazon Q per la riga di comando:

    q

  4. Effettua l’autenticazione con ID Builder o con il Centro identità IAM utilizzando l’URL di avvio fornito dall’amministratore del tuo account.

Homebrew

Per installare la CLI di Amazon Q Developer con Homebrew

brew install --cask amazon-q

Disinstallazione di Amazon Q per riga di comando

Se non è più necessario, è possibile disinstallare Amazon Q per la riga di comando.

Per disinstallare Amazon Q per la riga di comando su macOS

  1. Apri la cartella Applicazioni in Finder.

  2. Individua l’applicazione Amazon Q Developer.

  3. Trascina l’applicazione nel Cestino o fai clic con il pulsante destro del mouse e seleziona “Sposta nel cestino”.

  4. Svuota il Cestino per completare la disinstallazione.

Per disinstallare Amazon Q per la riga di comando su Ubuntu

  1. Usa il gestore di pacchetti apt per rimuovere il pacchetto:

    sudo apt-get remove amazon-q

  2. Rimuovi tutti i file di configurazione rimanenti:

    sudo apt-get purge amazon-q

Debug di Amazon Q Developer per riga di comando

Se riscontri un problema con Amazon Q Developer per la riga di comando, esegui q doctor per identificare e risolvere i problemi più comuni.

Output previsto

$ q doctor

✔ Everything looks good!

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

Se l’output non corrisponde a quello previsto, segui i prompt per risolvere il problema. Se continua a non funzionare, usa q issue per segnalare il bug.

Problemi comuni

Ecco alcuni problemi comuni che potrebbero verificarsi durante l’utilizzo di Amazon Q per la riga di comando:

Authentication failures (Errori di autenticazione)

Se riscontri problemi con l’autenticazione, prova a eseguire q login per autenticarti di nuovo.

Completamento automatico non funzionante

Assicurati che l’integrazione della shell sia installata correttamente eseguendo q doctor.

Problemi di integrazione di SSH

Verifica che il tuo server SSH sia configurato correttamente per accettare le variabili di ambiente richieste

Fasi per la risoluzione dei problemi

Segui queste fasi per risolvere i problemi con Amazon Q per la riga di comando:

  1. Esegui q doctor per identificare e risolvere i problemi più comuni.

  2. Verificare la connessione Internet.

  3. Verifica di utilizzare un ambiente supportato. Per ulteriori informazioni, consulta Ambienti a riga di comando supportati.

  4. Prova a reinstallare Amazon Q per la riga di comando.

  5. Se il problema persiste, segnalalo utilizzando q issue.