Qu'est-ce que claude-code-local ?
claude-code-local est un serveur local, pas une application de discussion ni un IDE. Il s'intercale entre la CLI officielle Claude Code d'Anthropic et un modèle ouvert exécuté localement, traduisant les requêtes au format API Anthropic de Claude Code vers un format qu'un modèle local hébergé par MLX peut traiter, puis traduisant la réponse en retour. Sa propre description GitHub la résume ainsi : elle permet de « Run Claude Code 100% on-device with local AI on Apple Silicon » via un « MLX-native Anthropic-API server ».
- Fonction principale : un serveur local compatible avec l'API Anthropic (
proxy/server.py) vers lequel Claude Code peut être dirigé à la place deapi.anthropic.com, via les variables d'environnementANTHROPIC_BASE_URLetANTHROPIC_API_KEY - Moteur d'inférence : MLX, le framework de calcul matriciel d'Apple pour Apple Silicon, via le paquet
mlx-lm— c'est pourquoi le projet est réservé au Mac et nécessite une puce de la série M - Ce que ce n'est pas : le projet ne télécharge, n'exécute ni n'expose d'aucune façon le véritable modèle Claude d'Anthropic. « Claude Code » dans le nom du projet désigne le client CLI d'Anthropic, que ce projet détourne pour dialoguer avec un modèle différent, hébergé localement
- Développeur : un seul développeur indépendant, Matt Macosko, basé à Arcata, en Californie, selon le pied de page du README GitHub — le README indique explicitement « one person, no team, no investors »
- Dépôt canonique : github.com/nicedreamzapp/claude-code-local — le projet d'origine, actif ; un fork du même nom, jinzaizhichi/claude-code-local, existe sur GitHub avec zéro étoile et n'est pas un projet indépendant distinct
Historique du projet et jalons de versions
Le dépôt GitHub a été créé le 26 mars 2026. Le développement est rapide, mais le projet n'a encore formellement tagué que trois versions, chacune regroupant un correctif ou une fonctionnalité majeure plutôt que de taguer chaque commit.
- 1v0.1.0 — 8 mai 2026 : correctif hors ligne vérifié et support des Mac 16 Go
Why it matters: Un contributeur a découvert via `lsof` que Claude Code 2.1 continuait de contacter `api.anthropic.com` au démarrage pour la télémétrie, les feature flags, l'installation automatique du marketplace et les mises à jour automatiques, même avec une `ANTHROPIC_BASE_URL` locale configurée — ce qui signifie que les configurations précédentes suivant l'ancien README n'étaient en réalité pas entièrement hors ligne. Cette version a corrigé le problème en désactivant ce trafic en arrière-plan via quatre variables d'environnement documentées, et a changé le modèle par défaut pour les Mac 16 Go (qui plantait avec le précédent modèle par défaut) vers un modèle plus petit et fonctionnel. - 2v0.2.0 — 5 août 2026 : correction de l'exactitude du cache de prompts
Why it matters: Correction d'un bug où le cache de prompts partagé se corrompait après la première session sur un serveur longue durée, provoquant, selon les notes de version, des réponses de sessions ultérieures issues du cache d'une conversation précédente et sans rapport. La mesure avant/après du projet lui-même, sur un serveur de longue durée, est passée de 1 bonne réponse sur 8 à 8 sur 8 après le correctif. - 3v0.3.0 — 22 août 2026 : lancement du benchmark Agent-12 et support Qwen 3.8 27B en pleine précision
Why it matters: Introduction de la propre suite de benchmark open source du développeur (« Agent-12 ») pour aider les utilisateurs à choisir un modèle, et ajout du support en pleine précision (non quantifié) pour un modèle de 27B avec décodage spéculatif, pour une accélération revendiquée d'environ 3 à 4 fois. Ces chiffres de performance et de benchmark sont des mesures auto-déclarées par le développeur — cet avis n'a pas pu les vérifier de manière indépendante, il convient donc de considérer les chiffres précis comme un point de départ plutôt qu'une garantie pour votre propre matériel.
Que peut-on faire avec claude-code-local ?
L'ensemble des fonctionnalités du projet vise à faire fonctionner Claude Code avec un modèle local avec un minimum de friction, ainsi que plusieurs modes locaux supplémentaires construits sur le même serveur sous-jacent. Voici ce que chaque élément fait réellement, selon le propre README GitHub du projet.
- Claude Code, redirigé en local — le cas d'usage principal : continuer à utiliser la CLI
claudeexactement comme d'habitude, mais en la faisant répondre par un modèle exécuté sur votre propre Mac plutôt que par le cloud d'Anthropic - Solution de repli « Keep going » — une commande shell permettant de poursuivre une conversation Claude Code existante avec un modèle différent (un modèle cloud gratuit OpenRouter, ou un modèle local) lorsque vous atteignez la limite d'usage propre à Anthropic, sans perdre la conversation
- Mode Native Engine — un agent plus léger intégré au projet lui-même, proposé comme alternative plus rapide au routage de chaque requête via le client Claude Code complet
- Mode Browser Agent — un mode optionnel où le modèle exécuté localement peut piloter une véritable fenêtre de navigateur, documenté séparément dans le guide Browser Agent du projet
- Mode vocal — un mode optionnel mains libres pour parler au modèle local et entendre une réponse vocale, documenté dans le guide du mode vocal du projet
- Contrôle depuis un téléphone — un mode optionnel pour envoyer des commandes au serveur hébergé sur le Mac depuis un téléphone, documenté dans le guide de contrôle téléphonique du projet
- Isolation du trafic — définit quatre variables d'environnement propres à Claude Code et documentées, pour désactiver les appels réseau non essentiels en arrière-plan (télémétrie, mise à jour automatique, installation automatique du marketplace, tâches en arrière-plan), vérifiable soi-même via
lsof -p $(pgrep -f claude)
Exemples d'utilisation : trois façons d'utiliser claude-code-local
Voici des scénarios concrets construits à partir des fonctionnalités documentées du projet ci-dessus — pas des cas d'usage hypothétiques.
Continuer à coder après avoir atteint la limite d'usage d'Anthropic
Claude Code signale que vous avez atteint votre limite d'usage et que la réinitialisation n'aura lieu que dans plusieurs heures. Plutôt que de vous arrêter, vous démarrez le serveur local (ou il tourne déjà), configurez ANTHROPIC_BASE_URL et ANTHROPIC_API_KEY pour pointer vers localhost, et poursuivez la même session avec un modèle local — le README du projet présente cela comme la raison principale de son installation.
Mettre en place un environnement de codage air-gapped et entièrement hors ligne
Pour des workflows juridiques, médicaux ou autres exigeant l'absence totale d'appels réseau, installez la version v0.1.0 ou ultérieure de claude-code-local (qui a corrigé la fuite de trafic en arrière-plan mentionnée plus haut), démarrez le modèle local, et vérifiez avec lsof que le processus Claude Code n'atteint que localhost:4000 pendant une session — aucune requête ne doit atteindre api.anthropic.com.
Choisir un modèle adapté à la mémoire de votre Mac
Avant d'installer, vérifiez la mémoire unifiée de votre Mac. Exécutez bash setup.sh, qui détecte la mémoire de votre Mac et recommande automatiquement un niveau de modèle — un MacBook Air de 16 Go reçoit un modèle plus petit (Hermes 4 14B), tandis qu'un Mac Studio de 96 Go et plus peut exécuter un modèle bien plus grand (Qwen 3.5 122B).
Installer claude-code-local
claude-code-local s'installe depuis le code source via un script shell — il n'existe aucune application téléchargeable ni version via gestionnaire de paquets. Il nécessite un Mac Apple Silicon (M1 ou plus récent), Python 3.12, et la CLI officielle Claude Code d'Anthropic déjà installée.
Source | Link |
|---|---|
| Dépôt officiel (code source, MIT) | github.com/nicedreamzapp/claude-code-local |
| Installateur en une commande | curl -fsSL https://raw.githubusercontent.com/nicedreamzapp/claude-code-local/main/install.sh | bash |
| Installation manuelle (clone + script de configuration) | git clone https://github.com/nicedreamzapp/claude-code-local && cd claude-code-local && bash setup.sh |
| Dépendance requise : CLI Claude Code | npm install -g @anthropic-ai/claude-code (paquet officiel d'Anthropic) |
| Versions de modèles MLX prêtes à l'emploi | huggingface.co/divinetribe |
L'installateur en une commande transmet directement un script distant à bash ; le README du projet propose une alternative manuelle (« prefer to do it by hand? ») pour quiconque veut lire setup.sh avant de l'exécuter. Les deux voies nécessitent Apple Silicon — il n'existe aucune version pour Mac Intel, Windows ou Linux, le projet dépendant du framework MLX d'Apple.
Tarifs et licence : est-ce vraiment gratuit ?
Oui — claude-code-local lui-même est gratuit et open source, sous licence MIT, confirmée par le badge de licence et le fichier LICENSE du dépôt. Aucun abonnement, compte ou limite d'usage n'est imposé par le projet lui-même.
- Le serveur, l'installateur et les lanceurs sont gratuits et sous licence MIT, sans offre payante
- Les modèles locaux fonctionnent sans coût par jeton, en utilisant le matériel et l'électricité de votre propre Mac
- Le projet nécessite toujours la CLI officielle Claude Code d'Anthropic, gratuite à installer ; le fait de maintenir par ailleurs un abonnement Anthropic vous appartient et est indépendant de l'usage de ce projet
- Une solution de repli cloud « keep going » optionnelle peut utiliser des modèles OpenRouter du niveau gratuit avec votre propre clé API gratuite — c'est optionnel et non requis pour le workflow local principal
Exigences matérielles et choix de modèles
Les exigences matérielles varient directement selon le modèle choisi, car claude-code-local n'a pas de minimum fixe propre au-delà d'Apple Silicon et macOS. Le propre script de configuration du projet recommande un niveau de modèle selon la mémoire unifiée totale de votre Mac.
Mémoire unifiée | Modèle recommandé |
|---|---|
| 16 Go (ex. MacBook Air, modèles de base) | Hermes 4 14B |
| 32–48 Go (niveau Pro) | Gemma 4 12B |
| 64–95 Go (niveau Max) | Gemma 4 31B |
| 96 Go et plus (niveau Max/Ultra) | Qwen 3.5 122B, avec de la marge pour Llama 3.3 70B et d'autres en parallèle |
Le projet documente aussi plusieurs options de modèles supplémentaires au-delà de la recommandation par défaut par niveau, dont Qwen 3.8 27B en pleine précision et une version « abliterated » (refus de sécurité réduits), auto-qualifiée ainsi, d'un modèle de 30B nommé Muse-Glimmer. Une remarque sur les modèles « abliterated » : le propre README du projet signale que ces modèles ont leurs refus de sécurité intégrés atténués et indique clairement que « each model's own license still applies » et qu'il faut « use them responsibly » — il s'agit d'une réelle différence de capacité par rapport à un modèle instruit standard, et la responsabilité de l'usage vous incombe. Les chiffres de benchmark et de vitesse pour des modèles spécifiques dans le README (y compris le classement Agent-12) sont des mesures auto-déclarées par le développeur, non vérifiées de manière indépendante par PromptQuorum.
À qui s'adresse claude-code-local ?
La pertinence de ce projet dépend de si vous voulez spécifiquement conserver le workflow de la CLI Claude Code tout en y substituant un modèle local, et de si vous disposez du matériel Apple Silicon requis.
Utilisez claude-code-local si
- Vous utilisez déjà la CLI Claude Code d'Anthropic et voulez continuer à travailler avec quand vous atteignez une limite d'usage, voulez éviter les coûts d'API, ou devez travailler entièrement hors ligne
- Vous possédez un Mac Apple Silicon (M1 ou plus récent) avec suffisamment de mémoire unifiée pour un modèle que vous jugez utile
- Vous voulez une configuration air-gapped pour des workflows juridiques, médicaux ou autres sensibles, et êtes prêt à vérifier vous-même le comportement réseau (par ex. via
lsof) - Vous êtes à l'aise pour installer depuis le code source via un script shell plutôt qu'une application signée et téléchargeable
- Vous comprenez et acceptez d'exécuter un modèle ouvert différent, hébergé localement — et non le véritable modèle Claude d'Anthropic — via une interface compatible
Attendez, ou cherchez ailleurs, si
- Vous n'êtes pas sur Apple Silicon — ce projet n'a aucune version Windows, Linux ou Mac Intel, car il dépend du framework MLX d'Apple
- Vous voulez un moyen officiel et pris en charge par l'éditeur d'exécuter Claude Code hors ligne — il s'agit d'un projet communautaire, pas d'un produit Anthropic ni d'un canal exploité ou garanti par Anthropic
- Vous attendez que la qualité de sortie du modèle local égale celle du véritable modèle Claude d'Anthropic — c'est un modèle ouvert différent qui répond, et la qualité varie selon celui choisi et votre niveau de matériel
- Vous n'êtes pas à l'aise pour transmettre un script d'installation distant à
bash, ou pour d'abord examiner vous-mêmesetup.sh— le propre README du projet propose les deux voies, utilisez donc la manuelle si cela compte pour vous
claude-code-local face aux autres configurations d'assistants de codage locaux
claude-code-local est l'une des nombreuses façons de faire fonctionner une assistance IA au codage avec un modèle local plutôt qu'une API cloud. Voici sa place face aux autres options dans ce domaine — consultez le répertoire des logiciels LLM locaux pour le catalogue complet.
- oMLX — un serveur d'inférence MLX généraliste pour Apple Silicon avec mise en cache de modèles sur SSD ; contrairement à claude-code-local, il n'est pas construit spécifiquement autour du format d'API de Claude Code, mais reste la comparaison la plus proche pour quiconque choisit un backend local basé sur MLX sur Mac. Voir l'avis oMLX.
- Aider — un outil de programmation en binôme IA en terminal, agnostique du modèle, qui fonctionne avec des modèles locaux via tout point de terminaison compatible OpenAI, intégré à git par conception ; une bonne comparaison si vous voulez une CLI de codage conçue local en premier lieu plutôt qu'une couche de compatibilité devant le client d'Anthropic. Voir l'avis Aider.
- Cline — un agent de codage autonome open source basé sur VS Code, qui prend aussi en charge les modèles locaux via des points de terminaison compatibles OpenAI ; une bonne comparaison si vous préférez un agent intégré à l'IDE plutôt qu'un workflow centré sur le terminal. Voir l'avis Cline.
Erreurs fréquentes lors de l'évaluation de claude-code-local
La plupart des confusions autour de ce projet viennent de son nom, qui laisse croire à une offre officielle d'Anthropic, ou de l'hypothèse que toute version serait automatiquement entièrement hors ligne.
Erreur 1 : croire qu'il s'agit d'un produit Anthropic, ou qu'il fait fonctionner Claude hors ligne
claude-code-local est un projet non officiel, tiers, construit par la communauté. Il n'est pas réalisé par Anthropic, n'est pas officiellement affilié à Anthropic ni approuvé par Anthropic, et ne fait pas fonctionner le véritable modèle Claude d'Anthropic hors ligne. Il détourne le client/CLI Claude Code d'Anthropic pour dialoguer avec un modèle ouvert différent, hébergé localement, via une couche de compatibilité API.
Erreur 2 : supposer que toute version est entièrement hors ligne par défaut
Avant la version v0.1.0 du projet (mai 2026), on a constaté que Claude Code lui-même continuait de contacter api.anthropic.com pour la télémétrie et d'autres trafics en arrière-plan, même avec une URL de base locale configurée. Si un comportement air-gapped et entièrement hors ligne compte pour votre usage, assurez-vous d'utiliser la v0.1.0 ou une version ultérieure, et vérifiez vous-même avec lsof plutôt que de le supposer.
Erreur 3 : considérer les chiffres de benchmark auto-déclarés comme vérifiés de manière indépendante
Le README du projet et son classement compagnon Agent-12 rapportent des chiffres précis de vitesse et de précision pour divers modèles. Ce sont les propres mesures du développeur, sur son propre banc de test — utiles comme point de départ, mais non vérifiées de manière indépendante par PromptQuorum ni par un tiers neutre. Testez sur votre propre matériel et vos propres tâches avant de vous fier à un chiffre précis.
Erreur 4 : confondre le dépôt d'origine avec son fork à zéro étoile
Un dépôt nommé jinzaizhichi/claude-code-local existe sur GitHub en tant que fork avec zéro étoile. Le projet d'origine, activement maintenu, avec le nombre d'étoiles et les versions référencés dans cet avis, est github.com/nicedreamzapp/claude-code-local.
Questions fréquentes
Qu'est-ce que claude-code-local ?
claude-code-local (github.com/nicedreamzapp/claude-code-local) est un serveur MLX gratuit, open source et non officiel pour Mac Apple Silicon, qui permet à la CLI Claude Code d'Anthropic de se connecter à un modèle ouvert exécuté localement, à la place de l'API cloud d'Anthropic.
claude-code-local est-il réalisé par Anthropic ?
Non. Il s'agit d'un projet indépendant, tiers, construit par la communauté. Il n'est pas réalisé par Anthropic et n'est en aucune façon officiellement affilié à Anthropic ni approuvé par Anthropic.
claude-code-local fait-il fonctionner le véritable modèle Claude d'Anthropic hors ligne ?
Non. Il ne télécharge, n'héberge ni n'exécute en aucune façon le modèle Claude d'Anthropic. Il fait fonctionner un modèle ouvert différent, hébergé localement (comme Gemma, Qwen, Llama ou DeepSeek), et le fait répondre via un serveur qui reproduit le même format d'API attendu par le client Claude Code.
claude-code-local est-il gratuit ?
Oui. Il est open source sous licence MIT, sans offre payante. La CLI gratuite Claude Code d'Anthropic reste nécessaire comme dépendance, mais le projet lui-même ne facture rien.
Quel matériel claude-code-local nécessite-t-il ?
Un Mac Apple Silicon (M1 ou plus récent) et Python 3.12, car le projet exécute l'inférence locale via le framework MLX d'Apple. Il n'existe aucun support Windows, Linux ou Mac Intel. Il fonctionne sur un Mac de 16 Go, selon les propres tests du projet, les Mac à plus grande mémoire unifiée pouvant exécuter des modèles plus grands et plus performants.
claude-code-local garde-t-il mon code entièrement hors ligne ?
Oui, mais seulement à partir de la v0.1.0. Un bug antérieur faisait que Claude Code lui-même contactait les serveurs d'Anthropic pour la télémétrie et des tâches en arrière-plan, même avec une URL de base locale configurée ; la v0.1.0 (mai 2026) a corrigé cela en désactivant ce trafic. Vérifiez votre propre configuration avec lsof -p $(pgrep -f claude) plutôt que de le supposer.
Comment installer claude-code-local ?
L'installateur en une commande documenté est curl -fsSL https://raw.githubusercontent.com/nicedreamzapp/claude-code-local/main/install.sh | bash. Une alternative manuelle — cloner le dépôt et exécuter bash setup.sh après l'avoir lu — est aussi documentée pour ceux qui préfèrent ne pas transmettre directement un script distant à bash.
Quels modèles claude-code-local peut-il exécuter ?
Le projet documente plusieurs modèles ouverts dimensionnés selon la mémoire unifiée de votre Mac, de Hermes 4 14B (16 Go) jusqu'à Qwen 3.5 122B (96 Go et plus), ainsi que d'autres options comme Gemma 4, Llama 3.3 70B et une version Qwen 3.8 27B en pleine précision. Le choix et la qualité du modèle varient selon celui choisi et votre matériel.
Qui développe claude-code-local ?
Le projet est développé et maintenu par un seul développeur indépendant, Matt Macosko, basé à Arcata, en Californie. Le propre README du projet l'indique explicitement : « one person, no team, no investors ».
Quand claude-code-local a-t-il été publié pour la première fois ?
Le dépôt GitHub a été créé le 26 mars 2026. Le premier tag de version formel, v0.1.0, a suivi le 8 mai 2026, avec la v0.2.0 (5 août 2026) et la v0.3.0 (22 août 2026) depuis — consultez la page officielle des Releases pour tout ce qui a été publié depuis la date de publication de cet avis.