Documentación
Zed
Zed declara un proveedor compatible con OpenAI en settings.json y solicita la clave por separado, a través del Agent Panel. El array models no es un atajo: contiene toda la lista de modelos que Zed conocerá.
Un bloque language_models.openai_compatible en settings.json declara el endpoint y sus modelos; la clave se introduce en la interfaz Agent Panel, nunca en el archivo.
{
"language_models": {
"openai_compatible": {
"kunavo": {
"api_url": "https://api.kunavo.com/v1",
"available_models": [
{
"name": "claude-sonnet-5",
"display_name": "Claude Sonnet 5",
"max_tokens": 200000,
"max_output_tokens": 64000,
"capabilities": { "tools": true, "images": true }
},
{
"name": "claude-haiku-4-5",
"display_name": "Claude Haiku 4.5",
"max_tokens": 200000
}
]
}
}
}
}settings.json se sincroniza y se comparte; si incluyes una clave ahí, también se compartirá.available_models es todo el catálogo que Zed reconoce: no hay una llamada de descubrimiento para un proveedor compatible con OpenAI, así que cualquier modelo que no incluyas no aparecerá en el selector. Añade una entrada por cada identificador que quieras usar, con max_tokens establecido en la ventana de contexto real de ese modelo.sk-kn-) y añade crédito desde $10; las llamadas se pagan con ese saldo y las llamadas fallidas no se facturan. El panel se abre entonces en la configuración de Zed.Paso a paso
- Cree una clave en
/app/keysy cópiela: se muestra una sola vez. - Abre
settings.jsoncon zed: open settings desde la paleta de comandos y añade el bloque anterior. - Abre la configuración de Agent Panel, busca el proveedor por el nombre que usaste como clave (aquí,
kunavo) y pega allí la clave de API. - Elige el modelo en el selector de modelos de Agent Panel: muestra el
display_namey envía elname. - Sobrescribe solo los valores de
capabilitiesque difieran de los predeterminados de Zed; los valores predeterminados sontools: true, con las imágenes y las llamadas paralelas a herramientas desactivadas.
Comprobado con Documentación de Zed sobre el acceso a la API el 6 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.
Verifica antes de depurar el cliente
Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en Zed.
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
-H "Authorization: Bearer sk-kn-..."Qué ID de modelo introducir en el campo
Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.
| ID de modelo | Entrada / salida de Kunavo | Dónde encaja en Zed |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | la opción predeterminada del agente: herramientas e imágenes activadas |
claude-opus-5 | $3.50 / $17.50 | refactorizaciones grandes, donde el plan importa más que la velocidad |
claude-haiku-4-5 | $0.70 / $3.50 | asistencia integrada y ediciones rápidas |
gpt-5-6-terra | $0.70 / $4.20 | una segunda familia en la misma entrada de proveedor |
Preguntas frecuentes
¿Cómo añado a Zed un proveedor compatible con OpenAI?
Añade a settings.json un bloque language_models.openai_compatible con el nombre de tu proveedor como clave, un api_url que apunte a la raíz /v1 del endpoint y un array available_models con los identificadores de cada modelo que quieras. Después, abre la configuración del proveedor en Agent Panel e introduce allí la clave de API. La documentación de Zed es explícita: las claves no deben incluirse en settings.json.
¿Por qué no aparece un modelo en el selector de modelos de Zed?
Porque no está en available_models. Zed no consulta el catálogo de un endpoint compatible con OpenAI, así que el array de settings.json es la lista completa de modelos que ofrece ese proveedor. Añade una entrada con el identificador del modelo como name, un display_name para el selector y max_tokens establecido en la ventana de contexto real del modelo.
¿Dónde guarda Zed la clave de API de un proveedor personalizado?
En la interfaz de configuración del proveedor de Agent Panel o en la variable de entorno que Zed genera a partir del nombre del proveedor; no en settings.json. Zed mantiene las credenciales fuera del archivo de configuración deliberadamente, porque ese archivo está pensado para ser portátil y compartirse, mientras que una clave no debería serlo.
¿Puede Zed usar modelos Claude a través de un endpoint personalizado?
Sí. El proveedor openai_compatible envía el nombre del modelo directamente a api_url, así que el endpoint, y no Zed, resuelve un identificador Claude. Establece capabilities.tools en true para los modelos compatibles con llamadas a herramientas; es el valor predeterminado de Zed para este tipo de proveedor, y el agente funciona igual que con un proveedor propio.