一名云计算从业者的思考

大家都在搜：

热搜词1 热搜词2 热搜词3

当前位置：首页 > 日常方案 > 正文内容

在Windows WSL上安装Amazon Q开发者CLI的完整指南

anycodes1年前 (2025-07-09)日常方案8120

## 引言

Amazon Q是AWS推出的AI助手工具，为开发者提供代码建议、问题解答和文档查询等功能。目前，Amazon Q开发者CLI并不直接支持Windows原生环境，但我们可以通过Windows Subsystem for Linux (WSL)来安装和使用它。本文将详细介绍如何在Windows WSL环境中安装、配置和使用Amazon Q开发者CLI。

## 什么是Amazon Q？

Amazon Q是AWS推出的AI编码助手，可以帮助开发者：
- 生成、完成和改进代码
- 回答技术问题
- 查询和搜索AWS文档
- 提供命令行工具的自动补全功能
- 帮助解决常见的开发问题

## 准备工作

在开始安装Amazon Q之前，我们需要确保系统满足以下要求：

1. Windows 10或更高版本
2. WSL 2已安装并配置
3. 互联网连接
4. AWS Builder ID账号（免费）

## 安装步骤

### 1. 安装WSL

如果您尚未安装WSL，请按照以下步骤操作：

1. 以管理员身份打开Windows命令提示符或PowerShell
2. 运行以下命令：

```bash
wsl --install
```

3. 重启计算机
4. 首次启动WSL时，系统会要求您创建一个用户账号和密码

如果您需要更详细的WSL安装指南，请参考[Microsoft官方文档](https://learn.microsoft.com/zh-cn/windows/wsl/install)。

### 2. 启动WSL Ubuntu环境

打开Windows命令提示符或PowerShell，然后输入：

```bash
wsl -d Ubuntu
```

这将启动Ubuntu WSL环境。如果这是您第一次启动，系统会自动安装Ubuntu并要求您设置用户名和密码。

### 3. 准备安装环境

在WSL环境中，我们需要先进入主目录并安装必要的工具：

```bash
cd ~
sudo apt update
sudo apt install unzip curl -y
```

系统会要求您输入之前设置的Ubuntu用户密码。

### 4. 下载和安装Amazon Q开发者CLI

接下来，我们将下载Amazon Q开发者CLI的安装包并进行安装：

```bash
curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.q.us-east-1.amazonaws.com/latest/q-x86_64-linux.zip" -o "q.zip"
unzip q.zip
chmod +x q/install.sh
./q/install.sh
```

当安装程序询问是否修改shell配置时，请选择"Yes"，这将添加Amazon Q的可执行文件路径到您的环境变量中。

安装完成后，为了激活新的shell配置，您可以重新启动WSL会话或运行：

```bash
bash
```

### 5. 验证安装并登录

现在我们可以验证Amazon Q是否正确安装：

```bash
q doctor
```

如果一切正常，您应该会看到类似于以下的输出：

```
✓ Everything looks good!
```

接下来，使用以下命令登录Amazon Q：

```bash
q login
```

您将看到两个登录选项，请选择"Use for Free with Builder ID"。系统会生成一个URL链接，请复制该链接并在浏览器中打开。您需要使用现有的AWS Builder ID登录或创建一个新账号。

完成验证后，您可以返回WSL终端，应该会看到登录成功的消息。

### 6. 使用Amazon Q

现在您可以开始使用Amazon Q了：

```bash
q chat
```

这将启动Amazon Q的交互式聊天界面，您可以开始向它提问、寻求代码帮助等。输入"/q"可以退出聊天界面。

## 高级配置：添加AWS文档MCP服务器（可选）

如果您想要增强Amazon Q的功能，使其能够搜索AWS文档并提供更精确的回答，您可以配置AWS Documentation MCP Server：

### 1. 安装所需工具

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
uv python install 3.12
```

### 2. 创建MCP服务器配置文件

```bash
mkdir -p ~/.aws/amazonq
nano ~/.aws/amazonq/mcp.json
```

在编辑器中添加以下内容：

```json
{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
        "command": "uvx",
        "args": ["awslabs.aws-documentation-mcp-server@latest"],
        "env": {
          "FASTMCP_LOG_LEVEL": "ERROR"
        },
        "disabled": false,
        "autoApprove": []
    }
  }
}
```

保存并关闭文件（按Ctrl+X，然后Y，最后Enter）。

### 3. 测试MCP服务器集成

启动Amazon Q聊天并尝试询问一些与AWS服务相关的问题：

```bash
q chat
```

例如，您可以尝试：

```
请解释一下CloudFront SaaS Manager并引用文档。
```

系统会提示您允许使用AWS文档搜索工具，输入"y"确认。

## 故障排除

如果您在使用Amazon Q时遇到问题，可以尝试以下步骤：

1. 运行诊断命令：
```bash
q doctor
```

2. 检查网络连接
3. 重新登录：
```bash
q login
```

4. 如果遇到权限问题，请确保您已经正确设置了环境
5. 如果问题仍然存在，可以尝试重新安装Amazon Q

## 总结

通过WSL，Windows用户现在可以使用强大的Amazon Q开发者CLI工具，提高开发效率。虽然目前没有直接的Windows原生版本，但WSL提供了一个完美的解决方案，让Windows用户也能享受Amazon Q带来的AI助手功能。

## 参考资料

1. [AWS官方文档：Installing Amazon Q for command line](https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-installing.html)
2. [AWS Repost: How to install Amazon Q Developer CLI on WSL2](https://repost.aws/articles/ARRW-I9s_cSP2NS2WZhYilQQ/how-to-install-amazon-q-developer-cli-on-wsl2)
3. [The essential guide to installing Amazon Q Developer CLI on Windows](https://dev.to/aws/the-essential-guide-to-installing-amazon-q-developer-cli-on-windows-lmh)
4. [Microsoft WSL安装指南](https://learn.microsoft.com/zh-cn/windows/wsl/install)
5. [Amazon Q开发者文档](https://docs.aws.amazon.com/amazonq/)
6. [AWS文档MCP服务器配置指南](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/)

----

额外补充：如果遇到下面的错误

![](https://www.runor.cn/zb_users/upload/2025/07/202507091851439691056.png)

可以参考文档：https://blog.csdn.net/xiaoxiongxiong04/article/details/145883198

扫描二维码推送至手机访问。

本文链接：https://www.runor.cn/?id=25

标签: Amazon Q WSL 开发者工具 AI编码助手 AWS

分享给朋友：

返回列表

上一篇：AWS EC2自定义主机名管理系统

下一篇：Amazon S3 文件大小限制及其实现方案

刘博说云

大家都在搜：

在Windows WSL上安装Amazon Q开发者CLI的完整指南

“在Windows WSL上安装Amazon Q开发者CLI的完整指南” 的相关文章

OpenSearch向量搜索实践：使用Flow Framework快速部署

AWS EC2 自动镜像创建与弹性伸缩部署指南

AWS S3接入点查询与分析方法

AWS账号分账的悖论：为什么"最佳实践"总是失效

OpenSearch自定义模型上传详解：文件处理与分块机制深度解析

发表评论

Powered By Z-BlogPHP. Theme by TOYEAN.

刘博说云

大家都在搜：

在Windows WSL上安装Amazon Q开发者CLI的完整指南

“在Windows WSL上安装Amazon Q开发者CLI的完整指南” 的相关文章

OpenSearch向量搜索实践：使用Flow Framework快速部署

AWS EC2 自动镜像创建与弹性伸缩部署指南

AWS S3接入点查询与分析方法

AWS账号分账的悖论：为什么"最佳实践"总是失效

OpenSearch自定义模型上传详解：文件处理与分块机制深度解析

发表评论取消回复

Powered By Z-BlogPHP. Theme by TOYEAN.

发表评论