Configura ClineCore para sesiones de programación con privacidad

Configura la sesión antes de enviar código privado

ClineCore permite que una aplicación cree un entorno de ejecución e inicie sesiones con la configuración del modelo y del entorno. La decisión práctica sobre privacidad no consiste solo en elegir un proveedor: también importa qué datos recibe la sesión, qué herramientas pueden actuar sobre ellos y qué conserva o expone tu aplicación después.

Los ejemplos siguientes son ilustrativos, no integraciones probadas. La referencia de ClineCore documenta la estructura de la API, pero no confirma que todos los proveedores acepten los mismos parámetros de modelo o ajustes de endpoint. Consulta la documentación de tu proveedor antes de depender de opciones específicas.

Separa los ajustes compartidos de los ajustes de sesión

Las opciones de ClineCore.create abarcan decisiones como el nombre del cliente, el modo de backend, las políticas de herramientas, las capacidades y si la automatización está activada. La llamada start requiere un config con los ajustes de modelo y entorno de la sesión. El ejemplo documentado incluye providerId, modelId, apiKey, systemPrompt, cwd, workspaceRoot y los indicadores de herramientas y agentes.

Un patrón básico del lado del servidor sería:

import { ClineCore } from "@cline/sdk"

const cline = await ClineCore.create({
  clientName: "private-code-review",
  backendMode: "auto",
  toolPolicies: {
    // Set policies for the tools your application exposes.
  },
})

const session = await cline.start({
  prompt: "Review the selected files for risky input handling.",
  config: {
    providerId: process.env.CLINE_PROVIDER_ID!,
    modelId: process.env.CLINE_MODEL_ID!,
    apiKey: process.env.CLINE_API_KEY!,
    systemPrompt: "Review only the supplied code. Do not request secrets.",
    cwd: process.cwd(),
    workspaceRoot: process.cwd(),
    enableTools: false,
    enableSpawnAgent: false,
    enableAgentTeams: false,
  },
})

Este ejemplo utiliza variables de entorno como práctica para gestionar credenciales; la referencia no prescribe un gestor de secretos ni define los nombres de estas variables de entorno. Mantén la clave en un servidor de confianza, no la envíes al código del navegador y evita imprimir la configuración de sesión en los registros de la aplicación. Si el proveedor requiere un endpoint o parámetros adicionales, configúralos solo según indique su documentación y verifica que ClineCore admita los campos necesarios.

Define explícitamente las decisiones de privacidad

Antes de iniciar una sesión, decide qué necesita el agente. Si la tarea lo permite, es preferible limitar el acceso a un espacio de trabajo acotado o a archivos seleccionados en lugar de proporcionar un repositorio entero. Excluye del material que le suministres secretos, datos personales y archivos no relacionados. Un prompt de sistema puede indicar cómo deben tratarse los datos, pero no sustituye a los controles de acceso ni a la minimización de datos.

Revisa el acceso a las herramientas con el mismo cuidado que el contenido de los prompts. ClineCore acepta políticas de herramientas predeterminadas y por sesión, y las capacidades de ejecución pueden incluir ejecutores de herramientas propios del cliente y callbacks de aprobación. Mantén las herramientas desactivadas cuando la tarea no las requiera; si hacen falta, aplica políticas y aprobaciones adecuadas a sus efectos. La referencia documenta estos puntos de configuración, pero no define el comportamiento de cada herramienta ni garantiza que una política concreta impida todas las acciones sensibles.

Considera que los registros de sesión pueden contener datos sensibles. La API puede enumerar sesiones, recuperar metadatos y mensajes, consultar el uso acumulado, actualizar registros y eliminar sesiones. Por eso, tu aplicación debe decidir quién puede llamar a estos métodos y qué reglas de conservación se aplican. No incluyas secretos ni datos personales innecesarios en sessionMetadata, los mensajes iniciales o los prompts: los metadatos y los mensajes son datos de sesión, no un sistema seguro para almacenar secretos.

La opción distinctId se describe como un identificador estable de telemetría/usuario. Si la utilizas, piensa si tu aplicación necesita realmente un identificador estable y si podría identificar a una persona. La referencia no explica la recopilación de telemetría, su conservación ni su anonimización; no des por hecho que el identificador es anónimo ni que configurarlo controla toda la telemetría.

Soluciona problemas habituales de configuración

• La creación de la sesión rechaza la configuración: Comprueba que config esté presente y que los identificadores del proveedor y del modelo coincidan con los valores aceptados por el proveedor. La referencia proporcionada ofrece un ejemplo, no un catálogo completo de proveedores.
• Falla la autenticación: Comprueba que la clave esté disponible en el proceso del servidor, que corresponda al proveedor seleccionado y que no se haya recortado o sustituido accidentalmente. Nunca incluyas la clave en un prompt de diagnóstico ni la pegues en una solicitud de soporte.
• Se ignora o rechaza una opción específica del proveedor: La referencia de ClineCore no documenta compatibilidad universal de endpoints o parámetros. Consulta la documentación del proveedor y del SDK en lugar de suponer que los ajustes de un proveedor sirven para otro.
• Una sesión puede realizar más acciones de las previstas: Revisa enableTools, las políticas de herramientas y las capacidades proporcionadas. Si no hacen falta herramientas, empieza con ellas desactivadas y habilita solo las necesarias para el flujo de trabajo.
• Aparece contenido sensible en el historial: Revisa qué rutas de la aplicación llaman a readMessages, list y otras API de sesión; después, aplica controles adecuados de autorización y conservación. La referencia expone estas API, pero no especifica las protecciones de almacenamiento o acceso de tu aplicación.
• El trabajo continúa inesperadamente: Utiliza el método documentado abort o stop para la sesión y libera los recursos del entorno de ejecución cuando la aplicación haya terminado de usarlos.

Lista de comprobación reutilizable antes de empezar

Antes de habilitar un flujo de trabajo de ClineCore, confirma que las credenciales permanecen en el servidor; que el espacio de trabajo contiene solo los archivos necesarios; que los prompts y metadatos no contienen secretos; que el acceso a las herramientas está limitado y revisado; que el historial de sesiones tiene un responsable y una política de conservación; y que los ajustes específicos del proveedor se han contrastado con su documentación actual. Para depurar, registra datos no sensibles, como si se inició una sesión y qué ID de solicitud interno corresponde, pero no registres credenciales, prompts completos ni archivos de código fuente.

La referencia de ClineCore ofrece puntos de configuración y gestión de sesiones, pero no una garantía general de privacidad. Un uso respetuoso con la privacidad depende de cómo tu aplicación proporciona los datos, controla el acceso a las herramientas, protege los registros de sesión y gestiona las credenciales.

Fuente

• Referencia de la API de ClineCore — opciones de la API, configuración de sesiones, métodos de gestión de sesiones y resumen de automatización.