Anthropic Python SDK 1.0 : migration manuelle ou Claude Code

Faire passer un projet Python d’anthropic 0.x à 1.0 tient en une commande d’installation, pip install --upgrade "anthropic>=1,<2", suivie d’un passage sur une liste fixe de changements incompatibles : la couche HTTP tourne désormais sur httpx2, les lecteurs asynchrones de .with_raw_response sont devenus des coroutines, les Text Completions et les paramètres temperature/top_p/top_k ont disparu, et AnthropicBedrock refuse de se construire sans région.¹ Parcourez cette liste à la main avec le guide de migration officiel, ou laissez Claude Code faire les modifications avec /claude-api upgrade python et relisez le diff.¹³ La note de version de Claude Code l’appelle /claude-api upgrade ; le guide de migration ajoute l’argument python, et c’est cette forme qu’il faut taper.¹³ Les deux routes mènent au même endroit – la page ci-dessous couvre chacune d’elles, à jour pour anthropic 1.0.0 (publié sur PyPI le 20 août 2026 ; vérifié le 25 août).² {.answer-block}

TL;DR

• Mettez à jour avec pip install --upgrade "anthropic>=1,<2", puis lancez pyright ou mypy : le guide de migration précise qu’un vérificateur de types signale presque tous les changements incompatibles, ce qui en fait une liste de contrôle toute prête.¹
• Python 3.10 est le nouveau plancher. Rien d’autre ne change dans votre environnement ; le SDK prend toujours en charge Pydantic v1 et v2.¹
• httpx est devenu httpx2. Les valeurs simples comme timeout=30.0 continuent de fonctionner ; les objets httpx que vous passez au client doivent venir de httpx2, et les bibliothèques qui patchent httpx restent aveugles tant que vous n’appelez pas httpx2.alias_httpx().¹
• Supprimés : les Text Completions, les paramètres d’échantillonnage et les dictionnaires de schéma dans output_format. client.completions.create(), temperature, top_p et top_k ont disparu ; les dictionnaires de schéma passent dans output_config={"format": {...}}.¹
• Claude Code v2.1.239 (21 août 2026) a ajouté /claude-api upgrade pour migrer les projets Python d’anthropic 0.x vers 1.x.³ Traitez sa sortie comme n’importe quelle migration automatisée : lisez le diff avant de le committer.

Qu’est-ce qui casse quand je passe à anthropic 1.0 ?

Six changements portent l’essentiel du poids ; je condense la référence rapide du guide à ces six-là, et les suppressions plus petites suivent.¹ Le plus gros a une raison simple : la couche HTTP du SDK est passée de httpx, qui n’est plus activement maintenu, à httpx2, un fork compatible au niveau de l’API et maintenu par l’équipe Pydantic, avec les mêmes classes, le même comportement et les correctifs de sécurité inclus.¹

Des suppressions plus petites et un changement de comportement les accompagnent, chacun avec un remplaçant :¹

La dernière ligne mord en silence : default_headers={"USER-AGENT": "my-app/1.0"} remplace désormais le User-Agent du SDK au lieu d’envoyer les deux.¹

Comment migrer à la main ?

Trois étapes, dans l’ordre : mettre à jour, laisser le vérificateur de types trouver ce qui casse, puis corriger par catégorie.

pip install --upgrade "anthropic>=1,<2"
pyright   # or mypy

Corrigez d’abord les imports httpx, parce que ce sont eux qui échouent le plus bruyamment. Les ré-exports du SDK lui-même (anthropic.Timeout, anthropic.DefaultHttpxClient, anthropic.DefaultAsyncHttpxClient, anthropic.DefaultAioHttpClient) pointent déjà vers httpx2 et continuent de fonctionner ; seuls les objets que vous construisez directement depuis httpx ont besoin de l’alias.¹

# Before
import httpx
from anthropic import Anthropic, DefaultHttpxClient

client = Anthropic(
    timeout=httpx.Timeout(60.0, connect=5.0),
    http_client=DefaultHttpxClient(
        proxy="http://my.proxy.example",
        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
    ),
)

# After
import httpx2 as httpx  # or `import httpx2` and rename the references
from anthropic import Anthropic, DefaultHttpxClient

client = Anthropic(
    timeout=httpx.Timeout(60.0, connect=5.0),
    http_client=DefaultHttpxClient(
        proxy="http://my.proxy.example",
        transport=httpx.HTTPTransport(local_address="0.0.0.0"),
    ),
)

Si d’autres parties de l’application importent encore httpx et partagent des clients ou des types d’exception avec le SDK, ou si vous utilisez HTTPXClientInstrumentor d’OpenTelemetry, l’intégration httpx de Sentry, respx, pytest-httpx ou vcrpy, appelez httpx2.alias_httpx() une seule fois en tête de votre point d’entrée. L’appel doit s’exécuter avant que quoi que ce soit n’importe httpx (il lève RuntimeError sinon), et le guide le réserve aux applications : une bibliothèque ne doit jamais l’appeler au nom de ses utilisateurs.¹ Sous pytest, l’option la moins intrusive du guide est un plugin précoce, un module tests/_alias_httpx.py qui appelle httpx2.alias_httpx(), enregistré dans pyproject.toml pour qu’il se charge avant respx, pytest-httpx et vos modules de test :¹

# tests/_alias_httpx.py
import httpx2

httpx2.alias_httpx()  # makes `import httpx` / `import httpcore` resolve to httpx2 / httpcore2

# pyproject.toml
[tool.pytest.ini_options]
addopts = "-p tests._alias_httpx"
pythonpath = ["."]

Les objets de réponse et d’erreur sont désormais des types httpx2. Le changement de paquet s’applique à ce que le SDK renvoie, pas seulement à ce que vous lui passez. APIStatusError.response, APIConnectionError.request, response.http_response / .headers / .url sur les réponses brutes, et l’argument response= que reçoivent vos hooks d’événement personnalisés de http_client sont tous des objets httpx2. Ils portent exactement les mêmes attributs qu’avant, donc seuls les tests isinstance et les annotations de type qui nomment httpx.Response / httpx.Request / httpx.Headers doivent basculer vers httpx2.¹ Le cas isinstance mérite un second regard. Le guide dit seulement que ces tests doivent basculer ;¹ la raison pour laquelle ils comptent, c’est qu’à moins que httpx2.alias_httpx() n’ait fait résoudre httpx vers httpx2, un test comme isinstance(err.response, httpx.Response) contre l’ancien paquet renvoie False sans rien lever, et le gestionnaire saute sa branche.

# Before
def log_failure(err: anthropic.APIStatusError) -> None:
    response: httpx.Response = err.response
    print(response.status_code, response.headers.get("request-id"))


# After
def log_failure(err: anthropic.APIStatusError) -> None:
    response: httpx2.Response = err.response
    print(response.status_code, response.headers.get("request-id"))

Ensuite, les lecteurs de réponse brute. .with_raw_response renvoyait LegacyAPIResponse pour les deux clients ; il renvoie maintenant les mêmes classes APIResponse / AsyncAPIResponse que .with_streaming_response utilisait déjà.¹

Ensuite, les paramètres supprimés. Les modèles actuels n’utilisent pas temperature, top_p ni top_k, donc les méthodes générées ne les acceptent plus. Un modèle antérieur au changement les honore toujours via extra_body, que le SDK fusionne tel quel dans le JSON de la requête.¹

# Before
client.messages.create(..., model="claude-sonnet-4-6", temperature=0.2)

# After
client.messages.create(..., model="claude-sonnet-4-6", extra_body={"temperature": 0.2})

Les dictionnaires de schéma se déplacent de la même façon : output_format={"type": "json_schema", "schema": ...} sur beta.messages.create() devient output_config={"format": {"type": "json_schema", "schema": ...}} ; les helpers parse() / stream() / count_tokens() / tool_runner() gardent output_format=Order pour une classe, et un dictionnaire de schéma à cet endroit lève désormais TypeError.¹

Terminez par Bedrock. AnthropicBedrock et AsyncAnthropicBedrock journalisaient un avertissement et se rabattaient sur us-east-1 ; ils lèvent maintenant ValueError à la construction. La région se résout depuis aws_region=, puis AWS_REGION / AWS_DEFAULT_REGION, puis la session boto3 du aws_profile indiqué.¹ Le SDK ignore aussi désormais les événements de streaming Bedrock inconnus qu’il produisait auparavant ; le seul cas connu est amazon-bedrock-invocationMetrics.¹

Comment migrer avec Claude Code ?

Le guide de migration nomme lui-même le raccourci : lancez /claude-api upgrade python dans votre projet et relisez le diff.¹ Claude Code v2.1.239, publié le 21 août 2026, est la version où la commande est arrivée ; la note de version dit, en entier, « Added /claude-api upgrade to migrate Python projects from anthropic 0.x to 1.x, and updated the skill’s Python reference for 1.x (timeouts use anthropic.Timeout, not httpx.Timeout) » (ajout de /claude-api upgrade pour migrer les projets Python d’anthropic 0.x vers 1.x, et mise à jour de la référence Python du skill pour 1.x).³

Cette phrase est toute la surface vérifiée : une commande du skill /claude-api qui migre l’usage 0.x d’un projet vers 1.x. Je n’ai trouvé aucune autre documentation sur la façon dont elle choisit ses modifications, alors traitez-la exactement comme cela : une migration automatisée dont vous relisez le diff. Passez à la v2.1.239 ou plus récente (claude update, ou la référence d’installation et de mise à jour), ouvrez une session à la racine du projet et lancez-la :

/claude-api upgrade python

Relisez ensuite le diff bloc par bloc, lancez le vérificateur de types, puis la suite de tests – la même relecture que vous accorderiez à la PR de migration d’un contributeur. L’étape du vérificateur de types compte plus que d’habitude ici, parce que presque tout ce qui casse en 1.0 est une erreur de type, et que cette vérification se moque de qui a fait les modifications.¹ Le seul détail que la note de version signale, anthropic.Timeout plutôt que httpx.Timeout, concorde avec le guide : ce ré-export pointe déjà vers httpx2.¹³

Nouveau sur Claude Code ? Le guide de démarrage rapide couvre la première session, et le guide complet couvre les skills intégrés et les commandes slash.

FAQ

anthropic 1.0 prend-il toujours en charge Pydantic v1 ?

Oui. Le SDK prend toujours en charge Pydantic v1 et v2 ; le minimum Python 3.10 est le seul changement d’environnement.¹

Pourquoi ma configuration OpenTelemetry ou respx ne voit-elle plus les requêtes du SDK après la mise à jour ?

Ces bibliothèques patchent httpx, que le SDK n’utilise plus. Appelez httpx2.alias_httpx() avant que quoi que ce soit n’importe httpx ; import httpx se résout alors vers httpx2 pour tout le processus.¹

Puis-je encore passer temperature à un modèle plus ancien ?

Oui, via extra_body={"temperature": 0.2}, que le SDK fusionne dans le JSON de la requête. Pour messages.batches.create(), mettez la clé directement dans le dictionnaire params de la requête.¹

Qu’est-ce qui a remplacé la compaction côté client dans tool_runner ?

La compaction côté serveur : passez betas=["compact-2026-01-12"] et context_management={"edits": [{"type": "compact_20260112", "trigger": {"type": "input_tokens", "value": 100_000}}]} à tool_runner(). Dans l’exemple du guide, cette paire remplace compaction_control={"enabled": True, "context_token_threshold": 100_000} ; le seuil de déclenchement doit être d’au moins 50 000 tokens.¹

Dois-je retirer httpx_aiohttp de mes requirements ?

Oui. anthropic[aiohttp] et http_client=DefaultAioHttpClient() fonctionnent comme avant, mais l’extra n’installe plus httpx_aiohttp, parce qu’il est désormais livré dans le SDK.¹

Points clés à retenir

Pour les développeurs d’applications : - Épinglez "anthropic>=1,<2", lancez le vérificateur de types et corrigez par catégorie, dans cet ordre : imports httpx, await sur les réponses brutes, paramètres supprimés, région Bedrock.¹ - Placez httpx2.alias_httpx() dans les premières lignes du point d’entrée si quoi que ce soit d’autre dans le processus partage des objets httpx avec le SDK ou instrumente httpx.¹

Pour les mainteneurs de bibliothèques : - N’appelez jamais httpx2.alias_httpx() à l’intérieur d’une bibliothèque ; aliasez plutôt l’import (import httpx2 as httpx).¹ - Abandonnez anthropic.Transport / ProxiesTypes au profit de httpx2.BaseTransport / httpx2.Proxy.¹

Pour les équipes qui utilisent Claude Code : - Passez à la v2.1.239 ou plus récente et lancez /claude-api upgrade python depuis la racine du projet ; relisez le diff, puis lancez le vérificateur de types et les tests avant de committer.¹³

Références