Configuração de Coding Agents

Zed: modelos personalizados, API Key e Base URL

Adicione a BetterToken como provedor compatível com OpenAI no Zed, configure Base URL, API Key e modelo e mantenha a chave no chaveiro do sistema. Na prática.

Adicione um provedor compatível com OpenAI em Agent Settings no Zed e informe a BetterToken API Key, a Base URL e o ID de modelo. O Zed armazena as chaves salvas nessa tela no chaveiro do sistema, não em settings.json.

Configurações principais

Campo	Valor
Provedor	`BetterToken`
API Key	`YOUR_API_KEY`
Base URL	`https://bettertoken.ai/v1`
Modelo	`YOUR_MODEL_ID`

Pré-requisitos

Instale a versão atual do Zed
Crie uma BetterToken API Key
Copie YOUR_MODEL_ID da model plaza

Cadastre-se e obtenha uma BetterToken API Key

Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.

Instalação

Instale ou atualize para a versão atual no site do Zed. Inicie o Zed e siga as etapas abaixo para abrir as configurações do Agent.

Configuração manual

Adicione um provedor compatível com OpenAI

Clique em Add Provider, escolha OpenAI Compatible e informe BetterToken como Provider Name.

Informe as configurações de conexão

Campo	Valor
API URL	`https://bettertoken.ai/v1`
API Key	`YOUR_API_KEY`
ID de modelo	`YOUR_MODEL_ID`

Informe apenas a Base URL. Este guia usa o modo Chat Completions padrão do Zed, que acrescenta o caminho desse endpoint.

Salve a API Key

Salve o provedor nas configurações do Zed. O Zed armazena a API Key no chaveiro local e não a grava em settings.json.

Selecione o modelo

Abra o seletor de modelos no Agent Panel e escolha YOUR_MODEL_ID em BetterToken.

Opcional: declare o provedor e o modelo em `settings.json`

Quando precisar gerenciar as declarações de modelo em arquivo, execute zed: open settings file. Mantenha no arquivo apenas o provedor, api_url e os metadados do modelo:

{
  "language_models": {
    "openai_compatible": {
      "BetterToken": {
        "api_url": "https://bettertoken.ai/v1",
        "available_models": [
          {
            "name": "YOUR_MODEL_ID",
            "display_name": "YOUR_MODEL_ID",
            "max_tokens": 128000
          }
        ]
      }
    }
  }
}

O Zed exige max_tokens como declaração da janela de contexto do modelo. Ajuste-o ao modelo selecionado. Informe a API Key em Agent Settings para que o chaveiro do sistema a armazene.

Teste a conexão

Selecione BetterToken / YOUR_MODEL_ID no Agent Panel.
Envie uma mensagem de teste curta.
Uma resposta normal sem erros de autenticação ou modelo confirma a configuração.

Encerre completamente e reinicie o Zed após alterar configurações de provedor ou modelo.

Alterne entre modelos

Escolha outro modelo BetterToken no seletor do Agent Panel. Para adicionar um ID de modelo, copie o valor atual da model plaza e atualize as configurações do provedor ou available_models.

Erros comuns

Erro	Correção
`401` ou `Unauthorized`	Informe novamente a BetterToken API Key em Agent Settings e remova espaços nas extremidades.
`404`	Use `https://bettertoken.ai/v1` como API URL; não acrescente `/chat/completions`.
`model not found`	Copie `YOUR_MODEL_ID` novamente da model plaza.
Configurações não aplicadas	Salve o provedor, encerre completamente o Zed e abra-o novamente.
O Zed usa uma chave antiga	Confira a variável gerada a partir do ID do provedor: Snake Case em maiúsculas seguido de `_API_KEY`, como `BETTERTOKEN_API_KEY` para `BetterToken`. Um valor não vazio tem precedência sobre o chaveiro. Remova a variável e reinicie o Zed para usar a chave salva. Consulte a precedência de chaves do Zed.

Detalhes técnicos

Chaveiro, arquivo de configurações e endpoint

O Zed chama a BetterToken por um provedor compatível com OpenAI. A tela de configurações armazena a chave no chaveiro do sistema; settings.json contém apenas o provedor, api_url e a declaração de modelo. Com as configurações padrão de Chat Completions deste guia, use https://bettertoken.ai/v1 como Base URL e deixe o Zed acrescentar o caminho do endpoint.