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

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

為命令列安裝 Amazon Q

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

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

注意

如需搭配 Windows 使用 Amazon Q CLI 的詳細資訊，請參閱 https：//dev.to 上的此部落格文章。

macOS

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

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

為 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 可存取性許可。

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

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 命令列時可能遇到的一些常見問題：

身分驗證失敗

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

自動完成無法運作

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

SSH 整合問題

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

疑難排解步驟

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

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

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

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

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

  5. 如果問題仍然存在，請使用 回報此問題q issue。