Utiliser Amp : guide pas à pas de la CLI Amp

Pour utiliser Amp, installez la CLI avec curl -fsSL https://ampcode.com/install.sh | bash, connectez-vous avec amp login, lancez amp dans un projet et décrivez ce que vous voulez. Avant le premier message, choisissez un mode sur le Dial avec Ctrl+S : low, medium, high ou ultra. Amp lit ensuite votre code, modifie les fichiers et exécute des commandes, et toute la conversation est enregistrée sous forme de thread que vous pouvez rouvrir ou partager.

Voilà la boucle de base. Ce guide couvre le reste : la connexion pour les scripts et la CI, les raccourcis du quotidien, les modes, les sous-agents comme l’oracle, settings.json, AGENTS.md, les serveurs MCP, le mode execute, ce que coûte Amp et comment le faire tourner à côté d’autres agents en CLI. Tout ce qui suit s’appuie sur la documentation officielle d’Amp en octobre 2026.

Qu’est-ce qu’Amp ?

Amp est un agent de code et un environnement de développement. Né au sein de Sourcegraph, il est développé par une entreprise indépendante depuis sa scission en décembre 2025. Il n’est lié à aucun fournisseur de modèles : Amp choisit le modèle selon le mode que vous sélectionnez, et il peut utiliser votre abonnement ChatGPT, votre abonnement Claude (dans son mode Claude Code) ou vos propres clés API.

Vous pouvez l’utiliser à trois endroits : l’application web sur ampcode.com (sans installation), les applications macOS, iPhone, iPad et Android, et la CLI en terminal, sujet de ce guide. Chaque conversation est un thread avec sa propre URL. Amp peut aussi exécuter un thread sur un orb, une machine qu’Amp crée pour ce thread sur ses serveurs, ou sur un runner que vous hébergez vous-même.

Étape 1 : installer la CLI

La CLI prend en charge macOS, Linux et Windows via WSL. Sous Windows, la documentation conseille WezTerm ou Alacritty plutôt que Windows Terminal, car le presse-papiers y fonctionne mieux. La page d’installation propose aussi des onglets Windows et Homebrew.

Amp se met à jour tout seul en arrière-plan. amp update met à jour à la main, amp version affiche la version installée et amp --help liste toutes les commandes. L’autocomplétion du shell tient en une ligne, par exemple source <(amp completions zsh) (bash et pwsh fonctionnent aussi ; fish utilise amp completions fish | source).

Étape 2 : se connecter

amp login

amp login ouvre le navigateur et ajoute un compte. La CLI peut en garder plusieurs : amp account list les affiche, amp account switch <email-or-user-id> choisit celui des commandes suivantes, et amp logout supprime le compte actif (--all les supprime tous).

Pour les scripts, la CI et les machines sans navigateur, utilisez plutôt un jeton d’accès :

export AMP_API_KEY=sgamp_your-token-here

Le jeton se crée dans les réglages sur ampcode.com ; il commence par sgamp_. Le jeton de session que stocke amp login expire en moins d’une heure et ne peut pas être renouvelé, c’est pourquoi la CLI le refuse à cet endroit.

Deux liaisons facultatives changent qui paie l’usage des modèles :

• Abonnement ChatGPT : amp config model-providers add-chatgpt-subscription (ou le raccourci amp add-chatgpt-sub) lie une offre ChatGPT, et l’usage des modèles OpenAI est décompté de celle-ci.
• Abonnement Claude : fonctionne uniquement dans le mode Claude Code d’Amp, à choisir sur le Dial. Les modes propres à Amp ne puisent jamais dans votre offre Claude.

Étape 3 : les bases de la CLI

Lancez amp dans un projet et tapez. Une entrée passée par pipe devient le premier message, donc echo "commit all my changes" | amp fonctionne aussi. Le raccourci le plus utile est Ctrl+O, qui ouvre la palette de commandes.

Si vous tapez pendant qu’Amp travaille, Entrée le réoriente : votre message arrive après l’étape en cours, sans attendre la fin du tour. Pour mettre un message en file d’attente jusqu’à ce que l’agent ait fini, lancez prompt: queue message depuis la palette. Shift+Entrée insère un retour à la ligne dans les terminaux qui le gèrent ; Ctrl+J fonctionne partout. Dans tmux, lancez tmux set -s extended-keys on pour que Shift+Entrée fonctionne.

Depuis la palette, ide connect relie Amp à VS Code, Cursor, Windsurf, Zed ou Neovim (Neovim demande un plugin). amp config keymap affiche tous les raccourcis.

Étape 4 : choisir un mode sur le Dial

Amp ne vous demande pas de modèle, mais un mode. Chaque mode combine modèle, effort de raisonnement, prompt système et outils, réglés pour un niveau de difficulté :

Appuyez sur Ctrl+S avant votre premier message pour tourner le Dial, ou ouvrez la palette et tapez mode. Un thread garde le mode avec lequel il a démarré ; si vous vous êtes trompé, ouvrez un nouveau thread plutôt que de lutter. Commencer trop haut gaspille du temps et des crédits sur une modification simple ; commencer trop bas peut coûter plus cher s’il faut plusieurs tentatives.

Pour garder la main sur les modèles, Réglages → Mode Dial → Tune Modes permet de fixer les modèles de chaque mode, et vous pouvez apporter vos propres clés API. Si vous préférez choisir un modèle précis à chaque session, un agent multi-fournisseurs comme opencode correspond mieux à cette habitude.

Étape 5 : sous-agents, oracle et librarian

Amp peut confier un travail ciblé à des sous-agents, chacun avec sa propre fenêtre de contexte :

• Task réalise le travail délégué de bout en bout et rend compte. Il peut modifier des fichiers et exécuter des commandes, et dispose de skills en lecture seule pour chercher dans votre code, étudier un autre dépôt, relire une modification et planifier.
• Read Thread lit et résume d’autres threads Amp.

Les deux utilisent le même modèle que le thread qui les a lancés. Amp les mobilise de lui-même quand le travail s’y prête, surtout en mode medium, et vous pouvez les demander directement : « répartis ça entre des sous-agents ».

L’oracle (un relecteur qui ne modifie jamais de fichiers), le librarian (qui clone d’autres dépôts dans /tmp et les explique) et le finder (recherche de code rapide) font désormais partie de Task. Pour les utiliser comme outils séparés avec le modèle de votre choix, installez-les comme plugins :

amp plugins add @amp/oracle
amp plugins add @amp/librarian
amp plugins add @amp/finder

Étape 6 : les réglages

Amp lit deux fichiers de réglages, et ceux du workspace l’emportent :

• Utilisateur : ~/.config/amp/settings.json (ou .jsonc).
• Workspace : .amp/settings.json dans le projet.

amp config edit ouvre le fichier utilisateur et amp config edit --workspace celui du projet. Chaque clé commence par amp. :

{
  "$schema": "https://ampcode.com/cli-settings.schema.json",
  "amp.showCosts": true,
  "amp.git.commit.coauthor.enabled": true,
  "amp.notifications.enabled": true
}

• amp.showCosts affiche le coût de chaque thread.
• amp.tools.disable désactive des outils par nom, avec des motifs * ; amp tools list liste les outils intégrés.
• amp.git.commit.ampThread.enabled et amp.git.commit.coauthor.enabled contrôlent ce qu’Amp ajoute à ses messages de commit, comme le trailer Amp-Thread-ID qui relie un commit à son thread.

À savoir avant de commencer : par défaut, Amp ne demande pas d’approbation avant d’exécuter des outils. Travaillez sur une branche, committez souvent et utilisez amp.tools.disable ou un plugin si vous voulez des garde-fous. Si vous préférez un agent qui demande d’abord par défaut, Claude Code et Codex CLI sont conçus autour des demandes d’approbation.

Les skills fonctionnent comme chez les autres agents : un dossier avec un SKILL.md. Amp charge les skills du projet depuis .agents/skills/, les skills personnels depuis ~/.config/amp/skills/ et ~/.config/agents/skills/, ainsi que les dossiers de Claude Code .claude/skills/ et ~/.claude/skills/.

Étape 7 : AGENTS.md

AGENTS.md contient les règles d’un projet : comment compiler, tester et lancer le linter, quelles conventions suivre, quels dossiers ne pas toucher. Amp lit celui du dossier courant et de chaque dossier parent jusqu’à votre dossier personnel, et les inclut toujours. Un AGENTS.md dans un sous-dossier est ajouté quand Amp lit un fichier de ce dossier. Si le projet n’en a pas, Amp propose d’en écrire un.

# Project rules

- Package manager: pnpm. Run `pnpm test` before you finish a task.
- TypeScript strict mode; no `any` in new code.
- API handlers live in src/api/; one file per route.
- See @docs/architecture.md for the module layout.

Quelques détails utiles :

• Les mentions @ intègrent d’autres fichiers : chemins relatifs, chemins @~/ et motifs comme @docs/*.md.
• Les règles personnelles vont dans ~/.config/amp/AGENTS.md (ou ~/.config/AGENTS.md).
• Repli : dans un dossier sans AGENTS.md, Amp lit AGENT.md ou CLAUDE.md, donc un projet Claude Code fonctionne dès le premier jour.
• Règles ciblées : un fichier mentionné peut porter un front matter globs:, pour que ses consignes ne s’appliquent que lorsque Amp travaille sur les fichiers correspondants.

Ce qu’il faut mettre dans le fichier est détaillé dans écrire CLAUDE.md et AGENTS.md.

Étape 8 : les serveurs MCP

Les serveurs MCP donnent de nouveaux outils à Amp : un navigateur, un gestionnaire de tickets, une recherche dans la documentation. Le plus rapide pour en ajouter un est la CLI :

amp mcp add context7 -- npx -y @upstash/context7-mcp
amp mcp add linear https://mcp.linear.app/sse

Les deux se retrouvent dans vos réglages sous amp.mcpServers. Un serveur local est une commande, un serveur distant une URL, et ${VAR} reprend des valeurs de l’environnement :

{
  "amp.mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["-y", "@playwright/mcp@latest", "--headless"]
    },
    "linear": {
      "url": "https://mcp.linear.app/sse"
    }
  }
}

Les serveurs du .amp/settings.json d’un workspace ne tournent pas tant que vous ne les avez pas approuvés avec amp mcp approve <name> ; amp mcp doctor affiche l’état de chaque serveur. Quand un même serveur est défini à plusieurs endroits, --mcp-config l’emporte sur le fichier du workspace, qui l’emporte sur vos réglages utilisateur. Comme chaque serveur ajoute ses outils au contexte, la documentation suggère de placer les serveurs rarement utilisés dans un skill (avec un mcp.json), pour que leurs outils ne se chargent qu’avec le skill.

Étape 9 : threads et mode execute

Chaque thread a une URL du type https://ampcode.com/threads/T-…. amp threads continue T-… le reprend dans le terminal, amp threads share T-… --visibility unlisted le rend partageable, et taper @T-… dans un prompt ajoute un autre thread comme contexte. Les threads démarrés hors d’un workspace sont privés.

Pour les scripts et la CI, le mode execute exécute un prompt puis s’arrête :

amp -x "what package manager is used here?"
git diff | amp -x "review this diff for bugs"
amp -ox "Investigate why the latest CI run on main failed"

-x s’exécute sur votre machine et s’active tout seul quand la sortie est redirigée. -ox exécute plutôt le prompt sur un orb. --stream-json produit une sortie lisible par une machine, et --mcp-config ajoute des serveurs MCP pour cette seule exécution.

Combien coûte Amp ? (octobre 2026)

L’usage des modèles provient de l’une de trois sources : un abonnement ChatGPT ou Claude lié, vos propres clés API ou des crédits Amp. Une fois l’usage inclus épuisé, vous ajoutez des crédits, qu’Amp facture au coût réel des modèles et des outils de chaque thread, sans marge sur les prix API des fournisseurs pour les particuliers et les workspaces hors entreprise. Pas besoin d’offre payante pour acheter des crédits. La recherche web consomme aussi des crédits. Les crédits expirent douze mois après l’achat, et amp usage affiche votre solde. Les orbs sont facturés à la minute et se mettent en pause quand ils sont inactifs ; les runners sur votre propre machine sont gratuits.

Les pièges courants

• Mauvais mode, et Ctrl+S ne le change pas. Le thread a déjà un premier message. Démarrez-en un nouveau avec Ctrl+C Ctrl+N.
• La CI dit que la connexion n’est pas valide. Le jeton de session d’amp login a une durée de vie courte. Mettez dans AMP_API_KEY un jeton d’accès sgamp_.
• Un serveur MCP du workspace n’apparaît jamais. Il doit être approuvé : amp mcp approve <name>, puis vérifiez avec amp mcp doctor.
• Votre offre Claude n’est pas utilisée. Seul le mode Claude Code s’en sert ; de low à ultra, c’est le routage propre à Amp.
• Amp a lancé une commande inattendue. Par défaut, il ne demande pas. Désactivez l’outil ou travaillez sur une branche jetable.
• Dans tmux, Shift+Entrée envoie le prompt. Activez extended-keys ou utilisez Ctrl+J.

Faire tourner Amp à côté d’autres CLI dans AgentVera

Amp a sa propre application web, son application de bureau et ses orbs, et si Amp est votre seul agent, cela suffit peut-être. Les choses se compliquent quand Amp tourne à côté de Claude Code, Codex ou Gemini CLI sur le même projet. AgentVera est une application de bureau qui exécute ces CLI côte à côte dans de vrais terminaux, avec vos propres installations et connexions. La prise en charge d’Amp fonctionne ainsi :

• Votre connexion Amp. Amp utilise sa propre connexion ampcode.com ; si vous êtes déconnecté, le terminal de l’agent vous demande de vous connecter au premier lancement. Dans Réglages → Comptes → Comptes des autres agents, vous pouvez ajouter d’autres comptes Amp, qui fonctionnent avec des clés API, et donner à chaque agent une liste ordonnée de comptes de secours.
• Un thread par agent. Un nouveau thread est créé à l’avance pour chaque agent avec amp threads new, et l’agent y revient avec threads continue aux lancements suivants.
• Des modes, pas des modèles. Vous choisissez low, medium, high ou ultra pour chaque agent, transmis avec --mode.
• MCP et le navigateur. Les serveurs ajoutés dans le MCP manager d’AgentVera et le navigateur d’AgentVera sont transmis avec --mcp-config. Amp n’a pas d’option pour des instructions supplémentaires, donc le champ de rôle de l’agent n’est pas utilisé ; c’est votre AGENTS.md qui s’applique.
• Volets, worktrees, revue et flows. Faites tourner Amp dans la grille du workspace à côté d’autres agents, chacun dans son propre git worktree pour qu’ils n’écrasent pas les fichiers des autres. La revue de code automatique vérifie leurs modifications, et dans les flows (Pro et Team) Amp peut être l’agent source ou cible.

La grille, les worktrees, la revue de code et le MCP manager sont inclus dans l’offre gratuite. Pour essayer, téléchargez AgentVera.

En résumé

Pour utiliser Amp, installez la CLI, lancez amp login, choisissez un mode avec Ctrl+S et décrivez la tâche. Démarrez la plupart des threads en medium, passez à high ou ultra pour les plus difficiles et laissez la recherche et la relecture aux sous-agents. Mettez les règles du projet dans AGENTS.md, les outils sous amp.mcpServers, et utilisez AMP_API_KEY avec amp -x pour les scripts. Comme Amp exécute les outils sans demander, gardez-le sur une branche : vous tirerez le meilleur d’un agent conçu pour se mettre directement au travail.