# L'API de Claude : console, prix, effort et cache

> Ouvrir un compte sur la Console, faire un premier appel à l'API de Claude, choisir modèle et effort, et réduire la facture avec le cache et les lots.

- Niveau : Expert
- Thème : Les outils expliqués
- Durée : 15 minutes
- Systèmes : Mac, Windows, Linux
- Disponible en France : La France figure parmi les pays où la plateforme Claude est ouverte ; les prix sont facturés en dollars. (https://www.anthropic.com/supported-countries, lue le 17 novembre 2026)
- Publié le 17 novembre 2026, relu le 17 novembre 2026
- Auteur : Ulrich Rozier
- Page : https://quelleia.com/guides/claude-api/

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

![Ce qui part dans une requête à l'API Messages et ce qui revient, d'après la documentation de la plateforme Claude lue le 17 novembre 2026.](https://quelleia.com/guides/claude-api/un-appel-a-l-api.svg)

*Ce qui part dans une requête à l'API Messages et ce qui revient, d'après la documentation de la plateforme Claude lue le 17 novembre 2026.*

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

![Page Pricing de la documentation : tableau Model pricing avec, pour Fable 5.2, Opus 5.5, Sonnet 5.5 et Haiku 5.5, le prix de l'entrée, de la sortie, des écritures de cache à 5 minutes et 1 heure, et des lectures de cache.](https://quelleia.com/guides/claude-api/tarifs-api.webp)

*Le tableau des prix de la plateforme Claude, en dollars par million de jetons, avec les colonnes du cache (capture du 17 novembre 2026, platform.claude.com).*

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

1. **Créez un compte** sur la Console (platform.claude.com) et ajoutez des crédits.
2. **Authentifiez-vous.** La documentation conseille l'outil en ligne de commande `ant` pour le développement local, ou une clé d'API créée dans la Console :

```bash
brew install anthropics/tap/ant
ant auth login
```

3. **Installez le SDK Python** dans un environnement neuf :

```bash
mkdir claude-quickstart && cd claude-quickstart
python3 -m venv .venv && source .venv/bin/activate
pip install anthropic
```

4. **Écrivez la requête** dans `quickstart.py` :

```python
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)
```

5. **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 : `medium` sur Opus 5.5 et Haiku 5.5, `high` sur les autres modèles.
- `xhigh` vise les tâches d'agent ou de code de plus de 30 minutes ; `max` sert 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.

1. **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.
2. **Plus précis** : placer `cache_control` sur des blocs choisis.
3. **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.
4. **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**

TypeScript, nouveau projet (Node.js 18+) :

```bash
npm init -y
npm pkg set type=module
npm install @anthropic-ai/claude-agent-sdk
npm install --save-dev tsx
```

TypeScript, projet existant :

```bash
npm install @anthropic-ai/claude-agent-sdk
npm install --save-dev tsx
```

Python avec uv (Python 3.10+) :

```bash
uv init
uv add claude-agent-sdk
```

Python avec pip, macOS ou Linux :

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install claude-agent-sdk
```

Python avec pip, Windows :

```bash
py -m venv .venv
.venv\Scripts\Activate.ps1
pip install claude-agent-sdk
```

macOS, Linux (clé d'API) :

```bash
export ANTHROPIC_API_KEY=your-api-key
```

Windows (PowerShell, clé d'API) :

```bash
$env:ANTHROPIC_API_KEY = "your-api-key"
```

D'après https://code.claude.com/docs/en/agent-sdk/quickstart (lue le 3 octobre 2026).

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_tokens` et 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

- [Claude Agent SDK](https://quelleia.com/outils/claude-agent-sdk/)
- [Claude opus 5 5](https://quelleia.com/modeles/claude-opus-5-5/)
- [Claude haiku 5 5](https://quelleia.com/modeles/claude-haiku-5-5/)
- [Meilleur rapport qualité-prix](https://quelleia.com/classement/qualite-prix/)
- [Anthropic](https://quelleia.com/editeurs/anthropic/)
- [Jetons, prix au million et vrai coût d'une tâche](https://quelleia.com/guides/jetons-et-prix.md) (guide, amateur)
- [Modèle de réflexion : penser avant de répondre](https://quelleia.com/guides/modele-de-reflexion.md) (guide, débutant)
- [Haiku, Sonnet, Opus ou Fable : quel modèle Claude choisir](https://quelleia.com/guides/claude-quel-modele.md) (guide, amateur)
- [Fenêtre de contexte : ce que veut dire « 1 million de jetons »](https://quelleia.com/guides/fenetre-de-contexte.md) (guide, débutant)

## Sources

- https://platform.claude.com/docs/en/get-started (lue le 17 novembre 2026)
- https://platform.claude.com/docs/en/about-claude/pricing (lue le 17 novembre 2026)
- https://platform.claude.com/docs/en/about-claude/models/overview (lue le 17 novembre 2026)
- https://platform.claude.com/docs/en/build-with-claude/effort (lue le 17 novembre 2026)
- https://platform.claude.com/docs/en/build-with-claude/prompt-caching (lue le 17 novembre 2026)
- https://platform.claude.com/docs/en/about-claude/models/choosing-a-model (lue le 17 novembre 2026)
- https://support.claude.com/en/articles/8664678-change-the-model-effort-and-thinking-settings (lue le 17 novembre 2026)
- https://support.claude.com/en/articles/17154008-monthly-api-credits-for-max-and-team-plans (lue le 17 novembre 2026)
- https://www.anthropic.com/claude-haiku-5-5 (lue le 17 novembre 2026)
- https://www.anthropic.com/supported-countries (lue le 17 novembre 2026)
