> ## 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.

# Configuração do TRAE: instalação, API Key, Base URL e modelos personalizados

> Instale o TRAE, configure a Base URL e a API Key da BetterToken, escolha um modelo compatível e corrija erros comuns.

Para conectar o TRAE à BetterToken, prepare uma API Key, informe a URL de solicitação abaixo e escolha um ID de modelo atual na model plaza.

## Configurações principais

| Campo                       | Valor                                                                     |
| --------------------------- | ------------------------------------------------------------------------- |
| API Key                     | BetterToken API Key                                                       |
| URL completa da solicitação | `https://www.bettertoken.ai/v1/chat/completions`                          |
| Modelo                      | Um ID atual da <a href={"https://bettertoken.ai/pricing"}>model plaza</a> |

## Pré-requisitos

* A versão atual da ferramenta está instalada
* Uma BetterToken API Key: <a href={"https://bettertoken.ai/register"}>cadastre-se e crie uma</a>
* Um ID de modelo da <a href={"https://bettertoken.ai/pricing"}>model plaza</a>

### Requisitos adicionais

## Instalação

Instale ou abra o TRAE e prossiga com a configuração manual abaixo.

## Configuração manual

| Campo                       | Valor                                                                     |
| --------------------------- | ------------------------------------------------------------------------- |
| API Key                     | BetterToken API Key                                                       |
| URL completa da solicitação | `https://www.bettertoken.ai/v1/chat/completions`                          |
| Modelo                      | Um ID atual da <a href={"https://bettertoken.ai/pricing"}>model plaza</a> |

### Configuração

<Steps>
  <Step title="Abra as configurações">
    No modo **IDE**, clique no ícone **Settings** no canto superior direito para abrir a central de configurações.

    Você também pode abrir o modo **SOLO** e clicar em **Settings** no canto superior direito do painel de chat.
  </Step>

  <Step title="Abra o painel de modelos">
    Na navegação à esquerda, escolha **Model** para abrir o painel de modelos.
  </Step>

  <Step title="Adicione um modelo">
    Clique em **+ Add model**.

    <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/trae/add-model.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=ab0661ac7c3876883c12239e0a5c9e7d" alt="Painel de modelos do TRAE com a entrada de configurações, o item Model e o botão para adicionar um modelo destacados." width="3024" height="1898" data-path="images/trae/add-model.png" />
  </Step>

  <Step title="Preencha a configuração do modelo">
    Quando a janela **Add model** aparecer, preencha os campos desta forma:

    | Campo              | Valor                                                                                                               |
    | ------------------ | ------------------------------------------------------------------------------------------------------------------- |
    | Provider           | `OpenAI`                                                                                                            |
    | Model              | `Custom model`                                                                                                      |
    | ID de modelo       | um **ID de modelo de um provedor compatível** copiado da <a href={"https://bettertoken.ai/pricing"}>model plaza</a> |
    | API Key            | sua API Key copiada do console da BetterToken                                                                       |
    | Custom request URL | `https://www.bettertoken.ai/v1/chat/completions`                                                                    |

    <img src="https://mintcdn.com/bettertoken-d796114e/HNF4kE5DlqYBF57E/images/trae/model-config.png?fit=max&auto=format&n=HNF4kE5DlqYBF57E&q=85&s=c9c1e7e79790ff45c182a1f23074c76f" alt="Janela Add model do TRAE com OpenAI e um modelo personalizado selecionados e campos para ID de modelo, API Key e URL personalizada." width="1638" height="1686" data-path="images/trae/model-config.png" />
  </Step>

  <Step title="Salve e comece a usar">
    Clique em **Confirm** para salvar e escolha o novo modelo de um provedor compatível.
  </Step>
</Steps>

<Note>
  A BetterToken oferece suporte ao TRAE apenas com **modelos de um provedor compatível**. Não use nomes fixos de modelos Claude nem defina a URL personalizada como `https://www.bettertoken.ai/v1`.
</Note>

## Teste a conexão

Envie um prompt curto. Se a ferramenta responder sem erro de autenticação ou de ID de modelo, a conexão funciona. Reinicie completamente a ferramenta após alterar a configuração.

## Alterne entre modelos

Abra o seletor ou altere o campo `Model` na configuração. Use o ID exato da <a href={"https://bettertoken.ai/pricing"}>model plaza</a> e reinicie a sessão atual.

## Erros comuns

| Erro                     | O que verificar                                                  |
| ------------------------ | ---------------------------------------------------------------- |
| `401` ou `Unauthorized`  | Confira a BetterToken API Key e remova espaços nas extremidades. |
| `404`                    | Confira a URL e não acrescente outro caminho de endpoint.        |
| `model not found`        | Copie um ID atual da model plaza.                                |
| Alterações não aplicadas | Salve a configuração e reinicie completamente a ferramenta.      |

* [API compatível com OpenAI versus API compatível com Anthropic](/pt-br/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [MCP versus API Key e Base URL](/pt-br/faq/concepts/mcp-vs-api-key-base-url)
* [O que são model\_provider, base\_url e wire\_api?](/pt-br/faq/codex/model-provider-base-url-wire-api)
* [Como configurar uma API compatível com OpenAI no Cline](/pt-br/faq/cline/openai-compatible-api)

## Configuração avançada

### Provedores compatíveis

| Provedor | Status              |
| -------- | ------------------- |
| Claude   | Sem suporte         |
| GPT      | Configuração manual |
| Kimi     | Configuração manual |
| GLM      | Configuração manual |

<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 manual**: informe a API Key, a Base URL e o Model.
  * **Sem suporte**: ainda não há um método verificado de conexão direta.
</Accordion>

## Detalhes técnicos

<Accordion title="Protocolo, endpoint e campos internos do provedor">
  O TRAE exige a URL personalizada completa `https://www.bettertoken.ai/v1/chat/completions`, não apenas a Base URL.
</Accordion>