Source: https://aiprimetech.io/fr/learn/use-claude-api-with-langchain/

[Accueil](/fr/) / [Apprendre](/fr/learn/) / ChatAnthropic dans LangChain : import, base_url, streaming, outils et erreurs 

# ChatAnthropic dans LangChain : importation, base_url, streaming, outils et erreurs 

ChatAnthropic du langchain-anthropic package est le modèle de chat Claude de LangChain. Il encapsule le SDK Python officiel d’Anthropic ; pour le faire pointer vers une passerelle, il suffit donc d’un argument, base_url, défini sur la racine de l’hôte. Tout le reste de vos chaînes, agents et outils reste identique. 

## Installation et import 

terminalCopier

```
pip install -U langchain-anthropic
```

app.pyCopier

```
from langchain_anthropic import ChatAnthropic

llm = ChatAnthropic(
    model="claude-sonnet-5",
    base_url="https://aiprimetech.io",           # host root: the SDK adds /v1/messages
    api_key="your_gateway_key",   # or set ANTHROPIC_API_KEY
)

print(llm.invoke("Say hello in one word.").text)
```

Non /v1 dans base_url ici. Le SDK Anthropic sous-jacent ajoute /v1/messages lui-même ; ajouter /v1 produit /v1/v1/messages et un 404 page not found. 

## Configuration à partir des variables d’environnement 

base_url est un alias de anthropic_api_url, ainsi que api_key un alias de anthropic_api_key. Lorsque vous ne les fournissez pas, ChatAnthropic lit ANTHROPIC_API_URL en premier, puis ANTHROPIC_BASE_URL, et la clé depuis ANTHROPIC_API_KEY. Les arguments explicites ont toujours la priorité. 

terminalCopier

```
export ANTHROPIC_API_KEY=your_gateway_key
export ANTHROPIC_API_URL=https://aiprimetech.io
```

app.pyCopier

```
from langchain_anthropic import ChatAnthropic

llm = ChatAnthropic(model="claude-sonnet-5")   # picks up the gateway from the environment
```

## Diffusion en continu 

app.pyCopier

```
for chunk in llm.stream("Explain backpressure in two sentences."):
    print(chunk.text, end="", flush=True)
```

.text ne recueille que les blocs de texte de chaque fragment, de sorte que le résultat reste propre lorsque le modèle émet également des blocs de réflexion ou d’utilisation d’outils. Utilisez le streaming pour les réponses longues : une requête longue sans streaming est la cause habituelle des dépassements de délai. 

## Outils et sortie structurée 

tools.pyCopier

```
from langchain_core.tools import tool

@tool
def get_time(city: str) -> str:
    """Return the current local time in a city."""
    return "12:00"

msg = llm.bind_tools([get_time]).invoke("What time is it in Tokyo?")
print(msg.tool_calls)
```

structured.pyCopier

```
from pydantic import BaseModel

class Weather(BaseModel):
    city: str
    temperature_c: float

print(llm.with_structured_output(Weather).invoke("It is 21 degrees in Lisbon today."))
```

## Nouvelles tentatives, délais d’expiration et max_tokens 

max_retries vaut par défaut 2, comme dans le SDK Anthropic, qui réessaie en cas d’erreurs de connexion, de réponses 429 et de réponses 5xx. timeout (alias de default_request_timeout) est exprimé en secondes. Si vous laissez max_tokens non défini, sa valeur provient du profil du modèle. 

app.pyCopier

```
llm = ChatAnthropic(
    model="claude-sonnet-5",
    base_url="https://aiprimetech.io",
    max_retries=4,
    timeout=120,
    max_tokens=8000,
)
```

Pour les traitements par lots, limitez le parallélisme afin de respecter la limite de concurrence de votre clé : llm.batch(inputs, config={"max_concurrency": 3}). 

## L’alternative ChatOpenAI 

Si votre code est standardisé sur ChatOpenAI, le point de terminaison de la passerelle compatible avec OpenAI donne aussi accès à Claude. Cette voie nécessite /v1 à la fin, à l’inverse de ChatAnthropic. 

app.pyCopier

```
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(model="claude-sonnet-5", base_url="https://aiprimetech.io/v1", api_key="your_gateway_key")
```

Privilégiez ChatAnthropic pour Claude : il conserve les fonctionnalités natives telles que la mise en cache des prompts et les blocs de réflexion. 

## Dépannage 

  | Ce que vous voyez  | Cause  | Solution  

 | 404 page not found | /v1 dans le paramètre de ChatAnthropic base_url | Utilisez la racine de l’hôte, https://aiprimetech.io 

 | Model "..." is not supported | Un identifiant auquel le groupe de votre clé ne donne pas accès, ou un ancien nom daté | Utilisez un identifiant actuel du tableau ci-dessous 

 | AuthenticationError | ANTHROPIC_API_KEY vide dans le processus en cours d’exécution, ou une clé destinée à un autre point de terminaison | Passez api_key= explicitement pour tester 

 | RateLimitError: Concurrency limit exceeded | Trop d’appels parallèles (batch, gather asynchrone) | max_concurrency dans la configuration du traitement par lots 

 | APITimeoutError | Générations longues sans streaming | Utilisez le streaming ou augmentez timeout  

  | Identifiant du modèle  | À utiliser pour  

 | claude-sonnet-5 | Choix par défaut pour le développement et les tâches d’agents : rapide, performant, à prix intermédiaire. 

 | claude-opus-5-5 | Raisonnement plus difficile, refactorisations importantes, longues exécutions d’agents. 

 | claude-fable-5-1 | Le plus performant et le plus cher ; réservez-le aux tâches les plus difficiles. 

 | claude-haiku-4-5 | Économique et rapide : titres, résumés, classification, petites étapes.  

## Questions fréquentes 

 Comment importer ChatAnthropic ?

Exécutez pip install -U langchain-anthropic, puis from langchain_anthropic import ChatAnthropic. Le paramètre base_url de ChatAnthropic doit-il inclure /v1 ?

Non. Passez la racine de l’hôte, par exemple https://aiprimetech.io; ; le SDK Anthropic ajoute /v1/messages. ChatOpenAI fonctionne à l’inverse et nécessite /v1. Quelles variables d’environnement ChatAnthropic lit-il ?

ANTHROPIC_API_KEY pour la clé, et ANTHROPIC_API_URL, puis ANTHROPIC_BASE_URL, pour le point de terminaison lorsque base_url n’est pas passé. base_url est-il identique à anthropic_api_url ?

Oui. base_url est un alias de anthropic_api_url, et api_key est un alias de anthropic_api_key.  

Commencez à utiliser Claude en quelques minutes

Obtenez une clé API — aucun compte Anthropic ni inscription sur liste d’attente requis.[Obtenir votre clé API](/register) 

AI Prime Tech est une passerelle API indépendante. Elle n’est ni affiliée à Anthropic, ni approuvée par Anthropic, ni revendeuse d’Anthropic. Claude et les noms de modèles associés sont des marques de leurs propriétaires respectifs.    

## Autres guides sur l’API Claude

[Comment obtenir une clé API Claude](/fr/learn/how-to-get-a-claude-api-key/)[Comprendre la tarification de l’API Claude](/fr/learn/claude-api-pricing-explained/)[La façon la moins chère d’utiliser l’API Claude](/fr/learn/cheapest-way-to-use-claude-api/)[Cursor illimité avec l’API Claude](/learn/use-claude-api-with-cursor/)[Accès illimité à Claude Code](/fr/learn/use-claude-api-with-claude-code/)[Passerelle API Claude ou accès direct à Anthropic](/fr/learn/claude-api-vs-anthropic-direct/)[Utiliser Claude via une API compatible avec OpenAI](/fr/learn/openai-compatible-claude-api/)[Comprendre les modèles Claude : comparaison de Claude Opus, Sonnet, Haiku et Fable — tous les modèles de l’API Claude, noms des modèles Anthropic et prix (2026)](/fr/learn/claude-api-models-compared/)[Payer l’API Claude en cryptomonnaies](/fr/learn/claude-api-with-crypto-payment/)[Accéder à l’API Claude sans liste d’attente](/fr/learn/claude-api-without-waitlist/)[Comment réduire la consommation de tokens de Claude](/fr/learn/how-to-reduce-claude-token-usage/)[Cline illimité avec l’API Claude](/fr/learn/use-claude-api-with-cline/)[Roo Code illimité avec l’API Claude](/fr/learn/use-claude-api-with-roo-code/)[Claude illimité dans les IDE JetBrains](/fr/learn/use-claude-api-with-jetbrains/)[Utiliser Aider sans limites avec l’API Claude](/fr/learn/use-claude-api-with-aider/)[Claude illimité dans VS Code](/fr/learn/use-claude-api-with-vscode/)[Configuration d’OpenCode pour Claude : paramètres d’opencode.json, modèles et erreurs courantes](/fr/learn/use-claude-api-with-opencode/)[Exécuter un agent Hermes sans limites sur Claude](/fr/learn/run-hermes-agent-with-claude-api/)[Utiliser OpenClaw sans limites avec Claude](/fr/learn/run-openclaw-with-claude-api/)[Ce que signifie une API compatible avec Anthropic](/fr/learn/anthropic-compatible-api/)[Clé API Claude Code — ANTHROPIC_API_KEY : comment l’obtenir, la configurer et quand utiliser claude setup-token à la place](/fr/learn/claude-code-api-key-setup/)[Coûts de l’API Claude Code — Tarifs et moyens de les réduire](/fr/learn/claude-code-api-costs/)[Les erreurs de l’API Claude expliquées : erreur serveur 500, surcharge 529, limite de débit 429, requête incorrecte 400 — et le correctif pour chacune](/fr/learn/claude-api-errors-troubleshooting/)[Comment acheter des crédits pour l’API Claude — et pourquoi un crédit Claude vaut mieux que toute offre d’« achat de compte Claude »](/fr/learn/buy-claude-api-credits/)[API Claude gratuite : existe-t-il une clé API Claude gratuite, et qu’est-ce qui est réellement gratuit en 2026 ?](/fr/learn/claude-api-free-trial/)[API Claude ou abonnement Claude Pro/Max — Que choisir](/fr/learn/claude-api-vs-subscription/)[Exécuter la CLI Codex sur Claude](/fr/learn/use-claude-api-with-codex/)[Connecter Claude à n8n](/fr/learn/use-claude-api-with-n8n/)[Router LiteLLM vers Claude](/fr/learn/use-claude-api-with-litellm/)[Utiliser Claude dans Kilo Code](/fr/learn/use-claude-api-with-kilo-code/)[Intégrer Claude à GitHub Copilot](/fr/learn/use-claude-api-with-github-copilot/)[Connecter Zed à Claude via la passerelle](/fr/learn/use-claude-api-with-zed/)[Connecter Cherry Studio à Claude](/fr/learn/use-claude-api-with-cherry-studio/)[SDK Python Anthropic : installation, configuration de base_url, streaming et gestion des erreurs](/fr/learn/anthropic-python-sdk/)[Claude avec Vercel AI SDK : baseURL de createAnthropic, streaming et corrections](/fr/learn/use-claude-api-with-vercel-ai-sdk/)[Utiliser Factory Droid avec Claude](/fr/learn/use-claude-api-with-factory-droid/)[L’API de Claude Code expliquée](/fr/learn/claude-code-api/)[Intégrer l’API Claude à votre application](/fr/learn/claude-api-integration/)[Comment utiliser Claude sans limites — et pourquoi il n’existe pas de « Claude Code piraté »](/fr/learn/get-unlimited-claude-usage/)