Beaucoup pensent que Claude Code, « modèle dans le cloud », ne demande pas de grosse config — c’est à moitié faux. L’inférence n’utilise pas le GPU local, mais à chaque tool call l’agent lance npm test, xcodebuild, docker compose, les serveurs de langage… Nous avons exécuté 8 tâches identiques sur trois Mac M4 au même chip (16 / 24 / 64 Go), en mesurant pic mémoire, swaps et temps bout en bout. En bref : terminal léger, 16 Go suffisent ; IDE + agent au quotidien, 24 Go est le sweet spot ; Xcode + simulateurs + subagents parallèles → visez 64 Go.
1. Idée reçue : Claude Code ne consomme pas en local ?
L’inférence du grand modèle se fait chez Anthropic dans le cloud : pas besoin de GPU NVIDIA, pas d’OOM parce que « le modèle est trop gros ». Ce n’est pas pour autant qu’un vieux 8 Go suffit — le mode agent, c’est laisser l’IA piloter votre environnement local :
- Lecture de fichiers → ripgrep, git, cache disque
- Tests → arbres de processus Node, Jest, pytest, cargo test…
- Correction CI → possiblement
xcodebuild, Gradle, conteneurs Docker - Subagents parallèles → plusieurs sessions terminal lisent et compilent en même temps
Dans notre audit de facture Claude Code sur 30 jours : ce qui coûte le plus, ce sont souvent les longues sessions + lecture du dépôt entier. Côté mémoire, pareil — le swap ralentit les commandes locales déclenchées par l’agent de 2 à 5 fois ; vous n’attendez pas que le modèle, mais aussi la compilation et les tests locaux.
2. Environnement et méthodologie
| Élément | Spécification |
|---|---|
| Matériel | Mac mini M4 (trois unités, 16 / 24 / 64 Go RAM, SSD 512 Go chacune) |
| Système | macOS 15.5, synchro Bureau iCloud désactivée, mode économie d’énergie coupé partout |
| Claude Code | Version 2026.7, Sonnet par défaut ; refactorings complexes aussi testés avec Opus |
| Dépôts de test | ① Monorepo TypeScript (pnpm, ~180 paquets) ② Projet iOS Swift (SPM + CocoaPods) ③ Backend Go moyen (avec Docker Compose) |
| Échantillonnage | 3 exécutions par scénario, médiane ; memory_pressure + Moniteur d’activité pour pic et swaps |
| Chronométrage | Temps mur de l’envoi du prompt au message « tâche terminée » de l’agent (commandes locales incluses) |
Note : comparaison même chip, seule la RAM change — pas d’effet génération CPU. Les chiffres varient un peu selon la taille du dépôt et les dépendances ; l’écart relatif entre les trois paliers est resté stable sur plusieurs runs.
3. Mémoire occupée par Claude Code seul
Scénario ultra léger : terminal seul, dépôt vide, une courte Q&R :
| État | Résident | Pic |
|---|---|---|
| Claude Code au repos (connecté) | ~180 Mo | ~220 Mo |
| Un tour sans tool call | ~200 Mo | ~350 Mo |
| 5 tool calls (lecture de 20 fichiers) | ~280 Mo | ~520 Mo |
| Session agent 40 tours (contexte non vidé) | ~400 Mo | ~780 Mo |
Donc : si vous n’utilisez Claude Code que comme « ChatGPT terminal amélioré », 16 Go largement suffisent. L’écart vient des effets de bord locaux lancés par l’agent.
4. Tableau comparatif des 8 scénarios
Tableau : pic mémoire (Claude Code + processus locaux parallèles), swap marqué (>500 Mo/min de pagination) et médiane du temps mur.
| Scénario | Pic 16 Go | Temps 16 Go | Pic 24 Go | Temps 24 Go | Pic 64 Go | Temps 64 Go |
|---|---|---|---|---|---|---|
| S1 Terminal seul + petit correctif TS (3 fichiers, lint) | 6.8 Go OK | 42s | 6.8 Go | 41s | 6.8 Go | 40s |
| S2 Claude Code + Cursor + LSP TS | 14.6 Go Swap occasionnel | — | 14.6 Go OK | — | 14.6 Go | — |
S3 Agent lance pnpm test (suite complète) |
15.9 Go Swap important | 8m 12s | 16.4 Go Swap léger | 3m 05s | 16.4 Go | 2m 58s |
| S4 Refactor API sur 12 fichiers + tests | 16.1 Go Swap important | 14m 30s | 17.8 Go OK | 6m 20s | 17.8 Go | 6m 08s |
| S5 Claude Code + Xcode + simulateur iPhone 16 | — Inutilisable | 25m+ | 22.3 Go Limite | 11m 40s | 22.3 Go OK | 10m 55s |
| S6 Deux subagents parallèles (tests chacun) | — Risque OOM | Échec | 21.7 Go Swap | 9m 50s | 21.7 Go OK | 4m 22s |
| S7 Docker Compose 4 services + API agent | — Inutilisable | — | 23.1 Go Swap | 7m 15s | 23.1 Go OK | 5m 40s |
| S8 CI nocturne monorepo (build + test + lint) | — Swap continu | 45m+ | 24.6 Go Forte pression | 18m 20s | 24.6 Go OK | 16m 05s |
Lecture du tableau : à partir de S3, le 16 Go s’effondre — pas parce que Claude Code est lent, mais parce que les tests sont tués par le swap. Le 24 Go couvre S1–S4 et S5 léger ; agents parallèles et Docker restent tendus. Le 64 Go : zéro « inutilisable » ; S6 à deux subagents plus de deux fois plus rapide qu’en 24 Go.
5. 16 Go : usages possibles et limites
Pour qui
- Claude Code surtout en terminal, IDE occasionnel ou Vim/Neovim
- Petit dépôt (<50k lignes), tests en moins de 30 secondes
- Pas de simulateur iOS, pas de matrice Docker
- Déjà un MacBook Air / MacBook Pro d’entrée, budget RAM reporté
Règles de survie en 16 Go
- Une seule appli « lourde » à la fois : fermer la fenêtre Cursor avec LSP TS pendant les tests agent
- Configurer
.claudeignorepour moins d’indexation inutile (comme dans l’article facture — économise aussi la RAM) /cleardès la fin d’un sous-tâche, éviter la boule de contextexcodebuild, Docker, CI longue sur Mac cloud ; local = édition et vérifs légères
# Vue temps réel memory_pressure # Utilisation du swap sysctl vm.swapusage # Processus les plus gourmands top -l 1 -s 0 -o mem | head -20
Ressenti : S1–S2 fluides ; dès qu’l’agent lance la suite complète (S3), ventilateur, curseur qui accroche, l’agent croit au « timeout test » et relance — lent et plus de tokens.
6. 24 Go : le meilleur choix pour la majorité
Si un seul palier pour « Claude Code + IDE moderne », 24 Go est le sweet spot 2026 — sur MacBook Pro 14″ M4, upgrade fréquent, souvent bien moins cher que le saut vers 48 Go.
24 Go couvre confortablement
- Claude Code + Cursor (ou VS Code) + LSP TypeScript / Python en parallèle
- Une passe de tests complète sur monorepo moyen
- Refactor multi-modules jusqu’à 12 fichiers + boucle de tests auto
- Un service Docker (base / Redis) + API locale
24 Go reste juste quand
- Xcode + simulateur iOS + Claude Code ensemble (pic S5 22,3 Go, marge minuscule)
- Deux subagents parallèles (S6) ou quatre services Docker (S7)
- Chrome 50+ onglets + stack ci-dessus (fréquent, ne riez pas)
7. 64 Go : qui en a vraiment besoin
64 Go sonne « surplus », mais pour les power users Claude Code ça règle le parallélisme — plus une file de compilation, mais plusieurs subagents qui lisent, testent et lancent des conteneurs en même temps.
Signaux pour viser 64 Go
| Signal | Pourquoi 64 Go |
|---|---|
| Souvent 2+ simulateurs iOS pour tests UI | Un simulateur ~3–5 Go, Xcode ~4–6 Go |
| Subagents parallèles avec Claude Code | Chaque session peut lancer son arbre de tests |
| Matrice Docker locale (db + cache + queue + mock) | La RAM des conteneurs s’additionne vite |
| Gros monorepo (cache turbo / nx résident) | Cache build + LSP + index remplissent 24 Go |
| Tech lead avec 3 fenêtres projet ouvertes | Pas du luxe, du quotidien |
S6 deux subagents : 64 Go 4m 22s vs 24 Go 9m 50s — pas le modèle, mais deux npm test parallèles sans se battre pour le swap. À 2 jobs parallèles/jour, 5 min gagnées chaque fois : ~60 h d’attente par an.
Budget à 36 Go (certains M4 Pro) : bon compromis iOS ; S5 plus stable qu’en 24 Go, mais pour double subagent, en fermer un ou déporter sur le cloud.
8. Au-delà de la RAM
| Composant | Impact sur Claude Code | Recommandation |
|---|---|---|
| SSD | L’agent lit beaucoup ; en swap, la vitesse disque fixe les à-coups | 512 Go minimum, 1 To plus confortable ; éviter disque externe lent pour le dépôt |
| Chip | Builds locaux, pas l’inférence modèle | M4 suffit ; M4 Pro plus rapide en multi-cœur, voir guide MacBook Pro |
| Réseau | Streaming, gros contexte uploadé ; coupure = agent interrompu | Câble stable ou Wi‑Fi 5 GHz ; éviter le partage de connexion pour longues tâches |
| Thermique | Compilations longues + chaleur estivale | Support pour portable ; tâches 7×24 plutôt Mac mini / cloud |
| Écran | Pas d’effet RAM direct, mais double écran = plus de fenêtres IDE résidentes | Écran externe → prévoir plus de marge RAM |
9. Hybride : machine locale + Mac cloud
Pas obligé de monter le portable à 64 Go. Approche 2026 courante :
- Local 16–24 Go : édition Claude Code, review, tests légers
- Mac mini M4 cloud (24–64 Go) :
xcodebuild, CI nocturne, subagents lourds - SSH sur le cloud pour la session agent ; local ne reçoit que les résultats — le goulot mémoire part au datacenter
En écho à notre article facture : fermer le capot → l’agent repart, tokens et temps perdus. Un Mac cloud toujours en ligne convient aux « longues tâches à déléguer ».
Pas assez de RAM ? Envoyez le lourd sur un Mac cloud toujours en ligne
Nuvcloud propose des Mac mini M4 dédiés (plusieurs configs RAM), accès SSH/VNC, facturation jour/semaine/mois. 16 Go en local pour coder, 64 Go dans le cloud pour agents Claude Code parallèles + build Xcode complet — voir les tarifs.
10. Guide d’achat par profil
| Votre profil | RAM conseillée | Matériel type | Note |
|---|---|---|---|
| Étudiant / scripts / automatisation ops | 16 Go | MacBook Air M4, Mac mini M4 | Avec .claudeignore + cloud pour le lourd |
| Full-stack / backend / data | 24 Go | MacBook Pro 14 M4, Mac mini M4 | Meilleur rapport qualité-prix |
| Dev iOS / macOS solo | 24–36 Go | MacBook Pro 14 M4 Pro | Simulateur souvent ouvert : 36 Go+ |
| Tech lead / maintenance monorepo | 48–64 Go | MacBook Pro 16 M4 Pro/Max, Mac mini sur mesure | Subagents parallèles indispensables |
| PC Windows principal | Cloud 24 Go+ | Mac mini Nuvcloud | Pas besoin d’un second portable |
11. Questions fréquentes
| Question | Réponse |
|---|---|
| Claude Code mange plus de RAM que Cursor ? | Le terminal est plus léger ; l’agent lance plus volontiers des commandes shell → effets locaux plus grands. Voir article couches IDE. |
| La RAM influence la facture en tokens ? | Indirectement : swap → timeout → retry → plus de tours. Machine lente = facture haute. |
| La mémoire unifiée Apple peut aller au GPU ? | Oui, mais Claude Code utilise peu le GPU local. L’intérêt : CPU et tâches I/O partagent le même pool — gardez de la marge. |
| Upgrader la RAM plus tard ? | Non. Apple Silicon est soudée — choisir au moment de l’achat. |
| Poste Linux + Claude Code ? | Supporté. Même conseil : 24 Go minimum ; sans toolchain macOS, souvent plus rentable. |
| Quand upgrader ou déporter ? | Pendant une tâche agent, lancez memory_pressure — « warn » ou swap qui monte : plus de RAM ou cloud. |
12. Conclusion
Claude Code transforme « écrire du code » en « diriger l’environnement local » — choisir la RAM, c’est estimer combien de processus l’agent lancera en parallèle pour vous. Nos mesures sont claires :
- 16 Go : terminal léger OK ; IDE + tests complets + agent ensemble → swap et chute brutale
- 24 Go : sweet spot 2026 pour la plupart, ~80 % des workflows Claude Code
- 64 Go : « taxe anti-galère » pour agents parallèles, matrice Xcode, Docker lourd — on gagne du temps, pas du prestige
La RAM est soudée — mieux vaut baisser d’un cran CPU et viser la bonne RAM. Budget serré : souvent 24 Go local + gros Mac cloud vaut mieux que 16 Go à la dure : un redémarrage agent coûte assez de temps et de tokens pour plusieurs jours de cloud.