OpenCode con Claude y GPT: configurar una API personalizada

OpenCode es un agente de programación con IA de código abierto que funciona en la terminal. Lee tu proyecto, edita archivos, ejecuta comandos y resuelve una tarea paso a paso. OpenCode está construido sobre el AI SDK y puede hablar con muchos proveedores, incluida cualquier API compatible con OpenAI, así que tú decides adónde van las solicitudes al modelo y quién las factura.

APIVAI te da una sola clave para modelos Claude y GPT, facturada por token (por debajo de los precios oficiales en la mayoría de los modelos), desde un saldo que recargas cuando lo necesitas. La misma clave funciona en el formato de OpenAI y en el de Anthropic, así que sirve para las dos configuraciones de abajo.

Empieza por el proveedor personalizado: cubre Claude y GPT, y tú controlas exactamente qué IDs de modelo aparecen en el selector. Usa el proveedor integrado anthropic si solo usas Claude y quieres la integración nativa de OpenCode con Claude. Ten en cuenta que, al sobrescribir anthropic, todas las solicitudes de ese proveedor van a APIVAI.

1. Regístrate en apivai.com con tu correo.
2. Recarga saldo desde $10 con tarjeta, cripto, Alipay o WeChat Pay. No hay prueba gratuita: solo pagas lo que usas.
3. 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.

1. Inicia OpenCode en tu proyecto y escribe /connect.
2. Baja hasta Other y selecciónalo.
3. Introduce el ID de proveedor apivai. Usarás exactamente este ID en el archivo de configuración.
4. Pega tu clave de APIVAI cuando te pida la clave de API.

OpenCode guarda la clave en ~/.local/share/opencode/auth.json. El mismo flujo está disponible fuera de la TUI con opencode auth login. Si prefieres una variable de entorno, sáltate este paso y añade "apiKey": "{env:APIVAI_API_KEY}" a las options del proveedor de abajo.

Pon esto en opencode.json en la raíz del proyecto, o en ~/.config/opencode/opencode.json para usarlo en todos los proyectos:

La baseURL debe terminar en /v1 una sola vez: el paquete le añade /chat/completions. Las claves dentro de models son los IDs que se envían a APIVAI, y name es solo la etiqueta del selector. limit le indica a OpenCode cuánto contexto queda y qué longitud puede tener una respuesta. small_model se usa para trabajos ligeros como generar títulos de sesión, así que ahí encaja un modelo barato.

Para ver qué IDs de modelo puede usar tu clave, ejecuta:

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. Reinicia OpenCode, ejecuta /models y elige un modelo bajo APIVAI.

1. Ejecuta /connect, selecciona Anthropic, elige Manually enter API Key y pega tu clave de APIVAI.
2. Añade la URL base a opencode.json:

Aquí el /v1 se queda. Es lo contrario que en herramientas como Claude Code: el SDK de Anthropic de OpenCode trata baseURL como un prefijo que ya incluye /v1 (su valor por defecto es https://api.anthropic.com/v1) y solo añade /messages. Si escribes https://api.apivai.com sin /v1, llamaría a /messages y daría 404. Elige los modelos Claude en la lista de Anthropic de /models; si falta el ID que quieres, añádelo en provider.anthropic.models. Hay más detalles sobre este formato en la página del proxy de la API de Claude.

Un agente de programación envía muchas solicitudes por tarea, así que el precio por token importa. Precios por 1M de tokens de entrada / salida a fecha de 2026-10-10:

Un esquema práctico: Claude Sonnet 4.6 o Claude Sonnet 5.5 como model, Claude Haiku 4.5 como small_model y Claude Opus 5.5 cuando una tarea falla una y otra vez. Los modelos GPT solo funcionan con el proveedor personalizado compatible con OpenAI.

Cada paso de una tarea reenvía la sesión y los archivos que ha leído el agente, así que los tokens de entrada se acumulan rápido. Dos ejemplos realistas con Claude Sonnet 4.6:

• Una tarea mediana, como añadir una función que toca varios archivos: unas 25 solicitudes de 30.000 tokens de entrada y 2.000 de salida cada una. Coste: $1.15 con APIVAI, $3.00 a precios oficiales.
• Un mes de trabajo con tres tareas así al día durante 22 días (1.650 solicitudes): $75.87 con APIVAI, $198 a precios oficiales.

El mismo mes con Claude Haiku 4.5 costaría $25.15. 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.

• 401 Unauthorized: ejecuta opencode auth list y comprueba que existe una credencial para apivai. El ID de /connect debe coincidir exactamente con el ID del proveedor en opencode.json. Comprueba también que la clave no se haya eliminado ni agotado su presupuesto.
• 404 Not Found: revisa options.baseURL. Las dos configuraciones usan https://api.apivai.com/v1, sin /chat/completions ni /messages al final y sin /v1 duplicado.
• Modelo no encontrado: la clave dentro de models debe ser un ID exacto como claude-sonnet-4-6. Compruébalo con GET /v1/models.
• El proveedor o los modelos no aparecen en /models: el valor de npm debe ser @ai-sdk/openai-compatible y el JSON debe ser válido. Reinicia OpenCode después de editar el archivo.
• Respuestas vacías o cortadas: el razonamiento está activado por defecto y consume tokens de salida. Sube limit.output a 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.

Sí. Enumera los dos IDs de modelo en el proveedor apivai y cambia entre ellos con /models.

https://api.apivai.com/v1 en las dos configuraciones. El paquete compatible con OpenAI le añade /chat/completions y el SDK de Anthropic le añade /messages.

En la raíz del proyecto si es para un solo proyecto, o en ~/.config/opencode/opencode.json para todos. La configuración del proyecto tiene prioridad sobre la global.

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.

Sí. La misma clave funciona en Aider, Claude Code y editores como Zed. 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 OpenCode.