FreeLLMAPI : 7,4 milliards de tokens gratuits par mois pour ton Claude Code, Quentin IA Marketing

Tu es en plein milieu d'une tâche, et Claude Code t'annonce que tu as atteint ta limite. Tu attends la réinitialisation, ou tu passes à l'abonnement du dessus. Il existe une troisième voie pour tout ce qui n'a pas besoin du meilleur modèle : brancher ton terminal sur des modèles gratuits. FreeLLMAPI est un routeur open source qui regroupe les offres gratuites de 34 fournisseurs derrière une seule adresse, et Claude Code s'y branche en une commande.

Tu gardes ton terminal, tes fichiers, ton CLAUDE.md et tes règles. Ce qui change, c'est le modèle qui répond : ce n'est plus Claude, mais le meilleur modèle gratuit disponible à ce moment-là. Voici l'installation complète, le réglage qui évite qu'un modèle reparte de zéro, et les limites à connaître avant de t'en servir.

Claude AI Lab

Le Claude AI Lab, c'est ma communauté Skool où je partage mes systèmes Claude et les modules plus avancés. L'accès est à $67/mois.

Rejoindre le Lab →

✅Ce qu'il te faut

Docker, pour l'installation en une commande. Sans Docker, une application de bureau existe pour Mac (.dmg) et Windows (.exe).

Claude Code installé, et Node.js pour lancer la commande npx qui le configure.

Un compte chez au moins un fournisseur gratuit (Google, Groq, Mistral, Cerebras, OpenRouter…), pour récupérer une clé API.

Quinze minutes, la plus grande partie pour créer les comptes et copier les clés.

7,4 Md

tokens gratuits par mois, capacité annoncée

fournisseurs gratuits derrière une adresse

43 600+

étoiles sur GitHub, licence MIT

Ce que fait FreeLLMAPI

🔗 github.com/tashfeenahmed/freellmapi

🔀Un routeur, pas un modèle

Il tourne sur ta machine. Tu lui donnes les clés gratuites de tes fournisseurs, il te rend une seule clé unifiée et une seule adresse, compatibles avec les formats OpenAI et Anthropic.

Il choisit le modèle à chaque requête. Le mieux classé dont la clé est saine et sous tous ses plafonds. Sur une erreur de quota ou de serveur, il met la clé en pause et passe au modèle suivant de ta chaîne.

Il garde une conversation sur le même modèle pendant 30 minutes, pour éviter de changer d'interlocuteur à chaque message.

Tes clés restent chez toi. Elles sont chiffrées (AES-256-GCM) dans une base locale et déchiffrées en mémoire à chaque requête. Tes outils ne voient que la clé unifiée.

Les chiffres, lus correctement

Les 7,4 milliards de tokens sont la capacité cumulée annoncée par le projet, en additionnant les offres gratuites de tous les fournisseurs. Les 635 « points d'accès » sont des couples fournisseur et modèle, pas 635 modèles différents, et une partie ne sert pas à coder.

Récupérer les clés gratuites

🔑 le site de chaque fournisseur

🗝️Une clé par fournisseur

Crée un compte sur le site officiel du fournisseur et génère une clé API. FreeLLMAPI n'invente aucun quota : il additionne les offres gratuites que chaque fournisseur t'accorde.

Commence par trois ou quatre. Google, Groq, Mistral, Cerebras, OpenRouter, Cloudflare, NVIDIA ou Cohere font partie de la liste. Plus tu ajoutes de fournisseurs, moins tu tombes à court.

Un modèle local compte aussi. Le fournisseur « custom » accepte toute adresse compatible OpenAI que tu héberges : Ollama, LM Studio, llama.cpp ou vLLM.

Tu restes responsable de chaque compte

Le routeur fait passer ton trafic, mais les conditions d'utilisation de chaque fournisseur s'appliquent telles quelles. Lis-les avant d'y envoyer des données sensibles.

Installer le routeur

💻 Terminal, macOS, Linux ou WSL

📦Une commande

Lance la commande ci-dessous. Elle crée le dossier ~/freellmapi, génère une clé de chiffrement, télécharge l'image Docker et démarre le routeur. La relancer plus tard est sans risque : ta configuration et ta clé sont conservées, le routeur se met à jour.

Ouvre http://localhost:3001, colle tes clés sur la page Keys, puis range la chaîne de secours (Fallback Chain) dans l'ordre que tu veux.

Copie ta clé unifiée, affichée en haut de la page Keys. C'est la seule clé dont Claude Code aura besoin.

curl -fsSL https://freellmapi.co/install.sh | bash

Sans Docker

L'application de bureau (.dmg pour Mac, .exe pour Windows) se télécharge sur la page Releases du dépôt. Elle n'a pas de mot de passe à créer.

Brancher Claude Code

🔌 npx freellmapi setup-claude

🧪Toujours un aperçu avant d'écrire

Exporte ta clé unifiée, ou passe-la avec --api-key à chaque commande.

Lance d'abord l'aperçu avec --dry-run. Il affiche ce qui serait écrit dans ta configuration Claude Code, sans rien toucher.

Puis la vraie commande. Elle fusionne avec ta configuration existante et crée d'abord une sauvegarde horodatée.

export FREELLMAPI_API_KEY=<ta-clé-unifiée>
npx freellmapi setup-claude --url http://localhost:3001 --dry-run
npx freellmapi setup-claude --url http://localhost:3001

🧭Deux options à connaître

Un profil à part. --profile <nom> crée un profil Claude Code dédié au routeur, séparé de ton usage habituel avec ton abonnement Claude.

Rien sur le disque. npx freellmapi launch lance Claude Code branché sur le routeur sans écrire ta clé dans un fichier de configuration.

L'adresse racine, pas /v1

Claude Code attend http://localhost:3001, l'adresse racine, parce qu'il ajoute lui-même le chemin de l'API Anthropic. Les autres outils compatibles OpenAI attendent http://localhost:3001/v1.

Activer la note de passation

📝 fichier .env du routeur

🤝Pour qu'un modèle ne reparte pas de zéro

Le problème. Quand le routeur change de modèle en pleine conversation (quota atteint, limite de débit, clé en pause), le nouveau modèle ne sait pas qu'il reprend une tâche en cours.

La solution. La note de passation ajoute un court message système qui lui dit qu'il prend le relais, avec un résumé récent de l'échange, et lui demande de ne pas recommencer la tâche.

L'activer. Ajoute la ligne ci-dessous dans le fichier .env du routeur (~/freellmapi), puis redémarre-le.

FREELLMAPI_CONTEXT_HANDOFF=on_model_switch

✅

Ce qu'elle fait

Se déclenche seulement quand le modèle change dans une même session. Garde les messages en mémoire 3 heures, jamais sur le disque ni dans les journaux.

⛔

Ce qu'elle ne fait pas

Rien sur la toute première requête, ni si le modèle reste le même. Elle ne récupère pas l'état interne du modèle précédent.

Les limites

⚠️ à lire avant de t'en servir

🧱Cinq choses à savoir

Ce n'est plus Claude qui répond. Claude Code devient le client d'un autre modèle. Ton terminal et ton projet restent les mêmes, le cerveau change.

Pas de modèle de pointe. Latence variable, aucune garantie de service. La qualité baisse en fin de journée, quand les meilleurs modèles gratuits atteignent leur plafond, puis remonte à minuit UTC.

Le routeur ne crée pas de quota. Il suit les plafonds de chaque clé pour rester dessous, mais il ne peut pas donner plus que ce que le fournisseur accorde ce jour-là.

Les nouveaux modèles arrivent avec 30 jours de retard sur une installation gratuite. L'option Premium (19 $ par an, ou 49 $ une fois) les reçoit le jour même. Le routeur, lui, reste gratuit et sous licence MIT.

Pensé pour expérimenter, pas pour la production. Le projet le dit lui-même : avant de livrer quelque chose de réel, passe sur une API payante.

Si ça ne marche pas

🛠️ quatre symptômes

🔌

Claude Code ne se connecte pas

Vérifie l'adresse : Claude Code attend http://localhost:3001, sans /v1.

🌙

Plus aucun modèle ne répond

Les quotas gratuits du jour sont épuisés. Attends minuit UTC, ou ajoute la clé d'un fournisseur de plus.

🔒

Mot de passe oublié (installation serveur)

Clique « Forgot password? ». Le code à usage unique s'écrit dans le journal du serveur et reste valable 15 minutes.

🔁

La note de passation semble ne rien faire

Normal si la ligne n'est pas dans le .env, si c'est ta première requête, ou si le modèle n'a pas changé.

Pour lire le code de mot de passe ou suivre ce que fait le routeur sur une installation Docker :

docker compose logs -f freellmapi

Quand t'en servir

Garde ton abonnement Claude pour le travail qui compte : l'architecture, le code qui part en production, les décisions où la qualité du raisonnement fait la différence. Branche FreeLLMAPI sur un profil séparé pour tout le reste : prototyper une idée, tester un script, faire tourner des tâches répétitives qui n'ont pas besoin du meilleur modèle. Tu ne seras plus bloqué par une limite au milieu d'une session, et tu sauras toujours quel modèle travaille pour toi.