用Amazon Q Developer命令行工具（CLI）快捷开发酒店入住应用程序

用Amazon Q Developer命令行工具（CLI）快捷开发酒店入住应用程序

Develop A Hotel Check-in/out Application by CLI for Amazon Q Developer

By Jackson@ML

1. 获取适用CLI的Amazon Q开发者版

打开Chrome浏览器，访问AWS官网链接https://aws.amazon.com ，查找适用于CLI 的Amazon Q Developer产品服务：https://aws.amazon.com/cn/developer/learning/q-developer-cli/,

如下图所示。

下载和安装适用于macOS系统的CLI for Amazon Q 开发者版。

点击下载后，Chrome浏览器出现下载进度，如下图。

很快下载结束，一个名为Amazon Q.dmg的程序文件出现在Finder > Downloads文件夹内。

用鼠标右键单击该文件，Open > Open with > DiskImageMounter (default) 打开并安装该程序。

用鼠标将Q图标拖动到右侧Application文件夹即可完成安装。

点击Get started (启动）。

提示Shell integrations，意味着安装结束后，要和macOS系统的终端（Terminal）集成到一起。

点击Install安装完毕，弹出对话框，需要对Amazon Q访问权限Enable。

于是，选择**Finder > Privacy & Security > Accessibility > Amazon Q (Enabled)**并赋予Mac本地安全访问权限（例如：指纹）。

之后，就会弹出对话框，要求Amazon Q Sign in(登录)。

点击Sign in试图登录时，会弹出错误信息Failed to login,如下图。

原来是要求Pro license(Pro许可证)。当用户注册并开通Pro之后，即可使用相应付费的高级功能。

2. 利用Amazon Q CLI运行Free with Builder ID

当Amazon Q安装完毕并启动后，重新打开Terminal，可以看到当中集成了qterm。在命令行输入以下命令，即可打开Amazon Q CLI:

$ q login

执行如下图所示。

用鼠标可切换两种模式，这里笔者选择Use for Free with Builder ID （以Builder ID免费使用）。

选择用免费的AWS Builder ID登录。按Enter键。随即重定向到Web页面，如下图。

点击“允许访问”，继续。页面更新为允许访问状态。

提示请求已批准(Request approved)，于是，弹出Amazon Q Developer的对话框。

出现Welcome！（欢迎）画面。
点击Get started开始CLI访问数据。

页面提示，过去的CodeWhisperer即现在的Amazon Q。

此时，终端显示登录成功！

正式进入Amazon Q Developer的CLI命令行工具时，只需执行以下命令：

% q chat

CLI启动后，显示了大型的Amzon Q的字符Logo，以及执行命令的提示符 >。

实际上，此时调用了Amazon Q CLI界面，并从默认大模型Claude Sonnet 4运行。

3. 构建基于CLI的酒店登记/登出Python应用程序

进入到Amazon Q命令行工具，亟需整准确的prompts与Q进行交互。

根据顾客到酒店登记/登出步骤，梳理开发需求，形成基本prompts(提示词)如下：
What do I guild a program to summarize check-in and check-out issues for guests who will input personal information ,such as name, age, gender, and occupation, etc. Eventually save all data into a Excel worksheet on the folder Coder/python-demo/check-in-program.py?

按Enter键，Q在命令行立刻开始思考**:.Thinking…** 短暂的几秒后，开始进行编程梳理和输出代码，如下图。

Q回答：
I’ll help you build a program that manages guest check-in and check-out information and saves the data to an Excel worksheet. Let’s create this program step by step.

*注： 基于用户的提示词，Q将代码分解和项目事项逐一显示出来，并邀请用户确认，是否进一步 信任（t） 或者 同意(y) 以及 不同意(n) 等等。

该项目需要手动创建目录 ~/python-demo；创建完毕后，选择t(trust)继续，意味着同意Q的思路及实现步骤。

因此，它启动了基本思路，如下所示。

开始按照要求，生成check_in_program.py程序文件，用于顾客去酒店登记。

接下来，要创建顾客出酒店check-out的程序，如下图。

接着，要创建该程序必须的第三方库（依赖项）安装文件requirement.txt

接下来，Q辅助构建了顾客登记应用程序，并自动小结如下：

告知用户如何运行该程序（按照以下步骤）。

程序创建完毕，按照Q的提示，在验证代码后，可依照相应步骤运行该程序。

4. 修订和完善项目代码

在命令行开发工具实现完毕后，打开VS Code，并且打开刚才创建的演示项目文件夹。

选定生成的代码（例如：check_in_program.py），并在VS Code中打开Amazon Q Developer的Chat窗口；

对该代码输入修正提示词：
Offer analysis for the Python project, then export a clean and reviewed code.

Amazon Q经过代码搜索，直接指出了须修改完善之处，并将意见罗列出来，结果如下图所示：

此时，代码已完善。

5. 运行项目代码

按照Amazon Q的CLI提示分步骤实现运行该项目代码：

1） 切换项目文件夹

在VS Code新的Terminal窗口，切换到该项目文件夹：

% cd ~/python-demo

2）创建虚拟环境并将其激活

在项目文件夹当前目录中，执行以下命令，分别创建和激活虚拟环境。

% python3 -m venv .venv
% source .venv/bin/activate

3） 安装依赖项(dependencies)

对于该项目必须安装的第三方库，将其写入文件requirements.txt。

然后，在终端运行安装命令。

% pip install -r requirements.txt

执行命令，依次安装pandas, openpyxl,numpy等库。安装速度取决于网络情况。

根据提示，将pip版本升级为最新版本，执行以下命令：

% pip install --upgrade pip

4）运行该应用程序

执行命令，运行该应用程序：

% python3 check_in_program.py

运行结果如下：

可以看到，顾客入住酒店check-in的各部分手续办理顺利！

办理完毕后，所有信息自动存储在guest_records.xlsx的Excel表格中。

• 若用Microsoft Excel打开该表格，则顾客信息随即可见（更多字段信息隐藏在该行右侧），如下表。

酒店入住固然如此，那么，顾客在离开酒店时check-out也有类似原理，本程序已实现该功能，此处不再赘述。

至此，该项目程序开发和运行完毕。

6. 小结

我们共同体验了Amazon Q Developer命令行工具带来的开发乐趣，更重要的是，该产品/服务还具有纠错功能，便于项目后期的调试和完善。

如果需要更加复杂、功能更强大的应用程序，则需要前期规划得当，配备必要的资源后，按照项目架构一步步实施。

总之，Amazon Q Developer能够助力用户快速、高效开发应用程序，还具备修正和验证机制，实为广大开发者的福音。

---

欢迎使用AWS产品服务，欢迎登录Amazon Q Developer!

技术好文陆续推出，敬请已关注、收藏和点赞👍！
您的认可，我的动力！😃

2025 All rights reserved. 版权所有，侵权必究。

---

推荐阅读：

用Amazon Q Developer助力Python快捷软件开发
用Streamlit开发第一个Python应用程序
获取并安装AWS CLI应用程序
【AWS入门】AWS亚马逊云科技账户注册指南
【AWS入门】创建并使用AWS Builder ID
【AWS入门】AWS云计算简介
【AWS入门】IAM多重身份验证（MFA）简介
2025最新版Python 3.13.5安装使用指南
2025最新版Visual Studio Code for Mac安装使用指南
用Python爬取高清图片的应用程序解决方案
社交网络分析（SNA）简介