# Utiliser Amp : guide pas à pas de la CLI Amp

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

Utiliser Amp, l’agent de code : installer la CLI, se connecter, choisir un mode sur le Dial et configurer AGENTS.md, les serveurs MCP, les sous-agents et les crédits.

**En bref:**

- Installez la CLI Amp avec une seule commande curl (macOS, Linux, Windows via WSL), lancez amp login, puis amp dans un projet. Chaque conversation est un thread enregistré sur ampcode.com.
- Au lieu d’un modèle, vous choisissez un mode sur le Dial : low, medium, high ou ultra. Choisissez-le avec Ctrl+S avant le premier message, car un thread garde son mode.
- Les règles du projet vont dans AGENTS.md, les réglages et serveurs MCP dans ~/.config/amp/settings.json ou .amp/settings.json. Hobby est gratuit ; les modèles se paient via abonnements, clés ou crédits.

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](/fr/glossary/coding-agent/ "Qu’est-ce qu’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

| Plateforme | Commande |
| --- | --- |
| macOS, Linux | `curl -fsSL https://ampcode.com/install.sh \| bash` |
| Windows | Lancer la même commande dans WSL |

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

```bash
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 :

```bash
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.

| Raccourci | Ce qu’il fait |
| --- | --- |
| `Ctrl+O` | Ouvre la palette de commandes |
| `Ctrl+S` | Tourne le Dial (avant le premier message) |
| `@` | Mentionne un fichier |
| `Ctrl+V` | Colle une image, y compris sous macOS |
| `Ctrl+G` | Rédige le prompt dans `$EDITOR` |
| `Ctrl+R` | Ouvre l’historique des prompts |
| `Esc Esc` | Interrompt l’agent |
| `Ctrl+C Ctrl+N` | Archive le thread et en démarre un nouveau |
| `Ctrl+C Ctrl+C` | Quitte |

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é :

| Mode | Pour quoi faire |
| --- | --- |
| `low` | Petites modifications bien délimitées |
| `medium` | La plupart des tâches ; le conseil par défaut de la documentation |
| `high` | Problèmes difficiles ou subtils |
| `ultra` | Travail ouvert comme les migrations et l’architecture |

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](/fr/glossary/subagent/ "Qu’est-ce qu’un sous-agent"), 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 :

```bash
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.` :

```json
{
  "$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.

```markdown
# 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](/fr/blog/claude-md-agents-md/ "Écrire CLAUDE.md et AGENTS.md").

## Étape 8 : les serveurs MCP

Les [serveurs MCP](/fr/blog/what-is-mcp-server/ "Qu’est-ce qu’un serveur 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 :

```bash
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 :

```json
{
  "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 :

```bash
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)

| Offre | Prix | Ce qu’elle comprend |
| --- | --- | --- |
| Hobby | Gratuit | Toutes les fonctionnalités ; orbs payés à l’usage ; vos abonnements ou clés |
| Individual (Megawatt) | 20 dollars par mois | Usage inclus plus 45 000 minutes d’orbs sur les serveurs d’Amp |
| Teams | Sans surcoût | Threads, skills et facturation partagés, crédits mutualisés, SSO |
| Enterprise | Sur mesure | Contrôles d’administration, journaux d’audit, options de rétention des données |

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](/fr/agents/amp/ "Amp dans AgentVera") 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](/fr/features/mcp-manager/ "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](/fr/features/workspace/ "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](/fr/download/ "Télécharger 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.

## Questions fréquentes

**Amp est-il gratuit ?** En octobre 2026, l’offre Hobby est gratuite et inclut toutes les fonctionnalités du produit. L’usage des modèles se paie via un abonnement ChatGPT ou Claude que vous liez, vos propres clés API ou des crédits Amp, facturés aux particuliers au prix API des fournisseurs, sans marge. L’offre Individual coûte 20 dollars par mois et ajoute 45 000 minutes d’orbs sur les serveurs d’Amp.

**Qui développe Amp aujourd’hui ?** Amp est né au sein de Sourcegraph. En décembre 2025, il est devenu une entreprise indépendante ; la CLI, l’application web et la documentation se trouvent désormais sur ampcode.com.

**Peut-on choisir le modèle dans Amp ?** Pas directement à chaque message. Vous choisissez un mode (low, medium, high ou ultra), et le mode détermine le modèle, l’effort de raisonnement, le prompt et les outils. Dans Réglages → Mode Dial → Tune Modes, vous pouvez fixer les modèles d’un mode et utiliser vos propres clés API.

**Amp lit-il CLAUDE.md ?** Oui, en solution de repli. Dans tout dossier sans AGENTS.md, Amp lit AGENT.md ou CLAUDE.md à la place. Il charge aussi les skills des dossiers de Claude Code, .claude/skills/ et ~/.claude/skills/, sauf si vous le désactivez.

**Amp demande-t-il avant d’exécuter des commandes ?** Non. Par défaut, Amp ne demande pas d’approbation avant d’exécuter des outils. Vous pouvez désactiver des outils intégrés avec amp.tools.disable, fixer des règles pour les outils MCP avec amp.mcpPermissions ou écrire un plugin qui décide quels appels d’outils passent.

---

**À 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/