Installation et configuration de Claude Code pour Ollama et llama.cpp, tarifs

Le codage agentique, désormais avec des backends de modèles locaux.

Sommaire

Claude Code n’est pas un outil d’autocomplétion doté d’un meilleur marketing. C’est un outil de codage agentique : il lit votre base de code, modifie des fichiers, exécute des commandes et s’intègre à vos outils de développement.

Cette différence compte, car l’unité de travail cesse d’être « une ligne de code » pour devenir « une tâche avec un état final ».

Anthropic pose clairement la distinction : l’achèvement de code suggère la ligne suivante au fur et à mesure que vous tapez, tandis que Claude Code opère au niveau du projet, planifie sur plusieurs fichiers, exécute des modifications, lance des tests et itère sur les échecs. En pratique, cela le rapproche davantage d’un développeur junior natif du terminal capable d’accomplir des tâches courantes rapidement, mais qui a toujours besoin d’une revue.

Cette tension entre vitesse et supervision constitue une grande partie de ce que les gens regroupent sous le terme de « vibe coding » ; Qu’est-ce que la Vibe Coding ? démêle ce terme, ses origines, ainsi que la réalité de l’efficacité et des risques.

laptop-homeresver-claude-code-coffee-books

Un détail qu’il est facile de rater quand on survole la documentation : le Terminal CLI (et l’interface VS Code) peut être configuré pour utiliser des fournisseurs tiers. C’est là qu’interviennent Ollama et llama.cpp.

Une fois que Claude Code est pointé vers un point d’accès HTTP local, les compromis liés au runtime, au matériel et à l’hébergement se situent en dehors du client ; cette comparaison de l’hébergement de LLM en 2026 aligne Ollama, les piles d’inférence dédiées et les options cloud en un seul endroit.

Pour voir comment Claude Code se positionne par rapport aux autres flux de travail de codage et de livraison assistés par IA, ce guide des outils de développement IA regroupe les assistants de type Copilot, l’automatisation et les schémas d’éditeur.

Pour un examen outil par outil des assistants de codage dans la même catégorie, Comparaison des assistants de codage IA passe en revue Cursor, Copilot, Cline et le reste à un niveau plus élevé que ce guide d’installation.

Installation de Claude Code et démarrage rapide

Options d’installation et leurs implications

Il existe plusieurs chemins d’installation, et ils ne sont pas égaux :

Les scripts d’installation natifs sont l’option « toujours à jour » car ils se mettent à jour automatiquement.
Homebrew et WinGet sont l’option « changement contrôlé » car vous effectuez la mise à niveau explicitement.

Commandes d’installation (démarrage rapide officiel) :

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

:: Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Ensuite, démarrez une session interactive depuis un dossier de projet :

cd /path/to/your/project
claude

Connexion et types de comptes

Claude Code a besoin d’un compte pour fonctionner en mode de premier partenaire. Le flux de démarrage rapide prend en charge les connexions via un abonnement Claude (Pro, Max, Team, Enterprise), un compte Console (crédits API) ou des fournisseurs cloud pris en charge. Une note opérationnelle utile : à la première connexion à la Console, un espace de travail « Claude Code » est créé pour un suivi des coûts centralisé.

Configuration de Claude Code : settings.json et variables d’environnement

Si Claude Code semble magique quand il fonctionne, il a souvent l’air « mystérieux » quand cela ne fonctionne pas. Le remède est de comprendre sa superposition de configuration et les quelques variables d’environnement qui comptent vraiment.

Fichiers de configuration et priorité

Les configurations de Claude Code sont hiérarchiques, avec trois fichiers destinés aux développeurs :

Portée utilisateur, s’applique partout : ~/.claude/settings.json
Portée projet, partagée dans un dépôt : .claude/settings.json
Portée locale, remplacements par machine : .claude/settings.local.json (ignoré par git)

La priorité est (de la plus haute à la plus basse) : politique gérée, drapeaux CLI, local, projet, utilisateur. Cet ordre explique plusieurs moments de « pourquoi ma configuration est-elle ignorée ».

Une installation de Hindsight pour Claude Code fusionne trois hooks dans le ~/.claude/settings.json utilisateur, enregistre MCP à la portée utilisateur et ajoute la compétence ~/.claude/skills/hindsight-coding-agent. Mémoire Hindsight pour OpenCode, Cursor et autres agents de codage couvre ce plugin, y compris le branchement des CLI OpenCode et Cursor.

Vous pouvez gérer les configurations de manière interactive via la commande /config, qui ouvre une interface de configuration dans le REPL.

Variables d’environnement qui contrôlent le routage des fournisseurs

Claude Code peut être orienté à l’exécution par des variables d’environnement. Deux bizarreries de comportement méritent d’être traitées comme des contraintes de conception :

Si ANTHROPIC_API_KEY est définie, Claude Code utilisera la clé au lieu d’un abonnement Claude même si vous êtes connecté. En mode impression (-p), la clé est toujours utilisée lorsqu’elle est présente.
Si ANTHROPIC_BASE_URL pointe vers un hôte non de premier partenaire (un proxy, une passerelle ou un serveur local), certaines fonctionnalités sont intentionnellement conservatrices. Par exemple, la recherche d’outils MCP est désactivée par défaut à moins que vous ne la réactiviez explicitement.

Pour la limite d’abonnement spécifique désormais appliquée dans les piles d’agents tiers, cette mise à jour de politique Claude pour les flux de travail OpenClaw explique pourquoi l’utilisation basée sur l’API est requise.

Un motif minimaliste d’« utilisation d’une passerelle » ressemble à ceci :

export ANTHROPIC_BASE_URL=https://your-gateway.example
export ANTHROPIC_API_KEY=sk-your-key

Note passerelle : Claude Code s’attend à certains formats d’API. Pour le format de messages Anthropic, la passerelle doit exposer /v1/messages et /v1/messages/count_tokens et doit transmettre les en-têtes anthropic-beta et anthropic-version. Si une passerelle rejette ces en-têtes, il y a un réglage dédié pour supprimer les bêta expérimentaux.

Sélection de modèle dans Claude Code lorsque vous n’utilisez pas Anthropic directement

Claude Code a un concept d’alias (opus, sonnet, haiku) et prend également en charge l’épinglage d’identifiants de modèles spécifiques. Il existe également une liste blanche qui peut restreindre ce que les utilisateurs peuvent sélectionner dans le sélecteur de modèles, même lorsqu’ils sont routés via des fournisseurs tiers.

Un motif pragmatique consiste à définir un modèle initial et à restreindre le sélecteur, puis à épingler ce que « default » résout via la variable d’environnement :

{
  "model": "claude-sonnet-4-5",
  "availableModels": ["claude-sonnet-4-5", "haiku"],
  "env": {
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-5"
  }
}

Exécution de LLM auto-hébergés via Ollama

Ollama est actuellement le moyen le plus simple de faire fonctionner Claude Code sur des modèles non-Anthropic, car il expose une API compatible Anthropic pour que Claude Code puisse communiquer avec elle.

Configuration rapide avec ollama launch

Si vous avez Ollama installé et en cours d’exécution, le chemin rapide est :

ollama launch claude

Ou spécifiez un modèle au démarrage :

ollama launch claude --model glm-4.7-flash

Configuration manuelle avec des variables d’environnement explicites

L’intégration Ollama documente un câblage manuel simple où Claude Code parle à Ollama via le point d’accès d’API compatible Anthropic :

export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434

claude --model qwen3.5

Ce motif est dogmatique d’une manière utile : il traite le « routage du fournisseur » comme une préoccupation d’environnement, et non comme quelque chose à cliquer dans une interface graphique.

Vérification de la réalité de la fenêtre de contexte

Le codage agentique est gourmand en contexte. Ollama le souligne sans détour : Claude Code nécessite une grande fenêtre de contexte et recommande au moins 64k jetons. Si votre modèle local plafonne à 8k ou 16k, Claude Code fonctionnera toujours, mais la promesse « au niveau du projet » devient fragile.

Pour un comportement pratique de modèles locaux dans une configuration d’agent terminal similaire (Ollama et llama.cpp, tâches de codage et notes d’échec honnêtes), Meilleurs LLM pour OpenCode - Testés localement est une contre-vérification utile lorsque vous faites une liste de tags GGUF ou Ollama pour Claude Code.

Exécution de LLM auto-hébergés via llama.cpp

llama.cpp est attrayant pour la raison opposée : il ne tente pas d’être une plateforme. C’est un serveur rapide et léger qui peut exposer à la fois des routes compatibles OpenAI et une route compatible avec l’API de messages Anthropic.

Pour les chemins d’installation, llama-cli et le comportement de llama-server au-delà des extraits ci-dessous, Démarrage rapide de llama.cpp avec CLI et Serveur est la référence de bout en bout.

Ce qu’exécuter côté serveur

Le serveur HTTP de llama.cpp (llama-server) prend en charge une API de messages compatible Anthropic sur POST /v1/messages, avec un streaming via SSE. Il offre également count_tokens sur /v1/messages/count_tokens.

Deux détails comptent pour Claude Code :

Le serveur n’affirme pas explicitement de fortes prétentions de compatibilité complète avec la spécification de l’API Anthropic, mais indique qu’il fonctionne suffisamment bien pour de nombreuses applications.
L’utilisation d’outils nécessite de démarrer llama-server avec le drapeau –jinja. Si vous manquez cela, Claude Code se comportera comme s’il avait soudainement oublié comment être un agent.

Une exécution locale minimale ressemble à :

# Construire ou télécharger llama-server, puis exécuter avec un modèle GGUF
./llama-server -m /models/your-model.gguf --jinja --host 127.0.0.1 --port 8080

Si vous voulez une limite d’authentification stricte, llama-server peut être configuré avec une clé API :

./llama-server -m /models/your-model.gguf --jinja --api-key my-local-key --host 127.0.0.1 --port 8080

Pointer Claude Code vers llama-server

Avec le serveur en cours d’exécution, votre côté Claude Code est principalement une modification de l’URL de base :

export ANTHROPIC_BASE_URL=http://127.0.0.1:8080
export ANTHROPIC_API_KEY=my-local-key   # seulement si vous avez activé --api-key sur llama-server

claude --model your-model-alias

Si vous ne définissez pas de clé API ou de jeton d’authentification, Claude Code peut essayer de revenir en arrière vers la connexion par abonnement, ce qui est la source de nombreuses plaintes de « pourquoi cela ouvre-t-il un navigateur ».

Vérifications d’état et diagnostic initial des pannes

llama-server expose un point de contrôle d’état simple qui retourne « loading model » tant que le modèle n’est pas prêt, et « ok » lorsqu’il est utilisable. Lorsque Claude Code semble rester en attente sur la première demande, vérifier /health est un moyen rapide de distinguer un « bug de configuration client » d’un « serveur encore en train de charger ».

Tarification et modèle de coûts

La tarification de Claude Code porte moins sur « l’achat d’une CLI » que sur « quelle voie de facturation soutient les jetons ».

Les plans d’abonnement incluent Claude Code

Anthropic inclut Claude Code dans les niveaux d’abonnement payants Claude. En avril 2026, la tarification publiée liste :

Pro à 17 $ par mois avec une remise annuelle (200 $ facturés d’avance), ou 20 $ facturés mensuellement, et inclut Claude Code.
Plans Max à partir de 100 $ par mois.
Plans Team facturés par siège, avec un siège standard à 20 $ par siège par mois facturé annuellement (25 $ mensuellement) et un siège premium à 100 $ par siège par mois facturé annuellement (125 $ mensuellement).

Tarification des jetons API

Si vous utilisez Claude Code via la facturation API, les coûts suivent les taux par jeton. Anthropic publie des prix par million de jetons (MTok) pour des modèles tels que :

Haiku 4.5 à 1 $/MTok entrée et 5 $/MTok sortie.
Sonnet 4.5 à 3 $/MTok entrée et 15 $/MTok sortie.
Opus 4.5 à 5 $/MTok entrée et 25 $/MTok sortie.

Contrôles de coûts dans la CLI

Le mode impression (-p) prend en charge des plafonds de budget directs comme –max-budget-usd, ce qui est pratique lorsque vous scriptez des tâches et souhaitez des dépenses prévisibles.

À l’intérieur des sessions interactives, /cost affiche les statistiques d’utilisation des jetons.

Les backends locaux changent la facture, pas la physique

Routage Claude Code vers Ollama ou llama.cpp peut supprimer les factures API par jeton, mais cela ne rend pas le travail gratuit. Vous échangez les coûts du cloud contre du calcul local, de la mémoire et « quelqu’un qui détient la disponibilité ». Pour certaines équipes, ce compromis est le but même.

Flux de travail typique : du plan au PR

Mon biais est que Claude Code est le plus fort lorsque vous le traitez comme un moteur de flux de travail, et non comme un chatbot. Les indices de l’outillage le suggèrent.

Commencez par le modèle de permissions, pas par le prompt

Claude Code est contrôlé par permissions par conception. La documentation décrit un modèle par niveaux : les opérations en lecture seule telles que la lecture de fichiers et grep sont autorisées, tandis que les commandes bash et les modifications de fichiers nécessitent une approbation.

Les modes de permissions existent pour gérer la friction. Dans la CLI, vous pouvez alterner les modes avec Shift+Tab (défaut -> acceptEdits -> plan). Le mode plan lit et propose des modifications mais n’édite pas. Le mode acceptEdits permet à Claude Code de créer et de modifier des fichiers dans votre répertoire de travail sans demande, tout en demandant toujours pour les commandes avec des effets secondaires en dehors de sa liste sûre.

Le mode auto est une option plus récente qui réduit les demandes en déléguant les approbations à un classifieur, positionné comme une voie médiane plus sûre entre les demandes constantes et la désactivation complète des demandes. Il nécessite une version minimale de Claude Code et des exigences spécifiques de plan et de modèle.

Utilisez les commandes intégrées pour garder les sessions honnêtes

Quelques commandes transforment Claude Code de « assistant » en « outillage » :

/init génère un guide de projet CLAUDE.md, qui est un moyen léger d’alimenter un contexte cohérent. Pour des jeux de manœuvres réutilisables et des flux de travail répétables qui se situent au-dessus de CLAUDE.md, Compétences Claude pour les développeurs couvre la disposition de SKILL.md, la compatibilité IDE, le réglage des déclencheurs et les tests. Pour comparer les compétences SDD de Claude Code avec GitHub Spec Kit et Kiro, voir GitHub Spec Kit vs Kiro vs Flux de travail SDD Claude Code. Si vous préférez installer une version prête à l’emploi et appliquée de cette pile de compétences, voir Démarrage rapide Superpowers.
/diff donne une vue interactive des modifications, y compris des diff par tour.
/rewind vous permet de faire revenir la conversation et/ou le code à un point antérieur, en utilisant des points de contrôle.
/debug active la journalisation du débogage en cours de session.
/doctor diagnostique et vérifie votre installation et vos paramètres.

Ce ne sont pas des gadgets ; ce sont les garde-fous sur lesquels vous vous appuyez lorsque qu’un agent modifie plus que prévu.

Pour un travail bruyant et délégable — exploration de la base de code, exécution automatisée de tests, revues de sécurité ou de style — associez ces commandes aux sous-agents Claude Code, qui pousse ce travail dans une fenêtre de contexte isolée au lieu de gonfler votre session principale.

Quand passer en mode non interactif

Pour les tâches ponctuelles (expliquer, résumer, générer un plan de correctif), le mode impression est un bon choix :

claude -p "Summarise the repository architecture and list the riskiest modules"

Il quitte après la réponse, ce qui fonctionne bien dans les scripts et la CI.

Liste de contrôle de dépannage

La plupart des problèmes de Claude Code sont des problèmes de configuration déguisés. Voici une liste de contrôle qui mappe les symptômes courants au mécanisme sous-jacent.

Claude Code continue de demander de se connecter en utilisant un serveur local

Cela signifie généralement que Claude Code essaie toujours d’utiliser l’authentification d’abonnement de premier partenaire. Assurez-vous de définir un mode d’authentification explicite pour le proxy :

Définissez ANTHROPIC_API_KEY pour les passerelles qui s’attendent à X-Api-Key.
Ou définissez ANTHROPIC_AUTH_TOKEN pour les passerelles qui utilisent Authorization Bearer.

Rappelez-vous que ANTHROPIC_API_KEY remplace l’utilisation de l’abonnement même si vous êtes connecté, et en mode interactif, vous pouvez avoir besoin d’approuver ce remplacement une fois.

La passerelle fait une erreur sur les en-têtes anthropic-beta

Certaines passerelles rejettent les en-têtes inconnus ou les champs bêta. Il existe une variable d’environnement conçue pour ce mode d’échec exact :

export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

La documentation de la passerelle LLM note également que vous pouvez en avoir besoin lors de l’utilisation du format de messages Anthropic avec Bedrock ou Vertex.

L’appel d’outils ne fonctionne pas sur llama.cpp

Revérifiez les drapeaux du serveur. llama-server documente que l’utilisation d’outils nécessite le drapeau –jinja. Sans cela, le serveur peut répondre, mais la boucle de l’agent se dégradera.

Les demandes de permission interrompent chaque commande

Cela peut être normal, selon le mode et les règles de permissions. Les options incluent :

Passer temporairement à acceptEdits (les modifications de fichiers fluissent plus vite).
Écrire des règles d’autorisation explicites pour des commandes bash connues sûres dans settings.json.
Utiliser /sandbox pour isoler l’outil bash tout en réduisant les demandes.
Évaluer le mode auto si votre plan et votre version le supportent, comme compromis.

Quelque chose semble ne pas aller et vous avez besoin d’observabilité

Utilisez les intégrés :

/doctor pour valider l’installation et les paramètres.
/debug pour commencer à capturer les journaux à partir de ce point.
Si vous êtes en mode impression, envisagez un budget maximal serré et un nombre maximal de tours pour garder les expériences limitées.

La position de Claude Code en tant qu’outil de premier partenaire protégé d’Anthropic est devenue stratégiquement significative en avril 2026, lorsque Anthropic a bloqué l’accès aux abonnements Claude pour les frameworks d’agents tiers tout en maintenant Claude Code sur la facturation par abonnement. La chronologie de la montée et de la chute d’OpenClaw couvre cet événement et ce qu’il révèle sur l’approche d’Anthropic en matière d’outillage de premier partenaire versus tiers.