CLAUTH: An open-source CLI to simplify AWS Bedrock setup for Claude Code users

#python #aws #cli #ai

Working with Claude Code on AWS Bedrock should be straightforward, but in practice, the initial setup is confusing and scattered.

You have to configure your AWS environment in a very specific way for Claude Code to work. That means setting several environment variables correctly, selecting the right AWS region, and providing a valid Bedrock model ARN. None of this is clearly guided, and a single mistake often results in silent failures.

Finding the model ARN is another common pain point. You usually have to dig through AWS documentation or internal wikis to locate the right ARN for the model you want to use. And if you ever want to switch models, you need to repeat the process manually.

Even for experienced developers, this setup flow is clunky. For those who are less familiar with AWS, it can be a real blocker.

🛠 Introducing CLAUTH

👉 CLAUTH is an open-source Python CLI that automates and streamlines the setup.

It wraps the usual AWS + Claude configuration steps into a clean, interactive experience:

Configures AWS CLI (SSO or IAM) through a guided wizard. No memorizing steps
Writes environment variables and config for you automatically
Auto-discovers available Bedrock models at auth time, so you can pick from a list instead of hunting ARNs manually
Switches models instantly with a single command. No more re-exporting environment variables
Lets you delete and reset configuration cleanly if you ever want to start over

✨ Quick Demo

Here’s what the interactive setup looks like in action:

⚡️ Getting Started

Install the CLI from PyPI:

pip install clauth
clauth init

You’ll be guided through selecting a region, configuring SSO or IAM credentials, and choosing your preferred Bedrock model. Everything is stored in a clean AWS CLI profile so Claude Code can work out of the box.

🧠 Why I Built This

I ran into these pain points repeatedly while helping teams onboard onto Claude Code inside AWS environments. Setting up the right environment variables and ARNs was tedious and error-prone, especially for teams unfamiliar with Bedrock’s quirks.

CLAUTH started as a way to remove that friction. Over time, it evolved into a proper CLI with a focus on clean UX and consistency.