• Messages
  • Managed Agents
  • Admin

Search...
⌘K
Erste Schritte
Einführung in ClaudeSchnellstart
Entwickeln mit Claude
FunktionsübersichtVerwendung der Messages APIStoppgründe und FallbackAblehnungen und FallbackFallback-Guthaben
Modellfähigkeiten
Erweitertes DenkenAdaptives DenkenEffortAufgabenbudgets (Beta)Schnellmodus (Forschungsvorschau)Strukturierte AusgabenZitateStreaming von NachrichtenBatch-VerarbeitungSuchergebnisseStreaming von AblehnungenMehrsprachige UnterstützungEmbeddings
Tools
ÜbersichtFunktionsweise der Tool-NutzungTutorial: Einen Tool-nutzenden Agenten erstellenTools definierenTool-Aufrufe verarbeitenParallele Tool-NutzungTool Runner (SDK)Strikte Tool-NutzungTool-Nutzung mit Prompt-CachingServer-ToolsFehlerbehebungWebsuche-ToolWeb-Fetch-ToolCodeausführungs-ToolAdvisor-ToolMemory-ToolBash-ToolComputer-Use-ToolTexteditor-Tool
Tool-Infrastruktur
Tool-ReferenzTool-Kontext verwaltenTool-KombinationenTool-SucheProgrammatische Tool-AufrufeFeingranulares Tool-Streaming
Kontextverwaltung
KontextfensterKompaktierungKontextbearbeitungPrompt-CachingSystemnachrichten während der KonversationEinen Orchestrierungsmodus erstellenCache-Diagnose (Beta)Token-Zählung
Arbeiten mit Dateien
Files APIPDF-UnterstützungBilder und Vision
Skills
ÜbersichtSchnellstartBest PracticesSkills für UnternehmenSkills in der API
MCP
Remote-MCP-ServerMCP-Connector
Claude auf Cloud-Plattformen
Amazon BedrockAmazon Bedrock (Legacy)Claude Platform auf AWSMicrosoft FoundryVertex AI

Log in
Token-Zählung
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Claude on AWS
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Messages/Kontextverwaltung

Token-Zählung

Die Token-Zählung ermöglicht es dir, die Anzahl der Tokens in einer Nachricht zu ermitteln, bevor du sie an Claude sendest. So kannst du fundierte Entscheidungen über deine Prompts und deine Nutzung treffen. Mit der Token-Zählung kannst du

  • Ratenlimits und Kosten proaktiv verwalten
  • Intelligente Entscheidungen zum Modell-Routing treffen
  • Prompts auf eine bestimmte Länge optimieren


Diese Funktion ist für Zero Data Retention (ZDR) qualifiziert. Wenn deine Organisation eine ZDR-Vereinbarung hat, werden Daten, die über diese Funktion gesendet werden, nicht gespeichert, nachdem die API-Antwort zurückgegeben wurde.


So zählst du Tokens in Nachrichten

Der Endpunkt für die Token-Zählung akzeptiert dieselbe strukturierte Liste von Eingaben wie beim Erstellen einer Nachricht, einschließlich Unterstützung für System-Prompts, Tools, Bilder und PDFs. Die Antwort enthält die Gesamtzahl der Eingabe-Tokens.



Die Token-Anzahl sollte als Schätzung betrachtet werden. In manchen Fällen kann die tatsächliche Anzahl der beim Erstellen einer Nachricht verwendeten Eingabe-Tokens geringfügig abweichen.

Token-Zählungen können Tokens enthalten, die von Anthropic automatisch für Systemoptimierungen hinzugefügt werden. Vom System hinzugefügte Tokens werden dir nicht in Rechnung gestellt. Die Abrechnung spiegelt nur deine Inhalte wider.

Unterstützte Modelle

Alle aktiven Modelle unterstützen die Token-Zählung.

Tokens in einfachen Nachrichten zählen

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-8",
    system="You are a scientist",
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(response.json())
Output
{ "input_tokens": 14 }

Tokens in Nachrichten mit Tools zählen



Token-Zählungen für Server-Tools gelten nur für den ersten Sampling-Aufruf.

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-8",
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA",
                    }
                },
                "required": ["location"],
            },
        }
    ],
    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
)

print(response.json())
Output
{ "input_tokens": 403 }

Tokens in Nachrichten mit Bildern zählen

import base64
import httpx

image_url = "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
image_media_type = "image/jpeg"
image_data = base64.standard_b64encode(httpx.get(image_url).content).decode("utf-8")

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-8",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image_media_type,
                        "data": image_data,
                    },
                },
                {"type": "text", "text": "Describe this image"},
            ],
        }
    ],
)
print(response.json())
Output
{ "input_tokens": 1551 }

Tokens in Nachrichten mit erweitertem Denken zählen



Weitere Details findest du unter Wie das Kontextfenster mit erweitertem Denken berechnet wird

  • Thinking-Blöcke aus vorherigen Assistant-Turns werden ignoriert und zählen nicht zu deinen Eingabe-Tokens
  • Das Denken des aktuellen Assistant-Turns zählt zu deinen Eingabe-Tokens
client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-sonnet-4-6",
    thinking={"type": "enabled", "budget_tokens": 16000},
    messages=[
        {
            "role": "user",
            "content": "Are there an infinite number of prime numbers such that n mod 4 == 3?",
        },
        {
            "role": "assistant",
            "content": [
                {
                    "type": "thinking",
                    "thinking": "This is a nice number theory question. Let's think about it step by step...",
                    "signature": "EuYBCkQYAiJAgCs1le6/Pol5Z4/JMomVOouGrWdhYNsH3ukzUECbB6iWrSQtsQuRHJID6lWV...",
                },
                {
                    "type": "text",
                    "text": "Yes, there are infinitely many prime numbers p such that p mod 4 = 3...",
                },
            ],
        },
        {"role": "user", "content": "Can you write a formal proof?"},
    ],
)

print(response.json())
Output
{ "input_tokens": 88 }

Tokens in Nachrichten mit PDFs zählen



Die Token-Zählung unterstützt PDFs mit denselben Einschränkungen wie die Messages API.

import base64
import anthropic

client = anthropic.Anthropic()

with open("document.pdf", "rb") as pdf_file:
    pdf_base64 = base64.standard_b64encode(pdf_file.read()).decode("utf-8")

response = client.messages.count_tokens(
    model="claude-opus-4-8",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "base64",
                        "media_type": "application/pdf",
                        "data": pdf_base64,
                    },
                },
                {"type": "text", "text": "Please summarize this document."},
            ],
        }
    ],
)

print(response.json())
Output
{ "input_tokens": 2188 }

Token-Zählungen bei Claude Fable 5 und Claude Mythos 5

Claude Fable 5 und Claude Mythos 5 verwenden den mit Claude Opus 4.7 eingeführten Tokenizer, der für denselben Text etwa 30 % mehr Tokens erzeugt als Modelle vor Claude Opus 4.7. Der Endpunkt für die Token-Zählung gibt die Anzahl gemäß dem Tokenizer des von dir übergebenen model zurück. Um den Unterschied für deinen Workload zu messen, zähle dieselbe Anfrage zweimal: einmal mit deinem aktuellen Modell und einmal mit model: "claude-fable-5" (oder "claude-mythos-5"), und vergleiche die beiden input_tokens-Werte.



Abrechnung und Migration: Nutzung und Abrechnung bei Claude Fable 5 und Claude Mythos 5 spiegeln die Zählungen dieses Tokenizers wider. Wenn du von einem Modell vor Claude Opus 4.7 migrierst, verbraucht derselbe Inhalt etwa 30 % mehr Tokens. Verwende bei der Migration eines Workloads zu Claude Fable 5 und Claude Mythos 5 keine Token-Zählungen, die mit einem Modell vor Claude Opus 4.7 gemessen wurden, um Kosten oder die Passung ins Kontextfenster abzuschätzen. Zähle deine Prompts mit model: "claude-fable-5" (oder "claude-mythos-5").


Preise und Ratenlimits

Die Token-Zählung ist kostenlos nutzbar, unterliegt jedoch Ratenlimits für Anfragen pro Minute basierend auf deiner Nutzungsstufe. Wenn du höhere Limits benötigst, kontaktiere den Vertrieb über die Claude Console.

NutzungsstufeAnfragen pro Minute (RPM)
1100
22.000
34.000
48.000


Token-Zählung und Nachrichtenerstellung haben separate und unabhängige Ratenlimits. Die Nutzung des einen wird nicht auf die Limits des anderen angerechnet.


FAQ

Was this page helpful?

  • So zählst du Tokens in Nachrichten
  • Unterstützte Modelle
  • Tokens in einfachen Nachrichten zählen
  • Tokens in Nachrichten mit Tools zählen
  • Tokens in Nachrichten mit Bildern zählen
  • Tokens in Nachrichten mit erweitertem Denken zählen
  • Tokens in Nachrichten mit PDFs zählen
  • Token-Zählungen bei Claude Fable 5 und Claude Mythos 5
  • Preise und Ratenlimits
  • FAQ