---
title: "OpenCode integración con la API de Claude"
description: "Tutorial de configuración de OpenCode para la API de retransmisión de 1折AI Claude, incluyendo dirección, clave y modelo, con selección de protocolo, ejemplos de configuración, pasos de verificación y errores comunes."
headingIds: {"Configuración de OpenCode v1":"section-1","Configuración de OpenCode v2":"section-2","Verificación de la integración y solución de problemas":"section-3","Costes y otras formas de integración":"section-4"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
Usa la función de proveedor personalizado de OpenCode para conectarte a 1折AI. Primero [crea una clave API ](/es/docs/api-keys/) y confirma los [modelos disponibles actualmente ](/es/docs/models/); los ID de modelo de abajo son ejemplos, ajústalos según los permisos de tu clave.

<Note>
Fecha de verificación de la configuración oficial: 2026-10-15. La siguiente configuración se basa en la documentación oficial; la verificación de extremo a extremo en este sitio aún no se ha completado; completa primero una breve pregunta-respuesta y la verificación de llamadas a herramientas antes de usarla en tareas largas. Los modelos OpenAI / GPT ya están disponibles; consulta la [descripción de modelos ](/es/docs/models/) para la lista de modelos y precios.
</Note>

## Configuración de OpenCode v1

Según [Providers oficiales de v1 ](https://opencode.ai/docs/providers/): ejecuta `/connect`, selecciona Other, introduce el ID del proveedor `onezhe` y rellena la clave API de este sitio. Fusiona en el proyecto `opencode.json`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "onezhe": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "1折AI",
      "options": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}
```

Después, en `/models` selecciona el modelo de ese proveedor. `/connect` solo guarda credenciales, no sustituye la configuración del proveedor. Aquí se selecciona explícitamente el SDK de Chat Completions; no se debe cambiar erróneamente por `@ai-sdk/openai`, que se usa para Responses. También se permite referenciar variables de entorno mediante `options.apiKey: "{env:ONEZHE_API_KEY}"`.

## Configuración de OpenCode v2

Según [Providers oficiales de v2 ](https://opencode.ai/v2/docs/providers), usa los campos nativos de v2; no se pueden mezclar con los de v1 anteriores. Fusiona en el proyecto `opencode.jsonc`:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "onezhe": {
      "name": "1折AI",
      "env": ["ONEZHE_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}
```

Proporciona `ONEZHE_API_KEY` en el entorno del proceso que inicia OpenCode y luego, en `/models`, selecciona `onezhe/claude-sonnet-4-6`. La principal diferencia de v2 es `providers`, `package`, `settings`, en lugar de `provider`, `npm`, `options` de v1. Usa primero `opencode --version` para confirmar la versión mayor utilizada.

Si deseas usar Anthropic nativo, v1 permite sobrescribir `provider.anthropic.options.baseURL` oficialmente, con ejemplos que incluyen `/v1`; v2 lista `@opencode/ai/providers/anthropic-compatible`. Este tutorial sigue una configuración explícita compatible con OpenAI; no se debe cambiar el protocolo por el nombre del modelo ni prometer que la caché y las llamadas a herramientas ya estén verificadas.

## Verificación de la integración y solución de problemas

1. Guarda y recarga la configuración; confirma que el proveedor seleccionado actualmente es `onezhe` o el modelo personalizado que añadiste.
2. Envía una pregunta breve; confirma que se puede responder; después intenta una tarea pequeña revocable y confirma por separado las llamadas a herramientas y la conversación de múltiples turnos.
3. Abre el [registro de llamadas ](/es/docs/usage-logs/) y comprueba la hora de la solicitud, el modelo, el estado y el uso. Que una respuesta de texto tenga éxito no significa que todas las capacidades de los Agentes sean compatibles.
4. Si aparece 404, comprueba que la dirección y el protocolo de este artículo coincidan; si aparece 401, comprueba el origen de la clave y si el proceso leyó las variables de entorno; si aparece 429, revisa la información de limitación de tasa antes de reintentar. Para más casos, consulta [códigos de error y solución de problemas ](/es/docs/troubleshooting/).

Las claves se guardan solo en el entorno local o en el almacén de credenciales de la herramienta; no las envíes al repositorio de código, capturas de pantalla ni registros públicos. Los servicios en segundo plano pueden no heredar las variables de entorno del terminal; los modelos auxiliares, la búsqueda y otras herramientas también pueden tener configuraciones de proveedor independientes que deben revisarse por separado.

## Costes y otras formas de integración

Consulta los [precios en tiempo real de la API de Claude ](https://1zheai.com/en/pricing/) y las [reglas de facturación ](/es/docs/pricing-explained/). Si necesitas otros clientes, vuelve al [directorio de integración de herramientas ](/es/docs/integrations/); si escribes tu propio programa, puedes usar la [guía de SDK y desarrollo ](/es/docs/guides/).