Claude Desktop

Ejecuta Claude Code dentro de la app Claude Desktop (pestaña Code) con OneProvider, sin una cuenta de Claude.

App Claude Desktop con la pestaña Code

Qué funciona

La pestaña Code (Claude Code con interfaz visual) y Cowork funcionan con OneProvider mediante el modo gateway integrado de Claude Desktop, que Anthropic llama third-party inference (inferencia de terceros). No hace falta ninguna cuenta de Claude ni de Anthropic. Funciona en macOS 14+ y en Windows 10 (2004) o posterior, incluido Windows 11.

Limitación del cliente

El modo gateway es solo local: las sesiones se ejecutan en tu computadora, sin sesiones en la nube, SSH ni Remote Control. Desktop toma el gateway del formulario de abajo, no de ANTHROPIC_BASE_URL ni de ~/.claude/settings.json (esos son para la línea de comandos de Claude Code). Sin el formulario, Desktop solo se abre con una suscripción de pago de Claude.

Configuración

1. Instala Claude Desktop y no inicies sesión

   Descarga la app desde claude.com/download (macOS: .dmg, arrastra Claude a Aplicaciones; Windows: instalador .msix) y ábrela. Quédate en la pantalla de inicio de sesión: no inicies sesión ni crees una cuenta de Anthropic.

2. Activa el Developer Mode

   macOS: en la barra de menús elige Help → Troubleshooting → Enable Developer Mode (Ayuda → Solución de problemas → Activar modo de desarrollador). Windows: haz clic en el menú de la aplicación ☰ en la esquina superior izquierda de la pantalla de inicio de sesión y luego en Help → Troubleshooting → Enable Developer Mode. La app se reinicia y aparece un menú Developer; se mantiene activo tras los reinicios.

3. Abre Configure Third-Party Inference

   Elige Developer → Configure Third-Party Inference… (Configurar inferencia de terceros). En la sección Connection pon Inference provider en Gateway y rellena la tarjeta Gateway credentials como se muestra. La base URL es exactamente esta, sin /v1 y sin ruta final; pega tu clave de OneProvider en Gateway API key.

   Inference provider: Gateway
   Gateway base URL: https://api.oneprovider.dev
   Gateway API key: sk-your-key-here
   Credential kind: Static API key
   Gateway auth scheme: Bearer (x-api-key also works)

4. Revisa la lista de modelos

   Deja Models vacío al principio: Desktop consulta https://api.oneprovider.dev/v1/models y muestra los modelos Claude del catálogo. Si el selector sigue vacío, abre la sección Models y añade el ID exacto del modelo Claude (<your-compatible-model-id>) del catálogo de modelos; la primera entrada es la predeterminada para las sesiones nuevas de Code.

5. Aplica, reinicia y arranca en modo gateway

   Haz clic en Apply Changes y luego en Save & Restart. Tras el reinicio, la pantalla de inicio de sesión ofrece arrancar con tu configuración de proveedor de inferencia: elige esa opción, no el inicio de sesión de Anthropic. Abre la pestaña Code, elige una carpeta de proyecto local y envía un mensaje.

Verifica la conexión

Confirma la solicitud en tu panel

Envía un mensaje corto en una sesión nueva de Code. En menos de un minuto la solicitud debe aparecer en el panel, en Consumo, con el modelo, los tokens y el importe cobrado. Si falla:

Pantalla de inicio de sesión estándar sin la opción de proveedor → el formulario no se aplicó: cierra la app por completo (Cmd+Q en macOS, Administrador de tareas en Windows) y vuelve a abrirla
"Gateway was unreachable" → revisa la base URL (exactamente https://api.oneprovider.dev) y apaga la VPN o el proxy
401 → clave incorrecta, revocada o caducada: revísala en el panel, en Claves
429 insufficient balance → recarga el saldo del panel y reenvía
Selector de modelos vacío → añade el ID del modelo en la sección Models
"Error 403: Forbidden" → estás en la vía de inicio de sesión de Anthropic: elige la opción de proveedor
Lo que aplicó Desktop: Help → Troubleshooting → Generate Diagnostic Report → Export to file (managed-config.txt, provider-status.txt)
Registro: ~/Library/Logs/Claude-3p/main.log (macOS) o %LOCALAPPDATA%\Claude-3p\Logs\main.log (Windows)

Datos de conexión

Protocolo

anthropic

Endpoint

https://api.oneprovider.dev

Seguridad de la clave

La clave se guarda solo en la configuración de Desktop de esta computadora. Usa una clave dedicada con límite de gasto; si la computadora es compartida o la clave se filtra, elimina o pausa esa clave en el panel y el resto de tu saldo estará a salvo.

Respuestas rápidas

¿Qué base URL uso?

Claude Code y los SDK de Anthropic usan https://api.oneprovider.dev. Los SDK de OpenAI y los clientes compatibles con OpenAI usan https://api.oneprovider.dev/v1. Una misma clave funciona con ambas; la lista de modelos está en la página de modelos y las tarifas, en la página de precios .

¿Cómo me autentico?

Envía la clave sk-… tal cual en x-api-key o en Authorization: Bearer: en uno de los dos, nunca en ambos. Guarda la clave en una variable de entorno, no en un archivo que se suba al repositorio. Más sobre la autenticación .

¿Dónde obtengo una clave?

Abre tu panel en el bot de Telegram @oneprovider_robot o en app.oneprovider.dev, recarga el saldo y pulsa “Emitir una clave”. Cada clave puede tener su propio límite de gasto. Panel y claves de API .

¿Qué significan 401, 404 y 429?

401: falta la clave, está mal escrita o se envió en un encabezado equivocado; pega la clave completa, sin comillas ni espacios. 404: casi siempre es una base URL incorrecta, por ejemplo con /v1 ausente o duplicado. 429 con “Insufficient balance”: se agotó el saldo del panel o el límite de gasto de la clave, así que recarga en lugar de reintentar; cualquier otro 429 es un límite de frecuencia, así que espera según Retry-After. Detalles: códigos de error y solución de problemas .

¿Por qué se cortan o se reinician los streams?

Las VPN y los proxies VLESS suelen almacenar SSE en búfer o romper la negociación de HTTP/2. OneProvider no tiene restricciones regionales y no almacena los streams en búfer: desactiva el proxy y reintenta.

¿Dónde pregunto si esto no basta?

Escribe a @Oneproviderhelpbot en Telegram o abre “Soporte” en el panel web, con el código de estado HTTP y el mensaje de error exacto. Cómo funciona el soporte .