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

要开始通过 JetBrains Gateway 使用 CodeCatalyst，请完成以下操作。

**Topics**
+ [安装 JetBrains Gateway](#codecatalyst-setup-jbgateway)
+ [安装适用于 JetBrains Gateway 的 AWS Toolkit](#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 分配：
+ [适用于 Linux 的 JetBrains Gateway](https://download.jetbrains.com/product?code=GW&latest&distribution=linux)
+ [适用于 Windows 的 JetBrains Gateway]( https://download.jetbrains.com/product?code=GW&latest&distribution=windows)
+ [适用于 macOS 的 JetBrains Gateway](https://download.jetbrains.com/product?code=GW&latest&distribution=mac)
+ [适用于 macOS Apple Silicon 的 JetBrains Gateway](https://download.jetbrains.com/product?code=GW&latest&distribution=macM1)

## 安装适用于 JetBrains Gateway 的 AWS Toolkit
<a name="codecatalyst-setup-toolkit"></a>

要将 JetBrains 与您的 CodeCatalyst 账户连接，必须安装最新版本的工具包扩展。您可以直接从 JetBrains **插件市场**中找到最新版本，并完成工具包的安装。

要通过 JetBrains **插件市场**安装 AWS Toolkit 插件，请完成以下步骤：

1. 在 JetBrains Gateway 主屏幕中，选择位于应用程序左下角的**设置/首选项**图标。

1. 选择**设置/首选项**，以打开**设置/首选项**视图。

1. 在**设置/首选项**视图中，选择**插件**以打开**插件**视图。
**注意**  
打开**插件**视图时，可能会显示**市场**视图或**已安装**视图。  
如果这是您第一次安装适用于 JetBrains Gateway 的 AWS Toolkit，请选择**插件市场**视图以继续。
如果您以前安装过适用于 JetBrains Gateway 的 AWS Toolkit 的某个版本，请从**已安装**视图对其进行更新。

1. 在**市场**视图中，输入文本 `AWS Toolkit`，然后选择显示的 **AWS Toolkit** 插件条目。

1. 选择**安装**，以下载并安装**适用于 JetBrains Gateway 的 AWS Toolkit**。
**注意**  
JetBrains Gateway 会显示下载状态和安装进度。成功安装工具包后，JetBrains Gateway **连接**资源管理器会更新为 **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[https://docs.aws.amazon.com/codecatalyst/latest/userguide/setting-up-topnode.html](https://docs.aws.amazon.com/codecatalyst/latest/userguide/setting-up-topnode.html) User Guide》中的 *Setting up CodeCatalyst* 部分。

**注意**  
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 与您的 CodeCatalys 账户连接，请完成以下步骤。

1. 在 JetBrains Gateway **连接**资源管理器中，选择 **Amazon CodeCatalyst** 插件，以打开 **Amazon CodeCatalyst** 插件视图。

1. 在 **CodeCatalyst** 插件视图中，选择**使用 AWS Builder ID 登录**，以打开**需要 AWS 登录**提示。

1. 在**需要 AWS 登录**提示中，选择**打开浏览器**，以在您的首选 Web 浏览器中打开 CodeCatalyst 控制台登录屏幕。

1. 将 AWS Builder ID 输入到提供的字段中，然后按照说明继续操作。

1. 出现提示时，选择**允许**以确认 JetBrains 和 CodeCatalyst 账户之间的连接。连接过程完成时，CodeCatalyst 会显示一条确认信息，表明可以安全地关闭浏览器。

1. 在 JetBrains Gateway 中，**CodeCatalyst** 插件视图已更新为**开发环境**视图。