La plateforme Claude donne accès aux modèles Claude depuis vos propres programmes. On y paie au jeton, en dollars, indépendamment de tout abonnement à l’appli. Ce guide suit la documentation officielle lue le 17 novembre 2026 : premier appel, prix, effort de réflexion, cache et traitement par lots.
Comment ça marche
Votre programme envoie une requête à l’API Messages : le modèle (claude-opus-5-5, par exemple), la conversation, la longueur maximale de la réponse (max_tokens) et, au besoin, l’effort et des marqueurs de cache. La réponse revient avec le texte et le décompte des jetons consommés, que la facture multiplie par le tarif du modèle. Des SDK officiels existent pour Python, TypeScript, C#, Go, Java, PHP et Ruby.
Les modèles actuels ont tous une fenêtre de contexte d’un million de jetons et 128 000 jetons de sortie au plus. Leur réflexion est « adaptative » : le modèle décide quand et combien réfléchir, et l’effort règle cette profondeur. Sur Fable 5.2 et Opus 5.5, la réflexion est toujours allumée ; une requête qui la coupe ou fixe un budget de réflexion (budget_tokens) renvoie une erreur.
Les prix
D’après la page des prix de la documentation, en dollars par million de jetons (MTok) :
| Modèle | Entrée | Sortie | Écriture cache 5 min | Écriture cache 1 h | Lecture cache |
|---|---|---|---|---|---|
| Claude Fable 5.2 | 8 $ | 40 $ | 10 $ | 16 $ | 0,20 $ |
| Claude Opus 5.5 | 4 $ | 20 $ | 5 $ | 8 $ | 0,20 $ |
| Claude Sonnet 5.5 | 2 $ | 10 $ | 2,50 $ | 4 $ | 0,10 $ |
| Claude Haiku 5.5 (requête jusqu’à 100 000 jetons) | 0,10 $ | 0,50 $ | 0,125 $ | 0,20 $ | 0,01 $ |
| Claude Haiku 5.5 (au-delà de 100 000 jetons) | 0,50 $ | 2,50 $ | 0,625 $ | 1 $ | 0,05 $ |

Les autres règles de la même page :
- Le traitement par lots (Batch API) divise par deux l’entrée et la sortie, pour des requêtes traitées de façon asynchrone.
- Le contexte long ne coûte pas plus cher par jeton, sauf sur Haiku 5.5, qui change de tarif au-delà de 100 000 jetons de prompt (cache compris).
- Le mode rapide (« fast mode ») donne jusqu’à 2,5 fois plus de jetons par seconde en sortie, à prix majoré : 16 $ et 80 $ par million pour Fable 5.2. Il ne se combine pas avec les lots.
- L’inférence aux États-Unis seulement (
inference_geo: "us") multiplie tous les prix par 1,1 ; le routage mondial, par défaut, garde le tarif normal. - La recherche web coûte 10 $ les 1 000 recherches, auxquels s’ajoutent les jetons des résultats.
Les abonnés Max, Ultra et Team reçoivent des crédits d’API chaque mois (100 $ pour Max, 200 $ pour Ultra), à réclamer en reliant une organisation de la Console dans « Settings », « Billing ». Pro et la formule gratuite n’y ont pas droit.
Faire un premier appel pas à pas
- Créez un compte sur la Console (platform.claude.com) et ajoutez des crédits.
- Authentifiez-vous. La documentation conseille l’outil en ligne de commande
antpour le développement local, ou une clé d’API créée dans la Console :
brew install anthropics/tap/ant
ant auth login
- Installez le SDK Python dans un environnement neuf :
mkdir claude-quickstart && cd claude-quickstart
python3 -m venv .venv && source .venv/bin/activate
pip install anthropic
- Écrivez la requête dans
quickstart.py:
import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
model="claude-opus-5-5",
max_tokens=1000,
messages=[{"role": "user", "content": "Résume en trois points les avantages d'une pompe à chaleur."}],
)
for block in message.content:
if block.type == "text":
print(block.text)
- Lancez-la avec
python quickstart.py, puis regardez l’usage dans la Console.
Régler l’effort
Le paramètre output_config.effort arbitre entre qualité, vitesse et coût, sur cinq niveaux : low, medium, high, xhigh et max. Il agit sur tous les jetons de la réponse, réflexion et appels d’outils compris : un effort bas donne des réponses plus directes et moins d’appels d’outils.
- Par défaut :
mediumsur Opus 5.5 et Haiku 5.5,highsur les autres modèles. xhighvise les tâches d’agent ou de code de plus de 30 minutes ;maxsert surtout à mesurer le plafond du modèle.- La documentation conseille de mesurer plusieurs niveaux sur vos propres tests plutôt que de reprendre les réglages d’un ancien modèle. Changer d’effort entre deux requêtes peut invalider le cache ; sur Fable 5.2, un changement par message le préserve.
Dans l’appli Claude, le même réglage se trouve en cliquant sur le nom du modèle à côté du bouton d’envoi, puis sur « Effort ».
Payer moins avec le cache
Le cache garde le début d’une requête (outils, consignes système, messages) pour les appels suivants. Une lecture du cache coûte bien moins que l’entrée normale (0,20 $ au lieu de 4 $ par million de jetons sur Opus 5.5) ; l’écriture coûte un peu plus cher que l’entrée.
- Le plus simple : un seul champ
cache_control={"type": "ephemeral"}au niveau de la requête, et l’API place elle-même le point de cache au bout de la partie réutilisable, en le déplaçant à mesure que la conversation grandit. - Plus précis : placer
cache_controlsur des blocs choisis. - La durée : cinq minutes par défaut, prolongées gratuitement à chaque réutilisation ; une heure en option, avec une écriture plus chère. Le compte part du début de la requête, temps de réponse compris.
- Le gain : mettez en tête ce qui ne change pas (consignes, documents de référence, définitions d’outils) et en fin ce qui change.
Installer Claude Agent SDK
npm · nouveau projet · TypeScript, nouveau projet (Node.js 18+)
npm init -ynpm pkg set type=modulenpm install @anthropic-ai/claude-agent-sdknpm install --save-dev tsxnpm · projet existant · TypeScript, projet existant
npm install @anthropic-ai/claude-agent-sdknpm install --save-dev tsxuv · Python avec uv (Python 3.10+)
uv inituv add claude-agent-sdkpip · macOS · Python avec pip, macOS ou Linux
python3 -m venv .venvsource .venv/bin/activatepip install claude-agent-sdkpip · Windows · Python avec pip, Windows
py -m venv .venv.venv\Scripts\Activate.ps1pip install claude-agent-sdkmacOS · macOS, Linux (clé d'API)
export ANTHROPIC_API_KEY=your-api-keyWindows · Windows (PowerShell, clé d'API)
$env:ANTHROPIC_API_KEY = "your-api-key"D'après code.claude.com, lue le 3 octobre 2026.La fiche de Claude Agent SDK →
Pour un agent complet (outils, fichiers, sous-agents), le SDK Claude Agent reprend la mécanique de Claude Code dans vos programmes.
Disponible en France ?
Oui. La France figure dans la liste des régions ouvertes par Anthropic, dont les services sont fournis dans l’Union européenne par Anthropic Ireland. Les prix sont en dollars.
Limites et précautions
- Une clé d’API vaut de l’argent. Ne la mettez jamais dans un dépôt de code ni dans une appli publiée ; préférez une variable d’environnement et une date d’expiration.
- La sortie coûte cinq fois l’entrée sur les modèles actuels : limitez
max_tokenset la longueur demandée. - L’effort élevé allonge la facture. Il augmente le nombre de jetons produits, réflexion comprise.
- Les données des requêtes suivent les conditions commerciales d’Anthropic, différentes de celles de l’appli grand public.
Pour aller plus loin
- Jetons, prix au million et vrai coût d'une tâcheNiveau Amateur 5 min
- Modèle de réflexion : penser avant de répondreNiveau Débutant 2 min
- Haiku, Sonnet, Opus ou Fable : quel modèle Claude choisirNiveau Amateur 8 min
- Fenêtre de contexte : ce que veut dire « 1 million de jetons »Niveau Débutant 2 min
- Adobe Firefly : le studio d'IA d'Adobe et ses modèles partenairesNiveau Débutant 10 min
- Anthropic et Claude : les produits, les modèles et les formulesNiveau Débutant 12 min
- Bien démarrer avec ChatGPT sur le web, l'ordinateur et le mobileNiveau Débutant 12 min
Pour monter son atelier d'IA à la maison, mini lab AI, du même auteur, va plus loin.
Sources
- Claude Platform Docs, Get started with Claude, lue le
- Claude Platform Docs, Pricing, lue le
- Claude Platform Docs, Models overview, lue le
- Claude Platform Docs, Effort, lue le
- Claude Platform Docs, Prompt caching, lue le
- Claude Platform Docs, Choosing the right model, lue le
- Claude Help Center, Change the model, effort, and thinking settings, lue le
- Claude Help Center, Monthly API credits for Max and Team plans, lue le
- Anthropic, Introducing Claude Haiku 5.5, lue le
- Anthropic, Supported Regions Policy, lue le
