Riferimento ai comandi CLI di Amazon Q - Amazon Q Developer
Argomenti globaliComandiFile di log

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à.

Riferimento ai comandi CLI di Amazon Q

Questa sezione fornisce un riferimento completo per tutti i comandi CLI di Amazon Q Developer e i relativi argomenti. Usa questo riferimento per comprendere le opzioni disponibili per ogni comando e la relativa sintassi corretta.

Per assistenza con qualsiasi comando, puoi usare il --help flag:

q [COMMAND] --help

Argomenti globali

I seguenti argomenti sono disponibili con qualsiasi comando CLI di Amazon Q:

Argomenti globali
Argomento Forma breve Descrizione
--verbose -v Aumenta la verbosità della registrazione. Può essere ripetuto per un output più dettagliato:,,, -v -vv -vvv -vvvv
--help -h Mostra le informazioni di aiuto per il comando
--version -V Mostra le informazioni sulla versione
--help-all Stampa l'aiuto per tutti i sottocomandi

Comandi

Le sezioni seguenti descrivono ogni comando Amazon Q CLI e i relativi argomenti disponibili.

q chat

Avvia una sessione di chat interattiva con Amazon Q. Quando non viene specificato alcun sottocomando, l'impostazione q predefinita è. q chat

Sintassi: 

q chat [OPTIONS] [INPUT]
q argomenti della chat
Argomento Forma breve Descrizione
--no-interactive Stampa la prima risposta a STDOUT senza modalità interattiva. Questa operazione avrà esito negativo se il prompt richiede le autorizzazioni per utilizzare uno strumento, a meno che non venga utilizzato anche --trust-all-tools
--resume -r Riprendi la conversazione precedente da questa cartella
--agent Agente da usare
--trust-all-tools Consenti al modello di utilizzare qualsiasi strumento per eseguire comandi senza chiedere conferma
--trust-tools Considera attendibile solo il set di strumenti specificato. Fornite un elenco di nomi di strumenti separati da virgole. Esempio: --trust-tools=fs_read,fs_write. Per non fidarti di nessuno strumento, usa --trust-tools=
INPUT La prima domanda da porre (argomentazione posizionale)

Esempi: 

q chat
q chat "How do I list files in Linux?"
q chat --no-interactive --trust-all-tools "Show me the current directory"
q chat --resume
q chat --agent my-agent "Help me with AWS CLI"

q tradurre

Traduci le istruzioni in linguaggio naturale in comandi shell eseguibili usando l'intelligenza artificiale.

Sintassi: 

q translate [OPTIONS] [INPUT...]
q traduce gli argomenti
Argomento Forma breve Descrizione
--n -n Numero di completamenti da generare (deve essere ≤5)
INPUT Descrizione in linguaggio naturale del comando che si desidera generare (argomenti posizionali)

Esempi: 

q translate "list all files in the current directory"
q translate "find all Python files modified in the last week"
q translate "compress all log files older than 30 days"

un medico

Risolvi e diagnostica i problemi di installazione e configurazione più comuni con Amazon Q.

Sintassi: 

q doctor [OPTIONS]
q) dott. argomentazioni
Argomento Forma breve Descrizione
--all -a Esegui tutti i test medici, senza correzioni
--strict -s Errore nelle avvertenze

Esempi: 

q doctor
q doctor --all
q doctor --strict

un aggiornamento

Aggiorna l'applicazione Amazon Q alla versione più recente.

Sintassi: 

q update [OPTIONS]
q aggiorna gli argomenti
Argomento Forma breve Descrizione
--non-interactive -y Non richiedere conferma
--relaunch-dashboard Riavvia nella dashboard dopo l'aggiornamento. L'impostazione predefinita è true
--rollout Utilizza il rollout

Esempi: 

q update
q update --non-interactive
q update --rollout

un tema

Ottieni o imposta il tema visivo per il menu a discesa con completamento automatico. Ciò influisce sull'aspetto della finestra popup che mostra il completamento dei comandi.

Sintassi: 

q theme [OPTIONS] [THEME]
q) argomenti del tema
Argomento Descrizione
--list Elenca tutti i temi disponibili
--folder Mostra il percorso della directory del tema
THEME Nome del tema da impostare. I temi predefiniti includono:dark,light, system (argomento posizionale)

Esempi: 

q theme --list
q theme --folder
q theme dark
q theme light
q theme system

Nota: le modifiche al tema influiscono sulla finestra popup di completamento automatico. Potrebbe essere necessario attivare i suggerimenti di completamento automatico per visualizzare le modifiche visive.

integrazioni q

Gestisci le integrazioni di sistema per Amazon Q.

Sintassi: 

q integrations [SUBCOMMAND] [OPTIONS]

q integrazioni (sottocomandi)

q integrazioni (sottocomandi)
Sottocomando Descrizione
install Installa un'integrazione. Supporta --silent (-s) per sopprimere i messaggi di stato
uninstall Disinstalla un'integrazione. Supporta --silent (-s) per sopprimere i messaggi di stato
reinstall Reinstalla un'integrazione. Supporta --silent (-s) per sopprimere i messaggi di stato
status Controlla lo stato di un'integrazione. Supporta --format (-f) per il formato di output

q in linea

Gestisci i suggerimenti in linea (testo fantasma) che appaiono direttamente sulla riga di comando durante la digitazione. Per ulteriori informazioni, consulta Funzionalità di assistenza da riga di comando

Sintassi: 

q inline [SUBCOMMAND] [OPTIONS]

q) sottocomandi in linea

q sottocomandi in linea
Sottocomando Descrizione
enable Abilita i suggerimenti in linea che appaiono durante la digitazione
disable Disattiva i suggerimenti in linea
status Mostra se i suggerimenti in linea sono abilitati o disabilitati
set-customization Seleziona un modello di personalizzazione da utilizzare. Specificare facoltativamente l'ARN della personalizzazione
show-customizations Mostra i modelli di personalizzazione disponibili. Supporta --format (-f) per il formato di output

Esempi: 

q inline enable
q inline disable
q inline status
q inline set-customization
q inline set-customization arn:aws:codewhisperer:us-east-1:123456789012:customization/example
q inline show-customizations
q inline show-customizations --format json

q login

Effettua l'autenticazione con Amazon Q utilizzando AWS Builder ID (gratuito) o IAM Identity Center (Pro).

Sintassi: 

q login [OPTIONS]
q) argomenti di accesso
Argomento Descrizione
--license Tipo di licenza. Opzioni: free (per Builder ID), pro (per Identity Center)
--identity-provider URL del provider di identità (per Identity Center)
--region Regione AWS (per Identity Center)
--use-device-flow Usa sempre il flusso OAuth del dispositivo per l'autenticazione. Utile quando i reindirizzamenti del browser non possono essere gestiti

Esempi: 

q login
q login --license free
q login --license pro --identity-provider https://my-company.awsapps.com/start --region us-east-1
q login --use-device-flow

q disconnessione

Esci dalla sessione Amazon Q.

Sintassi: 

q logout

Questo comando non accetta argomenti aggiuntivi.

un whokami

Visualizza informazioni sull'utente corrente e sullo stato di autenticazione.

Sintassi: 

q whoami [OPTIONS]
q) argomenti whoami
Argomento Forma breve Descrizione
--format -f Formato di output Opzioni: plain (impostazione predefinita)json, json-pretty

un profilo

Mostra il profilo associato all'utente corrente di IAM Identity Center. Questo comando è disponibile solo per gli utenti Pro.

Sintassi: 

q profile

Questo comando non accetta argomenti aggiuntivi.

impostazioni q

Gestisci le impostazioni di configurazione di Amazon Q. Per informazioni dettagliate sulla gestione delle impostazioni, consultaConfigurazione delle impostazioni di Amazon Q.

Sintassi: 

q settings [SUBCOMMAND] [OPTIONS] [KEY] [VALUE]
q settings (argomenti)
Argomento Forma breve Descrizione
--delete -d Eliminare un'impostazione
--format -f Formato di output. Opzioni: plain (impostazione predefinita)json, json-pretty
KEY Chiave di impostazione (argomento posizionale)
VALUE Impostazione del valore (argomento posizionale)

q settings, sottocomandi

sottocomandi q settings
Sottocomando Descrizione
open Apri il file delle impostazioni nell'editor predefinito
all Elenca tutte le impostazioni correnti. Supporta --format l'opzione

una diagnostica

Esegui test diagnostici per risolvere i problemi di installazione e configurazione di Amazon Q.

Sintassi: 

q diagnostic [OPTIONS]
q) argomenti diagnostici
Argomento Forma breve Descrizione
--format -f Formato di output Opzioni: plain (impostazione predefinita)json, json-pretty
--force Uscita diagnostica a forza limitata

un problema

Crea un nuovo GitHub problema per il feedback o la segnalazione di bug di Amazon Q

Sintassi: 

q issue [OPTIONS] [DESCRIPTION...]
q, problemi, argomenti
Argomento Forma breve Descrizione
--force -f Forza la creazione di problemi
DESCRIPTION Descrizione del problema (argomenti posizionali)

una versione

Visualizza le informazioni sulla versione e, facoltativamente, mostra il changelog.

Sintassi: 

q version [OPTIONS]
argomenti della versione q
Argomento Descrizione
--changelog[=VERSION] Mostra il changelog. Usa --changelog per la versione corrente, --changelog=all per tutte le versioni o --changelog=x.x.x per una versione specifica

un mcp

Gestisci i server Model Context Protocol (MCP). Per informazioni dettagliate su MCP, vedere. Utilizzo di MCP con Amazon Q Developer

Sintassi: 

q mcp [SUBCOMMAND] [OPTIONS]

q mcp aggiunge

Aggiungi o sostituisci un server MCP configurato.

Sintassi: 

q mcp add [OPTIONS]
q mcp aggiunge argomenti
Argomento Descrizione
--name Nome del server (richiesto)
--command Il comando utilizzato per avviare il server (obbligatorio)
--scope Dove aggiungere il server. Opzioni:workspace, global
--env Variabili di ambiente da utilizzare all'avvio del server. Formato: key1=value1,key2=value2
--timeout Timeout di avvio del server in millisecondi
--force Sovrascrivi un server esistente con lo stesso nome

q mcp remove

Rimuove un server dalla configurazione MCP.

Sintassi: 

q mcp remove [OPTIONS]
q mcp rimuove gli argomenti
Argomento Descrizione
--name Nome del server da rimuovere (obbligatorio)
--scope Ambito da cui rimuovere. Opzioni:workspace, global

un elenco mcp

Elenca i server MCP configurati.

Sintassi: 

q mcp list [SCOPE]
q mcp elenca gli argomenti
Argomento Descrizione
SCOPE Ambito dell'elenco. Opzioni:workspace, global (argomento posizionale)

un'importazione mcp

Importa una configurazione del server da un altro file.

Sintassi: 

q mcp import [OPTIONS] [SCOPE]
q: argomenti di importazione mcp
Argomento Descrizione
--file File da cui importare la configurazione del server (obbligatorio)
--force Sovrascrivi un server esistente con lo stesso nome
SCOPE Ambito in cui importare. Opzioni:workspace, global (argomento posizionale)

q = stato mcp

Ottieni lo stato di un server MCP configurato.

Sintassi: 

q mcp status [OPTIONS]
q: argomenti di stato mcp
Argomento Descrizione
--name Nome del server di cui ottenere lo stato (obbligatorio)

File di log

Amazon Q Developer CLI mantiene file di log che possono essere utili per la risoluzione dei problemi. Questi log vengono archiviati localmente sulla macchina e non vengono inviati ad AWS.

Posizioni dei file di log:

  • macOS: $TMPDIR/qlog/

  • Linux: $XDG_RUNTIME_DIR o o TMPDIR /tmp

Il livello di registro può essere controllato impostando la variabile di Q_LOG_LEVEL ambiente. I valori validi sono:

  • error: Solo messaggi di errore (impostazione predefinita)

  • warn: messaggi di avviso e di errore

  • info: messaggi informativi, di avviso e di errore

  • debug: messaggi di debug, informativi, di avviso e di errore

  • trace: Tutti i messaggi, incluse informazioni di tracciamento dettagliate

avvertimento

I file di registro possono contenere informazioni sensibili provenienti dalle tue conversazioni e interazioni con Amazon Q, inclusi percorsi di file, frammenti di codice e output di comandi. Sebbene questi log siano archiviati solo sul computer locale e non vengano inviati ad AWS, è necessario prestare attenzione quando si condividono i file di registro con altri.

Esempio di impostazione del livello di registro (a scopo di debug): 

# For bash/zsh
export Q_LOG_LEVEL=debug
q chat

# For fish
set -x Q_LOG_LEVEL debug
q chat