Set up Claude Desktop
This guide shows you how to set up the Claude desktop app for third-party (3P) inference through Amazon Bedrock, so credentials and usage stay in your AWS account instead of an Anthropic consumer account.
You need to have requested access to an AWS account in order to use this tool, which means you will have needed to complete your state cybersecurity training.
Before you begin
Section titled “Before you begin”Confirm:
- You know which AWS account will fund your work:
Innov-Devfor BizXInnov-RES-Devfor ResX engineeringInnov-RES-Sandboxfor ResX product, content, or design work
- You have a budget in mind for your AI spend on that account.
If you’re looking for the analogous CLI setups instead, see Configure Claude Code or Configure Codex.
Step 1: Open a Platform Access ticket
Section titled “Step 1: Open a Platform Access ticket”Go to newjersey/internal-ops, scroll down to Platform Access, and click it to open a new ticket. In the ticket:
- Identify the AWS account that will support your work (see Before you begin).
- Give yourself a budget for AI spend.
Step 2: Install Homebrew and Claude Desktop
Section titled “Step 2: Install Homebrew and Claude Desktop”While your access request is pending, install Homebrew and Claude Desktop through its Homebrew cask:
brew install --cask claudeStep 3: Set up AWS SSO
Section titled “Step 3: Set up AWS SSO”Complete
Set up AWS CLI with SSO
to authenticate to AWS. Name your profile after the AWS account you selected
in Step 1 (e.g. Innov-RES-Dev), per the profile-naming guidance in that
guide.
Verify you can authenticate before continuing:
aws sts get-caller-identity --profile <your-profile>Step 4: Install the managed configuration profile
Section titled “Step 4: Install the managed configuration profile”Once your AWS access is provisioned, the Tech Ops team will share a
.mobileconfig file (macOS) or .reg file (Windows) with you. This profile
points Claude Desktop at Amazon Bedrock using the provider, endpoint, and
credential values for your AWS account.
Daily use
Section titled “Daily use”Each day you want to use Claude Desktop:
- Open a terminal and re-authenticate:
aws sso login --profile <your-profile>. - Open the Claude desktop app and confirm it can communicate with AWS (send a test message).
For AWS SSO issues (login failures, missing config values, expired sessions), see Set up AWS CLI with SSO: Troubleshooting.
Reporting usage
Section titled “Reporting usage”- Each day, report your Claude usage to a spreadsheet you keep for this purpose.
- Each month, share your total usage and your budget (set in Step 1) with the finance team.
Sources
Section titled “Sources”For installing and using Claude Desktop on 3P, see Anthropic’s documentation:
