Instalando o Amazon Q para linha de comando - Amazon Q Developer
macOSLinux AppImageUbuntuHomebrewConfiguração do proxyDesinstalaçãoDepuração

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Instalando o Amazon Q para linha de comando

Você pode instalar o Amazon Q para linha de comandos no macOS iniciando o download de um arquivo para a aplicação Amazon Q. Para obter mais informações, consulte Ambientes de linha de comando.

Há duas opções de instalação a serem consideradas ao instalar o Amazon Q para linha de comando. A instalação mínima inclui somente os binários necessários no Linux para o chat do Amazon Q e para que o recurso de preenchimento automático funcione via SSH (qe). qterm A instalação completa contém o aplicativo de desktop e requer o uso do recurso de preenchimento automático. Se você quiser usar apenas o chat do Amazon Q, considere que a instalação mínima também é enviada e instalada qterm no seu shell. Você pode usar o qterm para zsh para oferecer suporte a preenchimentos em linha, e não é necessária uma versão completa. Para obter mais informações, consulte Instalar com um arquivo zip.

nota

Para obter informações sobre o uso da CLI do Amazon Q com o Windows, consulte esta postagem no blog dev.to.

macOS

Você pode instalar o Amazon Q para linha de comandos para macOS baixando a aplicação ou usando o Homebrew.

Depois de instalar o Amazon Q para linha de comando para macOS, você pode ativar a integração do shell para poder usar o preenchimento automático em mais de 500 ferramentas de linha de comando. Para obter mais informações, consulte Integração local com macOS.

Para instalar o Amazon Q para linha de comando para macOS, conclua o procedimento a seguir.

  1. Baixe o Amazon Q para linha de comandos para macOS.

  2. (Opcional) Verifique o arquivo baixado para o Amazon Q para linha de comandos no macOS. Para obter mais informações, consulte To verify the download (optional).

  3. Clique duas vezes no arquivo .dmg baixado e arraste a aplicação para a pasta de aplicações.

  4. Na pasta de aplicações, clique duas vezes em Amazon Q. A GUI será aberta.

  5. Habilite as integrações do shell. Isso permitirá que você execute o Amazon Q no shell e também permitirá que o Amazon Q o ajude com o preenchimento automático de comandos do shell.

  6. Faça a autenticação com o Builder ID ou com o Centro de Identidade IAM usando a URL inicial fornecida pelo administrador da sua conta.

  7. Siga as instruções para instalar as integrações do shell e para conceder permissões de acessibilidade ao macOS.

    A interface de verificação automatizada do Amazon Q Developer mostra as integrações do Shell com uma marca de seleção verde e a opção Ativar acessibilidade com um X vermelho, indicando que as integrações do shell estão completas, mas as permissões de acessibilidade ainda precisam ser concedidas

Linux AppImage

Atenção

Esse método de instalação requer uma GUI. Se você estiver instalando no Linux sem uma GUI, consulte Instalar com um arquivo zip.

Você pode instalar o Amazon Q para linha de comando para Linux usando o AppImage formato, que é um formato portátil que funciona na maioria das distribuições Linux sem precisar de instalação.

Para instalar o Amazon Q para uso da linha de comando Linux AppImage, conclua o procedimento a seguir.

  1. Baixe o Amazon Q para linha de comando para Linux AppImage.

  2. Faça o AppImage executável:

    chmod +x amazon-q.appimage

  3. Execute o AppImage:

    ./amazon-q.appimage

  4. Faça a autenticação com o Builder ID ou com o Centro de Identidade IAM usando a URL inicial fornecida pelo administrador da sua conta.

Ubuntu

Atenção

Esse método de instalação requer uma GUI. Se você estiver instalando no Linux sem uma GUI, consulte Instalar com um arquivo zip.

Você pode instalar o Amazon Q para linha de comandos no Ubuntu usando o pacote .deb.

Para instalar o Amazon Q para linha de comando para Ubuntu, conclua o procedimento a seguir.

  1. Baixe o Amazon Q para linha de comandos para Ubuntu. 

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

  2. Instale o pacote :

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

  3. Inicie o Amazon Q para linha de comandos:

    q

  4. Faça a autenticação com o Builder ID ou com o Centro de Identidade IAM usando a URL inicial fornecida pelo administrador da sua conta.

Homebrew

Para instalar o Amazon Q Developer CLI com o Homebrew, execute o seguinte comando:

brew install --cask amazon-q

Configuração do proxy

O Amazon Q Developer CLI (v1.8.0 e versões posteriores) oferece suporte a servidores proxy comumente usados em ambientes corporativos. A CLI respeita automaticamente as variáveis de ambiente proxy padrão.

Configurando variáveis de ambiente de proxy

Defina as configurações de proxy definindo essas variáveis de ambiente em seu shell:

# HTTP proxy for non-SSL traffic
export HTTP_PROXY=http://proxy.company.com:8080

# HTTPS proxy for SSL traffic  
export HTTPS_PROXY=http://proxy.company.com:8080

# Bypass proxy for specific domains
export NO_PROXY=localhost,127.0.0.1,.company.com

Proxy com autenticação

Para proxies que exigem autenticação:

export HTTP_PROXY=http://username:password@proxy.company.com:8080
export HTTPS_PROXY=http://username:password@proxy.company.com:8080

Suporte de proxy SOCKS

O Amazon Q CLI também oferece suporte a proxies SOCKS:

export HTTP_PROXY=socks5://proxy.company.com:1080
export HTTPS_PROXY=socks5://proxy.company.com:1080

Verificando a configuração do proxy

Depois de definir as variáveis do ambiente proxy, teste a conectividade:

q doctor

Solução de problemas de proxy

Se você encontrar problemas de conexão relacionados ao proxy:

  • Verifique a acessibilidade e as credenciais do servidor proxy

  • Garanta que seu firewall corporativo permita conexões com AWS endpoints

  • Entre em contato com seu administrador de TI se a validação do certificado SSL falhar

  • Verifique se o servidor proxy suporta os protocolos necessários

Desinstalando o Amazon Q para linha de comando

Você pode desinstalar o Amazon Q para linha de comandos se não precisar mais dele.

Para desinstalar o Amazon Q para linha de comando no macOS, conclua o procedimento a seguir.

  1. Abra a pasta Aplicações no Finder.

  2. Localize a aplicação Amazon Q Developer.

  3. Arraste a aplicação para a lixeira ou clique com o botão direito do mouse e selecione “Mover para a lixeira”.

  4. Esvazie a lixeira para concluir a desinstalação.

Para desinstalar o Amazon Q para linha de comando no Ubuntu, conclua o procedimento a seguir.

  1. Use o gerenciador de pacotes apt para remover o pacote:

    sudo apt-get remove amazon-q

  2. Remova todos os arquivos de configuração restantes:

    sudo apt-get purge amazon-q

Depuração do Amazon Q Developer para a linha de comando

Se estiver tendo problemas com o Amazon Q Developer para linha de comandos, execute q doctor para identificar e corrigir erros comuns.

Saída esperada

$ q doctor

✔ Everything looks good!

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

Se a sua saída não se parecer com a saída acima, siga os prompts para resolver o problema. Se ainda não estiver funcionando, use q issue para relatar o bug.

Problemas comuns

A seguir, apresentamos alguns problemas comuns que você pode encontrar ao usar o Amazon Q para linha de comandos:

Falhas de autenticação

Se estiver tendo problemas para se autenticar, tente executar q login para se autenticar novamente.

O preenchimento automático não está funcionando

Certifique-se de que sua integração de shell esteja instalada corretamente executando q doctor.

Problemas de integração com SSH

Verifique se o servidor SSH está configurado corretamente para aceitar as variáveis de ambiente necessárias.

Etapas de solução de problemas

Siga as etapas a seguir para solucionar problemas com o Amazon Q da linha de comandos:

  1. Execute q doctor para identificar e corrigir problemas comuns.

  2. Verifique a conexão com a Internet.

  3. Verifique se você está usando um ambiente compatível. Para obter mais informações, consulte Ambientes de linha de comando.

  4. Tente reinstalar o Amazon Q para linha de comandos.

  5. Se o problema persistir, reporte-o usando o q issue.