Source: https://aiprimetech.io/es/learn/use-claude-api-with-opencode/

[Inicio](/es/) / [Aprende](/es/learn/) / Configuración de OpenCode para Claude: ajustes de opencode.json, modelos y errores habituales 

# 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í. 

terminalCopiar

```
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. 

opencode.jsonCopiar

```
{
  "$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"
}
```

El baseURL debe terminar en /v1. El proveedor de Anthropic de OpenCode es el del AI SDK @ai-sdk/anthropic, cuyo valor predeterminado es https://api.anthropic.com/v1; añade /messages a lo que le proporciones. Sin /v1 la solicitud llega al sitio web y devuelve HTML, lo que OpenCode indica como un error de análisis. 

## 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. 

opencode.jsonCopiar

```
{
  "$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 

  | ID del modelo  | Úsalo para  

 | claude-sonnet-5 | Opción predeterminada para programación y trabajo con agentes: rápida, potente y de precio intermedio. 

 | claude-opus-5-5 | Razonamiento más complejo, refactorizaciones grandes y ejecuciones largas de agentes. 

 | claude-fable-5-1 | El más capaz y el más caro; resérvalo para las tareas más difíciles. 

 | claude-haiku-4-5 | Económico y rápido: títulos, resúmenes, clasificación y pasos pequeños.  

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: 

terminalCopiar

```
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. 

  | Lo que ves  | Causa  | Solución  

 | Un error de análisis de JSON, con una respuesta que empieza por < | baseURL sin /v1: la solicitud llegó al sitio web, no a la API | Termina baseURL por /v1 

 | 404 page not found | /v1 dos veces, por lo que la ruta queda como /v1/v1/messages | Usa exactamente https://aiprimetech.io/v1 

 | Invalid API key | La variable no está exportada en el shell desde el que se inició OpenCode, o se está utilizando otra clave | echo $AIPRIME_API_KEY, opencode auth list, reinicia OpenCode 

 | Modelo no compatible / modelo no encontrado | Un ID que el endpoint no ofrece, a menudo un nombre antiguo con fecha | Usa un ID de la tabla anterior 

 | prompt is too long: N tokens > N tokens | La sesión superó lo que acepta el modelo | /compact, y reduce limit.context 

 | Concurrency limit exceeded for user | Los subagentes en paralelo superan el límite de concurrencia de tu clave | Ejecuta menos subagentes a la vez o solicita a soporte un límite de concurrencia mayor 

 | Insufficient account balance | El saldo está agotado | [Recargar saldo](/es/topup/) y vuelve a intentarlo 

 | No available accounts o This request could not be completed | Problema temporal de capacidad en el proveedor | Vuelve a enviar el mensaje; cambia de modelo si el problema persiste  

Para los errores que proceden del modelo y no del cliente, consulta [guía de errores de la API de Claude](/es/learn/claude-api-errors-troubleshooting/). 

## Preguntas frecuentes 

 ¿Dónde está el archivo de configuración de OpenCode?

La configuración global está en ~/.config/opencode/opencode.json y la de cada proyecto en opencode.json, en la raíz del repositorio. OpenCode combina ambas. ¿Cómo uso Claude en OpenCode con una clave API?

Establece provider.anthropic.options.baseURL en la URL de la pasarela terminada en /v1 y apiKey en {env:YOUR_VAR}, o añade un proveedor personalizado con npm @ai-sdk/anthropic; después, elige el modelo con model: provider/model-id. ¿Por qué OpenCode falla con un error de análisis o con una respuesta que empieza por '<'?

A baseURL le falta /v1, por lo que las solicitudes llegan al sitio web en lugar de a la API. @ai-sdk/anthropic espera el prefijo completo, por ejemplo, https://aiprimetech.io/v1. ¿Puede OpenCode usar un inicio de sesión de Claude Pro o Max?

La documentación de OpenCode señala que Anthropic prohíbe los plugins de terceros para Pro/Max y que OpenCode dejó de incluirlos en 1.3.0. La vía admitida es una clave API.  

Empieza a usar Claude en minutos

Obtén una clave de API: no necesitas una cuenta de Anthropic ni estar en una lista de espera.[Obtén tu clave de API](/register) 

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.    

## Más guías de la API de Claude

[Cómo obtener una clave de API de Claude](/es/learn/how-to-get-a-claude-api-key/)[Precios de la API de Claude, explicados](/es/learn/claude-api-pricing-explained/)[La forma más económica de usar la API de Claude](/es/learn/cheapest-way-to-use-claude-api/)[Cursor ilimitado con la API de Claude](/learn/use-claude-api-with-cursor/)[Acceso ilimitado a Claude Code](/es/learn/use-claude-api-with-claude-code/)[Gateway de la API de Claude frente al acceso directo a Anthropic](/es/learn/claude-api-vs-anthropic-direct/)[Usar Claude a través de una API compatible con OpenAI](/es/learn/openai-compatible-claude-api/)[Los modelos de Claude explicados: una comparación de Claude Opus, Sonnet, Haiku y Fable; todos los modelos de la API de Claude, nombres de modelos de Anthropic y precios (2026)](/es/learn/claude-api-models-compared/)[Pagar la API de Claude con criptomonedas](/es/learn/claude-api-with-crypto-payment/)[Acceso a la API de Claude sin lista de espera](/es/learn/claude-api-without-waitlist/)[Cómo reducir el uso de tokens de Claude](/es/learn/how-to-reduce-claude-token-usage/)[Cline ilimitado con la API de Claude](/es/learn/use-claude-api-with-cline/)[Roo Code ilimitado con la API de Claude](/es/learn/use-claude-api-with-roo-code/)[Claude ilimitado en los IDE de JetBrains](/es/learn/use-claude-api-with-jetbrains/)[Aider sin límites con la API de Claude](/es/learn/use-claude-api-with-aider/)[Claude ilimitado en VS Code](/es/learn/use-claude-api-with-vscode/)[Ejecutar un agente Hermes sin límites con Claude](/es/learn/run-hermes-agent-with-claude-api/)[Ejecutar OpenClaw sin límites con Claude](/es/learn/run-openclaw-with-claude-api/)[Qué significa una API compatible con Anthropic](/es/learn/anthropic-compatible-api/)[Clave API de Claude Code — ANTHROPIC_API_KEY: cómo obtenerla, configurarla y cuándo usar claude setup-token en su lugar](/es/learn/claude-code-api-key-setup/)[Costes de la API de Claude Code: precios y cómo reducirlos](/es/learn/claude-code-api-costs/)[Explicación de los errores de la API de Claude: error del servidor 500, sobrecarga 529, límite de solicitudes 429, solicitud incorrecta 400 y la solución para cada uno](/es/learn/claude-api-errors-troubleshooting/)[Cómo comprar créditos para la API de Claude y por qué un crédito de Claude es mejor que cualquier oferta de «comprar una cuenta de Claude»](/es/learn/buy-claude-api-credits/)[API gratuita de Claude: ¿existe una clave API de Claude gratuita y qué es realmente gratis en 2026?](/es/learn/claude-api-free-trial/)[API de Claude frente a la suscripción Claude Pro/Max: cuál elegir](/es/learn/claude-api-vs-subscription/)[Ejecutar la CLI de Codex con Claude](/es/learn/use-claude-api-with-codex/)[Conectar Claude a n8n](/es/learn/use-claude-api-with-n8n/)[Enrutar LiteLLM a Claude](/es/learn/use-claude-api-with-litellm/)[Usar Claude en Kilo Code](/es/learn/use-claude-api-with-kilo-code/)[Integra Claude en GitHub Copilot](/es/learn/use-claude-api-with-github-copilot/)[Conecta Zed a Claude a través de la pasarela](/es/learn/use-claude-api-with-zed/)[Conecta Cherry Studio a Claude](/es/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic en LangChain: importación, base_url, streaming, herramientas y errores](/es/learn/use-claude-api-with-langchain/)[SDK de Python de Anthropic: instalación, configuración de base_url, streaming y gestión de errores](/es/learn/anthropic-python-sdk/)[Claude con Vercel AI SDK: baseURL de createAnthropic, streaming y soluciones](/es/learn/use-claude-api-with-vercel-ai-sdk/)[Ejecuta Factory Droid con Claude](/es/learn/use-claude-api-with-factory-droid/)[La API de Claude Code, explicada](/es/learn/claude-code-api/)[Integración de la API de Claude en tu aplicación](/es/learn/claude-api-integration/)[Cómo usar Claude sin límites y por qué no existe un «Claude Code crackeado»](/es/learn/get-unlimited-claude-usage/)