Claude Desktop con una API de terceros: Configure Third-Party Inference y solución de problemas

Wokey Team · 2026-09-24

Respuesta corta: la app de escritorio de Claude tiene exactamente una forma de usar una API de terceros: Developer → Configure Third-Party Inference. No lee ni ANTHROPIC_BASE_URL ni ~/.claude/settings.json, así que una configuración que funciona en tu terminal no hace nada en la app de escritorio. Esta guía repasa los problemas con los que la gente se encuentra: un menú que no aparece, ajustes que no se aplican, una lista de modelos vacía y funciones que simplemente no están disponibles en el modo de terceros. Para la configuración inicial completa, consulta la guía de configuración de Claude Desktop.

El orden correcto

1. Abre la app de escritorio y no inicies sesión con una cuenta de Anthropic.

2. Abre Help → Troubleshooting → Enable Developer Mode.

3. Abre Developer → Configure Third-Party Inference….

4. En Connection, establece Inference provider en Gateway y luego completa Gateway credentials:

   Campo	Valor
   Gateway base URL	https://api.wokey.ai (sin /v1)
   Gateway API key	Tu clave de API de Wokey
   Credential kind	Static API key
   Gateway auth scheme	Bearer (Wokey también acepta x-api-key; deja el predeterminado)

5. Haz clic en Apply Changes y luego en Save & Restart.

Requisitos del sistema:

• macOS: 14 (Sonoma) o posterior, en Apple silicon o Intel.
• Windows: Windows 10 compilación 19041 o posterior, en x64 o Arm64.

No aparece el menú Developer

El menú Developer solo aparece cuando el modo de desarrollador está activado: Help → Troubleshooting → Enable Developer Mode. Si esa opción tampoco está en el menú Help, actualiza la app a la última versión; las versiones antiguas no tienen la configuración de inferencia de terceros.

La ventana de configuración es de solo lectura

Si la máquina ya tiene una configuración enviada por un administrador, como un perfil MDM de tu empresa, la ventana se abre en modo de solo lectura y no puedes cambiarla localmente. Pregunta a tu administrador o usa una máquina no administrada.

Las variables de entorno no tienen efecto

Es el error más común. La app de escritorio toma la configuración del gateway solo de la configuración de inferencia de terceros. No lee ni ANTHROPIC_BASE_URL ni settings.json.

La pestaña Code de la app de escritorio se comporta igual. Ejecuta el mismo motor de Claude Code que la CLI, pero la dirección del gateway y la credencial vienen directamente de la configuración de escritorio. Los ajustes de nivel de usuario de ~/.claude/settings.json no pueden anularlos.

También funciona al revés: la configuración de escritorio no afecta a claude en tu terminal. Configura cada uno por separado; para la terminal, consulta la guía de base URL de Claude Code.

La lista de modelos está vacía o le faltan modelos

Sin una lista de modelos propia, la app solicita GET /v1/models al gateway y conserva solo los modelos cuyos ID se reconocen como Claude. Por eso, con Wokey, el descubrimiento automático muestra modelos como claude-opus-5 y claude-sonnet-5, y filtra GPT, Grok y otros modelos. Es lo esperado.

Para fijar la lista o elegir el modelo predeterminado, escribe los ID completos de los modelos en la lista de modelos de la ventana de configuración (Model list, la clave inferenceModels):

• La primera entrada es la predeterminada, y las sesiones nuevas de la pestaña Code también empiezan con ella.
• Cuando todas las entradas son ID completos, la app omite la solicitud a /v1/models.
• Si /v1/models falla y la lista está vacía, el selector queda vacío.

Errores

Gateway was unreachable: la app no puede llegar al gateway. Revisa que no haya errores de escritura en Gateway base URL y luego prueba desde una terminal con curl:

curl -X POST https://api.wokey.ai/v1/messages \
  -H "Authorization: Bearer your Wokey API key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":1,"messages":[{"role":"user","content":"."}]}'

Si curl funciona y la app no, la causa suele ser un proxy: la terminal pasa por uno y la app no, o al revés.

401 con code igual a invalid_api_key: la solicitud llegó a Wokey, pero la clave falta o es incorrecta. Wokey acepta ambos esquemas de autenticación, así que no hace falta cambiar ese ajuste. Vuelve a pegar la clave.

invalid x-api-key: la solicitud fue a Anthropic, así que la configuración de terceros no está activa. Por lo general no se hizo clic en Save & Restart, o después se eligió el inicio de sesión de Anthropic en la pantalla de inicio de sesión. Consulta la guía de invalid x-api-key.

Para más detalle: exporta un informe con Help → Troubleshooting → Generate Diagnostic Report. Tres archivos del informe son útiles:

• managed-config.txt: la configuración vigente.
• provider-status.txt: el estado de la conexión con el gateway.
• deployment-mode.txt: el modo actual.

Los registros están en:

• macOS: ~/Library/Logs/Claude-3p/main.log
• Windows: %LOCALAPPDATA%\Claude-3p\Logs\main.log

Funciones no disponibles en el modo de terceros

Estas dependen de una cuenta de Anthropic o de los servicios en la nube de Anthropic, así que no están disponibles con un gateway. No es un problema de configuración:

• Acceso desde el celular y la web de claude.ai
• Modo de voz
• Compartir proyectos y plugins
• Claude Design, Claude Security y Claude Tag
• Computer use
• Remote Control y los entornos en la nube alojados por Anthropic

Otras dos están desactivadas por defecto:

• La búsqueda de herramientas y las funciones beta experimentales. La app las desactiva por compatibilidad con gateways estrictos. Vuelve a activar la búsqueda de herramientas con toolSearchEnabled.
• Las sesiones remotas por SSH. Están en beta en el modo de terceros y requieren que un administrador configure una lista de hosts permitidos.

Volver a tu cuenta de Anthropic

Elige la opción de inicio de sesión de Anthropic en la pantalla de inicio de sesión para volver a la app de escritorio de Claude estándar.