Instalación — paso a paso

Instalar Kirat

Claude se puede usar de tres maneras, y en cada una Kirat se instala de forma distinta. Primero averigua cuál es la tuya y luego sigue solo esos pasos. La mayoría necesita una.

Videotutorial con capítulos, unos 7 minutos. Subtítulos en CC.

¿Dónde hablas con Claude?

Abre la app de Claude. Arriba ves las pestañas Chat, Cowork y Code. En Code, el selector que hay debajo del cuadro de mensaje dice Local o Cloud.

A · unos 2 minutos App de Claude, pestaña Chat La ventana de chat normal en Mac o Windows. Extensión de escritorio → B · unos 10 minutos Pestaña Code con «Local», o Claude Code en una terminal o en VS Code Claude trabaja con archivos de tu computadora. Plugin de Claude Code → C · unos 10 minutos Pestaña Code con «Cloud», claude.ai/code en el navegador o Code en la app móvil Claude trabaja en los servidores de Anthropic. Entorno en la nube →

¿Usas varias? Configura cada una. La extensión no llega a las sesiones de Code, y nada de tu computadora llega a una sesión en la nube.

No compatible: el chat de claude.ai en el navegador, el chat de las apps móviles de Claude y las tareas de Cowork que se ejecutan en la nube.

Antes de empezar: dos claves de API

Kirat usa tus propias claves. OpenAI y Google te cobran directamente lo que uses; nosotros nunca vemos tus claves. Conseguirlas es la parte lenta, por los formularios de registro y facturación de los proveedores.

OpenAI: en platform.openai.com, abre API keys y crea una clave. Activa la facturación y fija un límite mensual; conviene usar un proyecto aparte para Kirat.
Google Gemini: en aistudio.google.com, haz clic en Get API key. Activa la facturación del proyecto asociado y fija un presupuesto.
Ten ambas claves a mano (por ejemplo, en tu gestor de contraseñas). Las introduces en el siguiente paso.

Opcional, permisos mínimos: en OpenAI basta con una clave restringida (Restricted), con «List models» en Read y «Model capabilities» en Request, y todo lo demás en None. Una clave de Gemini creada en Google AI Studio ya está restringida a la API de Gemini.

App de Claude, pestaña Chat

Descomprime la descarga (Windows: clic derecho → Extraer todo…; Mac: doble clic). Obtienes una carpeta llamada kirat.
En la app de Claude, abre Settings → Extensions → Advanced settings y haz clic en Install Extension…. Elige el archivo .mcpb de la carpeta kirat. O arrastra el archivo a la página Extensions.
Introduce ambas claves de API y haz clic en Install. La app avisa de que la extensión no está verificada por Anthropic. Es lo normal en toda extensión instalada desde un archivo.
Abre un chat nuevo y escribe: Use the Kirat extension and call kirat_status. Ambos miembros deberían estar disponibles, y la comprobación de claves debería decir ok para las dos.

Las plantillas listas para usar (decide, review, critique, brainstorm) están en el botón + del cuadro de mensaje.

Pestaña Code con «Local», o Claude Code en una terminal o en VS Code

Esta vía necesita un comando en una terminal. Las sesiones locales de la pestaña Code y Claude Code comparten su configuración, así que instalas una sola vez para ambos.

Descomprime la descarga y mueve la carpeta kirat a tu carpeta personal (Mac: /Users/<usuario>, Windows: C:\Users\<usuario>). Déjala ahí: Claude Code ejecuta Kirat desde esa carpeta. Si tu nombre de usuario de Windows tiene un espacio, usa C:\kirat y escribe C:/kirat/claude-code en el comando de abajo.
Abre una terminal (Mac: la app Terminal; Windows: PowerShell) y escribe node --version. Si muestra v20 o superior, sigue. Si no, instala la versión LTS desde nodejs.org y abre una terminal nueva.
Ejecuta este comando en la terminal:
claude plugin install kirat --marketplace ~/kirat/claude-code
Si claude no se reconoce, instala primero Claude Code (ver code.claude.com, Quickstart). Si el comando es demasiado antiguo, ejecuta antes claude update.
Introduce ambas claves cuando te las pida. Si no te pide nada, escribe /plugin configure kirat@kirat en una sesión de Claude Code en la terminal.
Abre una sesión local nueva (o reinicia Claude Code) y escribe: Use the Kirat extension and call kirat_status.

Plantillas en Claude Code: /kirat:decide, /kirat:review, /kirat:critique, /kirat:brainstorm.

Sesiones en la nube: pestaña Code con «Cloud», claude.ai/code, app móvil

Todo ocurre en la configuración de tu entorno en la nube, en el navegador o en la app de Claude. Sin terminal. Lo haces una vez por entorno; después, cada sesión nueva en él tiene Kirat.

Abre la configuración del entorno. En la app de Claude: Code → el selector de entorno debajo del cuadro de mensaje → Cloud → pasa el ratón sobre tu entorno → icono de engranaje. En claude.ai/code es el mismo selector debajo del cuadro de mensaje: pasa el ratón sobre el entorno y haz clic en el icono de configuración.

Añade tus claves como network secrets. En Network secrets, haz clic dos veces en Add secret y deja el tipo Bearer:

Name	Allowed websites	Nombre del header	Prefix	Value
OpenAI	`api.openai.com`	`Authorization`	`Bearer`	tu clave de OpenAI
Gemini	`generativelanguage.googleapis.com`	`x-goog-api-key`	vacío (bórralo)	tu clave de Gemini

Nadie en una sesión puede leer estas claves, ni siquiera Claude. En los planes Team y Enterprise puede que la sección no aparezca o que solo ofrezca un formulario corto; en ese caso, pide ayuda a tu administrador o introduce las claves en Environment variables, una por línea: KIRAT_OPENAI_API_KEY=… y KIRAT_GEMINI_API_KEY=… (cualquiera que use el entorno puede leerlas).

Acceso a la red. Si dice Full, no hay nada que hacer. Si no, elige Custom, marca Also include default list of common package managers y añade kirat.ai a los dominios permitidos. Con variables de entorno en lugar de network secrets, añade también api.openai.com.
Script de configuración. En tu descarga, abre START-HERE.html (doble clic, se abre en el navegador) y haz clic en Copy setup block. Pégalo al principio del campo Setup script, por encima de lo que ya haya.

La dirección de descarga del bloque forma parte de tu compra: no la publiques.
Guarda y abre una sesión nueva en este entorno. Esta primera sesión ejecuta la configuración y normalmente aún no muestra Kirat, porque arrancó antes de que terminara. Abre una segunda sesión nueva y escribe: Call kirat_status. Ambos miembros deberían estar disponibles, y la comprobación de claves debería decir ok. A partir de ahí, cada sesión nueva tiene Kirat.

¿No funcionó? kirat_status indica qué clave o host revisar. Si Kirat tampoco aparece en la segunda sesión, el registro de configuración dice «Kirat setup failed» y el motivo. Después de corregirlo, cambia el script de configuración (basta con una línea vacía); si no, las sesiones nuevas conservan el estado anterior.

Antes de confiar en ello, lee los límites en la nube: entre otras cosas, el presupuesto diario cuenta por sesión, así que fija límites de gasto en OpenAI y Google.

¿Sigues atascado?

Claude no conoce Kirat: comprueba qué vía usas (sección 01). Una extensión de la pestaña Chat no aparece en las sesiones de Code.
Un miembro no está disponible: falta su clave de API o es incorrecta. kirat_status te dice cuál.
Las llamadas se bloquean: se agotó el presupuesto diario. Súbelo en la configuración de Kirat o espera al día siguiente (UTC).

El README.md de tu descarga cubre configuración, costes, actualizaciones y más problemas (en inglés). Kirat se ofrece sin soporte. Si no funciona en un entorno compatible, puedes pedir un reembolso en un plazo de 14 días: escribe a support@kirat.ai con tu número de pedido y la salida de kirat_status (nunca contiene tus claves).