Tutorial de configuración de Claude Desktop (cliente de escritorio)

Claude Desktop es el cliente de escritorio oficial de Anthropic (Windows / macOS). Incorpora una entrada de configuración para la «pasarela de inferencia de terceros», que permite enviar las solicitudes de conversación a NextHub sin iniciar sesión con una cuenta oficial.

Claude Desktop y Claude Code son dos cosas distintas

Claude Desktop (cliente de escritorio) y Claude Code (línea de comandos / extensión de VS Code) son dos productos independientes: sus configuraciones no son intercambiables y hay que configurarlos por separado. Esta página trata del cliente de escritorio; para la configuración de la línea de comandos, consulta configurar Claude Code manualmente.

Preparativos

1. Un ApiKey de un grupo de la familia Claude: claude code (0.37x), Claude Max (0.5x) o Claude-AWSB (0.7x); consulta gestión del ApiKey. Claude Desktop usa el protocolo Anthropic Messages, por lo que la dirección sigue el mismo criterio que la de Claude Code
2. Descarga el instalador de tu sistema desde claude.com/download

Notas sobre la instalación en Windows

Al ejecutarse, el instalador de Windows necesita acceder a los servicios oficiales de Anthropic. Si tu red no permite la conexión directa, abre cmd en el directorio del instalador, define las variables de entorno del proxy y vuelve a lanzar el instalador (sustituye el puerto por el tuyo):

set HTTP_PROXY=http://127.0.0.1:7897
set HTTPS_PROXY=http://127.0.0.1:7897
"Claude Setup.exe"

En macOS puedes instalarlo directamente con normalidad.

Configuración manual (modo de desarrollador)

1. Activa el modo de desarrollador

Abre Claude Desktop y ve a la pantalla de inicio de sesión:

• Windows: haz clic con el ratón en el campo del correo para enfocarlo, usa la tecla Tab para llevar el foco al menú de la esquina superior izquierda y pulsa Enter para entrar en Help → Troubleshooting → Enable developer mode
• macOS: entra directamente en el menú de la esquina superior izquierda en Help → Troubleshooting → Enable developer mode

Después de activarlo, espera a que el programa se reinicie automáticamente.

2. Configura la pasarela de inferencia de terceros

Con el mismo método abre el menú y entra en Developer → Configure third-party inference; rellena los campos según esta tabla:

Campo	Contenido
Gateway base URL	https://api.nexthub.cc
Gateway auth scheme	x-api-key
Gateway API key	tu ApiKey de NextHub (grupo de la familia Claude)
Skip login-mode chooser	activado

Haz clic en Apply locally, en la esquina inferior derecha, para aplicar la configuración.

No esperes a que «apruebe la prueba»

Esta página funciona en modo de pasarela de terceros, no con la verificación de inicio de sesión de una cuenta oficial de Anthropic, así que no habrá (ni hace falta esperar) un aviso de «conexión correcta / prueba superada». Después de pulsar Apply locally, vuelve directamente al cuadro de diálogo y envía un mensaje: si recibes respuesta, la configuración está activa.

3. Verificación

Crea una conversación nueva y envía un mensaje; si recibes una respuesta normal de Claude, la conexión se ha realizado correctamente.

La pequeña llamada del primer mensaje

Después de crear una conversación nueva, puede aparecer en el registro de consumo una llamada pequeña de un modelo distinto del que has elegido: la genera el cliente automáticamente para poner título a la conversación. El importe es mínimo y es un comportamiento normal.

Configuración con CC-Switch (opcional)

¿Te parece lioso el proceso manual? CC-Switch incluye un panel de Claude Desktop que permite importar con un clic los proveedores ya configurados en Claude Code:

1. Abre CC-Switch y selecciona Claude Desktop en el conmutador de aplicaciones de la izquierda (si no lo encuentras, ve a Ajustes → General → Visibilidad de aplicaciones para confirmar que la entrada no esté oculta)
2. La primera vez que entres, pulsa «Importar los proveedores existentes de Claude Code»; o pulsa + en la esquina superior derecha para añadirlo a mano: en la dirección de la interfaz pon https://api.nexthub.cc y en API Key la clave del grupo de la familia Claude
3. Pulsa «Habilitar» en la tarjeta del proveedor y después cierra Claude Desktop por completo y vuelve a abrirlo (a diferencia de Claude Code, no recarga la configuración en caliente: cerrar la ventana no equivale a salir del programa)

Las dos advertencias tras el reinicio son falsas alarmas

Después de un reinicio completo, la pantalla de conversación puede mostrar avisos como «configuración no verificada» o «conexión de red»: son falsas alarmas habituales del modo pasarela; ignóralas sin más, y si los mensajes se envían y se reciben con normalidad, la configuración está activa. Si no recibes respuesta, comprueba en este orden: si CC-Switch está en ejecución, si la dirección de la interfaz y el ApiKey están bien escritos y si has olvidado reiniciar por completo.