Vous voulez simplement discuter avec Claude ? Visitez claude.ai !

Vous voulez plonger directement dans la compréhension de notre API ? Consultez notre documentation de référence de l’API pour plus de détails.

Mettons-vous rapidement en route avec Claude ! Dans ce guide, nous vous guiderons à travers le processus de configuration de votre environnement, d’installation des bibliothèques nécessaires et d’envoi de votre première requête API à Claude. Commençons !

Notez que bien que ce guide utilise notre SDK Python, nous maintenons également un SDK TypeScript et prenons en charge les intégrations HTTP directes. Consultez notre documentation sur les SDK clients et la référence de l’API pour plus de détails.


Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

Étape 1 : Configurez votre environnement

Faites une copie de notre notebook Google Colab de démarrage rapide pour commencer immédiatement sans configurer d’environnement !

Tout d’abord, assurez-vous que Python est installé. Ouvrez votre terminal (sur macOS) ou l’invite de commande (sur Windows) et tapez :

Shell
python --version

Si vous voyez un numéro de version comme “Python 3.12.2”, vous êtes prêt. Sinon, visitez le site web officiel de Python et téléchargez la dernière version.

(Facultatif) Créez un environnement virtuel

Bien que ce ne soit pas obligatoire, il est recommandé de créer un environnement virtuel pour vos projets Claude. Cela permet de garder vos dépendances organisées et d’éviter les conflits avec d’autres projets. Pour créer un environnement virtuel, exécutez :

Shell
python -m venv claude-env

Ensuite, activez-le :

  • Sur macOS ou Linux : source claude-env/bin/activate
  • Sur Windows : claude-env\Scripts\activate

Étape 2 : Installez le SDK Python d’Anthropic

Une fois votre environnement configuré, il est temps d’installer la bibliothèque Python Claude. Exécutez simplement :

Shell
pip install anthropic

Cette commande installera la dernière version de la bibliothèque, ainsi que toutes les dépendances nécessaires.

Étape 3 : (Facultatif) Configurez votre clé API

Pour utiliser Claude, vous devrez fournir votre clé API. Vous pouvez rendre votre clé API disponible pour tous vos projets Claude en définissant une variable d’environnement. Voici comment procéder :

  • Sur macOS ou Linux :
    1. Ouvrez votre terminal et tapez : nano ~/.bash_profile (ou nano ~/.zshrc si vous utilisez une version plus récente de macOS)
    2. Ajoutez cette ligne au fichier, en remplaçant your-api-key-here par votre véritable clé API : export ANTHROPIC_API_KEY='your-api-key-here'
    3. Enregistrez le fichier et quittez l’éditeur (appuyez sur Ctrl+O, puis Entrée, puis Ctrl+X)
    4. Chargez le profil mis à jour en exécutant : source ~/.bash_profile (ou source ~/.zshrc)
  • Sur Windows :
    1. Ouvrez l’invite de commande et tapez : setx ANTHROPIC_API_KEY "your-api-key-here", en remplaçant your-api-key-here par votre véritable clé API
    2. Pour rendre ce changement permanent, suivez ces étapes :
      • Faites un clic droit sur “Ce PC” ou “Poste de travail” et sélectionnez “Propriétés”
      • Cliquez sur “Paramètres système avancés”
      • Cliquez sur le bouton “Variables d’environnement”
      • Dans la section “Variables système”, cliquez sur “Nouveau…” et entrez ANTHROPIC_API_KEY comme nom de variable et votre clé API comme valeur de variable

Étape 4 : Envoyez votre première requête API

Vous y êtes presque ! Envoyons votre première requête API à Claude. Créez un nouveau fichier Python (par exemple, claude_test.py) et ajoutez le code suivant :

Python
import anthropic

client = anthropic.Anthropic(
    # par défaut os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)

message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0.0,
    system="Répondez uniquement en parlant comme Yoda.",
    messages=[
        {"role": "user", "content": "Comment allez-vous aujourd'hui ?"}
    ]
)

print(message.content)

Décomposons ce qui se passe ici :

  • Nous importons la bibliothèque anthropic, qui fournit un moyen pratique d’interagir avec l’API Claude.
  • Nous créons une instance du client Anthropic, en passant notre clé API (si vous avez défini une variable d’environnement, vous pouvez l’omettre).
  • Nous appelons la méthode messages.create() pour envoyer un message à Claude. Nous spécifions le modèle que nous voulons utiliser (claude-3-opus-20240229), le nombre maximum de tokens dans la réponse (max_tokens=1000), la température (qui contrôle le caractère aléatoire de la sortie, temperature=0.0 signifie un minimum d’aléatoire), et le message système (qui définit le contexte de la conversation).
  • Enfin, nous imprimons la réponse de Claude.

Pour exécuter le code, tapez simplement python claude_test.py dans votre terminal ou invite de commande. Vous devriez voir une réponse de type proverbe de la part de Claude !

Visitez les exemples de l’API Messages pour plus d’exemples de structures d’appels API. Pour plus d’informations sur les paramètres de l’API, consultez la référence de l’API Messages.


Prochaines étapes

Félicitations, vous avez envoyé avec succès votre première requête API à Claude ! Voici quelques prochaines étapes pour poursuivre votre parcours.

Ressources de l’API

Plongez dans notre documentation de l’API pour plus de détails sur les endpoints et paramètres disponibles.

Consultez nos SDK clients pour un ensemble d’outils facilitant la création et l’intégration de Claude dans vos applications.

Anthropic cookbook

Le Anthropic cookbook contient un ensemble de recettes sous forme de notebooks Jupyter. Ces notebooks présentent du code copiable qui montre comment utiliser Claude de manière élégante et efficace dans des scénarios plus avancés, tels que le téléchargement de PDF, l’utilisation d’outils et l’appel de fonctions, les embeddings, et plus encore.

Autres ressources

Nous sommes impatients de voir ce que vous allez créer avec Claude. Bon codage !