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

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

Para conectar o Kodacode à 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 de modelo 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

* O VS Code está instalado
* A extensão Kodacode / Koda está instalada
* O ID de modelo selecionado vem de um **provedor compatível**

## Instalação

Instale ou abra o Kodacode e continue com a configuração manual abaixo.

## Configuração manual

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

### Configuração

<Steps>
  <Step title="Abra o painel Koda e adicione um modelo">
    Abra o painel **KODA** na barra lateral do VS Code, clique no seletor de modelos abaixo da caixa de entrada e escolha **Add model: Agent**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/kodacode/select-model-menu.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=b4bd4b16361c0367efbcbba78322df4a" alt="Escolha Add model: Agent no seletor de modelos do painel Koda." style={{ borderRadius: '0.5rem' }} width="3012" height="1600" data-path="images/kodacode/select-model-menu.png" />
    </Frame>
  </Step>

  <Step title="Preencha as configurações do modelo compatível com OpenAI">
    Na caixa de diálogo para adicionar modelo, use estes valores:

    | Campo    | Valor recomendado                                                                                                                    |
    | -------- | ------------------------------------------------------------------------------------------------------------------------------------ |
    | Provider | `Any OpenAI-compatible API`                                                                                                          |
    | API Base | `https://www.bettertoken.ai/v1/`                                                                                                     |
    | Model ID | Um ID de modelo de um provedor compatível da <a href={"https://bettertoken.ai/pricing"}>model plaza</a>, por exemplo `YOUR_MODEL_ID` |
    | API Key  | Sua BetterToken API Key                                                                                                              |

    Após preencher os campos, clique em **Connect**.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/kodacode/add-openai-compatible-model.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=099fa77d6f7720711451f39169f9ff85" alt="Selecione Any OpenAI-compatible API na caixa de diálogo de adição de modelo do Kodacode e preencha API Base, Model ID e API Key." style={{ borderRadius: '0.5rem' }} width="3102" height="1656" data-path="images/kodacode/add-openai-compatible-model.png" />
    </Frame>
  </Step>

  <Step title="Confirme que o modelo está ativo">
    Depois que a conexão for bem-sucedida, selecione o novo modelo, como `YOUR_MODEL_ID`, no seletor abaixo da caixa de entrada do Koda. Envie uma mensagem curta para confirmar que ele retorna uma resposta.
  </Step>

  <Step title="Verifique config.yaml">
    O Kodacode grava a configuração em `~/.koda/config.yaml`. Abra esse arquivo para confirmar que o modelo foi adicionado.

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/kodacode/config-yaml-result.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=5112177597f16b97739c7d406f50749b" alt="config.yaml do Kodacode com a configuração do modelo compatível com OpenAI adicionada." style={{ borderRadius: '0.5rem' }} width="1618" height="1648" data-path="images/kodacode/config-yaml-result.png" />
    </Frame>
  </Step>
</Steps>

### Exemplo de config.yaml

Use esta estrutura completa como referência. Substitua `YOUR_API_KEY` pela sua BetterToken API Key e não envie uma API Key real ao repositório.

```yaml theme={null}
name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
  - name: YOUR_MODEL_ID
    provider: openai
    model: YOUR_MODEL_ID
    apiKey: YOUR_API_KEY
    apiBase: https://www.bettertoken.ai/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase
```

<Note>
  Se você usar um modelo diferente de `YOUR_MODEL_ID`, atualize `name` e `model` para que correspondam ao ID de modelo de um provedor compatível da <a href={"https://bettertoken.ai/pricing"}>model plaza</a>.
</Note>

## Verifique a conexão

Envie um prompt de teste curto. Se a ferramenta retornar uma resposta sem erro de autenticação ou de ID de modelo, a conexão funciona. Reinicie completamente a ferramenta depois de alterar a configuração.

## Alterne entre modelos

Abra o seletor de modelos ou altere o campo `Model` na configuração. Use o ID de modelo 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`         | Verifique a BetterToken API Key e remova espaços no início ou no fim.    |
| `404`                           | Verifique a Base URL e não acrescente um caminho de endpoint específico. |
| `model not found`               | Copie um ID de modelo atual da model plaza.                              |
| As alterações não são aplicadas | Salve a configuração e reinicie completamente a ferramenta.              |

* Se a conexão falhar, confirme que **API Base** é `https://www.bettertoken.ai/v1/` e mantenha a `/` final.
* Se o modelo não estiver disponível, confirme que **Model ID** vem do provedor compatível.
* Se a autenticação falhar, copie a API Key novamente e evite espaços extras ou quebras de linha.
* Se as alterações em `config.yaml` não forem aplicadas, reinicie o VS Code ou execute **Developer: Reload Window**.
* A BetterToken geralmente não exige `User-Agent` adicional nem cabeçalhos personalizados.

## Advanced setup

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

### Guias relacionados

* [Visão geral do plugin Kodacode](https://docs.kodacode.ru/plugin/overview.html)
* [Guia de instalação do plugin Kodacode](https://docs.kodacode.ru/plugin/install.html)

## Detalhes técnicos

<Accordion title="Protocolo, endpoint e campos internos do provedor">
  Esta configuração usa `https://www.bettertoken.ai/v1`. A ferramenta acrescenta o caminho de endpoint compatível com OpenAI. Não adicione `/chat/completions` ou `/responses`, exceto quando um campo específico exigir isso.
</Accordion>