Respuesta corta
Para usar Zed con APIVAI, abre Agent Settings (comando agent: open settings), pulsa Add Provider en LLM Providers y añade un proveedor compatible con OpenAI con la API URL https://api.apivai.com/v1, tu clave de APIVAI y un ID de modelo como claude-sonnet-4-6 o gpt-5.5; en settings.json es una entrada de language_models.openai_compatible. Para usar Claude en su formato nativo puedes añadir en su lugar un proveedor compatible con Anthropic con https://api.apivai.com sin /v1, porque Zed añade /v1/messages por su cuenta. A fecha de 2026-10-10, Claude Sonnet 4.6 cuesta $1.15 / $5.74 por millón de tokens de entrada / salida con APIVAI, frente a los $3.00 / $15.00 oficiales. Pagas por token desde un saldo prepago, sin suscripción.
¿Qué es el Agent Panel de Zed y por qué conectarlo a tu propia API?
Zed es un editor de código rápido y de código abierto con un agente de IA integrado. El Zed Agent trabaja en el Agent Panel: lee tu proyecto, edita archivos, usa herramientas y muestra cada cambio para que puedas revisarlo o revertirlo. La misma configuración de modelos se usa también para el Inline Assistant, la generación de mensajes de commit de Git y los resúmenes de hilos.
Zed puede usar sus propios modelos alojados, pero también acepta cualquier proveedor con clave de API. Ahí encaja APIVAI: una sola clave te da modelos Claude y GPT, facturados por token (por debajo de los precios oficiales en la mayoría de los modelos), desde un saldo que recargas cuando lo necesitas. La clave funciona en el formato de OpenAI y en el de Anthropic, así que sirve para los dos tipos de proveedor personalizado de Zed.
¿Qué tipo de proveedor conviene usar en Zed?
Zed tiene dos tipos de endpoint personalizado que funcionan con APIVAI:
| OpenAI-compatible | Anthropic-compatible | |
|---|---|---|
| Clave en la configuración | openai_compatible | anthropic_compatible |
| API URL | https://api.apivai.com/v1 | https://api.apivai.com (sin /v1) |
| Modelos | Claude y GPT | Solo Claude |
| Qué llama Zed | /chat/completions | /v1/messages |
| Ideal para | Un proveedor para todos los modelos | Claude en su formato nativo Messages, caché de prompts |
Empieza por OpenAI-compatible: un solo proveedor cubre Claude y GPT, y cambiar de modelo es un clic en el Agent Panel. Añade también Anthropic-compatible si usas sobre todo Claude y quieres que Zed envíe las peticiones en el formato nativo de Claude, con caché de prompts incluida. Puedes configurar los dos a la vez con la misma clave.
¿Cómo se configura Zed con APIVAI paso a paso?
Paso 1: Crea una clave de APIVAI
- Regístrate en apivai.com con tu correo.
- Recarga saldo desde $10 con tarjeta, cripto, Alipay o WeChat Pay. No hay prueba gratuita: solo pagas lo que usas.
- Abre el Dashboard, crea una clave y cópiala. Puedes asignarle un límite de presupuesto propio para que el agente nunca gaste más de lo previsto.
Paso 2: Añade el proveedor compatible con OpenAI
Lo más rápido es la interfaz de configuración:
- Ejecuta
agent: open settingsdesde la paleta de comandos (o ve a Settings → AI → LLM Providers). - Pulsa Add Provider y rellena el nombre del proveedor, la API URL, el ID del modelo y la ventana de contexto según la tabla.
- Pega tu clave de APIVAI en el campo de clave del proveedor. Zed la guarda en el llavero del sistema, no en
settings.json.
| Campo | Valor |
|---|---|
| Nombre del proveedor | apivai |
| API URL | https://api.apivai.com/v1 |
| Clave de API | Tu clave de APIVAI |
| ID del modelo | claude-sonnet-4-6 (o cualquier ID de GET /v1/models) |
| Ventana de contexto | 200000 |
Si prefieres editar settings.json, el mismo proveedor con dos modelos queda así:
{
"language_models": {
"openai_compatible": {
"apivai": {
"api_url": "https://api.apivai.com/v1",
"available_models": [
{
"name": "claude-sonnet-4-6",
"display_name": "Claude Sonnet 4.6 (APIVAI)",
"max_tokens": 200000,
"max_output_tokens": 16384
},
{
"name": "gpt-5.5",
"display_name": "GPT-5.5 (APIVAI)",
"max_tokens": 128000,
"max_output_tokens": 16384
}
]
}
}
}
}Hay tres detalles importantes. En Zed, max_tokens es la ventana de contexto, no la longitud de la respuesta; el límite de respuesta es max_output_tokens. La api_url debe terminar en /v1 una sola vez, porque Zed le añade /chat/completions. Y la clave nunca va en settings.json: introdúcela en la interfaz o define la variable de entorno que Zed deriva del ID del proveedor (en mayúsculas más _API_KEY, así que apivai se convierte en APIVAI_API_KEY) y reinicia Zed.
Para ver qué IDs de modelo puede usar tu clave, ejecuta:
curl https://api.apivai.com/v1/models \ -H "Authorization: Bearer YOUR_APIVAI_KEY"
La lista de modelos cambia con el tiempo, así que copia los IDs de esta respuesta o de la página de precios y no de tutoriales antiguos.
Paso 3 (opcional): Añade un proveedor compatible con Anthropic para Claude
En Add Provider, elige Anthropic e introduce https://api.apivai.com como API URL, o añade esto junto al bloque anterior:
"anthropic_compatible": {
"apivai-claude": {
"api_url": "https://api.apivai.com",
"available_models": [
{
"name": "claude-sonnet-4-6",
"display_name": "Claude Sonnet 4.6 (APIVAI native)",
"max_tokens": 200000,
"max_output_tokens": 16384,
"capabilities": {
"tools": true,
"images": false,
"prompt_caching": true
}
}
]
}
}No añadas /v1 aquí. El cliente de Anthropic de Zed agrega /v1/messages a la API URL, así que https://api.apivai.com/v1 se convertiría en /v1/v1/messages y daría 404. Con prompt_caching, Zed envía puntos de caché y el contexto repetido se factura al precio de lectura de caché ($0.12 por 1M para Claude Sonnet 4.6). Introduce la clave en la interfaz de configuración del proveedor. Hay más detalles sobre este formato en la página del proxy de la API de Claude.
Paso 4: Elige el modelo en el Agent Panel
Abre el Agent Panel y pulsa el selector de modelo en el editor de mensajes. Tus modelos de APIVAI aparecen bajo el nombre de proveedor que elegiste; asegúrate de elegir la entrada de APIVAI y no un modelo con el mismo nombre de otro proveedor. Para que sea el modelo por defecto, define agent.default_model en settings.json con el nombre del proveedor y el ID del modelo.
¿Qué modelo conviene elegir en Zed?
El agente envía una solicitud en cada paso, así que el precio por token importa. Precios por 1M de tokens de entrada / salida a fecha de 2026-10-10:
| ID de modelo | Precio (entrada / salida) | Para qué |
|---|---|---|
claude-sonnet-4-6 | $1.15 / $5.74 | Opción por defecto para el día a día |
claude-sonnet-5-5 | $0.77 / $3.82 | Día a día, Sonnet más reciente |
claude-opus-5-5 | $1.54 / $7.65 | Bugs difíciles, refactorizaciones grandes |
claude-haiku-4-5 | $0.38 / $1.92 | Inline Assistant, mensajes de commit, cambios pequeños |
gpt-5.5 | $0.77 / $4.56 | Alternativa GPT, segunda opinión |
gpt-6-luna | $0.0144 / $0.0768 | Tareas sencillas muy baratas |
Un esquema práctico: Claude Sonnet 4.6 o Claude Sonnet 5.5 para el agente, Claude Opus 5.5 cuando una tarea falla una y otra vez, y Claude Haiku 4.5 para ediciones rápidas en línea. Los modelos GPT solo funcionan con el proveedor compatible con OpenAI.
¿Cuánto cuesta Zed con APIVAI?
Cada paso del agente reenvía el hilo y los archivos que ha leído, así que los tokens de entrada son la mayor parte del gasto. Dos ejemplos realistas con Claude Sonnet 4.6:
- Una tarea mediana, como corregir un bug que toca varios archivos: unas 15 solicitudes de 25.000 tokens de entrada y 1.500 de salida cada una. Coste: $0.56 con APIVAI, $1.46 a precios oficiales.
- Un mes de trabajo con dos tareas así al día durante 22 días (660 solicitudes): $24.66 con APIVAI, $64.35 a precios oficiales.
El mismo mes con Claude Haiku 4.5 costaría $8.17. Estas estimaciones no tienen en cuenta el caché de prompts e incluyen los tokens de razonamiento en la cifra de salida, ya que se facturan como salida. El Dashboard muestra cada solicitud con sus tokens y su coste, así que en un día podrás sustituir estas suposiciones por tus propias cifras. Para una comparación más amplia, consulta los precios de la API de Claude en 2026.
¿Cómo se solucionan los errores habituales de Zed?
- 401 Unauthorized: la clave falta, está incompleta, se eliminó o agotó su presupuesto. Vuelve a introducirla en la configuración del proveedor. Una variable de entorno no vacía tiene prioridad sobre el llavero, así que revisa también
APIVAI_API_KEY. - 404 Not Found: casi siempre es el
/v1. OpenAI-compatible necesitahttps://api.apivai.com/v1(sin/chat/completionsal final); Anthropic-compatible necesitahttps://api.apivai.comsin/v1. - Modelo no encontrado:
namedebe ser un ID exacto comoclaude-sonnet-4-6, no un nombre visible. Compruébalo conGET /v1/models. - Respuestas vacías o cortadas: el razonamiento está activado por defecto y consume tokens de salida. Sube
max_output_tokensa 8192 o más (mínimo 4096). - 429 Too Many Requests: el límite por defecto es de 60 solicitudes por minuto por clave. Las tareas largas del agente pueden alcanzarlo; espera un momento o pide a soporte que lo amplíe.
Las reglas generales de cada formato están en la página de API compatible con OpenAI y en la documentación.
Preguntas frecuentes
¿Puedo usar Claude y GPT en Zed con una sola clave?
Sí. Añade un proveedor compatible con OpenAI con los dos IDs de modelo en available_models y cambia entre ellos en el selector de modelo.
¿Qué API URL pongo en Zed?
https://api.apivai.com/v1 para un proveedor compatible con OpenAI y https://api.apivai.com para uno compatible con Anthropic, porque Zed añade /v1/messages por su cuenta.
¿Sirve esto para Edit Prediction de Zed?
No. Edit Prediction tiene su propia configuración de proveedor; los proveedores de esta guía alimentan el Zed Agent, el Inline Assistant, los mensajes de commit y los resúmenes de hilos.
¿APIVAI guarda mi código?
No. El contenido de las solicitudes y respuestas no se registra. Solo se conservan datos de uso como el modelo, los tokens y el coste para la facturación.
¿Puedo usar la misma clave en otros editores?
Sí. La misma clave funciona en Cline, Continue y agentes de terminal como OpenCode. Crear una clave por herramienta hace que el Dashboard sea más fácil de leer.
Crea una cuenta, recarga desde $10 y pega tu clave en Zed.