Setting up

The following sections describe the steps you need to take before using CodeWhisperer as a developer for the first time.

If you are an administrator who is setting up CodeWhisperer Professional for your organization, see Setting up Amazon CodeWhisperer for administrators.

Before you use CodeWhisperer for the first time, you must follow the following steps:

1. Choose your IDE.

2. Install or update your IDE (if applicable).

3. Install or update the AWS Toolkit (if applicable).

4. Choose your authentication method.

5. Set up your Builder ID, IAM Identity Center, or IAM credentials.

Choosing your IDE

CodeWhisperer acts as an enhancement to certain integrated development environments (IDEs). You can use it within any of the following services.

• Amazon SageMaker notebooks serve as an essential component of the SageMaker Studio interactive development environment, offering a managed JupyterLab environment to create, share, and collaborate on Jupyter notebooks. Designed to support machine learning workflows within AWS, Studio Notebooks provide built-in version control and collaboration functionalities. They facilitate integration with SageMaker and other AWS services, allowing users to build, train, and deploy models directly from their notebooks. Additionally, SageMaker Studio notebooks automatically scale underlying resources according to workload requirements, ensuring efficient resource utilization.

• JupyterLab is an IDE that allows you to work with data and code in a flexible, open-source platform. With JupyterLab, you can create and edit Jupyter notebooks, run code in various programming languages, and visualize and manipulate data using a range of libraries and tools. JupyterLab is widely used in data science, machine learning, and scientific research, and is supported by a vibrant community of contributors and users.

• The AWS Toolkit for Visual Studio Code is an open source plug-in for Visual Studio Code that makes it easier to create, debug, and deploy applications on Amazon Web Services. With the AWS Toolkit for Visual Studio Code, you will be able to get started faster and be more productive when building applications with Visual Studio Code on AWS. The toolkit provides an integrated experience for developing serverless applications, including assistance for getting started, ML-powered code recommendations, step-through debugging, and deploying from the IDE.

• The AWS Toolkit for JetBrains is an open source plug-in for the IDEs from JetBrains that makes it easier for developers to develop, debug, and deploy serverless applications that use Amazon Web Services. It includes features like credentials management and AWS Region management that simplify writing applications for Amazon Web Services.

• AWS Cloud9 is a cloud-based IDE that lets you write, run, and debug your code with just a browser. It includes a code editor, debugger, and terminal. AWS Cloud9 comes prepackaged with essential tools for popular programming languages, including JavaScript, Python, and PHP.

• AWS Lambda is a serverless, event-driven compute service that lets you run code for virtually any type of application or backend service without provisioning or managing servers. You can trigger Lambda from over 200 AWS services and software as a service (SaaS) applications, and only pay for what you use.

Installing or updating your IDE

To install VS Code for the first time, use the VS Code download page.

If you already have VS Code installed, update to the latest version as follows:

• On MacOS, choose Code -> Check for Updates.

• On Windows and Linux, choose Help -> Check for Updates.

To install JetBrains for the first time, use the JetBrains download page.

If you already have JetBrains installed, update to the latest version as follows:

• On MacOS, from the IDE's main dropdown menu, choose Check for Updates.

• On Windows and Linux, choose Help -> Check for Updates.

Installing the AWS Toolkit

In order to use CodeWhisperer with VS Code or JetBrains, you must first download and install the AWS Toolkit.

For information about installing the AWS Toolkit for VS Code, see Setting Up the AWS Toolkit for Visual Studio Code in the AWS Toolkit for Visual Studio Code user guide.

For information about installing the AWS Toolkit for JetBrains, see Setting Up the AWS Toolkit for JetBrains in the AWS Toolkit for JetBrains user guide.

Choosing your authentication method

If you plan to use CodeWhisperer with VS Code (through AWS Toolkit) or JetBrains (through AWS Toolkit), you will have to authenticate using either AWS Builder ID or IAM Identity Center.

If you plan to use CodeWhisperer with AWS Cloud9 AWS Lambda, SageMaker Studio, JupyterLab, or AWS Glue Studio, you will have to authenticate using IAM.

For information about authenticating with CodeWhisperer, see Authenticating with CodeWhisperer and AWS Toolkit.

Setting up your authentication method

Builder ID (used with AWS Toolkit and VS Code or JetBrains) requires only an email address. To use it, you don't even need an AWS account.

IAM Identity Center requires setup by your enterprise administrator.

IAM credentials are used within your AWS account to regulate access to, and between, various AWS services.

Get an AWS account and your root user credentials

To access AWS, you must sign up for an AWS account.

To sign up for an AWS account

1. Open https://portal.aws.amazon.com/billing/signup.

2. Follow the online instructions.

   Part of the sign-up procedure involves receiving a phone call and entering a verification code on the phone keypad.

   When you sign up for an AWS account, an AWS account root user is created. The root user has access to all AWS services and resources in the account. As a security best practice, assign administrative access to a user, and use only the root user to perform tasks that require root user access.

AWS sends you a confirmation email after the sign-up process is complete. At any time, you can view your current account activity and manage your account by going to https://aws.amazon.com/ and choosing My Account.