Skip to content

Use Claude Desktop with amazee.ai

Claude Desktop is Anthropic's native desktop app for macOS and Windows. You can route it through amazee.ai by configuring it as a custom OpenAI-compatible provider — keeping your conversations processed in your chosen region.

Prerequisites

Configuration

Claude Desktop reads its configuration from a JSON file.

Locate the config file

=== "macOS"

```
~/Library/Application Support/Claude/claude_desktop_config.json
```

=== "Windows"

```
%APPDATA%\Claude\claude_desktop_config.json
```

Edit the config

Open the file (create it if it doesn't exist) and add an openai provider block:

{
  "openai": {
    "baseUrl": "https://llm.[your-region].amazee.ai/v1",
    "apiKey": "your-api-key-here"
  }
}

Replace [your-region] with your actual endpoint from my.amazee.io.

Restart Claude Desktop

Quit and reopen the app. Your amazee.ai models will appear in the model selector.

Available models

See Available Models for the full list. Use the model ID exactly as shown (e.g. claude-sonnet-4-5).

Troubleshooting

Models not showing up : Verify the baseUrl ends in /v1 and the apiKey is correct. Check the Claude Desktop logs for connection errors.

"Unauthorized" error : Confirm your key is active in my.amazee.io → Keys.

Requests going to Anthropic : If you're logged in to Claude Desktop with an Anthropic account, log out from the app's account settings before testing the custom provider.