> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conecte modelos Claude ao Claude Desktop com a BetterToken

> Configure o provedor Claude da BetterToken no Gateway do Claude Desktop com Base URL e API Key.

Esta página aborda apenas a configuração direta do Claude Desktop para o **provedor Claude** da BetterToken. Informe sua BetterToken API Key, `https://www.bettertoken.ai` e `x-api-key` e reinicie o Claude Desktop.

## Configurações principais

| Campo    | Valor                        |
| -------- | ---------------------------- |
| API Key  | BetterToken API Key          |
| Base URL | `https://www.bettertoken.ai` |
| Modelo   | Modelo do provedor Claude    |

## Pré-requisitos

* <a href={"https://bettertoken.ai/register"}>Crie e copie uma BetterToken API Key</a>
* Confirme que a API Key pode usar modelos do provedor Claude

## Instalação

Instale ou atualize para a versão mais recente no [site do Claude Desktop](https://claude.ai/download) e inicie o Claude Desktop.

## Configuração manual

<Steps>
  <Step title="Ative o modo de desenvolvedor">
    No Claude Desktop, escolha **Help** → **Troubleshooting** → **Enable Developer Mode** na barra de menus do macOS.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/claude-desktop-llmeasy-api/enable-developer-mode-menu.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=88d5591c4fc6690a13b846df03f84991" alt="Opção Enable Developer Mode no menu Help do Claude Desktop." style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/claude-desktop-llmeasy-api/enable-developer-mode-menu.png" />
    </Frame>

    Clique em **Enable** na janela de confirmação e reinicie o Claude Desktop.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/developer-mode-confirm.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=ec60755e271216c1383bd7ec466c58db" alt="Confirmação do modo de desenvolvedor no Claude Desktop." style={{ borderRadius: '0.5rem' }} width="520" height="480" data-path="images/claude-desktop-llmeasy-api/developer-mode-confirm.png" />
    </Frame>
  </Step>

  <Step title="Abra as configurações de inferência de terceiros">
    Após reiniciar, escolha **Developer** → **Configure Third-Party Inference...** na barra de menus do macOS.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/claude-desktop-llmeasy-api/configure-third-party-inference.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=f4412369928fe11c78433578e0efa60a" alt="Opção Configure Third-Party Inference no menu Developer." style={{ borderRadius: '0.5rem' }} width="3840" height="2160" data-path="images/claude-desktop-llmeasy-api/configure-third-party-inference.png" />
    </Frame>
  </Step>

  <Step title="Informe as configurações de API da BetterToken">
    Selecione **Gateway** e informe:

    | Campo                   | Valor                        |
    | ----------------------- | ---------------------------- |
    | **Gateway base URL**    | `https://www.bettertoken.ai` |
    | **Gateway API key**     | Sua BetterToken API Key      |
    | **Gateway auth scheme** | `x-api-key`                  |

    O Claude Desktop busca os modelos Claude disponíveis após selecionar o esquema de autenticação. Clique em **Apply locally**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/ZMo3cJhJx4ISRrsG/images/claude-desktop-llmeasy-api/gateway-credentials.png?fit=max&auto=format&n=ZMo3cJhJx4ISRrsG&q=85&s=14951973725bde190ce650415e7b67f8" alt="Preenchimento de Gateway Base URL, API Key e esquema de autenticação da BetterToken no Claude Desktop." style={{ borderRadius: '0.5rem' }} width="1800" height="1440" data-path="images/claude-desktop-llmeasy-api/gateway-credentials.png" />
    </Frame>
  </Step>
</Steps>

## Teste a conexão

Clique em **Save & Restart**. Selecione **Continue with Gateway** e envie uma mensagem curta. A configuração está ativa quando **Gateway** aparece no canto inferior esquerdo e a mensagem recebe uma resposta normal.

<Frame>
  <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/claude-desktop-llmeasy-api/gateway-ready.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=292b7db7ffddbcb11be3312dda097997" alt="Claude Desktop aberto pelo Gateway da BetterToken e pronto para uso." style={{ borderRadius: '0.5rem' }} width="3840" height="2100" data-path="images/claude-desktop-llmeasy-api/gateway-ready.png" />
</Frame>

## Alterne entre modelos

Abra o seletor de modelos e escolha outro modelo Claude retornado pelo Gateway. Se ele não aparecer, abra novamente **Configure Third-Party Inference...**, clique em **Apply locally** e reinicie o Claude Desktop.

## Erros comuns

| Problema                      | Correção                                                                                       |
| ----------------------------- | ---------------------------------------------------------------------------------------------- |
| O Gateway não conecta         | Use exatamente `https://www.bettertoken.ai` em **Gateway base URL**. Não acrescente `/v1`.     |
| A solicitação retorna `401`   | Copie a BetterToken API Key novamente e confirme que o esquema é `x-api-key`.                  |
| Nenhum modelo Claude aparece  | Confirme que a API Key pode usar modelos do provedor Claude e abra novamente as configurações. |
| A configuração não é aplicada | Encerre completamente o Claude Desktop, abra-o novamente e escolha **Continue with Gateway**.  |

## Configuração avançada

Para usar GPT, Kimi, GLM ou outro provedor que não seja Claude no Claude Desktop, siga a [aba Claude Desktop no CC Switch](/pt-br/ai-tools/cc-switch#claude-desktop). O CC Switch gerencia API Format, mapeamento de modelos, proxy e reinicialização.

### Provedores compatíveis

| Provedor | Status                |
| -------- | --------------------- |
| Claude   | Configuração manual   |
| GPT      | Configuração avançada |
| Kimi     | Configuração avançada |
| GLM      | Configuração avançada |

<Note>Os status se aplicam ao método de configuração do BetterToken descrito nesta página.</Note>

<Accordion title="O que significa cada método de configuração">
  * **Configuração avançada**: instale o CC Switch e use um proxy local, conversão de protocolo ou mapeamento de modelos.
  * **Configuração manual**: informe a API Key, a Base URL e o Model.
</Accordion>

### Guias relacionados

* [Usar modelos de terceiros no Claude Desktop](/pt-br/faq/claude-desktop/third-party-models)
* [Configurar a BetterToken no CC Switch](/pt-br/ai-tools/cc-switch)
* [Configurar um provedor personalizado no Codex CLI](/pt-br/ai-tools/codex)
* [Baixar a versão mais recente do CC Switch](https://github.com/farion1231/cc-switch/releases)

## Detalhes técnicos

<Accordion title="Endpoint do Gateway e autenticação">
  Use `https://www.bettertoken.ai`, compatível com Anthropic, como **Gateway base URL**, sem `/v1`. Selecione `x-api-key` como esquema de autenticação.
</Accordion>