Claude Academy
Wird geladen

Eine Anfrage stellen

Lektion 315 Min.

Deine erste Anfrage an die Anthropic API zu stellen, ist unkompliziert, sobald du das grundlegende Setup und die Struktur verstanden hast. Dieser Leitfaden führt dich durch die wesentlichen Schritte, damit Claude auf deine Prompts mit Python antwortet.

Einrichten deiner Umgebung

Bevor du API-Aufrufe durchführst, musst du die erforderlichen Pakete installieren und deinen API-Key sicher konfigurieren.

Installiere zunächst die notwendigen Abhängigkeiten in deinem Jupyter-Notebook:

bash
%pip install "anthropic<1" python-dotenv

Erstelle als Nächstes eine .env-Datei im selben Verzeichnis wie dein Notebook, um deinen API-Key sicher zu speichern:

bash
ANTHROPIC_API_KEY="your-api-key-here"

Dieser Ansatz hält deinen API-Key aus deinem Code heraus und verhindert, dass er versehentlich in die Versionskontrolle übernommen wird. Füge .env immer zu deiner .gitignore-Datei hinzu.

Lade die Umgebungsvariablen und erstelle deinen API-Client:

python
from dotenv import load_dotenv
load_dotenv()

from anthropic import Anthropic

client = Anthropic()
model = "claude-haiku-4-5"

Die Create-Funktion

Der Kern des Stellens von API-Anfragen ist die Funktion client.messages.create(). Diese Funktion benötigt drei wichtige Parameter:

Der Aufruf client.messages.create mit Hinweisen, die seine drei Parameter model, max_tokens und messages beschriften, die unten aufgeführt sind.

  • model - Der Name des Claude-Modells, das du verwenden möchtest
  • max_tokens - Ein Sicherheitslimit für die Antwortlänge (kein Zielwert)
  • messages - Der Gesprächsverlauf, den du an Claude sendest

Der Parameter max_tokens fungiert als Sicherheitsmechanismus. Wenn du ihn auf 1000 setzt, stoppt Claude die Generierung nach 1000 Tokens, selbst wenn es noch mehr zu sagen hätte. Claude versucht nicht, dieses Limit zu erreichen - es schreibt einfach das, was es für angemessen hält, und stoppt, wenn es das Maximum erreicht.

Nachrichten verstehen

Nachrichten repräsentieren das Gespräch zwischen dir und Claude, ähnlich wie bei einer Chat-Anwendung. Es gibt zwei Arten von Nachrichten:

Chat-Fenster, in dem die Nutzernachricht fragt „Was ist Quantencomputing?" und die Assistentennachricht die KI-Antwort ist, die es definiert.

  • Nutzernachrichten - Inhalte, die du an Claude senden möchtest (von Menschen verfasst)
  • Assistentennachrichten - Antworten, die Claude generiert hat

Jede Nachricht ist ein Dictionary mit einer role (entweder „user" oder „assistant") und content (dem eigentlichen Text).

Deine erste Anfrage stellen

Hier ist ein vollständiges Beispiel für das Stellen einer Anfrage an Claude:

python
message = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What is quantum computing? Answer in one sentence"
        }
    ]
)

Wenn du diesen Code ausführst, verarbeitet Claude deine Anfrage und gibt ein Antwortobjekt zurück, das den generierten Text zusammen mit Metadaten zur Anfrage enthält.

Die Antwort extrahieren

Das Antwortobjekt enthält viele Informationen, aber normalerweise möchtest du nur den generierten Text. Greife darauf zu mit:

python
message.content[0].text

Dies liefert dir eine saubere, lesbare Ausgabe wie: „Quantencomputing ist eine Art der Berechnung, die Prinzipien der Quantenmechanik wie Superposition und Verschränkung nutzt, um Informationen mithilfe von Quantenbits (Qubits) zu verarbeiten, wodurch bestimmte komplexe Probleme potenziell exponentiell schneller gelöst werden können als mit klassischen Computern."

Mit diesen Grundlagen kannst du beginnen, mit verschiedenen Prompts zu experimentieren und komplexere Interaktionen mit Claude aufzubauen.