Accueil / Guides / Utiliser Claude Code gratuitement

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 | bash

Ouvrez 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>
claude

Configuration manuelle (Windows PowerShell)

$env:ANTHROPIC_BASE_URL="http://localhost:3001"
$env:ANTHROPIC_AUTH_TOKEN="<unified-key>"
claude
Important : utilisez ANTHROPIC_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èles gratuits pour Claude Code : appel d'outils et contexte de 128K+
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
OuiNon
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
OuiOui
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaOuiOui
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceOuiNon
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditOuiOui
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditOuiOui
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/jour
50 req/day account-wide (1,000 after a $10 purchase)
OuiOui
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/jour
Shared rate limit
OuiNon
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/jour
70,000 jetons/min
~6M
OuiOui
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayOuiOui

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 /clear entre les tâches pour envoyer moins de jetons.

Dépannage

ProblèmeCauseSolution
Claude Code demande une connexionLes variables d'environnement ne sont pas définies dans ce shellDéfinissez ANTHROPIC_BASE_URL et ANTHROPIC_AUTH_TOKEN, puis relancez claude
« Conflicting credential » ou démarrage impossibleANTHROPIC_API_KEY est définieSupprimez-la avec unset ANTHROPIC_API_KEY
Erreur 429 sur chaque requêteToutes vos clés de fournisseurs ont atteint leur limiteAjoutez des clés d'autres fournisseurs sur la page Keys
Les appels d'outils échouent ou l'agent s'arrêteLe modèle ne gère pas bien l'appel d'outilsAssociez la famille à un modèle du tableau ci-dessus
Les requêtes sont lentesDe grandes invites sur un petit modèle gratuit lentFigez un modèle rapide, par exemple un modèle Groq ou Cerebras
Utilisez chacun de ces modèles avec une seule clé. FreeLLMAPI est un routeur open source auto-hébergé. Il place toutes ces offres gratuites derrière un seul point de terminaison compatible OpenAI, et bascule vers une autre offre lorsqu'une limite de débit est atteinte. Parcourir le catalogue ou passer en production.

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

Sources

Tous les guides · Parcourir tous les modèles gratuits