# 開始使用 CodeCatalyst 和 AWS Toolkit for JetBrains
<a name="codecatalyst-setup"></a>

若要從 JetBrains Gateway 開始使用 CodeCatalyst ，請完成以下操作。

**Topics**
+ [安裝 JetBrains Gateway](#codecatalyst-setup-jbgateway)
+ [安裝 AWS Toolkit for JetBrains Gateway](#codecatalyst-setup-toolkit)
+ [建立 CodeCatalyst 帳戶和 AWS Builder ID](#codecatalyst-setup-id)
+ [連接 JetBrains Gateway 與 CodeCatalyst](#codecatalyst-setup-connect)

## 安裝 JetBrains Gateway
<a name="codecatalyst-setup-jbgateway"></a>

在整合 AWS Toolkit 與您的 CodeCatalyst 帳戶之前，請確定您使用的是最新版的 JetBrains Gateway。若要下載最新版的 JetBrains Gateway，請從以下連結中選擇您想要的 JetBrains Gateway 發行版本：
+ [JetBrains Gateway for Linux](https://download.jetbrains.com/product?code=GW&latest&distribution=linux)
+ [JetBrains Gateway for Windows]( https://download.jetbrains.com/product?code=GW&latest&distribution=windows)
+ [JetBrains Gateway for macOS](https://download.jetbrains.com/product?code=GW&latest&distribution=mac)
+ [JetBrains Gateway for macOS Apple Silicon](https://download.jetbrains.com/product?code=GW&latest&distribution=macM1)

## 安裝 AWS Toolkit for JetBrains Gateway
<a name="codecatalyst-setup-toolkit"></a>

若要連接 JetBrains 與您的 CodeCatalyst 帳戶，您必須安裝最新版的工具組擴充功能。您可以直接從 JetBrains **Plugins Marketplac** 找到最新版本並完成安裝工具組。

若要從 JetBrains **Plugins Marketplac** 安裝 AWS Toolkit 外掛程式，請完成下列步驟：

1. 在 JetBrains Gateway 主畫面中，選擇**設定/偏好設定**圖示 (位於應用程式左下角)。

1. 選擇**設定/偏好設定**來開啟**設定/偏好設定**檢視。

1. 在**設定/偏好設定**檢視中，選擇**外掛程式**來開啟**外掛程式**檢視。
**注意**  
**外掛程式**檢視可以在 **Marketplace** 檢視或**已安裝**檢視中開啟。  
如果這是您第一次安裝 AWS Toolkit for JetBrains Gateway，請選取 **Plugins Marketplac** 檢視以繼續。
如果您使用的是舊版 AWS Toolkit for JetBrains Gateway，請從**已安裝**檢視更新。

1. 在 **Marketplace** 檢視中，輸入 `AWS Toolkit` 文字並選擇顯示的 **AWS Toolkit** 外掛程式項目。

1. 選擇**安裝**下載並安裝 **AWS Toolkit for JetBrains Gateway**。
**注意**  
JetBrains Gateway 會顯示您的下載和安裝進度狀態。成功安裝工具組後，JetBrains Gateway **連線** Explorer 會更新以顯示 **Amazon CodeCatalyst** 外掛程式圖示。

## 建立 CodeCatalyst 帳戶和 AWS Builder ID
<a name="codecatalyst-setup-id"></a>

除了安裝最新版的 AWS Toolkit for JetBrains，您還必須具備有效的 AWS Builder ID 和 CodeCatalyst 帳戶，才能與 JetBrains Gateway 連線。如果您沒有有效的 AWS Builder ID 或 CodeCatalyst 帳戶，請參閱《CodeCatalyst 使用者手冊》**中的[設定 CodeCatalyst](https://docs.aws.amazon.com/codecatalyst/latest/userguide/setting-up-topnode.html)一節。

**注意**  
AWS Builder ID 與您的 AWS 憑證不同。AWS可從 AWS Toolkit 存取的大部分 AWS 服務 都需要憑證。若要建立新的 CodeCatalyst 帳戶，並透過現有的 CodeCatalyst 帳戶使用，需要 AWS Builder ID。包括使用可從 AWS Toolkit 存取的所有 CodeCatalyst 功能。

## 連接 JetBrains Gateway 與 CodeCatalyst
<a name="codecatalyst-setup-connect"></a>

若要連接 JetBrains Gateway 和您的 CodeCatalyst 帳戶，請完成下列步驟。

1. 在 JetBrains Gateway **連線** Explorer 中，選擇 **Amazon CodeCatalyst** 外掛程式來打開 **Amazon CodeCatalyst** 外掛程式檢視。

1. 在 **CodeCatalyst** 外掛程式檢視中，選擇**以 AWS Builder ID 登入**來開啟**需登入 AWS** 提示訊息。

1. 在**需登入 AWS** 提示訊息中，選擇**開啟瀏覽器**，在您偏好的網頁瀏覽器中開啟 CodeCatalyst 主控台登入畫面。

1. 在提供的欄位中輸入您的 AWS Builder ID，然後按照說明繼續操作。

1. 出現提示訊息時，選擇**允許**以確認 JetBrains 和 CodeCatalyst 帳戶之間的連線。連線程序完成後，CodeCatalyst 會顯示確認訊息，說明您可以安全關閉瀏覽器。

1. 在 JetBrains Gateway 中，** CodeCatalyst** 外掛程式檢視會更新為**開發環境**檢視。