wbmeet

如何在 VS Code 安装并使用 Amazon Q Developer：扩展、登录与首批代码建议

安装 Amazon Q 扩展、完成 Builder ID 或公司 SSO 登录，再在自己的仓库里拿到第一条内联建议或聊天回复。

第一次在 VS Code 里用 Amazon Q Developer，卡住的通常不是提示词，而是扩展有没有装对、用 Builder ID 还是公司 IAM Identity Center 登录，以及内联补全和聊天面板有没有真正连上。按官方文档装扩展、在浏览器完成认证，再在自己的仓库里触发第一条建议或问一个问题。

检索词是 如何在 VS Code 安装并使用 Amazon Q Developer。下文对照 AWS 文档 docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/q-in-IDE-setup.html、Builder ID 入门页与 Marketplace 项 AmazonWebServices.amazon-q-vscode。这是 AWS 的 IDE 助手，不是本站会议产品。要约短会对齐改动，用 wbmeet 建房即可，步骤见 如何创建与加入房间。

安装扩展登录认证建议与聊天

先核对你能用哪条登录路径

Amazon Q Developer 是 AWS 在 IDE 里的 AI 编程助手：内联代码建议（原 CodeWhisperer 能力）、侧边栏聊天、代码解释与重构。VS Code 扩展由 Amazon Web Services 发布，id 为 AmazonWebServices.amazon-q-vscode。个人免费试用走 AWS Builder ID（个人资料，不需要完整 AWS 账户，在浏览器完成邮箱或 Google 登录）。公司订阅了 Amazon Q Developer Pro 的员工走 Company account，用管理员提供的 IAM Identity Center Start URL 和 AWS Region 在浏览器 SSO 登录。

2 auth
Builder ID or IAM Identity Center
0 IAM
No IAM user/role sign-in in IDE
1 ext
Marketplace: Amazon Q

第一次：安装、登录、拿到建议或聊天回复

  1. 1

    从 VS Code 市场安装 Amazon Q

    打开 VS Code，Cmd+Shift+X（macOS）或 Ctrl+Shift+X（Windows/Linux）。搜索 Amazon Q，选发布者 Amazon Web Services，点 Install。也可 Quick Open（Cmd+P / Ctrl+P）粘贴 ext install AmazonWebServices.amazon-q-vscode。安装后重载窗口。活动栏会出现 Amazon Q 图标。

  2. 2

    选择登录方式并在浏览器完成认证

    点活动栏 Amazon Q 图标。个人项目选 Builder ID，按提示在浏览器创建或登录 AWS Builder ID（可用邮箱或 Google 账号，见 AWS Sign-In 文档）。公司 Pro 订阅选 Company account，填入管理员给的 IAM Identity Center Start URL 与 AWS Region，点 Continue，在浏览器完成 SSO，再回到 VS Code。不要把 IAM Access Key 贴进扩展。

  3. 3

    打开自己的仓库并检查内联建议

    File → Open Folder，选你拥有、能回滚的项目。新建或打开一个代码文件，正常打字。几秒后应出现灰色内联补全；按 Tab 接受，Esc 拒绝。若始终没有建议，看状态栏 Amazon Q 是否已连接，并确认未超免费额度。

  4. 4

    用聊天面板问第一个问题

    再次点 Amazon Q 图标打开聊天。先问只读问题：「这个仓库的入口文件在哪？」或「解释当前打开函数的作用」。若要改代码，明确说「只建议 diff，等我确认再应用」。不要把密钥、客户数据或生产连接串写进聊天。第一小时目标是确认建议与聊天都能响应。

# First hour · Amazon Q Developer in VS Code · as of 2026-09
# 1. Extensions → Amazon Q (publisher Amazon Web Services)
#    id: AmazonWebServices.amazon-q-vscode
# 2. Activity Bar → Amazon Q → Builder ID (personal)
#    OR Company account + Start URL + Region (Pro / org)
# 3. Open your repo. Type in a source file → wait for inline ghost text
# 4. Amazon Q chat: "Where is the main entry point in this repo?"
# Do not paste IAM access keys. Free Builder ID has usage limits.

登录路径、功能与常见坑

路径官方怎么写第一次注意
个人免费AWS Builder ID，无需 AWS 账户浏览器完成邮箱/Google 验证
公司 ProIAM Identity Center + Start URL + Region向管理员要 URL 与区域
不支持IAM 用户 / IAM 角色直登 IDE不要用 Access Key 冒充登录
内联建议打字时出现灰色补全，Tab 接受先确认已认证且未超配额
聊天活动栏 Amazon Q 面板第一问先用只读问题试通
01

装完却要求登录循环

多半是浏览器弹窗被拦截，或 Builder ID 邮箱未验证。允许 VS Code 打开外部链接，在系统默认浏览器完成登录后手动切回编辑器。

02

公司账号找不到 Start URL

Start URL 和 Region 由 IT 管理员在 Amazon Q 订阅控制台配置。个人 Builder ID 不需要这两项。搞混会导致 SSO 失败。

03

始终没有内联建议

检查文件类型是否受支持、Amazon Q 状态是否 Connected、是否触达免费层限额。View → Output 里选 Amazon Q 看错误日志。

官方 IDE 安装页：市场搜 Amazon Q → 点活动栏图标 → Builder ID 或 Company account → 浏览器认证 → 用图标聊天或等内联建议。定价与限额以 aws.amazon.com/q/developer/pricing 为准。

Builder ID ≠ AWS 控制台账户
Builder ID 是个人 IDE 身份，不能进 AWS 管理控制台，也不能分配 IAM 角色。要在 Console 用 Q 需走 IAM Identity Center。
免费层有上限
个人 Builder ID 在免费档有建议与聊天用量限制。超额需订阅 Pro 或由组织开通 IAM Identity Center。
教程页不是会议说明书
只讲 Amazon Q 第一次。短会白板见 wbmeet 与 对照笔记。

还想核对的问题

一定要 AWS 账户才能用吗？

个人免费路径不需要完整 AWS 账户，用 AWS Builder ID 即可。公司 Pro 走 IAM Identity Center，由组织管理员开通，同样不是在 IDE 里填 IAM Access Key。

能用 IAM 用户的 Access Key 登录吗？

不能。AWS 文档明确：IDE 内 Amazon Q 不支持 IAM 主体或 IAM 角色直登。请用 Builder ID 或 IAM Identity Center SSO。

内联建议和聊天有什么区别？

内联建议在你打字时出现灰色补全，Tab 接受。聊天在活动栏面板里，适合解释代码、提问或生成片段。两者都需要先完成认证。

第一个任务必须改生产代码吗？

不必。先问只读问题或在一个小文件里试内联补全。确认连通后再做可回滚的改动，并人工审查每一行。

免费开始开会