claude-api

Overview

Wobei claude-api hilft

Die Skill claude-api ist eine praxisnahe Referenz für die Entwicklung von LLM-gestützten Anwendungen mit Claude – unter Verwendung der Claude API, der offiziellen Anthropic SDKs und, wo verfügbar, der Agent SDK-Materialien. Sie ist nach Sprachen strukturiert, damit Entwickler schnell vom Setup zu funktionierenden Requests, Streaming-Antworten, Tool Use und Backend-Integrationsmustern kommen.

Diese Skill ist besonders nützlich, wenn du bereits weißt, dass du mit Claude arbeiten möchtest, und konkrete Implementierungshinweise statt eines allgemeinen KI-Überblicks brauchst. Das Repository enthält sprachspezifische Dokumentation für C#, Go, Java, PHP, Ruby, Python und TypeScript sowie rohe HTTP-Beispiele unter curl/.

Für wen diese Skill gedacht ist

claude-api passt besonders gut für:

• Backend-Entwickler, die Claude in Services, Worker und interne Tools integrieren
• API-Entwickler, die zwischen direkten HTTP-Aufrufen und offiziellen SDKs wählen
• Teams, die die Sprachunterstützung vergleichen, bevor sie sich auf Python, TypeScript, Go, Java, PHP, Ruby oder C# festlegen
• Entwickler, die Beispiele für Streaming, Tool Use, Batching, Files API-Nutzung und Fehlerbehandlung benötigen
• Agent-Builder, die die Agent SDK-Materialien für Python oder TypeScript nutzen

Welche Probleme damit gelöst werden

Statt verstreute Beispiele mühsam zusammenzusuchen, bietet dir claude-api einen strukturierten Einstieg für typische Implementierungsentscheidungen:

• Welches SDK oder welche API-Oberfläche verwendet werden sollte
• Mit welchem Sprachordner du zuerst beginnen solltest
• Wie die Authentifizierung mit ANTHROPIC_API_KEY funktioniert
• Wie du eine erste Message-Request sendest
• Wann Streaming bei langen Ausgaben die bessere Wahl ist
• Wo du Informationen zu Tool Use, Batches, Files API, Prompt Caching, Modellreferenzen und Fehlercodes findest

Die Skill enthält außerdem gemeinsame Referenzdateien wie shared/error-codes.md, shared/models.md, shared/prompt-caching.md, shared/live-sources.md und shared/tool-use-concepts.md. Das ist hilfreich, wenn du für das Backend-Verhalten mehr als nur ein minimales Hello-World-Beispiel brauchst.

Unterstützte Dokumentationsbereiche im Repository

Die Repository-Struktur zeigt diese Hauptbereiche:

• csharp/
• curl/
• go/
• java/
• php/
• python/agent-sdk
• python/claude-api
• ruby/
• typescript/agent-sdk
• typescript/claude-api
• shared/

Damit ist claude-api mehr als nur eine Sammlung einzelner Code-Snippets für eine Sprache. Am besten versteht man es als mehrsprachige Backend-Integrations-Skill für das Claude API-Ökosystem.

Wann claude-api gut passt

Verwende claude-api, wenn:

• Deine Codebasis anthropic, @anthropic-ai/sdk oder claude_agent_sdk importiert
• Du offizielle Nutzungsmuster der Anthropic SDKs einsetzen möchtest
• Du praxisnahe Beispiele für serverseitige Claude API-Integration brauchst
• Du vor der Implementierung sprachspezifische Installationshinweise suchst
• Du Funktionen wie Streaming, Tool Use, Batches oder Files API-Unterstützung verstehen musst

Wann claude-api nicht die richtige Wahl ist

Diese Skill ist nicht die beste Wahl, wenn:

• Dein Projekt ein anderes KI-Provider-SDK wie openai verwendet
• Du allgemeine Programmierhilfe brauchst, die nichts mit der Claude-Integration zu tun hat
• Du nach Frontend-UI-Mustern statt nach API- und Backend-Workflows suchst
• Du eine Sprache benötigst, die im Repository nicht abgedeckt ist, und keine rohen HTTP-Beispiele aus curl/ verwenden möchtest

How to Use

Die Skill installieren

Füge claude-api aus dem Anthropic Skills-Repository hinzu:

npx skills add https://github.com/anthropics/skills --skill claude-api

Beginne nach der Installation mit SKILL.md und wechsle dann in den Sprachordner, der zu deiner Codebasis passt.

Zuerst den richtigen Ordner wählen

Am schnellsten nutzt du claude-api effektiv, wenn du vor den Implementierungsdetails zuerst den passenden sprachspezifischen Pfad auswählst.

Sinnvolle Einstiegspunkte im Repository sind:

• SKILL.md
• csharp/claude-api.md
• curl/examples.md
• go/claude-api.md
• java/claude-api.md
• php/claude-api.md
• ruby/claude-api.md
• python/claude-api/README.md
• typescript/claude-api/README.md
• python/agent-sdk/README.md
• typescript/agent-sdk/README.md

Wenn du SDK-Support bewertest, bevor du dich für einen Stack entscheidest, lohnt es sich, mehrere Sprachordner nebeneinander zu vergleichen. Das Repository trennt klar zwischen direkter Claude API-Nutzung und Agent SDK-Anleitungen für Python und TypeScript.

Die passende Oberfläche zum Anwendungsfall wählen

Basierend auf der Repository-Struktur unterstützt claude-api mehrere praktische Wege:

• Verwende curl/examples.md für rohe HTTP-Requests oder nicht unterstützte Sprachen
• Verwende Sprachordner wie go/, java/, php/, ruby/ oder csharp/ für offizielle SDK-Muster
• Verwende python/claude-api/ oder typescript/claude-api/ für eine tiefere Themenabdeckung wie Streaming, Tool Use, Batches und Files API
• Verwende python/agent-sdk/ oder typescript/agent-sdk/, wenn dein Projekt auf Agent-Workflows statt nur auf direkten Message-Calls basiert

Diese Struktur ist für Installationsentscheidungen besonders nützlich, weil nicht jede Sprache dieselben Funktionen auf höherer Ebene bietet. So enthält das Repository ausdrücklich Agent SDK-Dokumentation für Python und TypeScript, während andere Sprachen sich auf die Nutzung der Claude API SDKs konzentrieren.

Authentifizierung sicher einrichten

In den Beispielen des gesamten Repositorys ist das Standardmuster die Verwendung der Umgebungsvariable ANTHROPIC_API_KEY statt hartcodierter Secrets. Dadurch passt claude-api gut zu produktionsreifen Backend-Workflows und CI-Umgebungen.

Bevor du Beispiele testest, stelle sicher, dass deine Laufzeitumgebung ANTHROPIC_API_KEY lesen kann.

Typische Installationspfade nach Sprache

Die Repository-Inhalte enthalten unter anderem diese Installationsbeispiele:

• C#: dotnet add package Anthropic
• Go: go get github.com/anthropics/anthropic-sdk-go
• PHP: composer require "anthropic-ai/sdk"
• Ruby: gem install anthropic
• Java: Abhängigkeitskonfiguration mit com.anthropic:anthropic-java
• Raw HTTP: curl gegen https://api.anthropic.com/v1/messages verwenden

Wenn du zwischen SDK und HTTP entscheidest, beginne bei unterstützten Sprachen am besten mit dem SDK und wechsle zu den Beispielen in curl/, wenn du Request-Kontrolle auf niedriger Ebene brauchst oder in einer anderen Sprache arbeitest.

Mit einer einfachen Message-Request beginnen

Die meisten Sprachleitfäden in claude-api folgen demselben praktischen Ablauf:

1. Einen Client initialisieren
2. Den API-Schlüssel aus der Umgebung lesen
3. Eine Message-Request mit einem Claude-Modell senden
4. Textblöcke aus der Antwort auslesen

Diese Konsistenz ist hilfreich, wenn Teams in mehreren Backend-Sprachen arbeiten. So lässt sich das Request-Muster standardisieren, auch wenn sich die Code-Syntax unterscheidet.

Streaming für lange Antworten nutzen

Das SKILL.md im Repository empfiehlt ausdrücklich, bei Requests mit potenziell langem Input, langem Output oder hohem max_tokens standardmäßig Streaming zu verwenden, da sich so Request-Timeouts vermeiden lassen. Dieser Hinweis ist eine der wichtigsten praktischen Erkenntnisse aus claude-api.

Wenn deine Anwendung lange Antworten, Zusammenfassungen, Tool-Loops oder längere Reasoning-Prozesse erzeugt, solltest du dir zuerst die Streaming-Dokumentation ansehen:

• python/claude-api/streaming.md
• typescript/claude-api/streaming.md
• Streaming-Abschnitte in sprachspezifischen Dateien wie go/claude-api.md, java/claude-api.md, ruby/claude-api.md und csharp/claude-api.md

Erweiterte Backend-Funktionen erkunden

Ein wichtiger Grund, claude-api zu installieren, statt sich nur auf einen einzelnen Quickstart zu verlassen, ist die tiefere Themenabdeckung im Repository. Relevante Dateien sind unter anderem:

• python/claude-api/tool-use.md
• typescript/claude-api/tool-use.md
• python/claude-api/batches.md
• typescript/claude-api/batches.md
• python/claude-api/files-api.md
• typescript/claude-api/files-api.md
• shared/tool-use-concepts.md
• shared/prompt-caching.md
• shared/models.md

Diese Inhalte sind besonders wertvoll für produktive Backend-Workflows, in denen mehr als nur ein einzelnes Request-Response-Beispiel benötigt wird.

Gemeinsame Referenzen für Troubleshooting nutzen

Wenn deine erste Integration fehlschlägt, enthält claude-api unterstützende Materialien, die bei Debugging und Planung helfen:

• shared/error-codes.md für die Bedeutung von HTTP-Fehlern, Retry-Fähigkeit und häufige Ursachen
• shared/models.md für modellbezogene Referenzen
• shared/live-sources.md für Hinweise zu Quellen

Besonders nützlich ist die Fehlercode-Referenz, weil sie zwischen retrybaren Zuständen wie 429, 500 und 529 sowie nicht retrybaren Request-Problemen wie 400 oder Authentifizierungsproblemen wie 401 unterscheidet.

Praktische Checkliste vor der Einführung von claude-api

Bevor du dich in einem Projekt für diese Skill entscheidest, frage dich:

• Brauchen wir offizielle SDK-Beispiele in einer der unterstützten Sprachen?
• Erwarten wir lange Ausgaben und brauchen deshalb Streaming-Hinweise?
• Benötigen wir Beispiele für Tool Use, Files API oder Batch-Verarbeitung?
• Entwickeln wir Agent-Workflows in Python oder TypeScript?
• Möchten wir einen Fallback über rohe HTTP-Requests mit curl?

Wenn du mehrere dieser Fragen mit Ja beantwortest, ist claude-api sehr wahrscheinlich eine gute Wahl.

FAQ

Was ist claude-api in diesem Repository?

claude-api ist eine Skill in anthropics/skills, die Entwicklern dabei hilft, Anwendungen mit der Claude API, den Anthropic SDKs und Agent SDK-Ressourcen zu entwickeln. Sie ist nach Sprachen organisiert und wird durch gemeinsame Referenzdokumente ergänzt.

Wie installiere ich claude-api?

Verwende:

npx skills add https://github.com/anthropics/skills --skill claude-api

Öffne danach SKILL.md und den Sprachordner, der zu deinem Stack passt.

Welche Sprachen deckt claude-api ab?

Die Repository-Struktur zeigt Dokumentation für C#, Go, Java, PHP, Ruby, Python, TypeScript sowie rohe HTTP-Beispiele mit curl.

Enthält claude-api Anleitungen zum Agent SDK?

Ja, aber laut Repository-Struktur befinden sich Agent SDK-Materialien speziell in python/agent-sdk/ und typescript/agent-sdk/. Wenn du Beispiele für Agent-Workflows suchst, solltest du dort zuerst nachsehen.

Hilft claude-api bei Streaming und Tool Use?

Ja. Das Repository enthält Dokumentation zu Streaming und Tool Use, insbesondere in den Claude API-Ordnern für Python und TypeScript. Außerdem enthalten mehrere sprachspezifische Leitfäden eigene Streaming-Abschnitte.

Ist claude-api nur für direkte API-Aufrufe gedacht?

Nein. Es deckt sowohl die direkte Nutzung der Claude API als auch SDK-basierte Integrationsmuster ab. Zusätzlich gibt es in curl/examples.md rohe HTTP-Beispiele für Entwickler, die kein SDK verwenden möchten oder in einer anderen Sprache arbeiten.

Wann sollte ich curl statt eines SDK verwenden?

Verwende curl, wenn du rohe HTTP-Beispiele brauchst, wenn deine Sprache in dieser Skill nicht durch ein offizielles SDK abgedeckt ist oder wenn du Request- und Response-Strukturen vor dem Einsatz einer Client-Bibliothek direkt prüfen möchtest.

Enthält claude-api Hinweise zur Fehlerbehandlung?

Ja. shared/error-codes.md dokumentiert HTTP-Fehlercodes, häufige Ursachen und welche Probleme retrybar sind. Dadurch ist claude-api nicht nur für das erste Setup nützlich, sondern auch für die Planung produktiver Integrationen.

Ist claude-api eine gute Wahl für allgemeine Programmierhilfe?

Nein. Die Repository-Beschreibung konzentriert sich auf die Nutzung der Claude API und der Anthropic SDKs. Wenn deine Aufgabe nichts mit Claude-Integration zu tun hat, ist diese Skill zu spezialisiert.

Was sollte ich nach der Installation von claude-api zuerst lesen?

Beginne mit SKILL.md und gehe dann zu der Datei weiter, die zu deiner Sprache und deinem Anwendungsfall passt. Für viele Teams ist diese Reihenfolge sinnvoll:

1. SKILL.md
2. Dein Sprachleitfaden wie go/claude-api.md oder php/claude-api.md
3. Themenspezifische Dokumente wie streaming.md, tool-use.md, batches.md oder files-api.md
4. Gemeinsame Referenzen wie shared/error-codes.md