安装适用于命令行的 Amazon Q - Amazon Q 开发者版
macOSLinu AppImageUbuntu卸载调试

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

安装适用于命令行的 Amazon Q

您可以通过为 Amazon Q 应用程序启动文件下载来安装适用于 macOS 的命令行版 Amazon Q。有关更多信息，请参阅 支持的命令行环境。

在为命令行安装 Amazon Q 时，需要考虑两种方式。最小安装仅在 Linux 上分发 Amazon Q 聊天和通过 SSH 运行自动完成功能所需的二进制文件（q和）。qterm完整版包含桌面应用程序，需要使用自动完成功能。如果您只想使用 Amazon Q 聊天，请考虑最少的发行版也会发货并安装qterm到您的外壳上。你可以使用 f qterm or zsh 来支持内联完成，不需要完整版本。有关更多信息，请参阅 使用 zip 文件进行安装。

注意

有关在 Windows 上使用 Amazon Q CLI 的信息，请参阅 dev.to 上的这篇博客文章。

macOS

你可以通过下载应用程序或使用 Homebrew 来安装适用于 macOS 的命令行版 Amazon Q。

安装适用于 macOS 命令行的 Amazon Q 后，您可以启用 SSH 集成，以便能够对 500 多种命令行工具使用自动完成功能。有关更多信息，请参阅 本地 macOS 集成。

安装适用于 macOS 命令行的 Amazon Q

  1. 下载适用于 macOS 命令行的 Amazon Q。

  2. （可选）在 macOS 上验证已下载的适用于命令行的 Amazon Q 文件。有关更多信息，请参阅验证下载（可选）。

  3. 双击下载的.dmg 文件，然后将应用程序拖到应用程序文件夹。

  4. 在您的应用程序文件夹中，双击 Amazon Q。GUI 将打开。

  5. 启用外壳集成。这将允许您从外壳中运行 Amazon Q，也可以让 Amazon Q 帮助您自动完成外壳命令。

  6. 使用构建器 ID 进行身份验证，或者使用您的账户管理员提供的启动 URL 通过 IAM Identity Center 进行身份验证。

  7. 按照说明安装 shell 集成，并授予 macOS 无障碍访问权限。

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

Linu AppImage

警告

此安装方法需要 GUI。如果您在没有 GUI 的 Linux 上进行安装，请参阅使用 zip 文件进行安装。

您可以使用该 AppImage 格式安装 Amazon Q for Linux 命令行，这是一种便携格式，无需安装即可在大多数 Linux 发行版上运行。

要安装适用于 Linux 的命令行版 Amazon Q，请使用 AppImage

  1. 下载适用于 Linux 命令行的 Amazon Q AppImage。

  2. 制作 AppImage 可执行文件：

    chmod +x amazon-q.appimage

  3. 运行 AppImage：

    ./amazon-q.appimage

  4. 使用构建器 ID 进行身份验证，或者使用您的账户管理员提供的启动 URL 通过 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. 使用构建器 ID 进行身份验证，或者使用您的账户管理员提供的启动 URL 通过 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 开发者版

如果您在使用命令行版 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 的问题：

  1. 运行q doctor以识别和修复常见问题。

  2. 检查您的 Internet 连接。

  3. 确认您使用的是受支持的环境。有关更多信息，请参阅 支持的命令行环境。

  4. 尝试重新安装适用于命令行的 Amazon Q。

  5. 如果问题仍然存在，请使用报告q issue。