# Utiliser Kiro CLI : le guide pas à pas

URL: https://agentvera.dev/fr/blog/how-to-use-kiro-cli/ · Publié: 2026-10-29

Utiliser Kiro CLI : installer kiro-cli, se connecter, discuter avec votre code, choisir un modèle, configurer steering, agents, MCP et specs. Crédits expliqués.

**En bref:**

- Installez-le avec le script officiel, Homebrew ou PowerShell, connectez-vous dans le navigateur avec GitHub, Google, AWS Builder ID ou IAM Identity Center, puis lancez kiro-cli dans le projet et décrivez le changement.
- Les règles du projet vont dans .kiro/steering/ ou AGENTS.md, les agents personnalisés dans .kiro/agents/, les serveurs MCP dans .kiro/settings/mcp.json ; /spec découpe une fonctionnalité en exigences, design et tâches.
- En octobre 2026, Kiro facture en crédits : 50 avec l’offre gratuite, 1 000 avec Pro pour 20 $ par mois. Auto choisit le modèle pour vous, et chaque modèle a son propre multiplicateur de crédits.

Pour utiliser Kiro CLI, installez-le avec `curl -fsSL https://cli.kiro.dev/install | bash` (ou `brew install kiro-cli` sur macOS), connectez-vous dans le navigateur, lancez `kiro-cli` dans le dossier d’un projet et décrivez ce que vous voulez. Kiro lit votre code, modifie des fichiers et exécute des commandes, en vous demandant votre accord avant d’utiliser un outil auquel vous ne faites pas encore confiance. Tapez `/model` pour choisir un modèle, ou laissez Auto et Kiro décide.

Voilà la boucle de base. Ce guide couvre le reste : la connexion, les commandes de chat du quotidien, les modèles et les crédits, les fichiers de steering, les agents personnalisés, les serveurs MCP, les specs, Kiro en CI et Kiro aux côtés d’autres agents. Tout suit la documentation officielle de Kiro en date d’octobre 2026.

## Ce qu’est Kiro

Kiro est l’environnement de développement agentique d’AWS. Il existe sous plusieurs formes qui partagent un même compte : un IDE de bureau, la CLI et Kiro Web. La CLI en est la partie terminal. Elle propose un chat interactif avec une interface plein écran dans le terminal, un mode headless pour les scripts et la CI, et peut servir d’agent aux éditeurs qui parlent l’Agent Client Protocol (ACP).

Ce qui distingue Kiro des autres agents de code, c’est l’accent mis sur les specs. Avant d’écrire le code d’une fonctionnalité, Kiro peut transformer votre idée en exigences, en design et en liste de tâches, puis traiter les tâches une à une. Si l’approche est nouvelle pour vous, [Développement piloté par les specs avec des agents IA](/fr/blog/spec-driven-development-with-ai/ "Développement piloté par les specs avec des agents IA") explique l’idée et compare Kiro aux autres outils qui le font.

Un mot sur les versions : l’installeur fournit Kiro CLI 2.x. La version 3 est une version précoce que vous pouvez essayer avec `kiro-cli --v3`. Elle tourne à côté de votre installation 2.x, et votre configuration reste telle quelle tant que vous ne basculez pas. Ce guide suit la 2.x et signale les différences avec la V3.

## Étape 1 : installer Kiro CLI

| Plateforme | Commande |
| --- | --- |
| macOS, Linux | `curl -fsSL https://cli.kiro.dev/install \| bash` |
| macOS (Homebrew) | `brew install kiro-cli` |
| Windows 11 (PowerShell) | `irm 'https://cli.kiro.dev/install.ps1' \| iex` |

Sous Linux, il existe aussi un paquet `.deb`, un AppImage et une archive zip. La CLI demande glibc 2.34 ou plus récent ; sur une distribution plus ancienne, prenez la variante musl du zip. Sous Windows, lancez l’installeur dans PowerShell ou Windows Terminal ; l’ancienne invite de commandes n’est pas prise en charge.

Vérifiez que tout fonctionne :

```bash
kiro-cli doctor
```

`kiro-cli update` cherche une nouvelle version et `kiro-cli settings app.disableAutoupdates true` désactive les mises à jour automatiques. Avec Homebrew, mettez à jour via `brew upgrade --greedy kiro-cli`.

## Étape 2 : se connecter

Après l’installation, Kiro ouvre le navigateur pour la connexion. Les options sont :

- **GitHub ou Google :** le plus rapide pour un usage individuel.
- **AWS Builder ID :** une identité AWS personnelle et gratuite.
- **AWS IAM Identity Center :** pour les entreprises qui gèrent Kiro via AWS. Vous saisissez l’URL de démarrage et la région de votre organisation.
- **Un fournisseur d’identité externe :** comme Okta ou Microsoft Entra ID, si votre entreprise l’a configuré.

`kiro-cli login` permet de se reconnecter à tout moment. Sur une machine distante sans navigateur, `kiro-cli login --use-device-flow` affiche une URL et un code à ouvrir sur un autre appareil. Le device flow fonctionne avec Builder ID, IAM Identity Center, Google et GitHub, mais pas avec un fournisseur d’identité externe. `kiro-cli whoami` indique le compte connecté et `kiro-cli logout` vous déconnecte.

Bon à savoir : avec l’offre gratuite et les offres individuelles, Kiro peut utiliser votre contenu pour améliorer le service. Vous pouvez le refuser ; la documentation de Kiro explique comment.

## Étape 3 : les bases du chat

Placez-vous dans un projet et lancez Kiro :

```bash
cd my-project
kiro-cli
```

L’interface terminal est celle par défaut. Quelques gestes reviennent sans cesse :

- **`@chemin`** joint un fichier à votre message.
- **`!`** en début de ligne exécute directement une commande shell, par exemple `!npm test`.
- **Shift+Tab** passe en mode plan, où Kiro réfléchit à un changement avant de toucher au code.
- **Shift+Enter** ou **Ctrl+J** ajoute une nouvelle ligne, **Ctrl+O** déplie les sorties longues, **Ctrl+C** quitte.
- **`/paste`** colle une image depuis le presse-papiers.

| Commande | Ce qu’elle fait |
| --- | --- |
| `/model` | Choisir un modèle |
| `/effort` | Régler l’effort de raisonnement |
| `/agent` | Passer à un autre agent |
| `/context` | Voir, ajouter ou retirer des fichiers de contexte |
| `/compact` | Résumer le chat pour libérer du contexte |
| `/plan` | Planifier un changement avant de le construire |
| `/spec` | Créer ou exécuter une spec |
| `/tools` | Accorder ou retirer la confiance aux outils |
| `/mcp` | Vérifier les serveurs MCP et s’y connecter |
| `/usage` | Voir votre offre et les crédits restants |
| `/guide` | Poser des questions sur Kiro CLI lui-même |
| `/quit` | Quitter |

Les chats sont enregistrés par dossier. `kiro-cli chat --resume` reprend le dernier chat du dossier courant, `--resume-picker` vous laisse en choisir un et `--list-sessions` les liste. Si vous préférez l’ancienne interface ligne par ligne, lancez `kiro-cli chat --classic`.

## Étape 4 : modèles et crédits

Par défaut, Kiro utilise **Auto**, qui envoie chaque requête vers un modèle adapté. La documentation le recommande pour la plupart des tâches. Pour choisir vous-même, tapez `/model` dans le chat ou listez les modèles depuis le shell :

```bash
kiro-cli chat --list-models
```

Pour faire d’un modèle celui par défaut, réglez-le :

```bash
kiro-cli settings chat.defaultModel "claude-sonnet-4.6"
```

Kiro facture en crédits, et chaque modèle a un multiplicateur. En octobre 2026, Claude Opus 5 compte 2,2 fois, Claude Sonnet 5.5 1,3 fois, DeepSeek 3.2 0,25 fois et Qwen3 Coder Next 0,05 fois. Une même tâche peut donc coûter très différemment selon le modèle : jetez un œil à `/usage` de temps en temps.

| Offre (octobre 2026) | Prix | Crédits |
| --- | --- | --- |
| Free | 0 $ | 50 |
| Pro | 20 $ par utilisateur et par mois | 1 000 |
| Pro+ | 40 $ par utilisateur et par mois | 2 000 |
| Pro Max | 100 $ par utilisateur et par mois | 5 000 |
| Power | 200 $ par utilisateur et par mois | 10 000 |
| Enterprise | Sur devis | Sur mesure |

Les offres payantes peuvent continuer au-delà de leurs crédits à 0,04 $ par crédit, et des packs supplémentaires existent. L’offre gratuite couvre les modèles open-weight et Claude Sonnet 4.5 ; les modèles Claude les plus récents demandent une offre payante. Les prix et les modèles changent souvent, vérifiez kiro.dev/pricing avant de choisir.

## Étape 5 : fichiers de steering et AGENTS.md

Les fichiers de steering sont des fichiers Markdown qui contiennent les règles de votre projet : ce que fait le produit, la stack technique, où se trouve quoi, ce qu’il faut éviter. Kiro les cherche à deux endroits :

- **Workspace :** `.kiro/steering/` dans le projet, versionné avec le code.
- **Global :** `~/.kiro/steering/`, pour les règles valables partout. En cas de conflit, le workspace l’emporte.

La documentation conseille de commencer par trois fichiers : `product.md`, `tech.md` et `structure.md`. Par défaut, un fichier de steering est inclus dans chaque chat. Vous pouvez le limiter à certains fichiers avec un front matter :

```markdown
---
inclusion: fileMatch
fileMatchPattern: "components/**/*.tsx"
---

- Les composants sont des composants fonctionnels avec des exports nommés.
- Les styles utilisent des CSS modules ; pas de styles inline.
```

Il existe quatre modes : `always` (par défaut), `fileMatch`, `manual` (vous l’ajoutez avec `#nom-du-fichier`) et `auto` (Kiro décide selon le nom et la description du fichier). Kiro CLI 2.x ne charge automatiquement que les fichiers `always` ; la V3 prend en charge les quatre.

Kiro lit aussi `AGENTS.md` et le traite comme un fichier de steering toujours inclus. Si votre équipe en maintient déjà un pour Codex, opencode ou d’autres agents, Kiro l’utilise tel quel. Pour savoir quoi y mettre, voyez [Bonnes pratiques CLAUDE.md](/fr/blog/claude-md-agents-md/ "Bonnes pratiques CLAUDE.md").

## Étape 6 : agents personnalisés

Un agent personnalisé est une configuration enregistrée, avec son prompt, son modèle, ses outils et ses fichiers de contexte. Créez-en un avec :

```bash
kiro-cli agent create my-agent
```

Les agents se trouvent dans `.kiro/agents/` (par projet) ou `~/.kiro/agents/` (globaux), en JSON ou, avec la V3, aussi en Markdown. Un court exemple :

```json
{
  "name": "my-agent",
  "description": "Reviews backend changes",
  "prompt": "You are a careful backend reviewer.",
  "model": "claude-sonnet-4.6",
  "includeMcpJson": true,
  "resources": ["file://.kiro/steering/**/*.md", "file://./ARCHITECTURE.md"]
}
```

Ouvrez un chat avec lui via `kiro-cli --agent my-agent`, changez d’agent dans le chat avec `/agent`, ou faites-en l’agent par défaut avec `kiro-cli settings chat.defaultAgent my-agent`. `kiro-cli agent list` affiche vos agents et `kiro-cli agent validate` vérifie un fichier.

Deux pièges. D’abord, les agents personnalisés n’incluent pas d’eux-mêmes les fichiers de steering ; c’est pourquoi l’exemple ajoute `.kiro/steering/**/*.md` dans `resources`. Ensuite, les agents du dossier d’un projet ne se chargent qu’une fois ce workspace approuvé. Les champs de permissions des outils diffèrent entre 2.x et V3 ; `/upgrade-agent` convertit un agent quand vous passez à la V3.

## Étape 7 : serveurs MCP

Les [serveurs MCP](/fr/blog/what-is-mcp-server/ "Qu’est-ce qu’un serveur MCP ?") donnent de nouveaux outils à Kiro : recherche dans la documentation, un navigateur, votre gestionnaire de tickets. Ils se déclarent dans un fichier `mcp.json`, soit `.kiro/settings/mcp.json` dans le projet, soit `~/.kiro/settings/mcp.json` pour tous les projets :

```json
{
  "mcpServers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "disabled": false
    },
    "my-remote": {
      "url": "https://mcp.example.com/mcp"
    }
  }
}
```

Un serveur local est une commande que Kiro lance ; un serveur distant est une URL (HTTPS, ou HTTP sur localhost), avec des `headers` optionnels et une connexion OAuth. Dans le shell, `kiro-cli mcp add` ajoute un serveur, `kiro-cli mcp list` affiche la configuration et `kiro-cli mcp status` indique si chaque serveur tourne. Dans le chat, `/mcp` fait la même chose et gère les serveurs qui demandent une connexion.

Si le même serveur est défini à plusieurs endroits, le réglage d’un agent prime sur le fichier du workspace, qui prime sur le fichier global. Chaque serveur ajoute des outils au contexte : désactivez ceux dont vous n’avez pas besoin avec `"disabled": true`.

## Étape 8 : les specs

Les specs sont la signature de Kiro. Pour tout ce qui dépasse un correctif rapide, créez-en une :

```text
/spec new user-invitations
```

Kiro écrit trois fichiers dans `.kiro/specs/user-invitations/` : `requirements.md` avec des user stories et des critères d’acceptation en notation EARS (« Quand X, le système doit Y »), `design.md` avec l’approche technique, et `tasks.md` avec une liste de tâches numérotées. Lisez et corrigez chaque fichier avant de continuer : cette relecture est tout l’intérêt de la démarche. Ensuite, laissez Kiro traiter les tâches :

```text
/spec run user-invitations
```

Les fichiers de spec sont du Markdown ordinaire. Versionnés, ils deviennent la documentation du changement suivant. Pour les changements plus modestes, le mode plan (Shift+Tab ou `/plan`) offre une version allégée de la même habitude.

## Étape 9 : mode headless et CI

Pour les scripts et la CI, lancez Kiro sans l’interface de chat :

```bash
export KIRO_API_KEY=your-key
kiro-cli chat --v3 --no-interactive --trust-tools=read_file,grep_search "Summarize the risky changes in this branch"
```

`--trust-tools` liste les outils que Kiro peut utiliser sans demander (ces noms viennent de la V3, d’où le `--v3` dans l’exemple, comme dans l’exemple GitHub Actions de la documentation). `--trust-all-tools` autorise tout : réservez-le à un sandbox. `--require-mcp-startup` fait échouer l’exécution si un serveur MCP ne démarre pas. Les clés d’API sont disponibles avec les offres Pro, Pro+, Pro Max et Power. Pour les éditeurs compatibles ACP, `kiro-cli acp` lance Kiro comme leur agent.

## Pièges courants

- **L’installeur échoue sous Windows.** Vous êtes dans l’invite de commandes. Utilisez PowerShell ou Windows Terminal sous Windows 11.
- **Le binaire ne démarre pas sur un vieux Linux.** La glibc est antérieure à 2.34. Prenez le zip musl.
- **Vos règles de steering sont ignorées.** Le fichier utilise `fileMatch` ou `auto`, que la 2.x ne charge pas automatiquement, ou vous êtes dans un agent personnalisé sans la ressource de steering.
- **Les crédits fondent vite.** Un modèle coûteux ou un long chat. Regardez `/usage`, essayez Auto et utilisez `/compact`.
- **Les commandes AWS ne marchent plus en V3.** La V3 a retiré l’outil AWS intégré ; utilisez plutôt un serveur MCP AWS.
- **Aucune option de clé d’API.** Le mode headless demande une offre payante.

## Kiro CLI ou un autre agent ?

Kiro convient bien si vous aimez planifier avec des specs, si votre entreprise gère déjà les accès via AWS IAM Identity Center, ou si vous voulez une seule facture pour les modèles premium et les modèles open-weight bon marché. Il convient moins si vous voulez apporter votre propre clé d’API ou utiliser des modèles locaux ; [opencode](/fr/blog/how-to-use-opencode/ "Utiliser opencode") le fait avec n’importe quel fournisseur. Si vous payez déjà Claude ou ChatGPT, Claude Code ou Codex CLI utilisent directement cet abonnement. [Meilleures alternatives à Claude Code](/fr/blog/best-claude-code-alternatives/ "Meilleures alternatives à Claude Code") compare les principaux agents CLI côte à côte.

## Faire tourner Kiro CLI à côté d’autres agents

Beaucoup d’équipes ne se limitent pas à un seul agent. Kiro écrit la spec, Claude Code ou Codex en construit une partie, un autre agent relit. Avec des onglets de terminal, tout ça devient vite confus. AgentVera est une application de bureau qui fait tourner ces CLI côte à côte dans de vrais terminaux, avec vos propres installations et connexions. La [prise en charge de Kiro CLI](/fr/agents/kiro-cli/ "Kiro CLI dans AgentVera") fonctionne ainsi :

- **Votre connexion Kiro.** AgentVera ouvre `kiro-cli chat` dans un vrai terminal. Vous vous connectez avec `kiro-cli login` ; si vous êtes déconnecté, le terminal de l’agent vous demande de vous connecter.
- **Modèle et effort par agent.** Laissez le modèle vide pour le choix par défaut de Kiro, ou choisissez-en un par agent. L’effort va de bas à max.
- **Des règles venues de vos fichiers.** Kiro CLI n’a pas de flag d’instructions supplémentaires : les consignes durables viennent donc d’`AGENTS.md` ou des fichiers de règles du projet.
- **Votre mcp.json reste le vôtre.** Les serveurs MCP ajoutés dans AgentVera et le navigateur d’AgentVera sont fusionnés avec votre propre `mcp.json` Kiro à chaque lancement.
- **Les sessions continuent.** Quand vous reprenez un agent, il s’ouvre avec son ID de session ou la dernière session du dossier.
- **Panneaux, flows et revue.** Faites tourner Kiro dans la grille du [workspace](/fr/features/workspace/ "Workspace") à côté de Claude Code ou Codex, chacun dans son propre git worktree. Les agents Kiro fonctionnent dans les flows, les messages groupés et les tâches planifiées, et reçoivent une revue de code automatique à la fin de chaque tour.

La grille, les worktrees, la revue de code et le gestionnaire MCP font partie de l’offre gratuite ; les flows sont inclus dans Pro et Team. [Téléchargez AgentVera](/fr/download/ "Télécharger AgentVera") pour essayer.

## En résumé

Pour utiliser Kiro CLI, installez-le, connectez-vous, lancez `kiro-cli` dans un projet et décrivez le changement. Laissez le modèle sur Auto tant que vous n’avez pas de raison de le changer, et gardez un œil sur `/usage`. Les règles du projet vont dans `.kiro/steering/` ou `AGENTS.md`, les outils dans `mcp.json`, et les configurations récurrentes dans des agents personnalisés. Pour tout ce qui dépasse un correctif rapide, commencez par `/spec new` : relire des exigences et une liste de tâches avant que le code n’existe, c’est ce que Kiro fait de mieux.

## Questions fréquentes

**Kiro CLI est-il gratuit ?** La CLI ne coûte rien et l’offre gratuite inclut 50 crédits. En octobre 2026, les offres payantes commencent à 20 $ par mois pour 1 000 crédits (Pro), avec Pro+, Pro Max et Power au-dessus. L’usage supplémentaire coûte 0,04 $ par crédit.

**Quelle différence entre Kiro IDE et Kiro CLI ?** Ce sont deux façons d’utiliser le même Kiro : l’IDE est un éditeur de bureau, la CLI un chat dans le terminal. Les deux utilisent votre compte et vos crédits Kiro, et comprennent les fichiers de steering, les specs et les serveurs MCP du dossier .kiro.

**Kiro CLI lit-il AGENTS.md ?** Oui. Kiro traite AGENTS.md comme un fichier de steering toujours inclus. Les fichiers de steering propres à Kiro se trouvent dans .kiro/steering/ du projet, et dans ~/.kiro/steering/ pour les règles globales.

**Qu’est-ce que Kiro CLI V3 ?** Une version précoce de la prochaine génération. Essayez-la avec kiro-cli --v3 ; elle tourne à côté de votre installation 2.x, qui reste inchangée tant que vous ne basculez pas. Elle partage son moteur avec Kiro IDE et ajoute notamment /rewind, des hooks et un agent de specs.

**Peut-on utiliser Kiro CLI en CI ?** Oui. Lancez kiro-cli chat --no-interactive avec un prompt et définissez KIRO_API_KEY. Les clés d’API sont disponibles avec les offres Pro, Pro+, Pro Max et Power, pas avec l’offre gratuite.

---

**À propos d’AgentVera.** AgentVera est une app de bureau pour macOS, Windows et Linux, développée par Solviera Teknoloji. Elle exécute 18 agents de code IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) côte à côte, par projet, dans de vrais terminaux avec les installations et connexions CLI de l’utilisateur. L’offre gratuite inclut des agents illimités. Télécharger: https://agentvera.dev/fr/download/ · Tarifs: https://agentvera.dev/fr/pricing/