Débutant 11 minConfiguration

Comprendre la fenêtre de contexte

Réponse directe

La fenêtre de contexte est le nombre maximal de tokens que le modèle traite en une fois : consigne système, historique, documents joints et réponse en cours de génération, le tout additionné. Elle coûte de la mémoire, car chaque token garde une entrée dans le cache KV. Sous Ollama, la valeur par défaut est de 4 096 tokens sur une carte de moins de 24 Gio de VRAM : c'est souvent elle, et non le modèle, qui limite ce que vous pouvez lui faire lire.

Trop courte, la fenêtre fait oublier le début d'un échange ou tronque un document. Trop grande, elle sature la VRAM et ralentit tout. Ce guide explique ce qu'elle contient, calcule sa consommation mémoire à partir de l'architecture d'un vrai modèle, et montre comment la régler sans mauvaise surprise.

Par Mohamed Meguedmi·Màj 2026-09-30·Testé sur Windows, macOS, Linux

#Ce que contient la fenêtre de contexte

Selon la documentation d'Ollama, la longueur de contexte est le nombre maximal de tokens auxquels le modèle a accès en mémoire. Tout s'additionne dans ce budget unique : le message système, l'historique de la conversation, les fichiers ou passages de documents que vous collez, votre dernière question et la réponse que le modèle est en train d'écrire. Pour un modèle de raisonnement, les tokens de réflexion comptent aussi. Quand le total dépasse la fenêtre, quelque chose doit sauter : les outils tronquent généralement le début, ou refusent la requête. Le modèle n'a aucune mémoire hors de cette fenêtre, sauf si un système extérieur (résumé, RAG) lui réinjecte des informations.

i
Fenêtre et mémoire ne sont pas la même chose
Un assistant qui « se souvient » d'une conversation d'hier ne le fait pas grâce à la fenêtre : l'application relit un historique ou une base et le recopie dans le prompt. La fenêtre est la limite de ce qui peut y entrer à un instant donné.

#Le token : l'unité qui remplit la fenêtre

Le kit IA Locale

Ton ChatGPT privé et gratuit sur ta machine en 1 heure — LM Studio, Ollama, Open WebUI, tes documents, sans cloud.

  • Espace en ligne à vie
  • PDF + fichiers
  • Mises à jour à vie

Un token n'est pas un mot : c'est un fragment de texte défini par le tokenizer du modèle, souvent une syllabe ou un mot courant. Un mot rare ou long en occupe plusieurs. Le français consomme en général plus de tokens que l'anglais pour un contenu équivalent, parce que la plupart des tokenizers sont entraînés surtout sur de l'anglais. Le rapport exact varie d'un modèle à l'autre : plutôt que de vous fier à une règle de pouce, mesurez. L'API d'Ollama renvoie prompt_eval_count, le nombre de tokens du prompt, à chaque requête.

Compter les tokens réels d'un prompt
curl http://localhost:11434/api/generate -d '{"model":"qwen3:8b","prompt":"Bonjour le monde","stream":false}'
# lisez prompt_eval_count et eval_count dans la réponse JSON
Règle de pouce
Une page A4 de texte français dense représente de l'ordre de un millier de tokens, selon le tokenizer : validez avec prompt_eval_count sur votre propre document.
Un livre
Plusieurs centaines de milliers de tokens : hors de portée d'une fenêtre de 32 000 ou 64 000 tokens sans découpage.
Une réponse
Un modèle de raisonnement peut produire des milliers de tokens de réflexion avant la réponse visible, qui consomment la fenêtre.

#Quelle taille de fenêtre choisir

Ollama fixe sa valeur par défaut selon la mémoire vidéo : 4 000 tokens environ (4k) sous 24 Gio de VRAM, 32k entre 24 et 48 Gio, 256k à partir de 48 Gio. La même page recommande au moins 64 000 tokens pour les tâches qui exigent un grand contexte, comme la recherche web, les agents et les outils de codage. Les modèles récents annoncent des maxima bien plus élevés : le catalogue QuelLLM indique par exemple environ 256 000 tokens pour Kimi K2.5 et environ 1 million pour Kimi K3, DeepSeek V4 Flash et GLM 5.2. Mais un maximum annoncé n'est pas un contexte utilisable sur votre machine : la mémoire, et parfois la qualité, s'y opposent.

Quelle fenêtre pour quel usage
UsageFenêtre indicativeRemarque
Conversation courte, questions-réponses4 096 à 8 192 tokensSuffit si vous ne collez pas de documents
Résumé ou analyse d'un article16 000 à 32 000 tokensVérifiez le nombre de tokens du texte
Assistant de code sur un dépôt64 000 tokens ou plusRecommandé par Ollama pour les outils de codage
Agent avec outils et recherche web64 000 tokens ou plusChaque appel d'outil réinjecte du texte
Très gros corpusNe visez pas la fenêtrePassez par un RAG plutôt que de tout envoyer

Deux pièges de dimensionnement reviennent souvent. D'abord, la fenêtre doit contenir la réponse : si vous remplissez 31 000 des 32 000 tokens avec un document, il ne reste presque rien pour répondre, et un modèle de raisonnement s'arrêtera en pleine réflexion. Ensuite, dans une conversation, l'historique grossit à chaque tour : une fenêtre qui suffit au premier message peut être saturée au vingtième. Prévoyez donc le pire cas de votre usage, pas le cas moyen, et gardez une marge d'environ un cinquième de la fenêtre.

#Combien de mémoire coûte le contexte

Chaque token présent dans la fenêtre laisse dans chaque couche du modèle une clé et une valeur, stockées dans le cache KV. Le coût par token se calcule à partir de quatre nombres de l'architecture : le nombre de couches, le nombre de têtes clé-valeur, la dimension d'une tête, et la taille d'un nombre (2 octets en FP16). La formule est : 2 (clé et valeur) × couches × têtes KV × dimension de tête × 2 octets. Attention : ce sont les têtes clé-valeur qui comptent, et non les têtes d'attention, car les modèles récents en partagent plusieurs (grouped-query attention). Le calcul avec les têtes d'attention surestime le cache d'un facteur de quatre pour le modèle ci-dessous.

Prenons Qwen3-8B, dont la fiche officielle indique 36 couches et 8 têtes clé-valeur (contre 32 têtes de requête), la configuration publique fixant la dimension d'une tête à 128. Le coût est de 2 × 36 × 8 × 128 × 2 = 147 456 octets par token, soit 144 Kio.

Cache KV de Qwen3-8B en FP16 (calcul d'après sa configuration)
ContexteCache KV (FP16)Cache KV (q8_0, environ la moitié)
4 096 tokens0,56 Gio0,28 Gio
8 192 tokens1,13 Gio0,56 Gio
16 384 tokens2,25 Gio1,13 Gio
32 768 tokens4,50 Gio2,25 Gio
131 072 tokens (avec YaRN, selon la fiche)18,00 Gio9,00 Gio
!
Le piège de la carte de 8 Go
Qwen3-8B en Q4 occupe environ 5 Go pour ses poids. Avec 32 768 tokens de contexte, le cache KV ajoute 4,5 Gio, ce qui atteint environ 9,5 Go avant même les buffers de calcul. Sur une carte de 8 Go, le modèle est alors déchargé en partie sur le CPU et la génération ralentit fortement, sans message d'erreur clair. Vérifiez avec ollama ps.

Deux leviers réduisent le cache. Le premier est la quantification du cache : la FAQ d'Ollama indique que le type q8_0 consomme environ la moitié de la mémoire du FP16 avec une perte très faible, et q4_0 environ un quart avec une perte plus visible aux grands contextes ; ils exigent que Flash Attention soit activée. Le second est de réduire la fenêtre à ce dont vous avez besoin. Notre guide sur le KV cache détaille les réglages.

#Régler la longueur de contexte

#Sous Ollama

Ollama permet de fixer la longueur par défaut au démarrage du serveur, de la changer pour une session ou de la préciser requête par requête via l'API.

Trois façons de fixer le contexte dans Ollama
# Valeur par défaut pour tout le serveur
OLLAMA_CONTEXT_LENGTH=64000 ollama serve

# Pour une session interactive
>>> /set parameter num_ctx 16384

# Pour un modèle personnalisé (Modelfile)
FROM qwen3:8b
PARAMETER num_ctx 16384

Après le chargement, exécutez ollama ps : la colonne CONTEXT affiche la longueur allouée et la colonne PROCESSOR indique la répartition entre GPU et CPU. Si une part passe sur le CPU, réduisez le contexte ou prenez un modèle plus petit.

#Sous LM Studio

Dans LM Studio, la longueur de contexte se règle au chargement du modèle, dans les paramètres de chargement. Changer la valeur oblige à recharger le modèle. Surveillez l'estimation de mémoire affichée avant de valider.

#Une procédure de réglage en quatre étapes

  1. 01
    Mesurer le besoin réel
    Envoyez votre document ou votre historique typique et lisez prompt_eval_count. Ajoutez la longueur de réponse attendue, et de la réflexion si le modèle en produit.
  2. 02
    Choisir la fenêtre
    Prenez la plus petite valeur qui contient ce total avec 20 % de marge, au moins 64 000 tokens si vous utilisez un agent ou un outil de codage, comme le conseille Ollama.
  3. 03
    Vérifier la mémoire
    Chargez le modèle avec cette fenêtre et lancez ollama ps. Le processeur doit afficher 100 % GPU ; sinon, réduisez la fenêtre, quantifiez le cache ou changez de modèle.
  4. 04
    Tester le rappel
    Placez un fait précis au milieu d'un long texte et demandez-le. Si le modèle le manque, la fenêtre annoncée dépasse ce qu'il exploite, et un découpage ou un RAG s'impose.

#Grande fenêtre ne veut pas dire lecture fidèle

Une étude de 2023, « Lost in the Middle », montre que les performances des modèles peuvent se dégrader nettement selon la position de l'information dans le contexte : elles sont souvent meilleures quand l'information se trouve au début ou à la fin, et se dégradent quand elle est au milieu, même pour des modèles annoncés comme à long contexte. Le benchmark RULER, publié en 2024, va plus loin : presque tous les modèles testés perdent beaucoup en précision quand la longueur augmente, et seule la moitié d'entre eux garde un niveau satisfaisant à 32 000 tokens, alors que tous annonçaient 32 000 ou plus.

Ces travaux portent sur des modèles de leur époque et ne disent rien des modèles de 2026, dont plusieurs sont entraînés spécifiquement pour le long contexte. Mais la conduite à tenir reste valable : placez la consigne et les faits critiques au début, rappelez la question à la fin, et mesurez sur vos documents avant de vous fier à une fenêtre annoncée de plusieurs centaines de milliers de tokens. Le test le plus simple consiste à glisser une information précise au milieu d'un long texte de votre domaine, puis à la redemander : si le modèle la retrouve à chaque essai, la fenêtre est exploitable pour votre usage ; s'il la rate, réduisez le texte envoyé ou passez par un découpage.

#Quand le contenu déborde

Résumer au fil de l'eau
Faites produire un résumé de l'échange tous les quelques tours et repartez avec ce résumé en tête de contexte : vous perdez du détail, mais vous gardez le fil.
Découper le document
Un long PDF se traite section par section, puis les réponses partielles sont agrégées. Le guide sur le chunking détaille les tailles utiles.
Passer à un RAG
Quand le corpus dépasse largement la fenêtre, on récupère les quelques passages pertinents au lieu de tout envoyer.
Choisir un modèle à plus grand contexte
Seulement si la mémoire suit : reportez-vous au calcul du cache KV plus haut avant de doubler la fenêtre.
FAQ
Qu'est-ce que la fenêtre de contexte d'un LLM ?+
C'est le nombre maximal de tokens que le modèle traite en une fois : message système, historique, documents joints, question et réponse en cours. Au-delà, le début est tronqué ou la requête refusée. La fenêtre limite ce que le modèle peut lire, pas ce qu'il a appris pendant son entraînement.
Quelle est la fenêtre de contexte par défaut d'Ollama ?+
Elle dépend de la mémoire vidéo : 4k tokens sous 24 Gio de VRAM, 32k entre 24 et 48 Gio, 256k au-delà de 48 Gio. Ollama recommande au moins 64 000 tokens pour les agents, la recherche web et les outils de codage. Vous pouvez la modifier avec OLLAMA_CONTEXT_LENGTH ou num_ctx.
Comment augmenter le contexte d'un modèle local ?+
Fixez OLLAMA_CONTEXT_LENGTH au démarrage du serveur, utilisez /set parameter num_ctx dans une session interactive, ou déclarez PARAMETER num_ctx dans un Modelfile. Vérifiez ensuite avec ollama ps que le modèle reste entièrement sur le GPU : un contexte plus long consomme davantage de mémoire et peut le faire déborder sur le CPU.
Combien de VRAM consomme un contexte de 32 000 tokens ?+
Cela dépend de l'architecture. Pour Qwen3-8B, le cache KV en FP16 atteint environ 4,5 Gio à 32 768 tokens, en plus des poids. La formule est : 2 × couches × têtes KV × dimension de tête × 2 octets par token. La quantification q8_0 du cache divise ce coût à peu près par deux.
Un contexte plus grand rend-il le modèle plus intelligent ?+
Non. Il lui permet de lire plus de texte, pas de mieux raisonner. Au contraire, les études « Lost in the Middle » et RULER montrent que la précision peut baisser quand le contexte s'allonge. Prenez la fenêtre nécessaire à votre tâche, pas la plus grande possible.
Faut-il un RAG ou une grande fenêtre pour analyser des documents ?+
Si le document tient dans la fenêtre avec une marge et que vous avez la mémoire, l'envoyer entier est plus simple. Au-delà, ou pour interroger une base de nombreux fichiers, le RAG est plus économe et souvent plus fiable, car il n'envoie que les passages utiles.

#Pour aller plus loin

Ce guide vous a aidé ?

Un retour, une erreur, une précision ? Faites-nous signe, ça améliore le guide pour tout le monde.