Claude Desktop × AIHubMix Setup Guide

Documentation Index

Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt

Use this file to discover all available pages before exploring further.

Applies to: Claude Desktop 1.3883.0 (Updated: April 23, 2026)
Level: Beginner — no command line required, fully click-based, no Anthropic account needed

​

Introdução

• Não requer conta Anthropic — bypasses phone number / email registration restrictions
• Access to Claude, GPT, Gemini, DeepSeek, and more through a single AIHubMix key
• Pay-as-you-go billing, flexible and cost-controlled

​

Pré-requisitos

• Operating System: macOS 13.0 (Ventura) or later, or Windows 10 / 11
• AIHubMix Account: Register and top up at aihubmix.com

​

Passo 1: Get Your AIHubMix chave de API

1. Visit aihubmix.com and log in
2. Go to the console → chave de APIs page
3. Clique Create New Key, enter a name (e.g. claude-desktop)
4. Copy the generated key (format: sk-xxxxxxxxxxxxxxxx)

Security notice: The chave de API is only shown once. Save it somewhere safe immediately.

​

Passo 2: Download and Install Claude Desktop

1. Visit the official download page: claude.ai/download
2. Download the installer for your operating system

• Abra o downloaded .dmg file
• Drag Claude.app into the Applications folder
• Abra Claude from Launchpad or the Applications folder

• Run the downloaded .msix installer
• Follow the on-screen prompts to complete installation
• Abra Claude a partir do Start menu

Note: You do not need to log in to an Anthropic account after opening. Proceed directly to the next step.

​

Passo 3: Enable Developer Mode and Configure AIHubMix

1. Abra o Claude Desktop app
2. Clique Help no top menu bar
3. Selecione Troubleshooting
4. Clique Enable Developer mode
   
5. Once enabled, a new Developer menu will appear no top menu bar.

6. Clique Developer no menu bar, then selecione Configure third-party inference

7. Preencha o seguinte fields no configuration dialog:

https://aihubmix.com

sk-xxxxxxxxxxxxxxxx

8. Clique Apply locally → Relaunch

9. After restarting, selecione Continue with Gateway on the screen below

10. Configuration complete — selecione a model

Note: The default model is Claude Opus 4.7, which has higher pricing and can lead to significant costs for everyday use. Recomendamos switching to another model. AIHubMix offers a wide range of cost-effective and free models — view the full list at aihubmix.com/models.

​

Passo 4: Verify the Installation

• The Cowork tab appears no left navigation panel
• Você pode send messages and receive responses normally
• The model name shown no bottom-right corner matches your selection
  

​

Solução de Problemas

​

Error on Launch / Cannot Connect

1. Confirm the connection type is set to gateway (not bedrock / vertex)
2. Check that the Base URL is https://aihubmix.com (no trailing slash)
3. Verify a chave de API was copied in full (must start with sk-)
4. Certifique-se your AIHubMix account has sufficient balance

• macOS: Abra Console.app, filter by Claude
• Windows: Abra Event Viewer

​

Model Not Found Error

curl https://aihubmix.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

​

Which Auth Scheme Should I Use?

​

Advanced: Export Configuration File (Optional)

​

Recursos Relacionados

• AIHubMix Documentation
• AIHubMix Claude Native API Reference
• Claude Desktop Official Third-Party Platform Guide
• Claude Desktop Download Page