本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 IDE 中安裝 Amazon Q Developer 延伸模組或外掛程式
若要在整合式開發環境 (IDE) 中設定 Amazon Q Developer，請完成下列步驟。安裝 Amazon Q 延伸模組或外掛程式後，透過 IAM Identity Center 或 AWS 建構家 ID進行身分驗證。您可以使用 Builder ID 驗證，免費使用 Amazon Q，無需 AWS 帳戶。
若要開始使用，請下載適用您 IDE 的 Amazon Q 延伸模組或外掛程式：
+ [下載適用於 Eclipse 的 Amazon Q](https://marketplace.eclipse.org/content/amazon-q)
+ [下載適用於 Visual Studio Code 的 Amazon Q](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.amazon-q-vscode)
+ [下載適用於 JetBrains IDE 的 Amazon Q](https://plugins.jetbrains.com/plugin/24267-amazon-q/)
+ [在 中下載 Amazon Q AWS Toolkit for Visual Studio](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.AWSToolkitforVisualStudio2022)
**注意**
一般而言，透過 IAM Identity Center 進行身分驗證的工作階段，其預設持續期間為 8 小時。不過，在 Amazon Q 中，預設工作階段會持續 90 天 (如果您是在 2024 年 4 月 18 日以後設定 IAM Identity Center)。如需詳細資訊，請參閱《AWS IAM Identity Center 使用者指南》**中的[如何在 IDE 中延長 Amazon Q 工作階段的持續期間](https://docs.aws.amazon.com/singlesignon/latest/userguide/configure-user-session.html#90-day-extended-session-duration)
若要登入並進行身分驗證，請完成本節中的步驟。
**Topics**
+ [先決條件：支援的 IDE 版本](#q-in-IDE-setup-prereqs)
+ [在 Eclipse IDE 中進行身分驗證](#setup-eclipse)
+ [在 JetBrains IDE 中進行身分驗證](#setup-jetbrains)
+ [在 Visual Studio Code 中進行身分驗證](#setup-vscode)
+ [在 Visual Studio 中進行身分驗證](#setup-vs)
+ [在 AWS 主控台中使用 IAM 主體](#q-no-IAM-in-IDEs)
## 先決條件：支援的 IDE 版本
+ Amazon Q 支援的最低 Eclipse 版本為 2024-06 (4.32)。
+ Amazon Q JetBrains 支援的 IDEs 最低版本 （包括 IntelliJ和 PyCharm) 為 2024.3。
+ Amazon Q 支援的最低 Visual Studio Code 版本為 1.85.0。
+ Amazon Q 僅支援適用於 Windows 的 Visual Studio。支援的最低 Visual Studio 版本為 Visual Studio 2022 17.7 版。所有 Visual Studio 2022 版本都可支援。
## 在 Eclipse IDE 中進行身分驗證
您可以使用 AWS 建構家 ID 或透過 Amazon Q Developer Pro 訂閱的 IAM Identity Center 免費進行身分驗證。選擇您的身分驗證方法，以查看在 Eclipse 中開始使用 Amazon Q 的步驟。
------
#### [ Builder ID ]
此程序不會要求您擁有建構家 ID。如果您尚未註冊建構家 ID，您將有機會在登入過程中註冊。
1. 在 Eclipse 中安裝 [Amazon Q 外掛程式](https://marketplace.eclipse.org/content/amazon-q)。
1. 在 IDE 右上角選擇 Amazon Q 圖示。
1. Amazon Q 索引標籤會在 IDE 底部開啟。在**選擇登入選項**下，選擇**個人帳戶**，然後選擇**繼續**。系統會將您重新導向至瀏覽器。
1. 依照瀏覽器中的指示，使用建構家 ID 進行身分驗證。完成身分驗證後，返回 Eclipse IDE。
1. 若要開始使用 Amazon Q，請選擇 Amazon Q 圖示以開啟 Amazon Q 聊天面板。
------
#### [ IAM Identity Center ]
開始此程序之前，您的管理員應已完成下列操作：
+ 在 IAM Identity Center 中為您建立身分
+ 讓該身分訂閱 Amazon Q Developer 專業方案
您的身分訂閱 Amazon Q Developer 專業方案之後，請完成以下步驟進行身分驗證：
1. 在 Eclipse 中安裝 [Amazon Q 外掛程式](https://marketplace.eclipse.org/content/amazon-q)。
1. 在 IDE 右上角選擇 Amazon Q 圖示。
1. Amazon Q 索引標籤會在 IDE 底部開啟。在**選擇登入選項**下，選擇**公司帳戶**，然後選擇**繼續**。
1. 輸入管理員從 [Amazon Q 訂閱主控台](manage-account-details.md)取得的**啟動 URL**。
1. 選擇管理員在 AWS 區域 其中設定 [IAM Identity Center 執行個體](https://docs.aws.amazon.com/singlesignon/latest/userguide/identity-center-instances.html)的 。
1. 選擇**繼續**。系統會將您重新導向至瀏覽器。
1. 依照瀏覽器中的指示，使用 IAM Identity Center 進行身分驗證。完成身分驗證後，返回 Eclipse IDE。
1. 若要開始使用 Amazon Q，請選擇 Amazon Q 圖示以開啟 Amazon Q 聊天面板。
------
## 在 JetBrains IDE 中進行身分驗證
您可以使用 AWS 建構家 ID 或透過 Amazon Q Developer Pro 訂閱的 IAM Identity Center 免費進行身分驗證。選擇您的身分驗證方法，以查看在 JetBrains IDE 中開始使用 Amazon Q 的步驟。
------
#### [ Builder ID ]
此程序不會要求您擁有建構家 ID。如果您尚未註冊建構家 ID，您將有機會在登入過程中註冊。
1. 在 JetBrains IDE 中安裝 [Amazon Q 外掛程式](https://plugins.jetbrains.com/plugin/24267-amazon-q/)。
1. 在 IDE 中選擇 Amazon Q 圖示。
根據預設，此圖示位於介面一側。
1. 依照瀏覽器中的指示，使用建構家 ID 進行身分驗證。
1. 若要開始使用 Amazon Q，請選擇 Amazon Q 圖示以便與 Amazon Q 聊天，或從 IDE 底部的導覽列中選擇 **Amazon Q**。
------
#### [ IAM Identity Center ]
開始此程序之前，您的管理員應已完成下列操作：
+ 在 IAM Identity Center 中為您建立身分
+ 讓該身分訂閱 Amazon Q Developer 專業方案
您的身分訂閱 Amazon Q Developer 專業方案之後，請完成以下步驟進行身分驗證：
1. 在 JetBrains IDE 中安裝 [Amazon Q 外掛程式](https://plugins.jetbrains.com/plugin/24267-amazon-q/)。
1. 在 IDE 中選擇 Amazon Q 圖示。
根據預設，此圖示位於介面一側。
1. 選擇**公司帳戶**。
1. 提供管理員從 [Amazon Q 訂閱主控台](manage-account-details.md)取得的**啟動 URL**。
1. 提供管理員在 AWS 區域 其中設定 IAM Identity Center [執行個體](https://docs.aws.amazon.com/singlesignon/latest/userguide/identity-center-instances.html)的 。
1. 選擇**繼續**。焦點將切換到您的 Web 瀏覽器。
1. 依照瀏覽器中的指示，使用 IAM Identity Center 進行身分驗證，然後返回 IDE。
1. 如果您的管理員已設定多個 Amazon Q Developer 設定檔，您將會看到您有權存取的設定檔。選擇符合您目前工作需求的設定檔，或管理員指示您使用的設定檔。如需設定檔的詳細資訊，請參閱[什麼是 Amazon Q Developer 設定檔？](subscribe-understanding-profile.md)。
如果只有一個設定檔可用，則會自動選擇該設定檔，而且您可以開始使用 Amazon Q。
若要變更 Amazon Q Developer 設定檔，請從 IDE 底部選擇 **Amazon Q**，然後選擇**變更設定檔**。在出現的視窗中，選擇您要使用的設定檔。
1. 若要開始使用 Amazon Q，請選擇 Amazon Q 圖示以便與 Amazon Q 聊天，或從 IDE 底部的導覽列中選擇 **Amazon Q**。
------
## 在 Visual Studio Code 中進行身分驗證
您可以使用 AWS 建構家 ID 或透過 Amazon Q Developer Pro 訂閱的 IAM Identity Center 免費進行身分驗證。選擇您的身分驗證方法，以查看在 VS Code 中開始使用 Amazon Q 的步驟。
------
#### [ Builder ID ]
此程序不會要求您擁有建構家 ID。如果您尚未註冊建構家 ID，您將有機會在登入過程中註冊。
1. 在 VS Code 中安裝 [Amazon Q 延伸模組](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.amazon-q-vscode)。
1. 在 IDE 中選擇 Amazon Q 圖示。
根據預設，此圖示位於介面一側。
1. 依照瀏覽器中的指示，使用建構家 ID 進行身分驗證。
1. 若要開始使用 Amazon Q，請選擇 Amazon Q 圖示以便與 Amazon Q 聊天，或從 IDE 底部的導覽列中選擇 **Amazon Q**。
------
#### [ IAM Identity Center ]
開始此程序之前，您的管理員應已完成下列操作：
+ 在 IAM Identity Center 中為您建立身分
+ 讓該身分訂閱 Amazon Q Developer 專業方案
您的身分訂閱 Amazon Q Developer 專業方案之後，請完成以下步驟進行身分驗證：
1. 在 VS Code 中安裝 [Amazon Q 延伸模組](https://marketplace.visualstudio.com/items?itemName=AmazonWebServices.amazon-q-vscode)。
1. 在 IDE 中選擇 Amazon Q 圖示。
根據預設，此圖示位於介面一側。
1. 選擇**公司帳戶**。
1. 提供管理員從 [Amazon Q 訂閱主控台](manage-account-details.md)取得的**啟動 URL**。
1. 提供管理員在 AWS 區域 其中設定 IAM Identity Center [執行個體](https://docs.aws.amazon.com/singlesignon/latest/userguide/identity-center-instances.html)的 。
1. 選擇**繼續**。焦點將切換到您的 Web 瀏覽器。
1. 依照瀏覽器中的指示，使用 IAM Identity Center 進行身分驗證，然後返回 IDE。
1. 如果您的管理員已設定多個 Amazon Q Developer 設定檔，您將會看到您有權存取的設定檔。選擇符合您目前工作需求的設定檔，或管理員指示您使用的設定檔。如需設定檔的詳細資訊，請參閱[什麼是 Amazon Q Developer 設定檔？](subscribe-understanding-profile.md)。
如果只有一個設定檔可用，則會自動選擇該設定檔，而且您可以開始使用 Amazon Q。
若要變更 Amazon Q Developer 設定檔，請從 IDE 底部選擇 **Amazon Q**，然後選擇**變更設定檔**。從命令面板選擇您要使用的設定檔。
1. 若要開始使用 Amazon Q，請選擇 Amazon Q 圖示以便與 Amazon Q 聊天，或從 IDE 底部的導覽列中選擇 **Amazon Q**。
------
## 在 Visual Studio 中進行身分驗證
若要從 Toolkit for Visual Studio 連線至 AWS 您的帳戶，請完成下列程序，開啟 ** AWS Toolkit 使用者介面 （連線 UI) 入門**。
1. 在 Visual Studio 主功能表中，展開**延伸模組**，然後展開 **AWS Toolkit**。
1. 從 **AWS Toolkit** 功能表選項選擇**開始使用**。
1. ** AWS 工具組連線 UI 入門會在** Visual Studio 中開啟。
您可以使用 AWS 建構家 ID 或透過 Amazon Q Developer Pro 訂閱的 IAM Identity Center 免費進行身分驗證。選擇您的身分驗證方法，以查看在 Visual Studio 中開始使用 Amazon Q 的步驟。
------
#### [ Builder ID ]
1. 從 Visual Studio 的主要功能表展開**延伸模組**，然後展開 **AWS Toolkit** 子功能表。
1. 選擇 **Getting started (入門)**。**開始使用**索引標籤會在 Visual Studio 編輯器視窗中開啟。
1. 在 **Amazon Q** 區段中，選擇**啟用**。
1. 在**免費方案**區段中，選擇**註冊或登入**按鈕。
1. 確認您想要在預設 Web 瀏覽器中開啟 AWS 授權請求入口網站。
1. 依照預設 Web 瀏覽器中的提示進行。授權程序完成後，您會收到通知，然後您就能安全地關閉瀏覽器並返回 Visual Studio。
------
#### [ IAM Identity Center ]
1. 從 Visual Studio 的主要功能表展開**延伸模組**，然後展開 **AWS Toolkit** 子功能表。
1. 選擇 **Getting started (入門)**。**開始使用**索引標籤會在 Visual Studio 編輯器視窗中開啟。
1. 在 **Amazon Q** 區段中，選擇**啟用**。您將填寫「專業方案」區段以進行身分驗證。
1. 憑證設定檔是由您公司或組織的管理員提供的設定檔名稱、啟動 URL、設定檔區域或 SSO 區域組成。如需 IAM Identity Center 憑證的詳細資訊，請參閱《IAM Identity Center 使用者指南》**中的[什麼是 IAM Identity Center？](https://docs.aws.amazon.com/singlesignon/latest/userguide/what-is.html)。
如果您有現有的憑證設定檔，請從專業方案面板中的下拉式功能表選擇該設定檔，然後選擇**連線**。
若要建立新的憑證設定檔，請在「專業方案」區段中填寫下列欄位：
1. 在**設定檔名稱**文字欄位中，輸入您要進行身分驗證的 IAM Identity Center 設定檔名稱。
1. 在**啟動 URL** 文字欄位中，輸入附加至 IAM Identity Center 憑證的啟動 URL。
1. 從**設定檔區域 （預設為 us-east-1)** 下拉式功能表中，選擇您要驗證 AWS 區域 之 IAM Identity Center 使用者設定檔定義的 。
1. 從 **SSO 區域 （預設為 us-east-1)** 下拉式功能表中，選擇 IAM Identity Center 登入資料定義的 **SSO 區域**，然後選擇**連線**按鈕以開啟**使用 AWS IAM Identity Center 登入**對話方塊。
1. 確認您想要在預設 Web 瀏覽器中開啟 AWS 授權請求入口網站。
1. 依照預設 Web 瀏覽器中的提示進行。授權程序完成後，您會收到通知，然後您就能安全地關閉瀏覽器並返回 Visual Studio。
1. **登入 Amazon Q** 視窗隨即出現。在憑證設定檔下拉式功能表中，選擇您在先前步驟中用來進行身分驗證的設定檔。
1. 如果您的管理員已設定多個 Amazon Q Developer 設定檔，則系統會提示您從下拉式功能表中選擇 Q Developer 設定檔。選擇符合您目前工作需求的設定檔，或管理員指示您使用的設定檔。如需設定檔的詳細資訊，請參閱[什麼是 Amazon Q Developer 設定檔？](subscribe-understanding-profile.md)。
如果只有一個設定檔可用，則會自動選擇該設定檔，而且您可以開始使用 Amazon Q。
若要變更 Amazon Q Developer 設定檔，請從 IDE 底部選擇 **Amazon Q**，然後選擇**變更 Q Developer 設定檔**。在出現的視窗中，選擇您要使用的設定檔。
您也可以藉由選擇聊天視窗右上角的溢位功能表，然後選擇**變更 Q Developer 設定檔**的方式來變更設定檔。
------
如需在 Toolkit for Visual Studio 中進行身分驗證的詳細資訊，請參閱《AWS Toolkit for Visual Studio 使用者指南》**中的[開始使用](https://docs.aws.amazon.com/toolkit-for-visual-studio/latest/user-guide/getting-set-up.html)。
## 在 AWS 主控台中使用 IAM 主體
視您的使用方式而定 AWS，您可能習慣使用 IAM 登入資料來登入 主控台以取得所有 AWS 服務。不過，您無法在 IDE 中使用 Amazon Q Developer 作為 IAM 主體，或搭配 IAM 角色使用。您必須使用來自 IAM Identity Center 的憑證或建構家 ID 進行身分驗證。