Installation — pas à pas

Installer Kirat

Claude s’utilise de trois façons, et pour chacune Kirat s’installe différemment. Identifiez d’abord la vôtre, puis suivez uniquement ces étapes. La plupart des gens n’en ont besoin que d’une.

Tutoriel vidéo avec chapitres, environ 7 minutes. Sous-titres via CC.

Où écrivez-vous à Claude ?

Ouvrez l’app Claude. En haut, vous voyez les onglets Chat, Cowork et Code. Dans Code, le sélecteur sous la zone de message indique Local ou Cloud.

A · environ 2 minutes App Claude, onglet Chat La fenêtre de chat habituelle sur Mac ou Windows. Extension de bureau → B · environ 10 minutes Onglet Code avec « Local », ou Claude Code dans un terminal ou dans VS Code Claude travaille avec des fichiers de votre ordinateur. Plugin Claude Code → C · environ 10 minutes Onglet Code avec « Cloud », claude.ai/code dans le navigateur, ou Code dans l’app mobile Claude travaille sur les serveurs d’Anthropic. Environnement cloud →

Vous en utilisez plusieurs ? Configurez chacune. L’extension n’atteint pas les sessions Code, et rien sur votre ordinateur n’atteint une session cloud.

Non pris en charge : le chat sur claude.ai dans le navigateur, le chat dans les apps mobiles Claude et les tâches Cowork exécutées dans le cloud.

Avant de commencer : deux clés API

Kirat utilise vos propres clés. OpenAI et Google vous facturent directement ce que vous consommez ; nous ne voyons jamais vos clés. Les obtenir est la partie lente, à cause des formulaires d’inscription et de facturation des fournisseurs.

OpenAI : sur platform.openai.com, ouvrez API keys et créez une clé. Activez la facturation et fixez une limite mensuelle ; un projet séparé pour Kirat est une bonne idée.
Google Gemini : sur aistudio.google.com, cliquez sur Get API key. Activez la facturation du projet associé et fixez un budget.
Gardez les deux clés sous la main (par exemple dans votre gestionnaire de mots de passe). Vous les saisirez à l’étape suivante.

Facultatif, droits minimaux : chez OpenAI, une clé restreinte (Restricted) suffit, avec « List models » sur Read et « Model capabilities » sur Request, tout le reste sur None. Une clé Gemini créée dans Google AI Studio est déjà limitée à l’API Gemini.

App Claude, onglet Chat

Décompressez le téléchargement (Windows : clic droit → Extraire tout… ; Mac : double-clic). Vous obtenez un dossier nommé kirat.
Dans l’app Claude, ouvrez Settings → Extensions → Advanced settings et cliquez sur Install Extension…. Choisissez le fichier .mcpb du dossier kirat. Ou faites glisser le fichier sur la page Extensions.
Saisissez les deux clés API et cliquez sur Install. L’app avertit que l’extension n’est pas vérifiée par Anthropic. C’est normal pour toute extension installée depuis un fichier.
Ouvrez un nouveau chat et tapez : Use the Kirat extension and call kirat_status. Les deux membres devraient être disponibles, et la vérification des clés devrait indiquer ok pour les deux.

Les modèles prêts à l’emploi (decide, review, critique, brainstorm) se trouvent sous le bouton + de la zone de message.

Onglet Code avec « Local », ou Claude Code dans un terminal ou dans VS Code

Cette voie demande une commande dans un terminal. Les sessions locales de l’onglet Code et Claude Code partagent leurs réglages : vous installez donc une seule fois pour les deux.

Décompressez le téléchargement et déplacez le dossier kirat dans votre dossier personnel (Mac : /Users/<nom>, Windows : C:\Users\<nom>). Laissez-le là : Claude Code lance Kirat depuis ce dossier. Si votre nom d’utilisateur Windows contient une espace, utilisez C:\kirat et écrivez C:/kirat/claude-code dans la commande ci-dessous.
Ouvrez un terminal (Mac : l’app Terminal ; Windows : PowerShell) et tapez node --version. S’il affiche v20 ou plus, continuez. Sinon, installez la version LTS depuis nodejs.org, puis ouvrez un nouveau terminal.
Exécutez cette commande dans le terminal :
claude plugin install kirat --marketplace ~/kirat/claude-code
Si claude est inconnu, installez d’abord Claude Code (voir code.claude.com, Quickstart). Si la commande est trop ancienne, exécutez d’abord claude update.
Saisissez les deux clés quand elles sont demandées. Si rien ne vous est demandé, tapez /plugin configure kirat@kirat dans une session Claude Code dans le terminal.
Ouvrez une nouvelle session locale (ou redémarrez Claude Code) et tapez : Use the Kirat extension and call kirat_status.

Modèles dans Claude Code : /kirat:decide, /kirat:review, /kirat:critique, /kirat:brainstorm.

Sessions cloud : onglet Code avec « Cloud », claude.ai/code, app mobile

Tout se passe dans les réglages de votre environnement cloud, dans le navigateur ou l’app Claude. Pas de terminal. Vous le faites une fois par environnement ; ensuite, chaque nouvelle session dans cet environnement a Kirat.

Ouvrez les réglages de l’environnement. Dans l’app Claude : Code → le sélecteur d’environnement sous la zone de message → Cloud → survolez votre environnement → icône d’engrenage. Sur claude.ai/code, c’est le même sélecteur sous la zone de message : survolez l’environnement, puis cliquez sur l’icône de réglages.

Ajoutez vos clés comme network secrets. Sous Network secrets, cliquez deux fois sur Add secret et gardez le type Bearer :

Name	Allowed websites	Nom du header	Prefix	Value
OpenAI	`api.openai.com`	`Authorization`	`Bearer`	votre clé OpenAI
Gemini	`generativelanguage.googleapis.com`	`x-goog-api-key`	vide (effacez-le)	votre clé Gemini

Personne dans une session ne peut lire ces clés, pas même Claude. Avec les offres Team et Enterprise, la section peut manquer ou n’offrir qu’un formulaire court ; demandez alors à votre administrateur, ou saisissez plutôt les clés sous Environment variables, une par ligne : KIRAT_OPENAI_API_KEY=… et KIRAT_GEMINI_API_KEY=… (toute personne qui utilise l’environnement peut les lire).

Accès réseau. S’il indique Full, il n’y a rien à faire. Sinon, choisissez Custom, cochez Also include default list of common package managers et ajoutez kirat.ai aux domaines autorisés. Avec des variables d’environnement au lieu de network secrets, ajoutez aussi api.openai.com.
Script de configuration. Dans votre téléchargement, ouvrez START-HERE.html (double-clic, il s’ouvre dans le navigateur) et cliquez sur Copy setup block. Collez-le tout en haut du champ Setup script, au-dessus de ce qui s’y trouve déjà.

L’adresse de téléchargement du bloc fait partie de votre achat : ne la publiez pas.
Enregistrez et ouvrez une nouvelle session dans cet environnement. Cette première session exécute la configuration et n’affiche généralement pas encore Kirat, car elle a démarré avant la fin de la configuration. Ouvrez une deuxième nouvelle session et tapez : Call kirat_status. Les deux membres devraient être disponibles, et la vérification des clés devrait indiquer ok. Ensuite, chaque nouvelle session a Kirat.

Ça n’a pas marché ? kirat_status indique la clé ou l’hôte à vérifier. Si Kirat manque encore dans la deuxième session, le journal de configuration affiche « Kirat setup failed » et la raison. Après correction, modifiez le script de configuration (une ligne vide suffit), sinon les nouvelles sessions gardent l’ancien état.

Avant de vous y fier, lisez les limites dans le cloud : entre autres, le budget quotidien compte par session, fixez donc des limites de dépenses chez OpenAI et Google.

Toujours bloqué ?

Claude ne connaît pas Kirat : vérifiez quelle voie vous utilisez (section 01). Une extension de l’onglet Chat n’apparaît pas dans les sessions Code.
Un membre n’est pas disponible : sa clé API manque ou est erronée. kirat_status vous dit laquelle.
Les appels sont bloqués : le budget quotidien est épuisé. Augmentez-le dans les réglages de Kirat ou attendez le jour suivant (UTC).

Le README.md de votre téléchargement couvre les réglages, les coûts, les mises à jour et d’autres problèmes (en anglais). Kirat est fourni sans assistance. S’il ne fonctionne pas dans un environnement pris en charge, vous pouvez demander un remboursement sous 14 jours : écrivez à support@kirat.ai avec votre numéro de commande et la sortie de kirat_status (elle ne contient jamais vos clés).