> ## 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 Kilo Code: instalação, API Key, Base URL e modelos personalizados

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

Para conectar o Kilo Code à BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um ID de modelo atual na model plaza.

## Configurações principais

| Campo    | Valor                                                                     |
| -------- | ------------------------------------------------------------------------- |
| API Key  | BetterToken API Key                                                       |
| Base URL | `https://www.bettertoken.ai/v1`                                           |
| 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

* VS Code instalado

## Instalação

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

## Configuração manual

Faça a configuração na interface do Kilo Code. Não é necessário editar um arquivo.

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

### Configuração

<Steps>
  <Step title="Remova variáveis de ambiente conflitantes">
    ```bash theme={null}
    unset OPENAI_API_KEY
    unset OPENAI_BASE_URL
    ```
  </Step>

  <Step title="Abra as configurações do Kilo Code">
    Abra a interface de configurações do Kilo Code.
  </Step>

  <Step title="Configure o provedor de API">
    Preencha:

    * **API Provider** → `OpenAI Compatible`
    * **Base URL** → `https://www.bettertoken.ai/v1`
    * **API Key** → sua BetterToken API Key
    * **Model** → um **ID de modelo de um provedor compatível** copiado da <a href={"https://bettertoken.ai/pricing"}>model plaza</a>
  </Step>

  <Step title="Configure cabeçalhos extras apenas quando a documentação exigir">
    O material oficial do Kilo Code menciona cabeçalhos personalizados opcionais para provedores compatíveis com OpenAI, mas não trata `User-Agent` como requisito da BetterToken.

    Se você também usa um gateway personalizado ou uma camada de roteamento, observabilidade ou cache, adicione cabeçalhos apenas conforme a documentação oficial do serviço upstream.
  </Step>

  <Step title="Reinicie o Kilo Code">
    Depois de alterar a configuração, reinicie o VS Code ou recarregue a extensão Kilo Code para aplicar os novos valores.
  </Step>
</Steps>

<Note>
  Se precisar de cabeçalhos extras, siga a documentação atual do Kilo Code ou os requisitos do gateway upstream. Não presuma que `User-Agent` seja obrigatório para a BetterToken.
</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 Base URL e não acrescente um caminho de endpoint específico. |
| `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">
  Esta configuração usa `https://www.bettertoken.ai/v1`. A ferramenta adiciona o caminho do endpoint compatível com OpenAI. Não acrescente `/chat/completions` nem `/responses`, a menos que um campo específico exija.
</Accordion>