Guide de démarrage rapide
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 :
- Un compte avec accès à l’API (voir notre guide ici sur l’obtention de l’accès à Claude)
- Une clé API (disponible via vos paramètres de compte)
- Python 3.7.1 ou plus récent installé sur votre ordinateur
É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 :
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 :
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 :
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 :
- Ouvrez votre terminal et tapez :
nano ~/.bash_profile
(ounano ~/.zshrc
si vous utilisez une version plus récente de macOS) - 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'
- Enregistrez le fichier et quittez l’éditeur (appuyez sur
Ctrl+O
, puisEntrée
, puisCtrl+X
) - Chargez le profil mis à jour en exécutant :
source ~/.bash_profile
(ousource ~/.zshrc
)
- Ouvrez votre terminal et tapez :
- Sur Windows :
- Ouvrez l’invite de commande et tapez :
setx ANTHROPIC_API_KEY "your-api-key-here"
, en remplaçantyour-api-key-here
par votre véritable clé API - 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
- Ouvrez l’invite de commande et tapez :
É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 :
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
- Visitez notre guide de migration pour apprendre à transférer votre cas d’utilisation vers Claude.
- Explorez le glossaire des termes pour vous familiariser avec la terminologie utilisée dans l’IA, les LLM et l’écosystème Claude.
- Rejoignez notre serveur Discord pour les développeurs pour vous connecter avec d’autres développeurs, poser des questions et partager vos projets.
- Visitez la bibliothèque de prompts pour trouver l’inspiration et des prompts prêts à l’emploi pour diverses tâches, ou mettez le pied à l’étrier du prompt engineering en consultant l’introduction au prompting.
Nous sommes impatients de voir ce que vous allez créer avec Claude. Bon codage !