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 が AmazonWebServices.amazon-q-vscode として公開。個人無料は AWS Builder ID(個人プロファイル、完全な AWS アカウント不要、ブラウザでメールまたは Google)。会社の Amazon Q Developer Pro は Company account で、管理者の IAM Identity Center Start URL と AWS Region でブラウザ SSO。
最初の一時間:入れて、ログインして、提案かチャット
- 1
Marketplace から 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
ログイン方法を選びブラウザで認証
Amazon Q アイコンをクリック。個人は Builder ID でブラウザに AWS Builder ID を作成/ログイン(メールまたは Google)。会社 Pro は Company account、Start URL と Region を入力、Continue、ブラウザで SSO 完了。IAM Access Key は貼らない。
- 3
自分のリポジトリを開きインライン提案を確認
File → Open Folder。ソースファイルで普通に入力。数秒後に灰色のインライン補完。
Tabで承認、Escで拒否。出ない場合は接続状態と無料枠を確認。 - 4
チャットで最初の質問
Amazon Q チャットを開く。読み取り専用から:「このリポジトリのエントリはどこ?」秘密情報や本番接続文字列は貼らない。最初の一時間は提案とチャットの応答確認が目的。
# 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 認証 |
| 会社 Pro | IAM Identity Center + Start URL + Region | 管理者から URL とリージョン |
| 非対応 | IDE で IAM ユーザー/ロール直ログイン | Access Key を貼らない |
| インライン提案 | 入力中のゴーストテキスト、Tab で承認 | 認証と無料枠を先に確認 |
| チャット | アクティビティバーの Amazon Q | 最初は読み取り専用の質問 |
インストール後ログインがループ
ブラウザのポップアップブロックや Builder ID の未確認メールが多い。外部リンクを許可し、既定ブラウザで完了。
会社アカウントで Start URL がない
Start URL と Region は IT 管理者が設定。個人 Builder ID には不要。混同すると SSO 失敗。
インライン提案が一切出ない
ファイル種別、Connected 状態、無料枠を確認。View → Output → Amazon Q。
公式 IDE セットアップ:Marketplace で Amazon Q → アクティビティバー → Builder ID または Company account → ブラウザ認証。料金は aws.amazon.com/q/developer/pricing。
- Builder ID ≠ AWS コンソールアカウント
- Builder ID は個人 IDE 用。管理コンソールや IAM ロールは不可。コンソールの Q は IAM Identity Center。
- 無料枠に上限
- 個人 Builder ID の無料枠は提案とチャットに上限。超過は Pro または組織の IAM Identity Center。
- 会議製品の手順書ではない
- Amazon Q の最初の一時間のみ。短い通話は wbmeet と 重い会議アプリを開かないとき。
確認したい質問
AWS アカウントは必須?
個人無料は AWS Builder ID で十分。会社 Pro は IAM Identity Center。
IAM ユーザーの Access Key でログインできる?
いいえ。IDE 内 Amazon Q は IAM 主体/ロール非対応。Builder ID または IAM Identity Center SSO。
インライン提案とチャットの違いは?
インラインは入力中のゴーストテキスト、Tab で承認。チャットはサイドパネルで説明や質問。
最初の作業は本番コード必須?
いいえ。読み取り専用の質問か小さなファイルで補完を試す。