安装适用于命令行的 Amazon Q
您可以通过为 Amazon Q 应用程序启动文件下载来安装面向 macOS 的适用于命令行的 Amazon Q。有关更多信息，请参阅 支持的命令行环境。
安装适用于命令行的 Amazon Q 时需要考虑两种方式。最小安装仅在 Linux 上分发 Amazon Q 聊天和通过 SSH 运行自动完成功能所需的二进制文件（q 和 qterm）。完整发行版包含桌面应用程序，并要求使用自动完成功能。如果您只想使用 Amazon Q 聊天，请考虑最小发行版也会将 qterm 发布并安装到您的 Shell。您可以将 qterm 用于 zsh 来支持内联完成，而不需要完整版本。有关更多信息，请参阅 使用 zip 文件进行安装。
注意
有关在 Windows 上使用 Amazon Q CLI 的信息，请参阅 dev.to 上的这篇博客文章
macOS
可以通过下载应用程序或使用 Homebrew 来安装面向 macOS 的适用于命令行的 Amazon Q。
安装面向 macOS 的适用于命令行的 Amazon Q 后，您可以启用 SSH 集成，以便能够对 500 多种命令行工具使用自动完成功能。有关更多信息，请参阅 本地 macOS 集成。
安装面向 macOS 的适用于命令行的 Amazon Q
-
（可选）在 macOS 上验证适用于命令行的 Amazon Q 的已下载文件。有关更多信息，请参阅验证下载（可选）。
-
双击下载的 .dmg 文件，然后将应用程序拖到应用程序文件夹。
-
在应用程序文件夹中，双击 Amazon Q。GUI 将打开。
-
启用 Shell 集成。这将支持您从 Shell 中运行 Amazon Q，也可以让 Amazon Q 协助您使用 Shell 命令自动完成功能。
-
使用构建器 ID 进行身份验证，或者使用您的账户管理员提供的启动 URL 通过 IAM Identity Center 进行身份验证。
-
按照说明安装 Shell 集成，并授予 macOS 可访问性权限。
Linux AppImage
警告
此安装方法需要 GUI。如果您在没有 GUI 的 Linux 上进行安装，请参阅使用 zip 文件进行安装。
您可以使用 AppImage 格式安装面向 Linux 的适用于命令行的 Amazon Q，这是一种可移植格式，无需安装即可在大多数 Linux 发行版上运行。
使用 AppImage 安装面向 Linux 的适用于命令行的 Amazon Q
-
使 AppImage 变为可执行文件：
chmod +x amazon-q.appimage -
运行 AppImage：
./amazon-q.appimage -
使用构建器 ID 进行身份验证，或者使用您的账户管理员提供的启动 URL 通过 IAM Identity Center 进行身份验证。
Ubuntu
警告
此安装方法需要 GUI。如果您在没有 GUI 的 Linux 上进行安装，请参阅使用 zip 文件进行安装。
您可以使用 .deb 程序包安装适用于命令行的 Amazon Q。
安装面向 Ubuntu 的适用于命令行的 Amazon Q
-
下载面向 Ubuntu 的适用于命令行的 Amazon Q。
wget https://desktop-release.q.us-east-1.amazonaws.com/latest/amazon-q.deb -
安装 包：
sudo dpkg -i amazon-q.deb sudo apt-get install -f -
启动适用于命令行的 Amazon Q：
q -
使用构建器 ID 进行身份验证，或者使用您的账户管理员提供的启动 URL 通过 IAM Identity Center 进行身份验证。
Homebrew
使用 Homebrew 安装 Amazon Q 开发者版 CLI
brew install --cask amazon-q
卸载适用于命令行的 Amazon Q
如果您不再需要适用于命令行的 Amazon Q，则可以卸载它。
在 macOS 上卸载适用于命令行的 Amazon Q
-
在 Finder 中打开应用程序文件夹。
-
找到 Amazon Q 开发者版应用程序。
-
将应用程序拖到回收站，或者右键单击并选择“移至回收站”。
-
清空回收站以完成卸载。
在 Ubuntu 上卸载适用于命令行的 Amazon Q
-
使用 apt 程序包管理器来移除程序包：
sudo apt-get remove amazon-q -
移除所有剩余的配置文件：
sudo apt-get purge amazon-q
调试适用于命令行的 Amazon Q 开发者版
如果您在使用适用于命令行的 Amazon Q 开发者版时遇到问题，请运行 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以重新进行身份验证。 - 自动完成功能不起作用
-
通过运行
q doctor来确保正确安装了 Shell 集成。 - SSH 集成问题
-
验证 SSH 服务器是否已正确配置为接受所需的环境变量。
故障排除步骤
按照以下步骤排查适用于命令行的 Amazon Q 的问题：
-
运行
q doctor来识别和修复常见问题。 -
检查您的 Internet 连接。
-
验证您使用的是受支持的环境。有关更多信息，请参阅 支持的命令行环境。
-
尝试重新安装适用于命令行的 Amazon Q。
-
如果问题仍然存在，请使用
q issue进行报告。
