104K+Descargar
AyudaConecta herramientas externas a la API de OpenDesign Cloud

Conecta herramientas externas a la API de OpenDesign Cloud

Gestiona tus claves de API de OpenDesign en la web y usa los modelos compatibles con tu plan en un agente externo. La aplicación de escritorio de OpenDesign no es necesaria. La configuración con un clic importa la conexión mediante CC Switch en tu ordenador.

Elige la conexión que necesitas

Para importar una clave de proveedor en OpenDesign, sigue la configuración de BYOK. Esta guía explica el proceso inverso: usar la API de modelos de OpenDesign Cloud desde una herramienta externa como Claude Code o Codex.

Antes de empezar

La Cloud API de OpenDesign está disponible con los planes Go, Plus, Pro y Max. El plan Free no es compatible. La lista de modelos de tu cuenta determina qué modelos de texto puedes usar; los modelos que aparecen en las capturas de pantalla son ejemplos y no están incluidos en todos los planes.

Los agentes compatibles son Claude Code, Codex, Grok Build, OpenCode, OpenClaw y Hermes Agent. Instala primero el agente que hayas elegido. Si CC Switch ya está instalado, puedes omitir el paso de instalación.

Abre las claves de API en la web

Inicia sesión en la gestión de la cuenta de OpenDesign en la web y elige API keys (claves de API) en la barra lateral. Selecciona One-click agent setup (configuración del agente con un clic) en la esquina superior derecha. Puedes empezar sin una clave existente.

La página completa de API keys: One-click agent setup está en la esquina superior derecha; Connection setup contiene los formatos de API y sus URL base.

Para realizar la configuración manual, abre Connection setup, selecciona el formato de API que requiere tu herramienta —Chat Completions, Responses o Messages— y copia su URL base de la API. Asegúrate de que el endpoint y el protocolo coincidan. Los pasos siguientes muestran la importación con un solo clic.

Paso 1: Instala y abre CC Switch

  1. En One-click agent setup, selecciona Download for Mac (descargar para Mac) o Download for Windows (descargar para Windows).
  2. Instala y abre CC Switch. Omite este paso si ya está instalado.

Paso 2: Elige un agente y un modelo

  1. Selecciona el agente de destino. Claude Code está seleccionado de forma predeterminada.
  2. Elige un modelo de texto de la lista Model disponible para tu plan. Si no hay ningún modelo disponible, elige otro agente o comprueba tu plan; copiar el nombre de un modelo de una captura de pantalla no concede acceso.
El cuadro de configuración: elige el agente de destino y, después, un modelo disponible para tu cuenta.

Paso 3: Importa y reinicia

  1. Selecciona Import into CC Switch (importar en CC Switch). Esto crea una clave nueva con el nombre del agente y del sistema, como Claude Code · Mac, y abre CC Switch.
  2. Permite Open CC Switch (abrir CC Switch) en el aviso del navegador. Revisa el API Endpoint, la clave y el modelo en CC Switch y, después, selecciona Import (importar).
  3. Vuelve a la página web y selecciona Done (listo), o Set up another agent (configurar otro agente) para crear otra conexión.
  4. Reinicia el agente de destino. Para Claude Code, sal de la sesión actual y ejecuta claude en un terminal nuevo.
La ventana de confirmación de CC Switch: comprueba el endpoint y el modelo antes de importar. La clave está oculta en esta captura de pantalla.

Cada configuración con un clic crea una clave nueva; no puede reutilizar una existente. Las claves existentes no se ven afectadas. La configuración anterior del agente sigue disponible en CC Switch.

Verifica la conexión activa

  1. Envía un mensaje breve en el agente reiniciado y confirma que responde.
  2. En Claude Code, ejecuta /status y compara el modelo con tu selección. En otros agentes, usa la vista de estado equivalente.
  3. En la página web de API keys, comprueba si se actualiza la hora de Last used (último uso) de la clave nueva.

Si el modelo anterior sigue activo, cierra la sesión antigua y reinicia el agente. Si el navegador no abrió CC Switch, busca el aviso de confirmación cerca de la barra de direcciones, abre CC Switch y vuelve a seleccionar Open (abrir). Más adelante puedes cambiar el modelo en CC Switch sin repetir la configuración.

Vuelve a la configuración anterior o revoca el acceso

En CC Switch, busca la configuración anterior del agente y actívala para volver a ella. Eliminar una configuración de CC Switch no desactiva la clave de API. Revoca la clave en la página web de API keys cuando quieras que deje de funcionar.

Consulta la página de la cuenta para comprobar tu plan actual y la disponibilidad de modelos. Consulta el tutorial de configuración del agente con un clic para ver la grabación completa y las capturas de pantalla, o Suscripciones y facturación para configurar la cuenta.

¿Las llamadas a la API comparten los créditos de la aplicación?

Sí. Las llamadas normales a la API comparten los límites del plan y los periodos de uso con la aplicación. Crear otra clave o cambiar de agente no los restablece. Los créditos promocionales pueden tener condiciones de acceso a la API independientes. Consulta créditos y uso.

Abre la consola de Cloud para gestionar las claves y el uso. Las herramientas como Zcode que aceptan un endpoint de modelo y una clave personalizados pueden configurarse para el protocolo de API correspondiente. Esto no significa que OpenDesign pueda iniciar esa herramienta como agente local integrado.

Las solicitudes con imágenes superan el límite de tamaño

Las indicaciones de soporte actuales especifican un límite de 50 MiB para el cuerpo de las solicitudes de API. Se aplica al cuerpo completo, no a cada imagen; la codificación de imágenes también aumenta su tamaño. Reduce el número o las dimensiones de las imágenes y vuelve a intentarlo con una solicitud pequeña. Si sigue fallando, proporciona al equipo de soporte el estado de la respuesta, la hora de la solicitud y el modelo sin exponer tu clave.