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 或 Ctrl+Shift+X。搜 Amazon Q，選發布者 Amazon Web Services，Install。也可 Quick Open 貼 ext install AmazonWebServices.amazon-q-vscode。安裝後重載。活動列會出現 Amazon Q 圖示。

  2. 2

    選擇登入方式並在瀏覽器完成認證

    點活動列 Amazon Q 圖示。個人專案選 Builder ID，在瀏覽器建立或登入 AWS Builder ID（可用信箱或 Google）。公司 Pro 選 Company account，填管理員給的 Start URL 與 Region，Continue 後在瀏覽器完成 SSO。不要把 IAM Access Key 貼進擴充。

  3. 3

    打開自己的倉庫並檢查內嵌建議

    File → Open Folder，選你擁有、能回溯的專案。在程式檔裡正常打字，幾秒後應出現灰色內嵌補全；Tab 接受，Esc 拒絕。若沒有建議，看狀態列是否 Connected 與免費配額。

  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 管理員配置。個人 Builder ID 不需要。搞混會導致 SSO 失敗。

03

始終沒有內嵌建議

檢查檔案類型、Amazon Q 連線狀態與免費層限額。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 角色。
免費層有上限
個人 Builder ID 在免費檔有建議與聊天用量限制。超額需 Pro 或組織 IAM Identity Center。
教程頁不是會議說明書
只講 Amazon Q 第一次。短會白板見 wbmeet 與 對照筆記。

還想核對的問題

一定要 AWS 帳戶才能用嗎？

個人免費路徑不需要完整 AWS 帳戶，用 AWS Builder ID 即可。公司 Pro 走 IAM Identity Center。

能用 IAM 使用者的 Access Key 登入嗎？

不能。IDE 內 Amazon Q 不支援 IAM 主體或 IAM 角色直登。請用 Builder ID 或 IAM Identity Center SSO。

內嵌建議和聊天有什麼區別？

內嵌建議在打字時出現灰色補全，Tab 接受。聊天在活動列面板，適合解釋程式與提問。

第一個任務必須改正式環境程式嗎？

不必。先問唯讀問題或試內嵌補全，確認連通後再做可回溯的改動。

免費開始開會