Amazon Q Developer CLI 命令速查表 - AWS 官方 AI 编码代理全参数
Amazon Q Developer CLI 是 AWS 官方终端 AI 编码代理，面向工作在 AWS 生态里、想让 AI 理解并修改本地仓库、同时又要与 AWS 服务/文档联动的开发者。它的差异点是深度绑定 AWS（可解释并操作 AWS 资源），并同时支持 q 单行查询与 Agent 模式两种工作流；本表帮你掌握安装登录、对话/单行查询与 Agent 执行。
安装与认证 5
brew install amazon-qq --versionq loginq logoutq config list对话与查询 5
q chatq "用 Python 写一个快排"q "解释这段报错：$(cat error.log)"q /docq /testAgent 模式 5
q chat 后输入 /q在 Agent 中描述完整需求/clearCtrl+Cq chat --helpAWS 生态集成 5
q "为这个 Lambda 生成 IAM 策略"q "解释这个 CloudFormation 模板"q "把这个 EC2 用户脚本改成 SSM"q config set region us-east-1q /help实用技巧 5
单行 q "..." 适合脚本/CI先 q login 再开 chat用 /doc /test 省去手写Agent 模式做多步重构结合 AWS 上下文最准命令示例
打印模式问一句，输出直接进管道
q "Write a quicksort in Python"不带 chat 就不会进交互，命令跑完即退出。这是把 Q 塞进 shell 管道或 CI 步骤的基本形态。
把报错日志整段喂进去让它解释
q "Explain this error output: $(cat error.log)"命令替换在 Q 启动前就完成，日志内容不会落进你的 shell 历史。注意这类日志里常含内部主机名与账号，分享前先过一遍。
先切 Agent 模式，再交一个跨文件的完整需求
q chat
/q
为这个 Lambda 生成 IAM 策略三行分别对应：开 REPL、切自主模式、给需求。Agent 模式会真的改文件并跑命令，用之前确认工作区干净。
先把 Region 设对，再让 Q 解读 IaC 模板
q config set region us-east-1
q "Explain this CloudFormation template"q config list 可以回读当前的 profile 与 region。Region 设错时 Q 给出的资源名与建议会指向另一个区域。
常见坑与注意事项
- 打印模式会把回答原样写到 stdout，脚本里若把整个仓库上下文拼进提示词，注意别把 .env、密钥文件内容一起送出去。
- q login 没做或登录过期就开 q chat，AWS 上下文是残缺的：先 q login，再用 q config list 确认 profile 与 region 已就位。
- q config set region 只改默认值，它不验证你的资源到底在哪个区；跨区问题先核对，再让 Q 生成 IAM 策略，否则策略会指向错误的资源。
- Agent 模式（/q）会跨文件编辑并执行命令，务必在干净、可回滚的工作区里运行，不要拿生产仓库或未推送的本地改动做试验。
- Ctrl+C 只中断当前这一步，被改过的文件仍然留在磁盘上；重试之前先看工作区差异。/doc 与 /test 生成的文档和测试也要人工复核，AI 常写出空断言或重复现有用例的测试。
提示
- Amazon Q Developer CLI 是 AWS 官方出品，聊 AWS 资源（Lambda/IAM/CloudFormation/EC2）时比通用编码代理更贴合云上下文，适合云原生团队。
- 单行
q "..."走打印模式，可直接接管道用于脚本与 CI；复杂多步任务进q chat后再/q切到 Agent 模式。 - 前置：
q login用 AWS Builder ID 或 IAM Identity Center 认证；用q config管理 profile 与 region。 - /doc 与 /test 是隐藏效率点：对着代码跑一下就能补文档和单测，不必手动写。
常见问题
q "..." 和 q chat 什么时候用哪个？
q 后面直接跟引号里的问题是打印模式：问一句、答一句、不进交互，输出可以直接接管道，脚本和 CI 里用这个。q chat 是交互式 REPL，可以连续追问，复杂任务才值得开。
q chat 里的 /q 是什么，为什么复杂重构要先切它？
/q 是把会话从问答切到自主 Agent 模式：之后你只需描述完整需求，它会自己跨文件编辑、运行命令并自检。单轮问答用不到它；要做多步重构时切过去，比一轮轮描述要改哪些文件高效。
为什么让 Q 讲 AWS 资源时它比通用模型更靠谱？
Q 的回答质量直接受它所处的 AWS 上下文影响，而上下文由 profile 和 region 决定。先 q config set region 把目标 Region 设对，再用 q config list 回读确认，Q 给出的 IAM 策略、模板解读才有落点；Region 不对时它会给出一份语法正确但指向错误区域的建议。
/doc 和 /test 这类斜杠命令怎么用？
它们在 q chat 里对着当前打开的代码生效：/doc 补文档注释，/test 给选中代码生成单元测试。不需要离开对话去手动写，但生成结果要人工过一遍再提交。想知道当前会话还有哪些斜杠命令可用，敲 /help。
任务跑歪了或者卡住了，怎么停下来重来？
Ctrl+C 中断当前正在生成或执行的部分，进程留在 q chat 里；对话历史太长时用 /clear 清空再重新描述需求。中断可能留下写了一半的文件，重来之前先看一眼工作区状态。
由 巧匠 维护
公开更新于 2026年8月23日，内容持续校对官方文档。