Dans cet exemple, nous allons demander à Claude d’écrire une fonction Python qui vérifie si une chaîne de caractères est un palindrome.

Prérequis

Vous aurez besoin de :

Anthropic fournit des SDK Python et TypeScript, bien que vous puissiez effectuer des requêtes HTTP directes à l’API.

Commencer avec le Workbench

Tout appel API que vous effectuez — quelle que soit la tâche spécifique — envoie une invite bien configurée à l’API Anthropic. Pendant que vous apprenez à tirer le meilleur parti de Claude, nous vous recommandons de commencer le processus de développement dans le Workbench, une interface web pour Claude.

Connectez-vous à la Console Anthropic et cliquez sur Write a prompt from scratch.

Dans la section du milieu, sous User, posons une question à Claude.

Why is the ocean salty?

Cliquez sur Run. Sur le côté droit, vous verrez une sortie comme

Response
The ocean is salty due to several factors:

1. Weathering of rocks: Over millions of years, rain, rivers, and streams have eroded rocks containing mineral salts. These salts are carried into the ocean by water runoff.
2. Volcanic activity: Underwater volcanoes and hydrothermal vents release minerals, including salts, into the ocean water.
3. Atmospheric deposition: Salt particles from ocean spray can be carried by wind and deposited back into the ocean.
4. Evaporation: As water evaporates from the surface of the ocean, it leaves behind dissolved salts, increasing the concentration of salt in the remaining water.
5. Biological processes: Some marine organisms contribute to the ocean's salinity by releasing salt compounds as byproducts of their metabolism.

Over time, these processes have continuously added salts to the ocean, while evaporation removes pure water, leading to the ocean's current salinity levels. It's important to note that the total amount of salt in the ocean remains relatively stable because the input of salts is balanced by the removal of salts through processes like the formation of evaporite deposits.

C’est une bonne réponse, mais supposons que nous voulions contrôler le type exact de réponse que Claude donne. Par exemple, en permettant à Claude de répondre aux questions uniquement avec des poèmes. Nous pouvons contrôler le format, le ton et la personnalité de la réponse en ajoutant une invite système.

You are a world-class poet. Respond only with short poems.

Cliquez à nouveau sur Run.

Response
The ocean's salty brine,
A tale of time and elements combined.
Rocks and rain, a slow erosion,
Minerals carried in solution.
Eons pass, the salt remains,
In the vast, eternal watery domain.

Voyez-vous comment la réponse de Claude a changé ? Les LLM répondent bien aux instructions claires et directes. Vous pouvez mettre les instructions de rôle soit dans l’invite système, soit dans le message utilisateur. Nous vous recommandons de tester pour voir quelle méthode donne les meilleurs résultats pour votre cas d’utilisation.

Une fois que vous avez ajusté les entrées de manière à être satisfait de la sortie et que vous avez une bonne idée de la façon d’utiliser Claude, convertissez votre Workbench en une intégration.

Cliquez sur Get Code pour copier le code généré représentant votre session Workbench.

Installer le SDK

Anthropic fournit des SDK pour Python (3.7+), TypeScript (4.5+), et Java (8+). Nous avons également actuellement un SDK Go en version bêta.

Dans votre répertoire de projet, créez un environnement virtuel.

python -m venv claude-env

Activez l’environnement virtuel en utilisant

  • Sur macOS ou Linux, source claude-env/bin/activate
  • Sur Windows, claude-env\Scripts\activate
pip install anthropic

Définir votre clé API

Chaque appel API nécessite une clé API valide. Les SDK sont conçus pour extraire la clé API d’une variable d’environnement ANTHROPIC_API_KEY. Vous pouvez également fournir la clé au client Anthropic lors de son initialisation.

export ANTHROPIC_API_KEY='your-api-key-here'

Appeler l’API

Appelez l’API en passant les paramètres appropriés au point de terminaison /messages.

Notez que le code fourni par le Workbench définit la clé API dans le constructeur. Si vous avez défini la clé API comme variable d’environnement, vous pouvez omettre cette ligne comme ci-dessous.

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-4-20250514",
    max_tokens=1000,
    temperature=1,
    system="You are a world-class poet. Respond only with short poems.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Why is the ocean salty?"
                }
            ]
        }
    ]
)
print(message.content)

Exécutez le code en utilisant python3 claude_quickstart.py ou node claude_quickstart.js.

[TextBlock(text="The ocean's salty brine,\nA tale of time and design.\nRocks and rivers, their minerals shed,\nAccumulating in the ocean's bed.\nEvaporation leaves salt behind,\nIn the vast waters, forever enshrined.", type='text')]
Le Workbench et les exemples de code utilisent les paramètres de modèle par défaut pour : le modèle (nom), la température et le nombre maximum de tokens à échantillonner.

Ce guide de démarrage rapide montre comment développer une application basique, mais fonctionnelle, alimentée par Claude en utilisant la Console, le Workbench et l’API. Vous pouvez utiliser ce même flux de travail comme base pour des cas d’utilisation beaucoup plus puissants.

Prochaines étapes

Maintenant que vous avez effectué votre première requête à l’API Anthropic, il est temps d’explorer ce qui est également possible :