Configuración de OpenCode para Claude: ajustes de opencode.json, modelos y errores comunes

OpenCode lee sus ajustes de opencode.json. Para usarlo con Claude a través de esta pasarela, cambias un valor, el del proveedor de Anthropic baseURL, y le proporcionas una clave. A continuación encontrarás dos configuraciones funcionales, los ajustes de modelo y contexto que importan, y soluciones para los errores que encuentran los usuarios de OpenCode en esta pasarela, extraídas de nuestros propios registros de solicitudes.

Dónde se encuentra opencode.json

OpenCode combina una configuración global con otra por proyecto: ~/.config/opencode/opencode.json para los ajustes que quieras usar en todas partes, y opencode.json en la raíz de un proyecto para ese repositorio. Añadir la línea $schema te proporciona autocompletado y validación en la mayoría de los editores.

No guardes la clave en el archivo. Ponla en una variable de entorno y haz referencia a ella como {env:AIPRIME_API_KEY}. Las claves que añades con /connect dentro de OpenCode se almacenan en ~/.local/share/opencode/auth.json; opencode auth list muestra lo que está almacenado allí.

export AIPRIME_API_KEY=your_gateway_key   # add to ~/.bashrc or ~/.zshrc
opencode auth list                         # credentials OpenCode already knows about

Opción 1: apunta el proveedor integrado de Anthropic a la pasarela

El cambio mínimo: conserva el proveedor de Anthropic de OpenCode y su lista de modelos, y modifica el destino al que envía las solicitudes.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://aiprimetech.io/v1",
        "apiKey": "{env:AIPRIME_API_KEY}"
      }
    }
  },
  "model": "anthropic/claude-sonnet-5",
  "small_model": "anthropic/claude-haiku-4-5"
}

Opción 2: un proveedor personalizado con tu propia lista de modelos

Una entrada de proveedor independiente mantiene la pasarela separada de cualquier inicio de sesión de Anthropic, te permite incluir exactamente los modelos que quieras en el selector y definir límites de contexto por modelo.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aiprime": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Prime Tech",
      "options": {
        "baseURL": "https://aiprimetech.io/v1",
        "apiKey": "{env:AIPRIME_API_KEY}"
      },
      "models": {
        "claude-sonnet-5":  { "name": "Claude Sonnet 5",  "limit": { "context": 200000, "output": 64000 } },
        "claude-opus-5-5":  { "name": "Claude Opus 5.5",  "limit": { "context": 200000, "output": 64000 } },
        "claude-haiku-4-5": { "name": "Claude Haiku 4.5", "limit": { "context": 200000, "output": 32000 } }
      }
    }
  },
  "model": "aiprime/claude-sonnet-5",
  "small_model": "aiprime/claude-haiku-4-5"
}

Prioriza @ai-sdk/anthropic para Claude: utiliza la API nativa de Messages, por lo que el almacenamiento en caché de prompts y el razonamiento funcionan tal como los diseñó Anthropic. La pasarela también admite el formato de OpenAI, así que @ai-sdk/openai-compatible con la misma https://aiprimetech.io/v1 URL base también funciona, y es la vía que debes usar para los modelos GPT con la misma clave.

Modelos y límites de contexto

model es lo que utiliza el agente principal; small_model se encarga de tareas secundarias de bajo coste, como los títulos de las sesiones. El limit.context valor indica a OpenCode cuándo compactar la sesión. Si una sesión larga falla con prompt is too long, redúcelo (200000 es un valor seguro) para que OpenCode resuma antes en lugar de enviar más de lo que acepta el endpoint.

Los ID de modelo son cadenas exactas. Los nombres antiguos como claude-3-5-sonnet-20241022 o las versiones con fecha no están disponibles; utiliza los ID anteriores o la lista de tu panel.

Comprueba la clave y la URL antes de iniciar OpenCode

Una solicitud desde el terminal te permite comprobar si la clave y la URL son correctas, independientemente de la configuración de OpenCode:

curl -s https://aiprimetech.io/v1/messages \
  -H "x-api-key: $AIPRIME_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":20,"messages":[{"role":"user","content":"ping"}]}'

Una respuesta JSON con un content array significa que la pasarela funciona correctamente y que cualquier problema restante está en opencode.json. Invalid API key significa que la variable está vacía o contiene una clave incorrecta.

Solución de problemas: errores que encuentran los usuarios de OpenCode

Estos son los errores más habituales al usar OpenCode con esta pasarela, junto con la solución para cada uno.

Para los errores que proceden del modelo y no del cliente, consulta guía de errores de la API de Claude.

Preguntas frecuentes

AI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios.