Claude Desktop y Claude Code
Puedes usar Claude Desktop y Claude Code con tu key de Quipua: todo lo que hagan se cobra al saldo de tu empresa y al presupuesto del equipo de la key, recibe la memoria de tu empresa y aparece en Uso como cualquier otra petición.
No elijas «Claude API». Esa opción manda la key a Anthropic, que no la conoce y responde 401. Quipua se configura como pasarela (gateway).
Claude Desktop
Primero activa el modo desarrollador. La opción «Configurar inferencia de terceros» sólo aparece con el modo desarrollador activado. En la barra de menús de Claude Desktop: Ayuda → Solución de problemas → Activar modo desarrollador (Help → Troubleshooting → Enable Developer Mode); según la versión, el nombre del menú puede variar ligeramente. Después reinicia la app si te lo pide.
- Con el modo desarrollador activado, abre Configurar inferencia de terceros (en Ajustes de Claude Desktop).
- En Conexión, elige la opción de pasarela / gateway (no «Claude API»).
- URL base:
https://api.quipua.com— sin/v1al final: Claude Desktop añade él mismo/v1/messagesy/v1/models. - Clave de API: tu key de Quipua (empieza por
ci_). - Pulsa Probar conexión. Claude Desktop pide la lista de modelos y verá los de texto de tu empresa (
auto,claude-sonnet-5,claude-opus-5-5,claude-haiku-4-5,gpt-6.1-sol…). - Aplicar cambios.
Si la prueba no encuentra los modelos, añádelos a mano en Models, por ejemplo claude-sonnet-5 y claude-haiku-4-5.
Búsqueda en internet
Funciona sin configurar nada: cuando Claude quiere buscar, Quipua hace la búsqueda y le devuelve los resultados con sus fuentes.
Opcional: si quieres que Claude pueda además abrir una página entera (Web Fetch), por ejemplo una normativa completa o una URL que le pegues, añade en Egreso los dominios que permites (mejor dominios concretos que *). No hace falta para buscar: sin ello, Claude trabaja con los extractos que devuelve la búsqueda.
Cabeceras opcionales
En Encabezados de inferencia personalizados puedes añadir las cabeceras propias de Quipua:
| Cabecera | Valor | Para qué |
|---|---|---|
x-ci-ahorro | conciso | Respuestas más cortas: menos tokens de salida. |
x-ci-memory | off | No anteponer la memoria de la empresa en estas peticiones. |
Claude Code
Exporta estas variables antes de arrancar claude (o ponlas en ~/.claude/settings.json, en env):
export ANTHROPIC_BASE_URL="https://api.quipua.com"
export ANTHROPIC_AUTH_TOKEN="ci_live_xxx"
export ANTHROPIC_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"ANTHROPIC_AUTH_TOKENse envía comoAuthorization: Bearer; también valeANTHROPIC_API_KEY(se envía comox-api-key). Quipua acepta las dos.ANTHROPIC_MODELes el modelo principal;ANTHROPIC_DEFAULT_HAIKU_MODEL, el rápido que usa Claude Code para tareas pequeñas. Puedes ponerautocomo modelo principal si tu equipo tiene el modelo automático.
Coste y límites
- Claude Desktop y Claude Code mandan un prompt de sistema y unas herramientas grandes en cada mensaje. Quipua respeta su caché de prompts (también la de 1 hora), así que en una sesión seguida lo repetido se cobra a una fracción del precio de entrada.
- Se aplican el saldo, el presupuesto del equipo y los límites de la key: sin saldo,
402; presupuesto agotado,403(Saldo, presupuestos y límites). - Para controlar el gasto, crea una key sólo para Claude Desktop/Code con un límite de gasto (por día, semana o mes) en el panel, en Keys.