為命令列安裝 Amazon Q - Amazon Q Developer
macOSLinux AppImageUbuntu解除安裝除錯

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

為命令列安裝 Amazon Q

您可以啟動 Amazon Q 應用程式的檔案下載，為 macOS 安裝 Amazon Q 命令列。如需詳細資訊，請參閱支援的命令列環境。

安裝 Amazon Q for 命令列時，需要考慮兩種模式。最低安裝僅會在 Linux 上分配 Amazon Q 聊天和自動完成功能所需的二進位檔，以透過 SSH (q 和 ) 運作qterm。完整分發包含桌面應用程式，且需要使用自動完成功能。如果您只想使用 Amazon Q 聊天，請考慮最小分佈也會出貨並安裝qterm到您的 shell。您可以使用 qtermzsh 支援內嵌完成，而且不需要完整版本。如需詳細資訊，請參閱使用 zip 檔案安裝。

macOS

您可以下載應用程式或使用 Homebrew 來安裝 Amazon Q for macOS 命令列。

在為 macOS 安裝命令列的 Amazon Q 之後，您可以啟用 SSH 整合，以針對超過 500 個命令列工具使用自動完成。如需詳細資訊，請參閱透過 SSH 使用自動完成。

為 macOS 安裝命令列的 Amazon Q

  1. 下載適用於 macOS 命令列的 Amazon Q。

  2. （選用） 驗證 macOS 上命令列的 Amazon Q 下載檔案。如需詳細資訊，請參閱。

  3. 按兩下下載的 .dmg 檔案，然後將應用程式拖曳到您的應用程式資料夾。

  4. 在您的應用程式資料夾中，按兩下 Amazon Q。GUI 將開啟。

  5. 啟用 Shell 整合。這將允許您從 shell 執行 Amazon Q，也將允許 Amazon Q 協助您進行 shell 命令自動完成。

  6. 使用帳戶管理員提供給您的啟動 URL，以建置器 ID 或透過 IAM Identity Center 進行驗證。

  7. 依照指示安裝 shell 整合，並授予 macOS 可存取性許可。

Linux AppImage

警告

此安裝方法需要 GUI。如果您在沒有 GUI 的 Linux 上安裝 ，請參閱 使用 zip 檔案安裝。

您可以使用 AppImage 格式安裝適用於 Linux 命令列的 Amazon Q，這是一種可攜式格式，可在大多數 Linux 發行版本上運作，而不需要安裝。

使用 AppImage 安裝 Linux 命令列的 Amazon Q

  1. 下載適用於 Linux AppImage 命令列的 Amazon Q。

  2. 讓 AppImage 可執行檔：

    chmod +x amazon-q.appimage

  3. 執行 AppImage：

    ./amazon-q.appimage

  4. 使用帳戶管理員提供給您的啟動 URL，以建置器 ID 或透過 IAM Identity Center 進行驗證。

Ubuntu

警告

此安裝方法需要 GUI。如果您在沒有 GUI 的 Linux 上安裝 ，請參閱 使用 zip 檔案安裝。

您可以使用 .deb 套件為 Ubuntu 安裝命令列的 Amazon Q。

為 Ubuntu 安裝命令列的 Amazon Q

  1. 下載適用於 Ubuntu 命令列的 Amazon Q。

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

  2. 安裝 套件：

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

  3. 針對命令列啟動 Amazon Q：

    q

  4. 使用帳戶管理員提供給您的開始 URL，以建置器 ID 或透過 IAM Identity Center 進行驗證。

解除安裝命令列的 Amazon Q

如果您不再需要命令列，可以解除安裝 Amazon Q。

在 macOS 上解除安裝命令列的 Amazon Q

  1. 在 Finder 中開啟應用程式資料夾。

  2. 找到 Amazon Q 應用程式。

  3. 將應用程式拖曳至垃圾桶，或以滑鼠右鍵按一下並選取「移至垃圾桶」。

  4. 清空垃圾桶以完成解除安裝。

在 Ubuntu 上解除安裝命令列的 Amazon Q

  1. 使用 apt 套件管理員移除套件：

    sudo apt-get remove amazon-q

  2. 移除任何剩餘的組態檔案：

    sudo apt-get purge amazon-q

為命令列的 Amazon Q Developer 偵錯

如果您遇到命令列的 Amazon Q Developer 問題，請執行 q doctor來識別和修正常見問題。

預期的輸出結果

$ q doctor

✔ Everything looks good!

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

如果您的輸出看起來與預期的輸出不同，請遵循提示來解決您的問題。如果仍然無法運作，請使用 q issue 報告錯誤。

常見問題

以下是使用 Amazon Q for 命令列時可能遇到的一些常見問題：

身分驗證失敗

如果您在驗證時遇到問題，請嘗試執行 q login以重新驗證。

自動完成無法運作

執行 ，確保您的 shell 整合已正確安裝q doctor。

SSH 整合問題

確認您的 SSH 伺服器已正確設定為接受所需的環境變數。

疑難排解步驟

請依照下列步驟對 Amazon Q for 命令列的問題進行疑難排解：

  1. 執行 q doctor以識別和修正常見問題。

  2. 請檢查您的網際網路連線。

  3. 確認您使用的是支援的環境。如需詳細資訊，請參閱支援的命令列環境。

  4. 請嘗試重新安裝命令列的 Amazon Q。

  5. 如果問題仍然存在，請使用 進行報告q issue。