Installazione di Amazon Q per la riga di comando - Amazon Q Developer
macOSLinux AppImageUbuntuDisinstallazioneDebug

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Installazione di Amazon Q per la 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.

Esistono 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 (e). q 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 viene spedita e installata qterm anche nella tua shell. Puoi usare qterm for 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 per 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 macOS locale.

Per installare Amazon Q per la riga di comando per macOS

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

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

  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. La GUI si aprirà.

  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 Builder ID o con IAM Identity Center utilizzando l'URL di avvio fornito dall'amministratore del tuo account.

  7. Segui le istruzioni per installare le integrazioni della shell e concedere le autorizzazioni 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, vedere. Installazione con un file zip

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

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

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

  2. Crea l' AppImage eseguibile:

    chmod +x amazon-q.appimage

  3. Esegui AppImage:

    ./amazon-q.appimage

  4. Effettua l'autenticazione con Builder ID o con IAM Identity Center utilizzando l'URL iniziale 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, vedere. Installazione con un file zip

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

Per installare Amazon Q per la riga di comando per Ubuntu

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

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

  2. Installare il pacchetto :

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

  3. Avvia Amazon Q per la riga di comando:

    q

  4. Effettua l'autenticazione con Builder ID o con IAM Identity Center utilizzando l'URL iniziale fornito dall'amministratore del tuo account.

Disinstallazione di Amazon Q dalla riga di comando

Puoi disinstallare Amazon Q dalla riga di comando se non ne hai più bisogno.

Per disinstallare Amazon Q dalla riga di comando su macOS

  1. Apri la cartella Applicazioni nel Finder.

  2. Individua l'applicazione Amazon Q.

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

Eseguire il debug di Amazon Q Developer per la 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 le istruzioni per risolvere il problema. Se continua a non funzionare, usalo q issue per segnalare il bug.

Problemi comuni

Ecco alcuni problemi comuni che potresti riscontrare quando usi Amazon Q per la riga di comando:

Authentication failures (Errori di autenticazione)

Se riscontri problemi di autenticazione, prova q login a eseguire nuovamente l'autenticazione.

Il completamento automatico non funziona

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

Problemi di integrazione SSH

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

Fasi per la risoluzione dei problemi

Segui questi passaggi 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