# Utiliser vagejs avec votre agent de code IA Votre assistant connaît les règles.

> Créez un site web avec un agent de code IA. vagejs fonctionne avec Claude Code, Codex, Cursor, GitHub Copilot et Gemini CLI, et voici ce que lit chacun d'eux.

vagejs est un générateur de sites statiques conçu pour les agents de code IA. Chaque nouveau site inclut un fichier d'instructions `AGENTS.md`, une commande qui décrit tout l'outil sous forme de données, et des vérifications qui nomment le fichier exact à corriger. Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI et les autres agents peuvent ainsi construire votre site sans deviner.

Mis à jour le 28 octobre 2026

Vous ne savez pas quoi demander ? Le [générateur de prompts pour sites web](https://vagejs.com/prompts/builder/) écrit votre premier prompt à partir de quelques réponses. Vous hésitez encore entre plusieurs outils ? Notre guide des [générateurs de sites statiques pour assistants de code IA](https://vagejs.com/guides/static-site-generator-for-ai-coding-assistants/) explique ce qu'il faut regarder et compare les options les plus populaires.

## Que reçoit votre assistant ?

-   **`AGENTS.md`** dans le dossier du projet : les commandes, des recettes pour les tâches courantes (ajouter une page, en renommer une, ajouter un article de blog, ajouter une langue, rendre un composant interactif) et les règles, comme « ne jamais inventer de dates ni d'auteurs ». La plupart des agents de code lisent ce fichier d'eux-mêmes.
-   **`CLAUDE.md`**, qui contient une seule ligne, `@AGENTS.md`, pour que Claude Code charge les mêmes instructions.

Vous n'utilisez pas vagejs ? Le [générateur d'AGENTS.md](https://vagejs.com/tools/agents-md-generator/) gratuit en crée un pour n'importe quel projet de site web.

-   **`npx vage info --json`** : chaque commande, option et réglage, avec des JSON Schemas pour la configuration et le frontmatter. Les assistants ont pour consigne de l'utiliser au lieu de deviner.
-   **Une sortie `--json`** pour `build`, `check`, `audit` et les commandes de déploiement, où chaque problème nomme le fichier à corriger.
-   **Un serveur MCP (facultatif).** `npx -p vagejs vage mcp` permet aux assistants qui parlent MCP d'appeler vagejs directement : le décrire, vérifier le site, lister les pages et les liens sortants. Tout est en lecture seule : l'approbation des liens et la publication restent entre vos mains.
-   **Une publication qui vous attend.** Les déploiements, les push et les envois à IndexNow affichent leur plan et s'arrêtent pour attendre un oui : un assistant ne peut donc pas publier votre site de lui-même.

Un assistant peut même créer le site pour vous. Quand `npm create vagejs@latest` s'exécute dans un agent ou un script, il ne pose aucune question et affiche les prochaines étapes au lieu de démarrer un serveur.

## Quel fichier d'instructions chaque outil lit-il ?

| Outil | Lit de lui-même | Configuration nécessaire |
| --- | --- | --- |
| [Claude Code](https://vagejs.com/agents/claude-code/) | `CLAUDE.md`, et `AGENTS.md` dans les versions récentes | Aucune : le `CLAUDE.md` du site de départ importe `AGENTS.md` |
| [OpenAI Codex](https://vagejs.com/agents/codex/) | `AGENTS.md` | Aucune |
| [Cursor](https://vagejs.com/agents/cursor/) | `AGENTS.md` et `.cursor/rules/*.mdc` | Aucune |
| [GitHub Copilot](https://vagejs.com/agents/github-copilot/) | `AGENTS.md` et `.github/copilot-instructions.md` | Aucune dans VS Code ; l'agent cloud a besoin d'un workflow de configuration |
| [Gemini CLI](https://vagejs.com/agents/gemini-cli/) | `GEMINI.md` | Un réglage pour ajouter `AGENTS.md` |
| [Autres agents](https://vagejs.com/agents/other/) | Variable | Devin Desktop, Cline, Aider, Zed et d'autres |

Chaque guide couvre la configuration, la façon dont l'outil trouve les instructions, les commandes à le laisser lancer librement et une astuce propre à cet outil.

## Quelle boucle chaque assistant suit-il ?

terminal

```
npx vage info --json     # learn the commands and settings
# edit pages in src/pages/
npx vage check --json    # fix every error it reports
npx vage build --json    # build the finished site
```

Les instructions demandent à l'assistant de lancer `check` après chaque modification et de ne terminer que lorsqu'il signale zéro erreur. Les avertissements qu'il ne peut pas corriger vous sont signalés, pas cachés.

## Quelles règles valent la peine d'être gardées ?

-   **Laissez-le lancer librement les commandes sûres.** `npm run check`, `npm run build` et `npx vage info` ne font que lire votre projet ou écrire dans `dist/`.
-   **Gardez la publication manuelle.** Ne mettez pas `vage deploy`, `deploy:github` ou `indexnow` sur une liste d'approbation automatique, et n'utilisez pas les modes « tout approuver » sur un projet qui compte pour vous.
-   **Les faits viennent de vous.** Les instructions demandent aux assistants de vous demander les titres, les dates, les auteurs et les affirmations au lieu de les inventer. Si le vôtre invente quelque chose, renvoyez-le vers `AGENTS.md`.
-   **Préférez les pages simples.** `AGENTS.md` demande aux assistants d'utiliser des pages Markdown et du HTML simple, sauf si vous demandez du [MDX ou des composants interactifs](https://vagejs.com/fr/features/react-vue-mdx/), car chaque composant interactif ajoute du JavaScript.
-   **Gardez les secrets hors du chat.** Les clés d'API vont dans des variables d'environnement ou dans `vage connect`, jamais dans un prompt ni dans une page.

Prêt à coller quelque chose ? La [bibliothèque de prompts](https://vagejs.com/fr/prompts/) contient des prompts pour les tâches courantes, qui fonctionnent avec n'importe lequel de ces outils.