Utiliser Claude Code gratuitement
Claude Code est un agent de code d'Anthropic. Il a besoin d'une API Anthropic Messages. Ce guide montre comment connecter Claude Code à des modèles gratuits via FreeLLMAPI. Vous définissez deux variables d'environnement. Vous n'avez pas besoin de clé Anthropic.
Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.
Ce que vous obtenez et ce que vous n'obtenez pas
Claude Code envoie chaque requête à une API au format d'Anthropic. FreeLLMAPI parle ce format sur /v1/messages. Il traduit chaque requête et l'envoie à un modèle gratuit, par exemple Gemini, GPT-OSS, Qwen ou GLM.
- Vous obtenez : l'interface de Claude Code, ses outils, ses modifications de fichiers et sa boucle d'agent, sur des modèles gratuits.
- Vous n'obtenez pas : les modèles Claude d'Anthropic. Aucun fournisseur ne donne les modèles Claude gratuitement par une API. Lisez Existe-t-il une API Claude gratuite ? pour les détails.
- Coût : 0 $ pour l'inférence. Les offres gratuites ont des limites de débit. FreeLLMAPI passe au fournisseur suivant lorsqu'une limite bloque une requête.
Étape 1 : installer FreeLLMAPI
FreeLLMAPI est open source. Il fonctionne sur votre ordinateur dans Docker. Vos clés de fournisseurs restent sur votre ordinateur.
macOS ou Linux
curl -fsSL https://freellmapi.co/install.sh | bashOuvrez le tableau de bord à l'adresse http://localhost:3001. Ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys. Google AI Studio et Groq fournissent chacun une clé gratuite en environ une minute. Copiez votre clé unifiée depuis la même page.
Étape 2 : connecter Claude Code
La méthode la plus rapide est la commande de configuration. Elle lit votre catalogue en direct, crée une sauvegarde de ~/.claude/settings.json et ajoute les paramètres de la passerelle.
Une seule commande
npx freellmapi setup-claude --url http://localhost:3001 --api-key <unified-key>Pour configurer manuellement, définissez deux variables d'environnement et lancez Claude Code :
Configuration manuelle (macOS ou Linux)
export ANTHROPIC_BASE_URL=http://localhost:3001
export ANTHROPIC_AUTH_TOKEN=<unified-key>
claudeConfiguration manuelle (Windows PowerShell)
$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claudeANTHROPIC_AUTH_TOKEN. N'utilisez pas ANTHROPIC_API_KEY. Si ANTHROPIC_API_KEY est définie, Claude Code voit un identifiant en conflit et ne démarre pas.Pour vérifier que les requêtes passent par la passerelle, lancez npx freellmapi doctor. Chaque réponse contient aussi un en-tête X-Routed-Via. Cet en-tête indique le fournisseur et le modèle qui ont répondu.
Étape 3 : choisir des modèles pour le travail d'agent
Claude Code envoie de longues invites. Une requête type contient une grande invite système, des définitions d'outils et le contenu des fichiers. Utilisez des modèles avec appel d'outils et une grande fenêtre de contexte. Les petites offres gratuites à faible limite de jetons par minute échouent sur ces requêtes.
Dans l'onglet Keys, Anthropic, associez chaque famille Claude (opus, sonnet, haiku) à auto ou à un modèle. Avec auto, le routeur choisit un modèle gratuit pour chaque requête. Le tableau indique les modèles gratuits avec appel d'outils et au moins 128K de contexte, d'après le catalogue du jour.
| Modèle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Oui | Non |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Oui | Oui |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Oui | Oui |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Oui | Non |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/jour 50 req/day account-wide (1,000 after a $10 purchase) | Oui | Oui |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/jour Shared rate limit | Oui | Non |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/jour 70,000 jetons/min ~6M | Oui | Oui |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Oui | Oui |
Affichage de 12 modèles gratuits sur 109 correspondants. Voir tous les modèles.
Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.
Limites de débit et apport du basculement
Une tâche de Claude Code peut envoyer de 20 à 100 requêtes. Une seule offre gratuite vous arrête vite. Par exemple, une clé Gemini Flash gratuite autorise peu de requêtes par jour. FreeLLMAPI tient le compte du quota de chaque clé. Lorsqu'un fournisseur envoie une erreur 429, le routeur essaie le fournisseur suivant du pool. Votre session Claude Code continue.
- Ajoutez des clés d'au moins quatre fournisseurs. Plus de clés donnent plus de requêtes par jour.
- Associez
haikuà un petit modèle rapide. Claude Code l'utilise pour les courtes tâches en arrière-plan. - Gardez le contexte petit. Utilisez
/clearentre les tâches pour envoyer moins de jetons.
Dépannage
| Problème | Cause | Solution |
|---|---|---|
| Claude Code demande une connexion | Les variables d'environnement ne sont pas définies dans ce shell | Définissez ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN, puis relancez claude |
| « Conflicting credential » ou démarrage impossible | ANTHROPIC_API_KEY est définie | Supprimez-la avec unset ANTHROPIC_API_KEY |
| Erreur 429 sur chaque requête | Toutes vos clés de fournisseurs ont atteint leur limite | Ajoutez des clés d'autres fournisseurs sur la page Keys |
| Les appels d'outils échouent ou l'agent s'arrête | Le modèle ne gère pas bien l'appel d'outils | Associez la famille à un modèle du tableau ci-dessus |
| Les requêtes sont lentes | De grandes invites sur un petit modèle gratuit lent | Figez un modèle rapide, par exemple un modèle Groq ou Cerebras |
Questions fréquentes
Claude Code est-il gratuit à utiliser ?
Le programme Claude Code est gratuit à installer. Il a besoin d'une API de modèle pour fonctionner. Avec FreeLLMAPI, il utilise les offres gratuites des fournisseurs, donc l'inférence coûte 0 $.
Puis-je obtenir les vrais modèles Claude gratuitement ?
Non. Anthropic ne donne pas d'API Claude gratuite. Claude Code fonctionne avec d'autres modèles gratuits, par exemple Gemini, GPT-OSS, Qwen ou GLM, par le point de terminaison au format Anthropic.
Pourquoi utiliser ANTHROPIC_AUTH_TOKEN et non ANTHROPIC_API_KEY ?
Claude Code envoie ANTHROPIC_AUTH_TOKEN comme jeton Bearer à votre passerelle. Si ANTHROPIC_API_KEY est définie, Claude Code la traite comme un identifiant de première partie et refuse de démarrer.
Quel modèle gratuit est le meilleur pour Claude Code ?
Utilisez un modèle avec appel d'outils et une fenêtre de contexte de 128K jetons ou plus. Le tableau de cette page montre les modèles gratuits les plus performants qui respectent ces deux règles à ce jour.
Cela fonctionne-t-il sous Windows ?
Oui. Définissez les deux variables dans PowerShell avec $env:ANTHROPIC_BASE_URL et $env:ANTHROPIC_AUTH_TOKEN, puis lancez claude.
Guides associés
- Existe-t-il une API Claude gratuite ?
- Meilleures API gratuites de modèles de code
- Utiliser Codex CLI avec des modèles gratuits
- Cline, Roo Code et Kilo Code avec une API gratuite
- Limites de débit des API LLM gratuites
Sources
- FreeLLMAPI docs: Anthropic and Claude clients (vérifié le 20 November 2026)
- FreeLLMAPI CLI generators (vérifié le 20 November 2026)
- Claude Code documentation: LLM gateway configuration (vérifié le 20 November 2026)