Dein erster API-Aufruf
Die API lässt dein Programm mit Claude sprechen. Drei Schritte: einen Schlüssel besorgen, das SDK installieren, eine Nachricht senden.
1. Einen API-Schlüssel besorgen
Erstelle einen in der Anthropic Console. Setze ihn dann als Umgebungsvariable, damit er niemals in deinem Code liegt:
export ANTHROPIC_API_KEY="sk-ant-..."
:::warning Committe niemals deinen Schlüssel Bewahre Schlüssel in Umgebungsvariablen oder einem Secrets-Manager auf — niemals in der Versionsverwaltung. Siehe Sicherheit. :::
2. Das SDK installieren
- Python
- TypeScript
- cURL
pip install anthropic
npm install @anthropic-ai/sdk
Nichts zu installieren — du brauchst nur curl.
3. Den Aufruf ausführen
Jede Anfrage ist eine Liste von messages. Das Modell antwortet mit content.
- Python
- TypeScript
- cURL
import anthropic
client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from the environment
message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[
{"role": "user", "content": "In one sentence, what is an API?"}
],
)
print(message.content[0].text)
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic(); // reads ANTHROPIC_API_KEY from the environment
const message = await client.messages.create({
model: "claude-sonnet-4-6",
max_tokens: 1024,
messages: [
{ role: "user", content: "In one sentence, what is an API?" },
],
});
console.log(message.content[0].text);
curl https://api.anthropic.com/v1/messages \
--header "x-api-key: $ANTHROPIC_API_KEY" \
--header "anthropic-version: 2023-06-01" \
--header "content-type: application/json" \
--data '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "In one sentence, what is an API?"}
]
}'
Was gerade passiert ist
model— welches Claude verwendet werden soll. Verdrahte es nicht blind fest; siehe Ein Modell auswählen.max_tokens— eine Obergrenze für die Antwortlänge (in Tokens). Es legt nicht das Kontextfenster fest.messages— die bisherige Konversation. Die API ist zustandslos: Um einen Chat fortzusetzen, sende jedes Mal den gesamten Verlauf zurück.system(optional) — eine übergeordnete Anweisung, die Claudes Rolle für den Aufruf festlegt.
Weiter
- Das richtige Modell wählen & Kosten schätzen → Ein Modell auswählen · Tokens & Preise
- Antworten streamen und eine Konversation führen → Streaming & mehrstufige Konversationen
- Claude deine Funktionen aufrufen lassen → Tool-Nutzung
- Produktionsreife Snippets → API-Snippets