PluelyPluelyDocumentación

Guías

Cómo conectar una CLI de IA local a Pluely

Envía las preguntas de Pluely a una CLI que ya usas (Claude Code, Gemini CLI, OpenAI Codex, Qwen Code u Ollama) para que las respuestas salgan de una herramienta de tu propio equipo. Una vez conectada, tu CLI aparece en la parte superior del selector de modelos de la superposición.

Qué significa “Tu CLI” en Pluely

El selector de modelos de la superposición se divide en grupos: Tu CLI, Búsqueda web / Modelos de Pluely y Tus proveedores. “Tu CLI” es una herramienta de línea de comandos de IA instalada en tu equipo a la que Pluely se conecta directamente. Mientras haya una CLI conectada, es la opción activa: las respuestas se generan en local a través de ella, no con ningún modelo alojado.

CLI compatibles

  • Claude Code: la CLI de Anthropic; Sonnet / Opus / Haiku con tu suscripción de Claude.
  • Gemini CLI: la CLI de Google, con tu plan de Google AI o una clave de API de Gemini.
  • OpenAI Codex: modelos de la clase GPT-6 con tu plan de ChatGPT.
  • Qwen Code: modelos Qwen3-Coder con un Alibaba Cloud Coding Plan o una clave de API de Model Studio.
  • Ollama: modelos abiertos que se ejecutan totalmente sin conexión en tu hardware.

Paso a paso: conectar una CLI

  1. Comprueba que la CLI está instalada y funciona desde tu terminal (inicia sesión ahí primero si necesita una cuenta).
  2. Abre el Panel (icono de Inicio en la esquina superior izquierda de la superposición) → Dev Space → Conectar tu CLI.
  3. Pluely detecta automáticamente las CLI instaladas y muestra la versión de cada una, sin rutas que escribir. ¿Acabas de instalar una? Haz clic en el botón de actualizar junto al título de la sección para volver a buscar.
  4. Haz clic en Conectar en la CLI que quieras.
  5. Debajo de la fila conectada aparece un panel Modelo: elige un modelo conocido, escribe un ID de modelo personalizado o deja Predeterminado (decide la CLI). Ollama es la excepción: en él es obligatorio elegir uno de los modelos que hayas descargado en local.
  6. Abre el selector de modelos de la superposición: tu CLI es la primera opción y aparece con su modelo (por ejemplo, Claude Code · opus).

Capturas de pantalla y modelos de razonamiento

  • El panel Modelo te indica si la configuración actual puede ver imágenes: Claude Code, Gemini CLI, OpenAI Codex y Qwen Code pueden ver imágenes; en Ollama depende del modelo descargado (llava, gemma3, qwen-vl y otras familias multimodales).
  • Los modelos de razonamiento funcionan con todas las CLI: la cadena de pensamiento se elimina automáticamente para que solo veas la respuesta final.

Por qué importa trabajar en local

Una CLI conectada se ejecuta en tu propio equipo, así que las solicitudes no tienen que salir de tu dispositivo para llegar a la infraestructura gestionada de Pluely. Si ya pagas o mantienes una suscripción a una CLI, Pluely se convierte en una superposición cómoda sobre una herramienta en la que ya confías, sin ningún modelo gestionado nuevo de por medio.

Volver a los modelos gestionados

Abre el selector de modelos y elige cualquier opción de “Modelos de Pluely” o “Tus proveedores”: eso desactiva el modo CLI por ahora, y volver a conectarla es un clic en Dev Space. Para quitar la conexión por completo, usa Desconectar en la fila de la CLI.

Solucionar problemas con una CLI que no responde

  • Ejecuta la CLI en tu terminal, fuera de Pluely: si falla ahí (sesión caducada, suscripción que falta), soluciónalo primero ahí; Pluely funcionará igual.
  • Cuando algo falla, Pluely muestra el propio mensaje de error de la CLI, así que la solución suele aparecer indicada directamente en la superposición.
  • ¿Acabas de instalar o actualizar una CLI? Haz clic en el botón de actualizar junto a “Conectar tu CLI” para volver a detectarla.
  • ¿Has elegido un ID de modelo personalizado que da error? Vuelve a Predeterminado (decide la CLI): siempre funciona.
  • Pluely gestiona automáticamente el requisito de “directorio de confianza” de Gemini CLI y la comprobación del repositorio git de Codex, sin necesidad de opciones.

Consejos

  • Claude Code, Gemini CLI, OpenAI Codex y Qwen Code requieren sus propias cuentas: Pluely no gestiona esa facturación, solo se conecta a lo que ya está instalado.
  • Ollama es una gran opción para ejecutar IA totalmente sin conexión, en local y sin coste.
  • Mantén tu CLI actualizada por tu cuenta; Pluely usa la versión que haya en tu equipo.
  • Si cambias a menudo entre una CLI y los modelos gestionados, el selector de modelos de la parte superior de la superposición lo deja a un clic.

Relacionado

Última actualización: 10 de julio de 2026 · pluely.com