To set up the AWS CLI for CodeCatalyst

1. Install the latest version of the AWS CLI. If you already have a version of the AWS CLI installed, make sure that it is recent and includes commands for CodeCatalyst, and update it if needed. To verify that you have a version installed that includes CodeCatalyst commands, open a command prompt and run the following command:

   aws codecatalyst help

   If you see a list of CodeCatalyst commands, you have a version that supports CodeCatalyst. If the command is not recognized, update your version of the AWS CLI to the latest version. For more information, see Installing or updating the latest version of the AWS CLI in the AWS Command Line Interface User Guide.

2. Run the aws configure command to create a profile if you don't have one or if you want to use a named profile specifically for CodeCatalyst. We recommend creating a named profile to use specifically with CodeCatalyst, but you can also use the default profile. For more information, see Configuration basics.

3. Edit the config file for the profile to add a section for connecting to CodeCatalyst as follows. The config file is located at ~/.aws/config on Linux or macOS, or at C:\Users\USERNAME\.aws\config on Windows.

   [profile codecatalyst]
   region = us-west-2
   sso_session = codecatalyst
   
   [sso-session codecatalyst]
   sso_region = us-east-1
   sso_start_url = https://view.awsapps.com/start
   sso_registration_scopes = codecatalyst:read_write

4. Save the file.

5. Before attempting to run any CodeCatalyst commands, open a new terminal or command prompt and run the following command to request and retrieve credentials to run aws codecatalyst commands. Replace codecatalyst with the name of your profile if needed.

   aws sso login --profile codecatalyst