Claude Desktop: fallos de Cowork y Code con un Gateway
Corrige fallos de Cowork y errores del modo Code en Claude Desktop después de conectar BetterToken como Gateway. Con configuración, ejemplos y soluciones.
Después de configurar BetterToken Gateway en Claude Desktop, los siguientes síntomas no suelen indicar que la API Key sea incorrecta:
- El modo Cowork no funciona
- El modo Code muestra
Claude Code process exited with code 1 - La misma API Key funciona en Claude Code CLI desde una terminal
Si aún no has configurado el Gateway, empieza por usar la API de BetterToken en Claude Desktop.
Corrige primero el modo Cowork
Claude Desktop solo admite modelos Claude. Es una limitación del cliente Claude Desktop.
Comprueba que la API Key esté completa y no haya vencido. Usa x-api-key en esta configuración Gateway, guarda y reinicia Claude Desktop.
Sigue la guía de Claude Desktop: selecciona Gateway, usa la Base URL https://bettertoken.ai, tu BetterToken API Key y Gateway auth scheme x-api-key. Pulsa Apply locally y reinicia Claude Desktop por completo.
Corrige después los errores de cierre del modo Code
Si Cowork funciona, pero el modo Code —la pestaña </>— sigue mostrando Claude Code process exited with code 1, comprueba si Claude Desktop todavía usa una versión anterior de Claude Code incluida en la aplicación.
Causa principal: Claude Desktop puede estar descargando en segundo plano una versión más reciente de Claude Code. Antes de que termine la descarga, el modo Code puede recurrir a una versión anterior instalada de Claude Code. Esa versión puede no ser compatible con el uso de un Gateway de terceros en modo Code, por lo que el proceso se cierra de inmediato.
Cómo corregirlo:
Espera a que termine la descarga de la versión nueva de Claude Code
Mantén Claude Desktop abierto durante un tiempo para que finalice la actualización de Claude Code en segundo plano.
Cierra Claude Desktop por completo
Usa Cmd+Q para cerrar la aplicación por completo. No cierres solo la ventana.
Vuelve a abrir la aplicación e inicia una sesión de Code nueva
Abre Claude Desktop de nuevo, entra en el modo Code e inicia una sesión nueva.
Referencia rápida
| Síntoma | Causa habitual | Solución |
|---|---|---|
| Cowork | Gateway auth scheme | Comprueba que la API Key esté completa y no haya vencido. Usa x-api-key en esta configuración Gateway, guarda y reinicia Claude Desktop. |
El modo Code muestra Claude Code process exited with code 1 | Claude Desktop recurre a una versión anterior de Claude Code | Espera a que termine la descarga de la versión nueva, cierra por completo con Cmd+Q y vuelve a abrir la aplicación |
