AWS Logo
Menu
Use Claude Code with Amazon Bedrock

Use Claude Code with Amazon Bedrock

Setting up Claude Code with Amazon Bedrock

amazonbedrockclaudecodeanthropic-claude
Gopinath Srinivasan
Amazon Employee
Published May 27, 2025

Use Claude Code with Amazon Bedrock

Amazon Bedrock is a fully managed service that offers a choice of high-performing foundation models (FMs) from leading AI companies like AI21 Labs, Anthropic, Cohere, DeepSeek, Luma, Meta, Mistral AI, , Stability AI, and Amazon through a single API, along with a broad set of capabilities you need to build generative AI applications with security, privacy, and responsible AI. Claude Code is an AI-powered coding assistant that helps you write, understand, and maintain code directly from your terminal. This guide will walk you through setting up Claude Code on your desktop using Amazon Bedrock.

Prerequisites

Before we begin, make sure you have the following installed on your system:
  1. Node.js (LTS version) - Required to run Claude Code
  2. AWS CLI - For configuring AWS credentials
  3. AWS Account with Bedrock Access - You'll need an AWS account with access to Amazon Bedrock services
Note: If you have a the above prerequisites set up already, please proceed step 5 directly.

Step 1: Install Node.js and AWS CLI

If you have it already set up, please proceed to step # 2.

Install Node.js

For macOS:

For Windows:

Download and install the LTS version from the official Node.js website

For Linux (Ubuntu/Debian):

Install AWS CLI

For macOS:

For Windows:

Download and run the installer from the AWS CLI website

For Linux (Ubuntu/Debian):

Step 2: Configure AWS Access for Bedrock

  1. Set up an AWS account - If you don't have one already Visit the AWS sign-up page
  2. Create an IAM user or role with permissions for Amazon Bedrock
    • Sign in to the AWS IAM console
    • Create a new user or role
    • Attach the AmazonBedrockFullAccess managed policy
  1. Configure AWS CLI with your credentials
    Enter your AWS Access Key ID and Secret Access Key
    • Set your default region (e.g., us-east-1)
    • Set your output format (e.g., json)

Step 3: Request Access to Bedrock Models

  1. Sign in to the AWS Management Console
  2. Navigate to the Amazon Bedrock console
  3. In the left navigation, select "Model access"
  4. Click "Manage model access"
  5. Select the Anthropic Claude models (specifically Claude 3 Sonnet)
  6. Click "Request access"
  7. Wait for access approval (usually quick for standard models)

Step 4: Create an Inference Profile (Optional)

Inference profiles help you track usage, monitor costs, and manage model access more effectively. For enhanced control:
  1. In the Amazon Bedrock console, go to "Inference profiles"
  2. Click "Create inference profile"
  3. Select Anthropic Claude as your model provider
  4. Choose the appropriate model version (Claude 3.7 Sonnet)
  5. Configure your profile settings (name, description, tags)
  6. Review and create the profile
For detailed instructions, refer to the AWS Bedrock documentation on creating inference profiles and using inference profiles with model invocation.

Step 5: Install Claude Code

Now that all prerequisites are in place, install Claude Code:

Step 6: Configure Claude Code for AWS Bedrock

Create a settings file to tell Claude Code to use AWS Bedrock:

Step 7: Validate Your Setup

Let's make sure everything is working correctly:
  • Verify Claude Code installation
Test basic functionality
Start Claude Code with Amazon Bedrock
You should see the Claude Code welcome screen, confirming that your setup is working properly with Amazon Bedrock:
Welcome Screen
Claude Welcome Screen
The welcome screen shows that Claude Code is running successfully. You can now use commands like /help to see available options, /status to check your current setup, and start asking questions about your codebase or giving instructions to Claude directly in your terminal.

Troubleshooting

  • Authentication issues: Make sure your AWS credentials are correctly configured using aws configure
  • Permission errors: Verify your IAM user has the appropriate Bedrock permissions
  • Model access: Ensure your account has been granted access to the requested Anthropic Claude model
  • Region mismatch: Make sure the region in your AWS config matches where Bedrock is available

Conclusion

You've successfully set up Claude Code to work with Amazon Bedrock on your desktop! This integration provides several advantages:
  • Enhanced security: Your code data never leaves your AWS environment
  • Compliance: Helps meet regulatory requirements for sensitive development
  • Enterprise administration: Centralized management of AI resources
  • Cost control: Consolidated billing through your AWS account
Now you can use Claude Code for a wide range of tasks, including:
  • Understanding complex codebases
  • Writing new code and features
  • Fixing bugs and issues
  • Managing git repositories
  • Reviewing documentation
For more information, check out the official Claude Code documentation and AWS Bedrock documentation.
 

Any opinions in this post are those of the individual author and may not reflect the opinions of AWS.

2 Comments