OpenCode con un proveedor personalizado

Añade este proveedor a opencode.json y dale tu clave con /connect, y OpenCode funcionará con los modelos Claude, GPT y Grok a través de tu clave de AIGROW.

Comprar crédito de API

¿Ya tienes un código? Canjéalo en acceso a la API y después crea una clave.

opencode.json en tu proyecto

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aigrow": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AIGROW",
      "options": { "baseURL": "https://aigrow.gg/v1" },
      "models": { "claude-opus-5.5": { "name": "Claude Opus 5.5" } }
    }
  }
}

Cambia ag_your_key_here por una clave de acceso a la API.

Dónde está el ajuste

Un proyecto
opencode.json
Todos los proyectos
~/.config/opencode/opencode.json
La clave, después de /connect
~/.local/share/opencode/auth.json
Guarda la claveEn OpenCode ejecuta /connect, desplázate hasta Other e introduce aigrow como id del proveedor.
Pega tu clavePega tu clave de AIGROW cuando OpenCode te la pida.
Añade el proveedorPon el bloque en opencode.json. El id del proveedor en el archivo debe coincidir con el que escribiste en /connect.

Más modelos y uno predeterminado

Enumera todos los modelos que quieras en el selector y define model para que OpenCode arranque con uno de ellos.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aigrow": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AIGROW",
      "options": { "baseURL": "https://aigrow.gg/v1" },
      "models": {
        "claude-opus-5.5": { "name": "Claude Opus 5.5" },
        "grok-4.7": { "name": "Grok 4.7" },
        "gpt-6-astra": { "name": "GPT-6 Astra" }
      }
    }
  },
  "model": "aigrow/claude-opus-5.5"
}

Qué modelo usar

Escribe el id exactamente como aparece aquí.

Claude Opus 5.5claude-opus-5.5
Es el modelo predeterminado en todos los bloques de esta página y el modelo Claude más barato de aquí por token enviado y recibido. Contexto: 1.000.000 tokens.
Grok 4.7grok-4.7
El precio de salida más bajo de aquí. Su contexto es la mitad que el de los modelos Claude. Contexto: 500.000 tokens.
GPT-6 Astragpt-6-astra
Para un modelo GPT. Cuesta lo mismo por token que Fable y más que Opus. Contexto: 1.050.000 tokens.
Claude Fable 5.1claude-fable-5.1
Cuesta más por token que Opus. Compara ambos en la clasificación de programación antes de cambiar. Contexto: 1.000.000 tokens.

La lista de precios incluye cada id y su tarifa en crédito, los precios de la API de Claude muestran las tarifas oficiales y la clasificación de programación compara los modelos con consultas de código.

Comprueba que funciona

Primero la clave por sí sola y después OpenCode con ella.

La clave

Pide la lista de modelos. Requiere una clave válida y no cuesta nada.

curl https://aigrow.gg/v1/models -H "Authorization: Bearer ag_your_key_here"

Si la clave funciona, te devuelve la lista:

{
  "object": "list",
  "data": [
    { "id": "claude-opus-5.5", "object": "model", ... },
    { "id": "claude-fable-5.1", "object": "model", ... },
    { "id": "gpt-6-astra", "object": "model", ... },
    { "id": "claude-sonnet-5.5", "object": "model", ... },
    { "id": "gpt-6.1-sol", "object": "model", ... },
    { "id": "grok-4.7", "object": "model", ... },
    ...
  ],
  "has_more": false
}

OpenCode

Ejecuta /models, elige un modelo en AIGROW y envía esta consulta.

Reply with the word ready

Una configuración correcta responde en la sesión:

ready

Cuando falla

Primero los errores de OpenCode y luego las respuestas que el endpoint da a cualquier herramienta.

El proveedor no tiene clave
Ejecuta opencode auth list. Si falta aigrow, ejecuta /connect de nuevo y comprueba que el id coincida con el de opencode.json.
404 con @ai-sdk/openai
Ese paquete llama a la API Responses, que el endpoint no ofrece. Usa @ai-sdk/openai-compatible, como en el bloque.
Mi herramienta muestra un error 401 o de autenticación
Falta la clave o está mal escrita. Cópiala de nuevo desde Acceso a la API en el panel y asegúrate de enviarla como clave, no como nombre de modelo. Una clave revocada falla igual: crea una nueva y sustitúyela.
Recibo un 402 o un mensaje sobre el crédito
Tu saldo está agotado. Abre Acceso a la API en el panel, canjea un código o compra otro paquete y la siguiente solicitud se procesará. No hace falta cambiar nada más.
Aparece 404 o Unknown model
El modelo tiene que ser uno de los que sirve el endpoint, por ejemplo claude-opus-5.5. Las grafías propias del proveedor también funcionan (claude-opus-5-5, anthropic/claude-opus-5.5), pero un id con fecha o cualquier modelo fuera del catálogo se rechaza antes de reenviar la solicitud y no se factura nada. Solicita GET /v1/models con tu clave para ver la lista actualizada, o consulta los ids en la lista de precios.
Las solicitudes se rechazan con un 429
La capacidad del endpoint la comparten todos los clientes: unas 20 solicitudes por minuto y 4 simultáneas. Cada 429 incluye una cabecera retry-after, y los SDK de OpenAI y Anthropic esperan ese tiempo y reintentan por su cuenta. En un bucle propio, espera los segundos que indica o reduce la concurrencia.
El modelo no está disponible en este momento
Un 404 que indica que el modelo no está disponible en este momento significa que el proveedor original ha dejado de responder durante un breve periodo; no es un problema de tu clave ni de tu saldo. Reintenta en unos instantes o envía la solicitud a otro modelo.
Recibo un 502 o un 503
Es un fallo transitorio del proveedor o de la configuración, y no se cobra de tu saldo. Reintenta la solicitud; si sigue fallando, escríbenos a través de la tienda y lo revisaremos.

Lo que no funciona a través de AIGROW

  • El paquete @ai-sdk/openai, que llama a /v1/responses. Todos los modelos de aquí funcionan con @ai-sdk/openai-compatible.

  • Búsqueda web en vivo dentro del modelo. Una herramienta de búsqueda web enviada con una solicitud se responde con lo que el modelo ya sabe, sin resultados en vivo. Una herramienta que obtiene páginas en tu propio equipo sigue funcionando.

  • Cualquier endpoint además de estos tres: /v1/messages, /v1/chat/completions y /v1/models. La Responses API, los embeddings y el recuento de tokens responden 404.

  • Campos de enrutador como models, route, provider y plugins. Se descartan, de modo que una solicitud siempre va al único modelo que indica.

Cuánto cuesta un mes con OpenCode

OpenCode se factura por token a las tarifas de crédito de la lista de precios. Un agente reenvía toda la conversación en cada paso, así que una tarea larga cuesta más de lo que sugiere su último mensaje; el registro de actividad de acceso a la API muestra lo que costó cada solicitud.

Preguntas sobre OpenCode y una API personalizada

¿Cómo añado un proveedor personalizado a OpenCode?
Ejecuta /connect, elige Other y guarda tu clave con un id de proveedor; después añade a opencode.json un proveedor con ese id, con npm configurado como @ai-sdk/openai-compatible y options.baseURL como https://aigrow.gg/v1.
¿Dónde guarda OpenCode la clave?
En ~/.local/share/opencode/auth.json después de /connect. opencode auth list muestra qué proveedores tienen una clave.
¿Qué paquete de npm usa el proveedor?
@ai-sdk/openai-compatible, que llama a /v1/chat/completions. @ai-sdk/openai llama a /v1/responses, que el endpoint no ofrece.

Fuentes: OpenCode Providers · OpenCode Config. Consultado el 21 de octubre de 2026.

Configurar otra herramienta

  • Claude CodeProtocolo de Anthropic

    Cuatro variables de entorno, en la shell o en settings.json.

  • ClineProtocolo de OpenAI

    El proveedor OpenAI Compatible, cuatro campos en la pantalla de ajustes.

  • Roo CodeProtocolo de OpenAI

    El proveedor OpenAI Compatible, los mismos campos que en Cline.

  • Kilo CodeProtocolo de OpenAI

    Un proveedor personalizado en la pestaña Providers; la lista de modelos se rellena sola.

  • ContinueProtocolo de OpenAI

    Una entrada de models en config.yaml, con provider openai y un apiBase.

  • AiderProtocolo de OpenAI

    OPENAI_API_BASE y OPENAI_API_KEY, y después openai/ antes del id del modelo.

  • ZedProtocolos de Anthropic y OpenAI

    Un proveedor compatible con Anthropic para Claude y uno compatible con OpenAI para GPT y Grok.

  • GooseProtocolo de OpenAI

    El proveedor de OpenAI con OPENAI_HOST, o un archivo de proveedor personalizado.

  • Vercel AI SDKProtocolos de Anthropic y OpenAI

    El proveedor compatible con OpenAI para todos los modelos, o el proveedor de Anthropic para Claude.

  • OpenAI Agents SDKProtocolo de OpenAI

    Tu propio cliente AsyncOpenAI, cambiado a chat completions y con el rastreo desactivado.

  • LangChainProtocolos de Anthropic y OpenAI

    ChatOpenAI con base_url para todos los modelos, o ChatAnthropic para Claude.

La guía de la API incluye los SDK, curl, los endpoints y los límites de uso.

Pega el bloque y OpenCode funcionará con tu crédito.

Compra un paquete de crédito, canjea el código de tu correo en acceso a la API, crea una clave y ponla en lugar de ag_your_key_here.

Comprar crédito de APIVer precios y modelos