Skip to main content
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
Estos problemas suelen tener dos causas distintas: el esquema de autenticación del Gateway de escritorio no coincide con el proveedor o la versión de Claude Code incluida en Claude Desktop aún no ha terminado de actualizarse. Si aún no has configurado el Gateway, empieza por usar la API de BetterToken en Claude Desktop.

​
Corrige primero el modo Cowork

Causa principal: Gateway auth scheme no coincide con el proveedor. En la configuración de Claude Desktop Gateway, elige el esquema de autenticación según el proveedor:
  • Para un proveedor Claude, establece Gateway auth scheme en x-api-key
  • Para un proveedor GPT, establece Gateway auth scheme en bearer
Después de seleccionar el esquema correcto, Claude Desktop obtiene automáticamente los modelos disponibles para ese grupo. Si el esquema no es correcto, el modo Cowork puede fallar al autenticarse con el Gateway.
1

Abre la configuración de inferencia de terceros

En la barra de menús de macOS, elige Developer → Configure Third-Party Inference….
2

Cambia el esquema de autenticación

Elige Gateway auth scheme según el proveedor: usa x-api-key para un proveedor Claude y bearer para un proveedor GPT.
3

Guarda la configuración

Haz clic en Apply locally para guardar la configuración local del Gateway.
El modo Cowork suele volver a funcionar después de este cambio.

​
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:
1

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.
2

Cierra Claude Desktop por completo

Usa Cmd+Q para cerrar la aplicación por completo. No cierres solo la ventana.
3

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.
Si los registros muestran que Claude Desktop recurre a una versión anterior de Claude Code, como 2.1.111, mientras una versión más reciente, como 2.1.119, aún no está lista, espera a que termine la descarga y reinicia la aplicación.

​
Referencia rápida