Hub gratuit →

Installer Gemini CLI devenu Antigravity CLI gratuitement

Par Romain Brunel · 10 min de lecture
En bref
  • Je te dirige vers Antigravity CLI pour le parcours gratuit avec un compte personnel.
  • Je commence dans un dossier vide, avec une tâche locale facile à vérifier.
  • Je contrôle les fichiers modifiés avant de conserver le résultat.
Le guide en PDF, offert
Mon mémo pour installer et encadrer Antigravity CLI
7 points, check-list, infographie · affiseo.fr
Télécharger le PDF
PartagerLinkedInXWhatsAppFacebookE-mail

Pour installer l’agent gratuit que tu cherches sous le nom Gemini CLI, je te conseille aujourd’hui Antigravity CLI : Google a transféré l’accès grand public vers cet outil. Tu installes le programme officiel, tu lances `agy` dans un dossier d’essai et tu te connectes avec ton compte personnel. La formule gratuite existe, avec des limites d’usage, comme l’indique la tarification Google.

Je vais te faire créer une petite page que tu pourras ouvrir sur ton ordinateur. Mon objectif est que tu comprennes ce que l’agent modifie avant de lui confier un vrai projet. Je m’appuie ici sur les instructions officielles consultées le 21 novembre 2026 ; mes exemples vécus concernent mes propres systèmes construits avec Claude Code et Codex.

Tu en es où ?

Gemini CLI a changé de porte d’entrée

Si tu arrives d’un tuto qui lance la commande `gemini`, je comprends la confusion. Gemini désigne la famille de modèles de Google, autrement dit le moteur qui produit les réponses. CLI veut dire interface en ligne de commande : tu écris dans un terminal, une fenêtre qui permet de demander des actions à ton ordinateur. L’agent ajoute la capacité de travailler sur les fichiers et d’utiliser des outils.

Pour un compte personnel, je te dirige aujourd’hui vers Antigravity CLI, lancé avec `agy`. Google a annoncé le transfert de l’ancien accès grand public le 19 mai 2026. Le 18 juin 2026 correspond à l’arrêt de cet ancien accès personnel. Cette décision concerne aussi les abonnements personnels Pro et Ultra de l’ancien parcours. Je ne te fais donc pas installer un vieux paquet en te promettant que la connexion gratuite fonctionnera encore.

Je distingue aussi le terminal de l’application graphique Antigravity et des extensions pour éditeurs. Tu peux choisir une interface plus visuelle si les commandes te rebutent. Ici, je garde le terminal pour que tu voies précisément dans quel dossier l’agent travaille. Les anciennes licences professionnelles et les clés API payantes ont leur propre parcours ; ce guide vise ton premier essai avec un compte personnel.

Chez moi, j’ai repris Quel Canapé avec Claude Code et Codex, puis construit Canapé OS pour piloter le site. Le site était resté à l’abandon pendant 2 ans. En le reprenant, j’ai notamment ajouté les filtres dynamiques qui ont fait passer le catalogue de 160 à 950 canapés. Là, tu as un résultat visible : davantage de canapés accessibles dans le catalogue. C’est ce genre de changement qui m’intéresse avec un agent. Pour ton premier essai, choisis une fonction que tu peux vérifier à l’écran.

Frise du transfert de l’accès personnel de Gemini CLI vers Antigravity CLI.
Frise du transfert de l’accès personnel de Gemini CLI vers Antigravity CLI.
Télécharger en PNGÉpingler sur Pinterest
Teste-toi
Tu veux démarrer gratuitement avec un compte personnel aujourd’hui. Je te dirige vers quoi ?

Gratuit veut dire un quota, pas un serveur à volonté

La page tarifaire officielle affiche une formule Individuals à 0 $ par mois, avec accès au CLI et un quota renouvelé chaque semaine. Je te conseille de commencer là, sans souscrire pour installer. Vérifie ce que ton compte propose au moment de la connexion : le modèle accessible et les limites font partie de l’offre, pas du fichier installé sur ton ordinateur.

Le fonctionnement des quotas dépend notamment du travail demandé à l’agent. Un message qui entraîne beaucoup de recherches et de modifications peut consommer davantage qu’une question courte. Je ne transforme donc pas une ancienne promesse de requêtes quotidiennes en plafond actuel. Le détail des limites gratuites mérite une page dédiée, surtout pour distinguer un usage occasionnel d’une production continue.

Je garde également une séparation nette entre connexion personnelle et API. Une API est une porte d’accès pour un programme, avec ses propres conditions de facturation. Si un écran te demande de créer un projet Cloud ou d’activer une facturation alors que tu veux simplement découvrir l’outil, reviens vérifier le parcours choisi. Avoir une adresse professionnelle Google ne signifie pas automatiquement disposer du forfait personnel.

Dans Playing to Win, A. G. Lafley et Roger L. Martin montrent avec Olay, chez P&G, comment relier le terrain choisi aux capacités nécessaires. Je ramène ça à ton dossier : écris le résultat recherché avant de choisir les outils. Ici, une page qui présente des prestations et permet de préparer un courriel suffit.

Comparaison entre accès personnel gratuit et accès par API.
Comparaison entre accès personnel gratuit et accès par API.
Télécharger en PNGÉpingler sur Pinterest

Installer sur Mac, Linux ou Windows

Je commence dans un dossier sans données sensibles. Les installateurs officiels ciblent macOS et Linux sur processeur Intel ou AMD 64 bits, ou ARM64, ainsi que Windows en AMD64 ou ARM64. Sur Mac, regarde la puce dans « À propos de ce Mac » ; sous Windows, le type du système figure dans les informations système. Je parle ici du CLI : les exigences de l’application graphique sont distinctes. Prévois une connexion internet, un compte Google personnel et un navigateur pour la connexion.

Je prends les commandes dans la documentation officielle. Elles téléchargent et exécutent l’installateur : compare le domaine avant de les copier. Sur Mac ou Linux, ouvre Terminal ; sous Windows, ouvre PowerShell. Attends la fin de l’installation, puis ferme et rouvre le terminal avant les commandes de lancement.

**Mac ou Linux : installation dans Terminal** ```sh curl -fsSL https://antigravity.google/cli/install.sh | bash ```

**Mac ou Linux : vérification et lancement dans le dossier d’essai** ```sh agy --version mkdir agy-demo cd agy-demo agy ```

**Windows : installation dans PowerShell** ```powershell irm https://antigravity.google/cli/install.ps1 | iex ```

**Windows : vérification et lancement dans le dossier d’essai** ```powershell agy --version mkdir agy-demo cd agy-demo agy ```

Je lance chaque ligne à la suite. `agy --version` doit afficher une version ; sinon, règle ce blocage avant de continuer. `mkdir` crée le dossier et `cd` te place dedans. Le dernier `agy` ouvre l’interface interactive. Si agy-demo existe déjà, choisis un autre nom de dossier vide.

Je ne rajoute pas Node.js et npm à ce parcours : l’installation actuelle fournit un binaire, le programme directement exécutable. Sur Mac et Linux, la commande ci-dessus nécessite curl et bash. Garde le texte exact de toute erreur, plutôt que de relancer une installation au hasard.

Parcours de l’installation officielle au lancement dans un dossier d’essai.
Parcours de l’installation officielle au lancement dans un dossier d’essai.
Télécharger en PNGÉpingler sur Pinterest

Connecter le bon compte et garder la main

Au premier lancement, l’outil peut retrouver une connexion dans le trousseau de ton système, le coffre qui conserve les identifiants. Sinon, le parcours de connexion ouvre le navigateur. Pour ce premier essai, je choisis le compte Google personnel prévu pour l’offre gratuite, puis je reviens au terminal. Si le mauvais compte apparaît, je corrige la connexion avant de travailler. Je ne colle jamais un mot de passe dans la conversation. Après connexion, tu dois retrouver l’interface interactive dans le terminal et pouvoir envoyer une demande. Je commence par « Réponds simplement bonjour, sans modifier de fichier ». Une réponse confirme que l’échange avec le modèle fonctionne ; un navigateur qui annonce seulement une connexion réussie ne suffit pas.

Le choix de faire confiance au dossier mérite ton attention. Tu autorises un programme à travailler sur des fichiers ; le thème clair ou sombre est secondaire. Je te conseille de commencer avec le mode `default` et de lire les demandes d’autorisation. Le mode `auto` automatise davantage de décisions : je le garde pour plus tard, quand tu sais reconnaître les actions attendues.

Les permissions et le bac à sable, une zone qui limite certaines actions techniques, complètent tes consignes. Une phrase comme « ne touche pas à mes secrets » aide à diriger l’agent, mais ne remplace pas ces réglages. Je retire du dossier les exports clients, les fichiers d’identifiants et les accès de production avant l’exercice. Je garde aussi une copie indépendante du travail existant.

Je pose enfin cette limite : « N’utilise aucun service externe supplémentaire, ne téléverse pas le projet et ne publie rien. Crée seulement les fichiers dans ce dossier. » Cela ne rend pas l’agent hors ligne : il lui faut toujours une connexion au modèle distant pour traiter ta demande. La page produite, elle, doit pouvoir s’ouvrir localement sans service distant. Si l’agent propose un hébergement ou un service supplémentaire, demande pourquoi avant de l’autoriser.

Carte du dossier d’essai séparé des secrets et des accès de production, avec contrôle des autorisations.
Carte du dossier d’essai séparé des secrets et des accès de production, avec contrôle des autorisations.
Télécharger en PNGÉpingler sur Pinterest
Teste-toi
Une consigne écrite suffit-elle à empêcher techniquement tout accès sensible ?

La première tâche que je te propose

Je te propose une page HTML locale pour démarrer. HTML est le langage qui structure le contenu d’une page web ; ton navigateur peut ouvrir directement ce fichier. Pas besoin de connexion à une boutique ni de compte client. Tu vas voir le résultat, changer un détail et contrôler si ta demande a été respectée.

Voici la demande à saisir dans l’agent : « Dans ce dossier d’essai, propose le plan d’une page index.html pour présenter une activité fictive de réparation de vélos. Je veux un titre, une liste de prestations et un bouton qui ouvre un courriel. Aucun service externe supplémentaire ni publication du projet ; la connexion de l’agent au modèle reste autorisée. Explique les fichiers nécessaires et attends mon accord avant de les créer. » Je précise que les prestations et les coordonnées sont fictives : elles ne doivent pas passer pour celles d’une vraie entreprise.

Lis le plan, puis autorise la création si elle reste dans ce cadre. Ouvre index.html depuis ton explorateur de fichiers. Le titre doit être visible, la liste lisible et le bouton doit lancer ton application de courriel avec le destinataire de démonstration. Je teste aussi une fenêtre étroite : un bouton coupé sur téléphone reste un défaut, même si l’agent annonce que tout fonctionne.

Dans Automate Your Busywork, Aytekin Tank part des formulaires modèles de Jotform avant d’aborder des processus plus complexes. Je garde cette progression : ta page locale doit fonctionner avant de lui confier davantage. Demande ensuite une seule modification observable, par exemple améliorer le contraste du bouton.

Arbre de vérification d’une page HTML locale avant de conserver les changements.
Arbre de vérification d’une page HTML locale avant de conserver les changements.
Télécharger en PNGÉpingler sur Pinterest

Relire, tester et revenir en arrière

Je consulte `/diff`, qui montre les lignes ajoutées ou supprimées, puis je compare avec ma demande. La référence des commandes décrit aussi `/usage` pour voir la consommation et `/exit` pour quitter. Je garde les extensions pour après ces premiers contrôles. Un fichier modifié hors du périmètre prévu demande une explication, même si la page s’affiche correctement.

Après la demande sur le contraste, je m’attends à voir dans `/diff` une modification du style du bouton dans index.html, ou dans le fichier de style annoncé dans le plan. Le destinataire du courriel et les prestations doivent rester identiques. Si tu vois une suppression sans rapport ou un autre dossier modifié, arrête-toi dessus. Un affichage vide ne prouve pas que la demande a réussi : contrôle le dossier courant et ouvre le fichier pour comparer le bouton avant et après.

Pour un projet existant, je fais enregistrer un état propre dans Git avant le travail. Git est un historique des fichiers : il permet d’identifier une modification et de retrouver une version enregistrée. Si tu ne l’utilises pas encore, commence avec une copie de dossier que tu sais restaurer. Ne découvre pas ton système de sauvegarde après avoir accepté une suppression.

La méthode de vérification de Google consiste à explorer, préparer un plan, appliquer puis contrôler le résultat. Pour un programme, je demande l’exécution du test adapté et je lis sa sortie réelle. Pour notre page simple, je complète par le navigateur : affichage, clic, fenêtre étroite. La phrase « c’est terminé » ne constitue pas un résultat de test.

Sur Quel Canapé, j’ai ajouté un juge qui note les rendus 3D. Chaque fiche a sa vraie photo fournisseur ; si le rendu reçoit moins de 7 sur 10, cette photo reste affichée. Le rendu vient d’être généré, mais il n’a pas gagné sa place pour autant. C’est ce garde-fou que je veux retrouver quand un agent modifie du code. Si le bouton ouvrait le courriel avant et ne le fait plus après le changement de couleur, je garde la version précédente et je demande de corriger ce clic.

Boucle entre demande limitée, modifications et contrôle du résultat.
Boucle entre demande limitée, modifications et contrôle du résultat.
Télécharger en PNGÉpingler sur Pinterest
Teste-toi
L’agent annonce que ta page fonctionne. Que fais-tu ensuite ?

Donner ses consignes sans tout répéter

Je crée ensuite un fichier `GEMINI.md` à la racine du dossier de travail. La documentation des règles confirme sa lecture, comme celle de `AGENTS.md`. Ce fichier contient les consignes durables du projet. Pour notre exercice, j’y écrirais : répondre en français, travailler sur la page locale, expliquer les changements, demander avant d’ajouter une dépendance, ne rien publier.

Je précise aussi comment contrôler le résultat : ouvrir index.html dans un navigateur et tester le bouton. Une dépendance est un logiciel supplémentaire dont ton projet a besoin pour fonctionner. Si la page peut rester autonome, je n’en ajoute pas. La future page consacrée à GEMINI.md détaillera les consignes réutilisables ; ici, garde un fichier court que tu peux relire entièrement.

Dans Work the System, Sam Carpenter formalise les Working Procedures : des procédures écrites pour les opérations répétées. Pour ta page, je retiens une consigne courte : partir du descriptif validé, créer le fichier, contrôler les coordonnées. Inscris le destinataire fictif attendu dans GEMINI.md pour pouvoir repérer une modification involontaire.

Si tu avais déjà Gemini CLI, je sauvegarde l’ancienne configuration avant de migrer. Le guide de migration conserve les fichiers de consignes et propose `agy plugin import gemini` pour convertir les anciennes extensions en modules additionnels. Je ne lance cette conversion que si tu en as réellement à récupérer. Vérifie ensuite chaque connexion ajoutée ; un ancien réglage copié n’est pas forcément encore utile.

Document annoté reliant la tâche locale, ses limites et le contrôle dans le navigateur.
Document annoté reliant la tâche locale, ses limites et le contrôle dans le navigateur.
Télécharger en PNGÉpingler sur Pinterest
Teste-toi
Que mets-tu dans GEMINI.md pour rendre la tâche vérifiable ?

Si ça bloque, cherche au bon endroit

Si `agy` est introuvable, je commence par le PATH, la liste des dossiers où le terminal cherche les programmes. Le dépannage officiel indique `~/.local/bin` sur Mac et Linux, et le dossier `agy/bin` dans les données locales de ton profil Windows. Sur Mac ou Linux, essaie `~/.local/bin/agy --version`. Si cela fonctionne, le programme est installé ; c’est sa recherche par le terminal qu’il faut corriger.

Sur Mac avec zsh, tu peux ajouter `export PATH="$HOME/.local/bin:$PATH"` dans ton fichier `~/.zshrc`, puis rouvrir le terminal. Sous Windows, vérifie dans les variables d’environnement utilisateur que Path contient le dossier indiqué par l’installateur, puis rouvre PowerShell. Je ne conseille pas de passer administrateur pour masquer une erreur de chemin.

Si l’interface s’ouvre mais refuse la connexion, relève le compte utilisé, le message complet et le mode choisi. Un quota épuisé, un trousseau verrouillé et une mauvaise identité sont des problèmes différents. Je traite le premier en attendant le renouvellement annoncé ; les autres demandent de corriger l’accès. Effacer tous les réglages d’un coup rend souvent le diagnostic plus difficile.

Je construis mes outils avec Claude Code et Codex ; je ne vais pas te vendre ce parcours comme une bascule de mes propres systèmes vers Google. Pour choisir ensuite ton agent, compare la même tâche, la correction nécessaire et la facilité à comprendre ses actions. Le futur comparatif Codex contre Gemini CLI partira de cette base. Tu peux retrouver le cadre général dans mes pages sur les agents de code et l’IA et l’automatisation. Garde ton dossier d’essai : il te servira de cas de comparaison.

Bureau de travail avec ordinateur et carnet pour préparer un premier projet local.

Exemple fictif pour décider si l’automatisation vaut le coup

  1. Je suppose une mise à jour répétée 12 fois par mois et faite à la main en 15 minutes : 12 × 15 = 180 minutes.
  2. Je suppose ensuite 45 minutes de préparation du petit outil et 5 minutes de contrôle à chaque passage : 45 + 12 × 5 = 105 minutes le premier mois.
  3. Le temps potentiellement économisé est donc 180 - 105 = 75 minutes. Je retire encore le temps réellement passé à corriger les erreurs.
  4. Je ne compte aucun gain tant que le résultat ne satisfait pas le même contrôle que la version manuelle.

Ces durées sont fictives, pas une mesure de performance de Gemini ou d’Antigravity. Je te propose de refaire le calcul avec ta propre tâche avant de payer un abonnement.

Les erreurs fréquentes

✗ Je suis un tutoriel ancien sans regarder le produit concerné.
✓ Je vérifie la date et le parcours de connexion actuel. Une ancienne commande valide ne prouve pas que son accès gratuit existe encore.
✗ Je confie mon site en ligne dès le premier message.
✓ Je commence sur une copie et je garde une sauvegarde restaurable. Je sépare la fabrication locale de la publication.
✗ Je confonds la réussite de la connexion avec celle du travail.
✓ Je vérifie le fichier obtenu, le clic attendu et les modifications. Je relève un défaut précis avant de demander une correction.

Ta check-list

0 sur 9 fait

Tout le guide en une image

Parcours visuel de l’installation d’Antigravity CLI au contrôle d’une page locale.
Parcours visuel de l’installation d’Antigravity CLI au contrôle d’une page locale.
Télécharger en PNGÉpingler sur Pinterest

Questions fréquentes

Comment utiliser Gemini pour coder ?

Je donne à l’agent une tâche précise dans un dossier de projet : comprendre un fichier, proposer une modification, puis la vérifier. Pour le parcours personnel actuel, je passe par Antigravity CLI. Tu peux commencer avec une page locale sans savoir écrire tout son code.

Quel est le tarif de Gemini CLI ?

Je distingue l’ancien produit et son successeur grand public. Antigravity propose une formule personnelle gratuite avec quota ; les abonnements et les accès par API suivent leurs propres conditions. Je vérifie l’offre affichée sur le compte avant de choisir un mode payant.

Comment activer Gemini CLI ?

Pour commencer gratuitement aujourd’hui, je lance agy après installation et je suis la connexion du compte personnel. Si tu disposes d’une ancienne configuration Gemini CLI, vérifie le guide de migration. Un accès professionnel géré par ton organisation peut avoir un parcours différent.

Comment installer Gemini CLI sur Windows ?

Je te dirige vers le programme Antigravity CLI actuel. Dans PowerShell, je suis la commande officielle indiquée dans la section installation, puis je rouvre le terminal et je vérifie agy --version. Si la commande est introuvable, je contrôle le Path utilisateur.

Comment télécharger gratuitement Gemini sur mon PC ?

Si tu veux un agent qui travaille sur tes fichiers, je choisis le CLI ou l’application Antigravity depuis le site officiel. Installer le programme ne rend pas tout usage illimité. Si tu cherches seulement une conversation dans le navigateur, tu n’as pas besoin de cet exercice en terminal.

Qu’est-ce que l’agent Gemini ?

Un agent combine un modèle qui comprend ta demande et des outils pour agir. Je peux lui demander de lire, créer ou modifier un fichier dans le périmètre autorisé. Je garde des contrôles concrets : il peut se tromper même quand son explication paraît cohérente.

Sources

  • Le billet officiel du 19 mai 2026 annonce le transfert des particuliers de Gemini CLI vers Antigravity CLI. Le 18 juin 2026 est la date de fin de l’ancien accès gratuit et des accès personnels Pro et Ultra. Les licences Standard et Enterprise et les clés API payantes restent des cas distincts. : https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/ (consulté le 2026-11-21)
  • Installation officielle du binaire agy par install.sh sur Mac/Linux ou install.ps1 sur Windows ; contrôle agy --version et lancement agy dans le dossier du projet. : https://antigravity.google/docs/getting-started?tab=cli (consulté le 2026-11-21)
  • Antigravity CLI utilise le trousseau local ou une connexion Google par navigateur ; parcours spécifique SSH et distinction compte personnel, Cloud et clé API. : https://antigravity.google/docs/install/ (consulté le 2026-11-21)
  • Offre Individuals affichée à 0 $ par mois, incluant le CLI, avec quota de base renouvelé chaque semaine. : https://antigravity.google/pricing (consulté le 2026-11-21)
  • Les quotas dépendent du travail effectué et de la capacité disponible, peuvent changer et ne correspondent pas à un nombre fixe de messages. Google Workspace ne comprend pas automatiquement un forfait Antigravity. : https://antigravity.google/docs/plans/ (consulté le 2026-11-21)
  • Commandes Antigravity CLI : /usage, /diff, /exit, /permissions, /config et /help ; référence de la session interactive. : https://antigravity.google/docs/cli/reference (consulté le 2026-11-21)
  • La documentation recommande exploration, planification puis exécution avec mécanisme local de vérification ; fichiers de consignes et modes de permissions. : https://antigravity.google/docs/cli/best-practices (consulté le 2026-11-21)
  • Les fichiers GEMINI.md et AGENTS.md du dossier de travail et de ses parents jusqu’à la racine du dépôt sont chargés comme consignes ; ces instructions ne sont pas une isolation technique. Schéma des consignes : tâche locale, limites et contrôle, synthèse pédagogique AFFISEO. : https://antigravity.google/docs/rules/ (consulté le 2026-11-21)
  • Les autorisations et le bac à sable contrôlent les actions de l’agent ; il existe plusieurs modes d’exécution dont default et auto. Carte du périmètre : dossier d’essai isolé des données sensibles, conseil pédagogique AFFISEO. : https://antigravity.google/docs/permissions/ (consulté le 2026-11-21)
  • Le dossier du binaire peut manquer au PATH : ~/.local/bin sur Mac/Linux et AppData/Local/agy/bin sur Windows ; problèmes possibles de trousseau et de mises à jour. : https://antigravity.google/docs/cli/troubleshooting/ (consulté le 2026-11-21)
  • La migration détecte les anciens profils, conserve les consignes GEMINI.md et AGENTS.md et propose agy plugin import gemini pour convertir les extensions. Compatibilité partielle des réglages. : https://antigravity.google/docs/cli/gcli-migration/ (consulté le 2026-11-21)
  • L’installateur officiel CLI pour macOS et Linux accepte x86_64/amd64 et arm64/aarch64. La commande proposée nécessite curl et bash ; le binaire est indépendant de Node.js. : https://antigravity.google/cli/install.sh (consulté le 2026-11-21)
  • L’installateur officiel Windows PowerShell accepte les architectures AMD64 et ARM64 et refuse les autres architectures. : https://antigravity.google/cli/install.ps1 (consulté le 2026-11-21)

Autres pages sur notre guide « Codex et autres agents de code »

Toutes les pages du sujet sont dans notre guide « Codex et autres agents de code ».