Índice de la documentación

// Documentación de Singularity

Proveedores de IA y ajustes de los agentes

Singularity orquesta exactamente siete proveedores: Claude Code, Codex, Copilot, Cursor, Gemini, Mistral y Ollama. Ejecuta sus herramientas de línea de comandos en tu equipo; por tanto, el CLI elegido debe estar instalado, autenticado y operativo antes de iniciar un agente.

El modelo: Singularity controla CLI

Singularity no se comunica directamente con las API de los proveedores. Prepara el ticket, abre un proceso local y controla el CLI del proveedor seleccionado. Instala primero ese CLI con el método recomendado por su fabricante, abre un terminal, ejecútalo una primera vez y completa su autenticación.

La prueba más sencilla consiste en pedir una respuesta al CLI desde la carpeta de un proyecto. Si solicita un inicio de sesión, la aprobación de una carpeta o una actualización, resuélvelo antes de lanzar un ticket en Singularity.

Claude Code

Instala Claude Code, ejecuta claude y sigue el inicio de sesión interactivo de Anthropic. La lista de modelos (Auto y los modelos Claude disponibles para tu cuenta) se carga desde el catálogo del proveedor, por lo que puede cambiar sin que esta página se actualice.

La pestaña permite ajustar el modo de permisos, el esfuerzo, el razonamiento extendido o adaptativo, el modo rápido reservado a Opus, la caché de prompts, el contexto extendido, la memoria, los límites de razonamiento y de salida, así como los equipos de agentes.

Codex

Instala el CLI de Codex, ejecuta codex y conecta tu cuenta de OpenAI siguiendo el flujo propuesto. Los modelos mostrados son los del catálogo de Codex disponible en el equipo, junto con la opción Auto.

La pestaña expone la personalidad, la política de aprobación, el sandbox, el esfuerzo y el resumen del razonamiento, así como el editor utilizado para abrir las referencias. Las opciones de seguridad modifican realmente los permisos concedidos al proceso: prefiere el acceso al espacio de trabajo salvo necesidad explícita.

Copilot

Instala el CLI de GitHub Copilot, ejecuta copilot y autentícate en GitHub. Tu cuenta y tu organización deben permitir Copilot. A continuación se ofrecen Auto y los modelos que devuelve Copilot.

La pestaña ajusta el modo de aprobación (sugerencia, edición automática o autonomía completa), la búsqueda web, el modo plan y la delegación. Empieza en modo sugerencia en un repositorio sensible.

Cursor

Instala Cursor y su agente CLI y, después, ejecuta agent para completar el inicio de sesión. Auto y los modelos publicados por Cursor alimentan el selector. También se puede introducir una clave en la pestaña; el campo está oculto.

Los ajustes cubren los permisos (force, shell o plan), las confirmaciones del modo shell, la búsqueda web y la conservación del historial de sesión.

Gemini

Instala Gemini CLI, ejecuta gemini y elige el inicio de sesión de Google propuesto. Auto y los modelos Gemini autorizados se descubren a través del catálogo.

Es la pestaña más detallada: aprobaciones, número de intentos y de turnos, compresión y retención de las sesiones, detección de bucles, enrutamiento de los planes, estrategia de exceso de uso, formato de texto o JSON, sandbox, modo Vim, actualización automática, notificaciones e integración con el IDE.

Mistral

Instala el CLI Mistral Vibe y comprueba que arranca desde un terminal. Después, configura un perfil o una clave de Mistral en el campo oculto de la pestaña. Se ofrecen Auto y los modelos que devuelve el proveedor.

Puedes activar los modelos sin conexión, elegir entre YOLO, ask y plan para los permisos y ajustar la búsqueda web y la persistencia del historial.

Ollama y los modelos locales

Instala Ollama, inicia su daemon local y comprueba ollama list. Singularity utiliza por defecto el endpoint local http://127.0.0.1:11434 y dirige Claude Code hacia ese servidor. La pestaña permite buscar, descargar, eliminar y actualizar modelos; también recomienda los adecuados a la RAM y al procesador mediante llmfit o una estimación.

Descarga el modelo antes de seleccionarlo. Un modelo pequeño cuantizado responde más rápido y consume menos memoria, pero sigue peor las instrucciones largas y las refactorizaciones complejas. En CPU, cuenta con una generación notablemente más lenta; en una máquina sin suficiente RAM o memoria de GPU, el modelo puede volverse inutilizable. Mantén un proveedor remoto para las tareas difíciles.

Elegir el modelo predeterminado

El ajuste del proveedor define el modelo predeterminado para los nuevos agentes del espacio de trabajo. Auto — pick based on context (Auto — elegir según el contexto) deja que la precualificación seleccione un modelo admisible según la tarea.

En un ticket, el selector de agente puede sustituir esa elección para esa ejecución: es útil para reservar un modelo potente a una migración o elegir un modelo rápido para una corrección mecánica. El ajuste del ticket prevalece sobre el predeterminado del espacio sin modificarlo.

Excluir modelos o niveles de razonamiento

En «Models for automatic selection» (Modelos para la selección automática), desmarca un modelo para impedir que Auto lo elija. Sigue disponible para una selección manual. Usa esta exclusión para evitar un modelo demasiado caro, demasiado lento, obsoleto o inadecuado para tu repositorio.

Cuando el proveedor expone una profundidad de razonamiento, también puedes retirar algunos niveles de los selectores de ticket. Así se evita, por ejemplo, un razonamiento mínimo en código crítico o un nivel máximo en tareas cortas. Estas exclusiones reducen las elecciones automáticas; no desinstalan nada.

¿Cómo medir el coste real de un lote de tickets?

Para medir el coste de un lote de tickets, registra el consumo del mismo ámbito antes y después de su ejecución y, después, separa gastos variables, suscripciones y tiempo humano. Un contador de tokens o una estimación de sesión no prueba el importe facturado. No se garantiza ningún coste por ticket ni ningún ahorro.

  1. Definir la tarea de control. Elige una pequeña corrección representativa, con el commit de partida, el mismo conjunto de datos, los criterios de aceptación y las pruebas. Enumera los tickets del lote, incluidos los que fallan. Para comparar dos flujos de trabajo, parte del mismo estado y conserva los mismos criterios.
  2. Fijar el contexto. Anota el proveedor, la versión del CLI, el modelo realmente utilizado (y cada cambio si Auto está activo), el esfuerzo, el número de agentes y el modo suscripción o API. Identifica la cuenta/el proyecto de facturación sin copiar ninguna clave ni dato confidencial.
  3. Registrar antes. Anota la fecha y hora con la zona horaria y guarda la fuente del contador, su periodo, su moneda, los tokens por modelo y los valores de caché si están disponibles. Aísla el lote de los demás usos de la cuenta o declara la medición no atribuible. Con Claude Code interactivo, consulta /usage en la sesión correspondiente; para un lote orquestado sin acceso a esa sesión, usa el registro del proveedor del ámbito aislado, no una nueva sesión vacía del CLI.
  4. Ejecutar y registrar. Conserva todos los intentos, errores, relanzamientos, subagentes y correcciones tras la revisión. Cronometra por separado la preparación, la espera de la máquina, la revisión humana y la integración. La duración real de una sesión no es tiempo de trabajo humano.
  5. Registrar después. Espera a que terminen los agentes y se actualicen los contadores; conserva la hora de captura y la ventana cubierta. Usa exactamente la misma fuente y el mismo ámbito. Archiva cada sesión antes de su puesta a cero; una diferencia negativa o un cambio de periodo invalida la resta.
  6. Conciliar y publicar los límites. Calcula después menos antes, en la misma unidad. Para la API, concilia la estimación con los importes del proveedor cuando estén disponibles. Suma solo periodos disjuntos: no cuentes dos veces un total padre y sus subagentes. Indica los tickets intentados, aceptados y rechazados, la calidad obtenida y el tiempo de revisión. Una media por ticket aceptado solo vale para este lote, con los fallos incluidos en el numerador.

¿Cómo medir el consumo de Claude Code?

La documentación oficial de costes de Claude Code, consultada el 11 de octubre de 2026, describe /usage: el bloque Session estima el coste de los tokens; las barras de suscripción siguen los límites del plan. El importe de la sesión no es la factura de una suscripción Pro o Max. Para la API, consulta la vista Usage de la Claude Console de la cuenta facturada (requiere iniciar sesión). Comprueba el comando disponible en tu versión del CLI y la actualidad del registro.

Ejemplo ilustrativo: tres tickets, no un benchmark

Cifras ficticias, no medidas. En un ámbito de API aislado, un registro acumulado del proveedor del 11/10/2026 a las 10:00 UTC indica 12,00 USD y el de las 10:40 UTC, 13,80 USD, para el mismo periodo y la misma moneda: diferencia ilustrativa de 1,80 USD. El registro ficticio cuenta tres tickets intentados, dos aceptados, uno rechazado, cuatro intentos y 18 minutos de revisión. El modelo exacto y la versión del CLI deberían anotarse en un registro real; este ejemplo no ejecutó ningún modelo.

Si los registros son completos y exclusivos del lote, 1,80 / 2 = 0,90 USD por ticket aceptado solo para este ejemplo, fallo incluido. No es una tarifa anunciada ni una previsión. Con una suscripción, anota más bien la evolución de la cuota y los posibles excesos realmente facturados: no conviertas un porcentaje de cuota en euros. Una parte proporcional de suscripción es una convención contable que debe explicitarse, no un coste marginal observado.

Ficha de registro para copiar

Lote / tickets / commit de partida:
Criterios / pruebas / datos:
Proveedor / versión del CLI / modelo(s) / esfuerzo / agentes:
Modo suscripción o API / ámbito de facturación:
Fuente / periodo / zona horaria / moneda / impuestos:
Antes: fecha y hora, importe o cuota, tokens/caché disponibles
Después: fecha y hora, importe o cuota, tokens/caché disponibles
Intentos / errores / relanzamientos / tickets aceptados y rechazados:
Minutos de preparación / espera / revisión / integración:
Diferencia observada / conciliación con la factura / pruebas anonimizadas:
Límites: usos simultáneos, plazos, reinicios, caché, gastos excluidos

La caché, los precios contractuales, las monedas, los impuestos, los créditos y otros dispositivos pueden impedir una atribución exacta. Si falta un contador, indica «no disponible», nunca cero. Mantén la licencia de Singularity, las suscripciones de los proveedores, los excesos, la ejecución remota y el tiempo humano en líneas separadas; no vuelvas a contar un consumo ya incluido. Consulta las tarifas y costes de los proveedores y aplica esta ficha al protocolo comparativo de Claude Code.

Lo que sale de tu equipo

Singularity no sube por sí mismo tu código a un proveedor de IA. Solo los CLI que has instalado y configurado se comunican con sus servicios externos, según sus propias condiciones, ajustes y políticas de conservación. Por tanto, los prompts, fragmentos de archivos y resultados de herramientas que necesita el agente pueden pasar por el proveedor elegido.

Con Ollama en la dirección local y un modelo ejecutado localmente, la inferencia se queda en el equipo; no obstante, la descarga inicial de un modelo contacta con el registro de Ollama. Un endpoint de Ollama remoto o un modelo en la nube ya no es local. Consulta la tabla de políticas de las siete integraciones. Comprueba siempre la URL configurada y los permisos del agente antes de trabajar con un repositorio confidencial.

¿Qué políticas de datos se aplican a las siete integraciones?

La conservación depende del proveedor, del plan y de la cuenta que utiliza realmente el CLI. Esta revisión de la documentación de los fabricantes, consultada el , permite localizar la norma aplicable; no constituye ni un compromiso de Singularity ni una verificación de tu contrato.

Fuentes consultadas el 11 de octubre de 2026
Integración / cuenta / CLIDestino y caso local o remotoFuentes oficiales: tratamiento y conservación
Claude Code
Cuenta de Claude o API / claude
Anthropic; plataforma de terceros si está configurada. Remoto.Anthropic: uso y conservación. Distinguir Free/Pro/Max de las condiciones comerciales Team/Enterprise/API; ajustes y excepciones propios de la cuenta.
Codex
Cuenta de ChatGPT o clave de API / codex
OpenAI, o el proveedor/la pasarela configurados. Remoto para estos servicios.OpenAI: cuenta y normas aplicables; conservación en la API. Las normas del workspace de ChatGPT y las de la organización de la API no son intercambiables.
Copilot
Cuenta de GitHub autorizada / copilot
Servicios de GitHub Copilot y modelos seleccionados. Remoto.GitHub: datos de las sesiones; privacidad y conservación. Comprobar el plan individual o Business/Enterprise y el ajuste de almacenamiento en la nube de las sesiones.
Cursor
Cuenta o clave de Cursor / agent
Backend de Cursor y, después, proveedor del modelo, incluso con una clave personal. Remoto.Cursor: Data Use & Privacy. Tratamiento según el Privacy Mode; caché y excepciones antiabuso descritas por Cursor. No equiparar este modo con una ausencia total de almacenamiento.
Gemini
Cuenta de Google o clave / gemini
Code Assist, Gemini API o Vertex AI según la autenticación. Remoto.Google: condiciones y privacidad de Gemini CLI. Elegir el aviso del servicio utilizado: individual, Standard/Enterprise, API gratuita/de pago o Vertex AI; las condiciones de Gemini para el gran público no bastan.
Mistral
Perfil o clave / CLI Mistral Vibe
API de Mistral configurada: remoto. Modelo sin conexión: local solo si el servidor y el modelo lo son.Mistral: tratamiento y conservación; condiciones ZDR del CLI. ZDR depende de la organización y de la API admisible; no aplicar al CLI las normas de Vibe Work/Chat.
Ollama
Daemon de Ollama; Claude Code dirigido a su endpoint
Modelo local en 127.0.0.1: local. Modelo en la nube o endpoint remoto: remoto, incluso a través de un daemon local.Ollama: datos locales/en la nube y desactivación de la nube. Las FAQ distinguen el tratamiento en la nube de la inferencia local; un servidor privado depende también de la política de su operador. La descarga contacta con el registro.

Antes de trabajar con un repositorio confidencial, comprueba la autenticación, el endpoint, el modelo, las opciones de compartición y las normas de tu organización. Ausencia de entrenamiento, ausencia de conservación e historial local son tres cuestiones distintas. Aquí no se deduce ningún plazo universal: las excepciones legales, antiabuso, los comentarios voluntarios y los servicios con estado deben consultarse en las fuentes. Las herramientas web, las extensiones/MCP, los registros y los historiales del CLI pueden tener sus propios destinos y plazos, incluso con una inferencia local.

Preguntas frecuentes

¿Necesita Singularity mis claves de API?

No para los proveedores que autentican su propio CLI. Cursor y Mistral también ofrecen un campo de clave en sus ajustes; está oculto en la interfaz. Ollama puede recibir un token si tu endpoint local o privado lo exige.

¿Por qué no aparece un modelo?

La lista procede del catálogo del proveedor activo. Comprueba que su CLI está instalado y autenticado y, después, reinicia o actualiza Singularity. Con Ollama, el modelo también debe estar descargado localmente.