Configuración de Coding Agents

Zed: modelos personalizados, API Key y Base URL

Añade BetterToken como proveedor compatible con OpenAI en Zed, configura la Base URL, la API Key y el modelo, y guarda la Key en el llavero del sistema.

Añadir un proveedor compatible con OpenAI en Agent Settings de Zed e introduce la BetterToken API Key, la Base URL y el ID del modelo. Zed guarda las Keys introducidas en esta pantalla en el llavero del sistema, no en settings.json.

Ajustes principales

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

Requisitos previos

Instala la versión actual de Zed
Crea una BetterToken API Key
Copia YOUR_MODEL_ID desde la model plaza

Regístrate y obtén una BetterToken API Key

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Instalación

Instala o actualiza Zed a la versión actual desde el sitio web de Zed. Abre Zed y sigue estos pasos para acceder a los ajustes del agente.

Configuración manual

Añadir un proveedor compatible con OpenAI

Haz clic en Add Provider, elige OpenAI Compatible e introduce BetterToken como Provider Name.

Introduce los ajustes de conexión

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

Introduce únicamente la Base URL. Esta guía usa el modo Chat Completions predeterminado de Zed, que añade la ruta de ese endpoint.

Guarda la API Key

Guarda el proveedor en los ajustes de Zed. Zed almacena la API Key en el llavero local del sistema y no la escribe en settings.json.

Selecciona el modelo

Abre el selector de modelos del Agent Panel y elige YOUR_MODEL_ID en BetterToken.

Opcional: declara el proveedor y el modelo en `settings.json`

Si necesitas gestionar las declaraciones de modelos mediante un archivo, ejecuta zed: open settings file. Conserva en el archivo únicamente el proveedor, api_url y los metadatos del 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
          }
        ]
      }
    }
  }
}

Zed requiere max_tokens para declarar la ventana de contexto del modelo. Ajústalo al modelo seleccionado. Introduce la API Key en Agent Settings para que el llavero del sistema la almacene.

Verifica la conexión

Selecciona BetterToken / YOUR_MODEL_ID en el Agent Panel.
Envía un mensaje de prueba breve.
Una respuesta normal sin errores de autenticación ni de modelo confirma la configuración.

Cierra Zed por completo y vuelve a abrirlo después de cambiar los ajustes del proveedor o del modelo.

Cambia de modelo

Elige otro modelo de BetterToken en el selector del Agent Panel. Para añadir un ID de modelo, copia el valor actual desde la model plaza y actualiza los ajustes del proveedor o available_models.

Errores habituales

Error	Solución
`401` o `Unauthorized`	Vuelve a introducir la BetterToken API Key en Agent Settings y elimina los espacios que la rodean.
`404`	Usa `https://bettertoken.ai/v1` como API URL; no añadas `/chat/completions`.
`model not found`	Vuelve a copiar `YOUR_MODEL_ID` desde la model plaza.
Los ajustes no se aplican	Guarda el proveedor, cierra Zed por completo y vuelve a abrirlo.
Zed usa una Key antigua	Comprueba la variable generada a partir del ID del proveedor: palabras en mayúsculas separadas por guiones bajos, seguidas de `_API_KEY`, como `BETTERTOKEN_API_KEY` para `BetterToken`. Un valor no vacío tiene prioridad sobre el llavero. Elimina la variable y reinicia Zed para usar la Key guardada. Consulta la prioridad de claves de Zed.

Detalles técnicos

Llavero, archivo de ajustes y endpoint

Zed llama a BetterToken mediante un proveedor compatible con OpenAI. La pantalla de ajustes guarda la Key en el llavero del sistema; settings.json solo contiene el proveedor, api_url y la declaración del modelo. Con los ajustes predeterminados de Chat Completions de esta guía, usa https://bettertoken.ai/v1 como Base URL y deja que Zed añada la ruta del endpoint.