Sommaire
En bref : quand vous appuyez sur Entrée dans Claude Code, votre prompt quitte votre ordinateur en une seule requête, avec son contexte : la conversation jusque-là, les instructions, les outils et les fichiers déjà lus. Il part en HTTPS vers l’API d’Anthropic, peut-être à travers un océan par un câble sous-marin, jusqu’à un data center où des puces d’IA font tourner le modèle. La réponse revient en streaming, token par token. Parfois, la réponse est une demande : lire un fichier ou exécuter une commande sur votre machine. Claude Code l’exécute, après vous avoir demandé là où il est réglé pour demander, et renvoie le résultat. Cette boucle, c’est l’agent.
Une requête, bien plus que votre prompt
Claude Code tourne sur votre machine. Selon Anthropic, il « reads your codebase, edits files, runs commands, and integrates with your development tools » (lit votre base de code, modifie des fichiers, exécute des commandes et s’intègre à vos outils de développement). Quand vous appuyez sur Entrée, il envoie une requête à l’API Claude, une API RESTful à l’adresse https://api.anthropic.com, en HTTPS.
Cette requête contient plus que ce que vous avez tapé. Tout ce qu’elle transporte compte dans la fenêtre de contexte du modèle : « the system prompt, every message in messages (including tool results, images, and documents), and your tool definitions » (le prompt système, chaque message de messages, y compris les résultats d’outils, les images et les documents, et vos définitions d’outils).
Peut-être à travers un océan
Depuis votre routeur et votre fournisseur d’accès, la requête traverse Internet jusqu’à l’endroit où tourne le modèle. Entre continents, cela passe en général par un câble posé au fond de la mer : selon TeleGeography, les câbles sous-marins portent « over 99% » (plus de 99 %) du trafic de données intercontinental (le trafic satellite ne se mesure pas précisément).
Le point d’arrivée n’est pas toujours proche. Par défaut, l’API d’Anthropic indique que « inference may run in any available geography » (l’inférence peut s’exécuter dans n’importe quelle zone géographique disponible) ; seul le réglage us la garde sur une infrastructure basée aux États-Unis. Le data center peut donc se trouver de l’autre côté d’un océan.
Puces, couches, tokens
Dans le data center, des puces d’IA font tourner le modèle. Anthropic entraîne et exécute Claude sur « AWS Trainium, Google TPUs, and NVIDIA GPUs » (AWS Trainium, TPU Google et GPU NVIDIA). Le modèle élabore sa réponse un token à la fois (la vidéo le dessine comme des couches empilées : une illustration, pas l’architecture réelle).
La réponse n’attend pas d’être terminée. Avec le streaming, l’API l’envoie « incrementally … using server-sent events (SSE) » (progressivement, au moyen de server-sent events), si bien que chaque token repart par le même chemin au fur et à mesure qu’il est écrit.
La boucle, c’est l’agent
Parfois, ce qui revient n’est pas du texte mais une demande d’action : lire un fichier, exécuter une commande. Dans les termes de l’API, Claude répond par un bloc tool_use, « your code runs the operation and sends back a tool_result » (votre code exécute l’opération et renvoie un tool_result). Ici, votre code, c’est Claude Code, sur votre machine.
Il demande d’abord. Dans son mode manuel par défaut, Claude Code demande avant d’exécuter des commandes Bash (sauf un ensemble intégré de commandes en lecture seule) et avant de modifier des fichiers. Vous approuvez, la commande s’exécute sur votre machine, et le résultat repart dans la requête suivante. Encore et encore jusqu’à ce que la tâche soit finie : cette boucle, c’est l’agent.
À retenir
Claude Code est une boucle entre votre machine et un modèle dans un data center lointain. Tout ce qui s’exécute sur votre machine s’y exécute parce que Claude Code l’a lancé, après vous avoir demandé là où il est réglé pour demander.
Sources
- Anthropic, Claude Code overview
- Anthropic, Claude Code permissions
- Anthropic, API overview
- Anthropic, Context windows
- Anthropic, Data residency
- Anthropic, Streaming
- Anthropic, Tool use overview
- Anthropic, partenariat de calcul avec Google et Broadcom
- TeleGeography, Mythbusting, part 3
La vidéo est animée en code (rendue dans Blender) et le script a été écrit avec l’aide de l’IA ; chaque fait ci-dessus est vérifié auprès des sources. Illustratif : le trajet (un fournisseur, un câble, un data center), le modèle en couches empilées et le texte à l’écran. Il s’agit d’une vidéo explicative indépendante, sans lien avec Anthropic. La vidéo est en anglais. Réalisée avec Shotloop, mon app Mac gratuite pour faire des vidéos explicatives en code, corrigées un plan à la fois.