OpenCode integración con la API de Claude

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.

Usa la función de proveedor personalizado de OpenCode para conectarte a 1折AI. Primero crea una clave API y confirma los modelos disponibles actualmente ; los ID de modelo de abajo son ejemplos, ajústalos según los permisos de tu clave.

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 para la lista de modelos y precios.

Configuración de OpenCode v1

Según Providers oficiales de v1 : ejecuta /connect, selecciona Other, introduce el ID del proveedor onezhe y rellena la clave API de este sitio. Fusiona en el proyecto opencode.json:

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "provider": {
4
    "onezhe": {
5
      "npm": "@ai-sdk/openai-compatible",
6
      "name": "1折AI",
7
      "options": { "baseURL": "https://1zheai.com/v1" },
8
      "models": {
9
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
10
      }
11
    }
12
  }
13
}

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 , usa los campos nativos de v2; no se pueden mezclar con los de v1 anteriores. Fusiona en el proyecto opencode.jsonc:

1
{
2
  "$schema": "https://opencode.ai/config.json",
3
  "providers": {
4
    "onezhe": {
5
      "name": "1折AI",
6
      "env": ["ONEZHE_API_KEY"],
7
      "package": "@opencode/ai/providers/openai-compatible",
8
      "settings": { "baseURL": "https://1zheai.com/v1" },
9
      "models": {
10
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
11
      }
12
    }
13
  }
14
}

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

Guarda y recarga la configuración; confirma que el proveedor seleccionado actualmente es onezhe o el modelo personalizado que añadiste.
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.
Abre el registro de llamadas 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.
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 .

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 y las reglas de facturación . Si necesitas otros clientes, vuelve al directorio de integración de herramientas ; si escribes tu propio programa, puedes usar la guía de SDK y desarrollo .