Så integrerar du Claude API i din app

För att integrera Claude API skapar du en API-nyckel i Anthropics Claude Console, lagrar den som en hemlighet på servern (oftast ANTHROPIC_API_KEY) och anropar Messages API från en route på din egen server med något av Anthropics officiella SDK:er. Varje förfrågan anger en model, sätter max_tokens (det längsta svaret du accepterar) och skickar konversationen som messages, med dina instruktioner i en separat system-prompt. Sätt en utgiftsgräns, streama långa svar och hantera fel för hastighetsgräns (429) och överbelastning (529) med återförsök.

Guiden täcker installation, ett säkert flöde för förfrågningar, prompter för en AI-byggare och de fel du bör planera för. Uppgifterna om Anthropic kommer från deras dokumentation per september 2026. För hur tokens och priser fungerar i allmänhet, se hur du använder LLM-API:er.

Vad du kan bygga med det

Chattassistenter och hjälpwidgetar (hur du bygger en AI-chattbotapp)
Sammanfattningar, omskrivningar och utkast till svar
Extrahering av fält från dokument, mejl och formulär
Frågor och svar utifrån ditt eget innehåll
Agenter som anropar din apps funktioner via tool use

Fler idéer finns i hur du lägger till AI-funktioner i din app.

Messages API i korthet

Enligt Anthropics API-referens är en förfrågan ett POST till https://api.anthropic.com/v1/messages med:

Del	Vad det är
`x-api-key`-header	Din API-nyckel
`anthropic-version`-header	API-versionen, till exempel `2023-06-01`
`model` (obligatoriskt)	Vilken Claude-modell som ska användas
`max_tokens` (obligatoriskt)	Det största antal tokens svaret får innehålla; modellen kan sluta tidigare
`messages` (obligatoriskt)	Konversationen: växlande `user`- och `assistant`-turer
`system` (valfritt)	Instruktioner som gäller hela konversationen
`stream` (valfritt)	Sätt till `true` för att ta emot svaret när det skrivs, via server-sent events

API:et är tillståndslöst: för att fortsätta en konversation skickar du de tidigare turerna igen med varje förfrågan. Därför kostar långa chattar mer per meddelande.

Anthropic publicerar officiella SDK:er för Python, TypeScript, C#, Go, Java, PHP och Ruby. De sätter headrarna, tolkar svaren och stödjer streaming. Använd ett av dem i stället för rå HTTP om du inte har en särskild anledning.

Välja modell

Anthropic erbjuder flera Claude-modeller som avväger förmåga mot hastighet och pris, och utbudet förändras. Välj den minsta modell som klarar uppgiften väl, testa den på riktiga exempel och håll modell-ID:t i konfigurationen så att du kan byta utan kodändring. Kontrollera Anthropics sidor för modeller och priser för aktuella alternativ och priser.

Sätta upp ditt konto

Logga in i Claude Console på platform.claude.com och lägg till fakturering.
Skapa en API-nyckel. Ha en nyckel per miljö (test och produktion) så att du kan återkalla en utan att bryta den andra.
Sätt en utgiftsgräns. Anthropics felsida noterar att när användningen når en gräns du satt returnerar API:et ett 400-fel, så din app bör visa ett tydligt meddelande när det händer.
Granska hastighetsgränserna för ditt konto i Console; de mäts per organisation.

Flödet för en förfrågan

Användaren agerar i din app: skickar ett meddelande, klickar på ”Sammanfatta”.
Webbläsaren anropar din serverroute, aldrig Anthropic direkt.
Din server kontrollerar att användaren är inloggad och får använda funktionen, och tillämpar en gräns per användare.
Den bygger förfrågan: en systemprompt med dina regler, användarens indata och eventuell data från din databas som uppgiften behöver.
Den anropar Messages API med nyckeln från miljön och ett rimligt max_tokens.
Den streamar svaret till webbläsaren och loggar tokenanvändningen från svaret.

Alternativ och avvägningar

Beslut	Enkelt val	När du bör gå längre
Streaming	Vänta på hela svaret	Streama för chatt och allt långt; Anthropic rekommenderar streaming eller batcher för långvariga förfrågningar
Utdataformat	Vanlig text	Strukturerad JSON-utdata när din kod behöver läsa fält
Din data	Ta med relevant post	Sökning i ditt innehåll när det är för mycket (vad RAG är)
Åtgärder	Modellen skriver bara text	Tool use, där modellen ber din kod köra en funktion du definierat
Stora, icke brådskande jobb	Loopa över objekten	Message Batches API, som du skickar in och hämtar resultat från senare

Prompter att ge din AI-byggare

En första funktion:

Lägg till en panel ”Fråga om det här dokumentet”. Den anropar en serverroute POST /api/ask som kontrollerar att användaren är inloggad och äger dokumentet, och anropar sedan Claude Messages API med det officiella Anthropic SDK:t och hemligheten ANTHROPIC_API_KEY. Läs modell-ID:t från hemligheten CLAUDE_MODEL. Systemprompt: ”Svara endast utifrån det angivna dokumentet. Om svaret inte finns där, säg det.” Skicka dokumenttexten och frågan, sätt max_tokens till 800, streama svaret till sidan och exponera aldrig nyckeln för webbläsaren.

Skydd och fel:

Begränsa varje användare till 20 frågor per timme, lagrat i databasen. Logga indata- och utdatatokens från varje svar tillsammans med användar-ID och förfrågans ID. Vid 429- eller 529-fel, försök igen med exponentiell backoff upp till 3 gånger och respektera eventuell retry-after-header, visa sedan ”Assistenten är upptagen, försök igen snart.” Om API:et rapporterar ett fel för utgiftsgräns, visa ”AI-funktionerna är pausade” och larma administratören.

Fel att planera för

Från Anthropics felsdokumentation, de du faktiskt kommer att möta i din app:

Kod	Typ	Vad du gör
400	`invalid_request_error`	Rätta förfrågan; returneras också när du nått en utgiftsgräns du satt
401	`authentication_error`	Kontrollera att nyckeln finns, är korrekt och inte återkallad
413	`request_too_large`	Skicka mindre; Messages API accepterar upp till 32 MB per förfrågan
429	`rate_limit_error`	Backa och försök igen, respektera `retry-after`
500	`api_error`	Försök igen med backoff; kontakta supporten med förfrågans ID om det kvarstår
529	`overloaded_error`	Tillfällig hög trafik från alla användare; backa och försök igen

Anthropics dokumentation säger att de officiella SDK:erna automatiskt försöker igen vid tillfälliga fel (anslutningsfel, hastighetsgränser och 5xx-fel) två gånger som standard med exponentiell backoff, och det går att konfigurera. Varje svar innehåller en request-id-header; logga den så att supporten kan spåra problem.

Vanliga misstag

Att anropa API:et från webbläsaren. Din nyckel blir offentlig. Gå alltid via din server. Se hur du håller API-nycklar säkra.
Att glömma att max_tokens är ett tak, inte ett mål. Sätt det efter vad funktionen behöver; för lågt klipper svaren, för högt riskerar långa, dyra svar.
Att lägga regler i användarmeddelandet. Stabila instruktioner hör hemma i system-prompten; behörigheter hör hemma i din kod.
Att skicka hela chatten för evigt. Klipp eller sammanfatta gamla turer när konversationerna växer.
Ingen utgiftsgräns eller gräns per användare.
Att hårdkoda ett modell-ID. Modeller uppdateras och utgår.
Att ignorera stoppskälet. Om svaret stoppades för att det nådde max_tokens, säg det till användaren eller höj taket.

Checklista

API-nyckel skapad i Claude Console och lagrad som en hemlighet på servern
Separata nycklar för test och produktion
Utgiftsgräns satt; tydligt meddelande när den nås
Alla förfrågningar går via din server med behörighetskontroll
Systemprompten innehåller reglerna; modell-ID är konfigurerbart
max_tokens satt per funktion; långa svar streamas
Gräns per användare i din app
429 och 529 hanteras med backoff; förfrågans ID loggas
Vänligt feltillstånd som inte bryter sidan
Testat med tomma, mycket långa och fientliga indata

Använda Claude API i Mythex

I appar du bygger på Mythex använder Claude-funktioner din egen Anthropic-nyckel och faktureras till ditt Anthropic-konto, inte till Mythex-byggkrediter. Det är skilt från agenten i Mythex som skriver din kod. Lägg till ANTHROPIC_API_KEY som en projekthemlighet via /secrets, projektinställningarna eller hemlighetskortet i chatten, och beskriv sedan funktionen med prompter som de ovan. Publicera igen efter att du ändrat hemligheter i en live-app. Se Lägg till AI-funktioner med egna API-nycklar för en startprompt. Jämför du leverantörer täcker hur du integrerar OpenAI API samma område för OpenAI.

Frågor

Hur får jag en Claude API-nyckel?

Logga in i Claude Console på platform.claude.com, ställ in fakturering och skapa en API-nyckel. Lagra den som en hemlighet på servern, konventionellt kallad ANTHROPIC_API_KEY, och lägg den aldrig i kod som körs i webbläsaren.

Vad behöver en förfrågan till Claude API?

Enligt Anthropics referens för Messages API i september 2026 har begäran tre obligatoriska fält: model, max_tokens och messages. Direkta HTTP-anrop behöver också headrarna x-api-key och anthropic-version. De officiella SDK:erna sätter dem åt dig.

Vad är ett 529-fel från Claude API?

Anthropics felsida beskriver 529 som overloaded_error: API:et är tillfälligt överbelastat på grund av hög trafik från alla användare. Försök igen med exponentiell backoff. De officiella SDK:erna försöker automatiskt igen vid vissa tillfälliga fel.

Kan jag använda Claude med kod skriven för OpenAI SDK?

Anthropic dokumenterar ett kompatibilitetslager för OpenAI SDK, så att du kan använda Claude via OpenAI SDK:s gränssnitt. För ny kod ger Anthropics egna SDK:er tillgång till Claude-specifika funktioner, så de är oftast den bättre utgångspunkten.