Home → Guides → Apuntar Claude Desktop y Codex a APICLAN

Apuntar Claude Desktop y Codex a APICLAN

Las aplicaciones de escritorio no tienen un campo de base URL en sus propios ajustes. CC Switch escribe esa configuración por ti. Aquí está exactamente qué introducir y las dos cosas que explican casi todas las instalaciones que fallan.

Antes de empezar

Necesitas una cuenta con saldo y una clave API. Créala en la consola, en «Claves API»: elige la familia de proveedor que vas a llamar — Anthropic para Claude Desktop, OpenAI para Codex — y después el grupo de claves del que quieras gastar. El grupo fija tu tarifa; lo que cuesta cada modelo está en la página de precios.

Una clave pertenece exactamente a un grupo. Una clave creada para modelos de texto no puede llamar a modelos de imagen, ni al revés; eso vuelve como un 404 sobre el modelo, no como un error de permisos. Si necesitas ambos, crea dos claves. Lo que una clave concreta puede llamar lo dice siempre GET /v1/models enviado con esa clave.

La dirección que se escribe y la regla del /v1

Toda solicitud tiene que llegar a una ruta que empiece por /v1. Si hay que escribir /v1 en el cliente depende del cliente: unos lo añaden solos y otros no. Este único detalle está detrás de la mayoría de los avisos de «no conecta».

ClienteDirección de solicitud a escribir
Claude Desktop (via CC Switch)https://apiclan.us/v1
Codex / ChatGPT desktop apphttps://apiclan.us/v1
OpenAI SDK, Cherry Studio, Chatbox, LobeChat, LM Studiohttps://apiclan.us/v1
Cursor, Cline, Roo Codehttps://apiclan.us/v1
Claude Codehttps://apiclan.us
Anthropic SDKhttps://apiclan.us

Al revés, la solicitud da 404 en el borde, lo que significa que nunca llega a la pasarela y nunca aparece en tu registro de uso — así que un registro vacío es en sí mismo el síntoma. No dejes nunca una barra final en la dirección.

Codex, que ahora viene dentro de la app de escritorio de ChatGPT

Codex se ha integrado en la aplicación de escritorio ChatGPT. En Windows, instala ChatGPT desde la Microsoft Store; en macOS, descárgala del sitio de OpenAI. El Codex de línea de comandos admite los mismos ajustes.

En CC Switch, añade un proveedor para Codex, pega tu clave e introduce https://apiclan.us/v1 como dirección de solicitud. Activa ese proveedor y después cierra Codex por completo — no basta con cerrar la ventana — y vuelve a abrirlo. La configuración se lee al arrancar, así que una instancia en marcha conserva los ajustes antiguos y parece que no ha pasado nada.

Si prefieres editar el archivo de configuración a mano en lugar de usar CC Switch, la base URL y dónde va la clave están en nuestra guía rápida.

La aplicación Claude Desktop

Instala Claude Desktop desde claude.com y configura el proveedor en CC Switch:

  1. Abre CC Switch, elige el destino Claude Desktop y añade un proveedor nuevo.
  2. Ponle el nombre que quieras y pega tu clave de APICLAN en el campo API Key.
  3. Introduce https://apiclan.us/v1 como dirección de solicitud — el cliente le añade /messages. Sin barra final.
  4. Guarda, abre Claude Desktop y elige un modelo.

Si CC Switch te ofrece elegir entre conexión directa y mapeo de modelos, lee la sección siguiente antes de decidir. Ese ajuste es el que determina si el selector de modelos funciona.

Cuando el selector de modelos devuelve un error de pasarela

Un aviso de que la conexión funciona pero el proveedor rechazó la solicitud casi siempre trata del nombre del modelo, no de la clave. La aplicación de escritorio envía sus propios identificadores de modelo integrados, y una pasarela solo puede servir los modelos que sus cuentas de origen ofrecen realmente.

La solución es el mapeo de modelos en lugar de la conexión directa: haz corresponder las entradas de la app con los nombres que sirve esta pasarela. La conexión directa solo funciona si el proveedor acepta exactamente los identificadores que envía la app.

Envía GET /v1/models con tu clave para obtener la lista a la que mapear. Esa lista se construye a partir del grupo de tu propia clave, así que es la respuesta real para tu cuenta y no un catálogo general.

Volver a la cuenta oficial

No se sobrescribe nada de forma permanente. En CC Switch, activa de nuevo el proveedor oficial y reinicia el cliente: la aplicación de escritorio vuelve a tu suscripción. Puedes dejar ambos configurados y cambiar cuando quieras — el saldo aquí es prepago y no caduca, así que una configuración sin usar no cuesta nada.

Si aun así no funciona

¿Sigues atascado? Escribe a support@apiclan.us con el nombre del modelo que falló y más o menos cuándo lo intentaste. Lo lee una persona.

Start using it

No subscription, no monthly minimum, no sales call. Top up with USDT and spend what you use — 1 USDT gives you 2 credits of API balance.

Read the 30-second quickstart

Prices quoted on this page are regenerated automatically from live billing data. Third-party terms are quoted from that party's own published documentation.