> ## Documentation Index
> Fetch the complete documentation index at: https://kiro.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration et première exécution

> Prenez en main Kiro CLI en quelques minutes — de la première installation jusqu'à une programmation productive

Kiro CLI est un agent de programmation IA qui vit dans votre terminal — il lit votre code source, écrit du code, exécute des commandes et demande une confirmation avant de faire quoi que ce soit de destructeur. Ce guide vous permet de partir de zéro et de programmer efficacement en environ cinq minutes.

## Prérequis

Si vous n'avez pas encore effectué l'installation, exécutez la commande d'installation depuis la [page d'installation](https://kiro.dev/docs/getting-started/installation.md) et complétez l'authentification par navigateur. Puis revenez ici.

## Apprenez à connaître l'interface CLI

Kiro CLI dispose d'un agent guide intégré qui connaît tout sur l'interface CLI — commandes, outils, paramètres, flux de travail et bonnes pratiques. Plutôt que de lire la documentation, vous pouvez simplement lui poser des questions.

Après avoir lancé une session, tapez :

```bash
> /guide
```

Puis engagez une conversation :

```bash
[guide] > What can you help me with?

[guide] > How should I set up this project to work well with Kiro?

[guide] > What's the best way to do code reviews with Kiro?

[guide] > How do I connect my GitHub account?
```

L'agent Guide s'appuie sur une documentation indexée qui correspond à votre version installée. Il peut aussi créer des fichiers de configuration pour vous — des agents, des requêtes et des fichiers de steering — directement à partir de la conversation.

**💡 Tip:** Considérez `/guide` comme votre compagnon d'intégration. Posez-lui des questions sur vos flux de travail spécifiques et il vous dira la meilleure façon de les accomplir avec Kiro CLI.

Appuyez sur `Shift+Tab` pour revenir à votre agent principal lorsque vous êtes prêt à commencer à travailler.

## Démarrez votre première session

Accédez à n'importe quel répertoire de projet et lancez Kiro :

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

L'interface utilisateur du terminal s'ouvre — une interface de clavardage riche avec coloration syntaxique, panneaux interactifs et suivi visuel de la progression des outils. Vous discutez maintenant avec un agent IA capable de lire, d'écrire et d'exécuter des commandes dans votre projet.

## Engagez une conversation

Tapez naturellement. Kiro comprend le contexte de votre projet et peut agir :

```bash
> Explain the architecture of this project

> Find all TODO comments and summarize them

> Write a unit test for the auth module

> Refactor the database connection to use connection pooling
```

Kiro lit vos fichiers, exécute des commandes et effectue des modifications — en demandant une autorisation avant toute action destructrice.

## Interactions de base

### Référencer des fichiers avec @

Pointez Kiro vers des fichiers précis à l'aide de `@` avec complétion par tabulation :

```bash
> Review @src/api/routes.ts for security issues
```

### Planifier avant d'agir

Appuyez sur `Shift+Tab` pour passer en mode Plan. Kiro décrit ce qu'il a l'intention de faire avant d'apporter des modifications — utile lorsque vous voulez d'abord revoir l'approche.

```bash
[plan] > Migrate the Express routes to use async/await error handling
```

L'agent produit un plan structuré avec des étapes. Lorsque vous êtes satisfait, il passe en mode d'exécution et effectue le travail.

### Exécuter des commandes shell directement

Faites précéder d'un `!` pour exécuter des commandes sans passer par l'agent :

```bash
!npm run build
```

### Approuver ou rejeter les modifications

Lorsque Kiro veut exécuter une commande ou écrire dans un fichier, une invite d'approbation s'affiche. Appuyez sur `y` pour approuver, `n` pour rejeter, ou `Tab` pour explorer les options et donner de la rétroaction.

## Aidez Kiro à comprendre votre projet

Par défaut, Kiro lit vos fichiers et déduit le contexte. Mais vous pouvez le rendre nettement plus intelligent en lui indiquant les conventions de votre projet. Créez un fichier de steering :

```bash
mkdir -p .kiro/steering
```

Ajoutez `.kiro/steering/project.md` :

```markdown
# Project Context

- This is a TypeScript project using Next.js 15
- Use pnpm for package management
- Follow the existing code style (Prettier + ESLint)
- Write tests with Vitest
- Prefer functional components with hooks
```

Kiro lit automatiquement les fichiers de steering et suit vos directives dans chaque réponse. La différence est immédiate — les réponses correspondent à votre pile technologique, à vos conventions et à vos préférences.

Consultez [Steering](https://kiro.dev/docs/steering.md) pour le guide complet sur la rédaction de fichiers de steering efficaces.

## Commandes à barre oblique essentielles

Les commandes à barre oblique contrôlent votre session. Tapez `/` et l'interface TUI affiche des suggestions de complétion automatique. Voici celles que vous utiliserez le plus souvent :

| Commande | Ce qu'elle fait |
|---------|-------------|
| `/help` | Ouvre un panneau consultable de toutes les commandes |
| `/guide` | Passe à l'agent Guide pour obtenir de l'aide sur Kiro lui-même |
| `/context` | Affiche les fichiers présents dans le contexte et l'utilisation des jetons |
| `/model` | Bascule entre les modèles d'IA |
| `/agent` | Bascule entre les agents |
| `/chat new` | Démarre une nouvelle conversation |

## Travailler avec plusieurs agents

Kiro est livré avec des agents intégrés pour différentes tâches, et vous pouvez créer les vôtres :

- **Agent Default** — assistant de programmation à usage général
- **Agent Plan** — décompose les tâches complexes en plans structurés (`Shift+Tab`)
- **Agent Guide** — répond aux questions sur Kiro CLI lui-même (`/guide`)

Créez des agents personnalisés pour les flux de travail récurrents — révision de code, rédaction de tests, déploiement, ou toute autre tâche propre à votre équipe :

```bash
> /guide Create an agent for code review
```

L'agent Guide génère un fichier `.kiro/agents/code-review.yaml`. Basculez-y à tout moment avec `/agent swap code-review`.

### Travail parallèle avec des sous-agents

Pour les tâches plus importantes, Kiro peut créer des sous-agents qui travaillent en parallèle avec un contexte isolé. Appuyez sur `Ctrl+G` pour ouvrir le moniteur de Crew et les observer travailler en temps réel.

Consultez [Sous-agents](https://kiro.dev/docs/custom-agents/subagents.md) et [Agents personnalisés](https://kiro.dev/docs/custom-agents.md) pour le guide complet.

## Gardez le contrôle

Au-delà du flux d'approbation par action, vous disposez d'un contrôle précis sur ce que Kiro peut faire :

- **Motifs de confiance** — approuvez une commande une seule fois, ou faites confiance à un motif (p. ex., toutes les commandes `npm run`) pour ne pas être interrompu lors des opérations courantes
- **Autorisations des outils** — utilisez `/tools trust <name>` pour approuver à l'avance des outils précis, ou `/tools untrust <name>` pour exiger une autorisation explicite
- **Réinitialisation à tout moment** — `/tools reset` efface toutes les autorisations d'exécution

Consultez [Autorisations](https://kiro.dev/docs/permissions.md) pour le modèle de confiance complet.

## Étendre avec des outils externes

Kiro prend en charge le Model Context Protocol (MCP), qui lui permet d'interagir directement avec des bases de données, des API, GitHub et d'autres services. Une fois que vous avez configuré un serveur MCP, vous pouvez demander des choses comme « énumère mes pull requests ouvertes » ou « interroge la base de données de préproduction ».

Consultez [Intégration MCP](https://kiro.dev/docs/mcp.md) pour connecter votre premier serveur.

## Astuces pour votre première session

- Appuyez sur `Shift+Enter` pour saisir des requêtes sur plusieurs lignes
- Appuyez sur `Shift+Tab` pour passer en mode Plan (l'agent planifie avant d'agir)
- Appuyez sur `Esc` pour annuler l'agent ou fermer n'importe quel panneau
- Tapez `/help` pour voir toutes les commandes disponibles

La référence complète du clavier se trouve dans [Interface utilisateur du terminal](https://kiro.dev/docs/cli/terminal-ui.md#raccourcis-clavier).

## Configuration du proxy

Kiro CLI (v1.8.0+) respecte les variables d'environnement de proxy standards. Définissez-les dans votre shell :

```bash
export HTTP_PROXY=http://proxy.company.com:8080
export HTTPS_PROXY=http://proxy.company.com:8080
export NO_PROXY=localhost,127.0.0.1,.company.com
```

Pour les proxys nécessitant une authentification :

```bash
export HTTPS_PROXY=http://username:password@proxy.company.com:8080
```

## Débogage et résolution de problèmes

Si vous avez un problème avec Kiro CLI, exécutez `kiro-cli diagnostic`. Cette commande affiche votre version de Kiro CLI, les renseignements sur le système et l'environnement.

Pour signaler le problème, exécutez `kiro-cli issue`. Cette commande ouvre un formulaire de signalement GitHub dans votre navigateur, avec le rapport de diagnostic déjà rempli. Par SSH, dans CloudShell ou dans WSL, `kiro-cli issue` affiche l'URL du signalement au lieu de l'ouvrir. Elle affiche aussi l'URL si le navigateur ne s'ouvre pas.

### Emplacements des fichiers journaux

Kiro CLI écrit des journaux à des emplacements propres à chaque plateforme :

| Plateforme | Chemin |
|----------|------|
| macOS | `$TMPDIR/kiro-log/kiro-chat.log` |
| Linux | `$XDG_RUNTIME_DIR/kiro-log/kiro-chat.log` |
| Windows | `%TEMP%\kiro-log\logs\kiro-chat.log` |

Remplacez le chemin des journaux à l'aide de la variable d'environnement `KIRO_CHAT_LOG_FILE` :

```bash
KIRO_CHAT_LOG_FILE=/tmp/my-debug.log kiro-cli chat
```

Sous Windows (PowerShell) :

```powershell
$env:KIRO_CHAT_LOG_FILE = "C:\temp\my-debug.log"
kiro-cli chat
```

### Problèmes courants

- **Le répertoire personnel se remplit au démarrage :** Dans les environnements à stockage limité comme CloudShell, définissez `KIRO_SKIP_BINARY_PINNING=1` uniquement lorsque le fichier binaire Kiro installé demeure dans un chemin fixe et stable. Cela évite de créer une copie du fichier binaire propre à la session. N'utilisez pas cette option si un programme d'installation peut remplacer ou supprimer le fichier binaire pendant la session.
- **Le moteur d'exécution intégré remplit le répertoire personnel :** Dans Kiro CLI 2.37 ou une version ultérieure, définissez `KIRO_RUNTIME_DIR` sur un chemin absolu pour y extraire le moteur d'exécution intégré de Kiro au lieu de votre répertoire personnel. Une valeur relative ou vide est ignorée. Pour le confirmer, démarrez `kiro-cli chat` et vérifiez que le répertoire contient maintenant le moteur d'exécution.
- **Échecs d'authentification** — Exécutez `kiro-cli login` pour vous authentifier de nouveau.

### Étapes de résolution de problèmes

1. Exécutez `kiro-cli diagnostic` pour vérifier votre version de Kiro CLI, les renseignements sur le système et l'environnement.
2. Vérifiez votre connexion Internet.
3. Vérifiez que vous utilisez un environnement pris en charge. Consultez [Commandes CLI](https://kiro.dev/docs/reference/cli-commands.md) pour connaître les shells pris en charge.
4. Essayez de réinstaller Kiro CLI depuis la [page d'installation](https://kiro.dev/docs/getting-started/installation.md).
5. Si le problème persiste, signalez-le à l'aide de `kiro-cli issue`.

## À explorer ensuite

Maintenant que vous êtes opérationnel, voici où approfondir vos connaissances :

- [Interface utilisateur du terminal](https://kiro.dev/docs/cli/terminal-ui.md) — Référence complète de l'interface de clavardage, des thèmes et des panneaux
- [Steering](https://kiro.dev/docs/steering.md) — Guidez Kiro avec du contexte et des conventions propres à votre projet
- [Agents personnalisés](https://kiro.dev/docs/custom-agents.md) — Créez des agents spécialisés pour vos flux de travail
- [MCP](https://kiro.dev/docs/mcp.md) — Connectez des outils et des sources de données externes
- [Hooks](https://kiro.dev/docs/hooks.md) — Automatisez des actions avant et après les commandes
- [Mode sans interface](https://kiro.dev/docs/cli/headless.md) — Exécutez Kiro de manière non interactive dans des pipelines CI/CD
- [Agent Guide](https://kiro.dev/docs/custom-agents/built-in.md) — Posez à tout moment des questions à Kiro sur ses propres fonctionnalités avec `/guide`