Sådan integrerer du Claude API i din app

For at integrere Claude API skal du oprette en API-nøgle i Anthropics Claude Console, gemme den som en hemmelighed på serveren (normalt ANTHROPIC_API_KEY) og kalde Messages API fra en route på din egen server ved hjælp af et af Anthropics officielle SDK'er. Hver forespørgsel angiver en model, sætter max_tokens (det længste svar du accepterer) og sender samtalen som messages, mens dine instruktioner ligger i en separat system-prompt. Sæt en forbrugsgrænse, stream lange svar, og håndtér hastighedsgrænse-fejl (429) og overbelastningsfejl (529) med nye forsøg.

Denne guide dækker opsætning, et sikkert flow for forespørgsler, prompts til en AI-builder og de fejl, du skal være forberedt på. Anthropic-detaljerne er fra deres dokumentation fra september 2026. For hvordan tokens og priser fungerer generelt, se sådan bruger du LLM API'er.

Hvad du kan bygge med det

• Chatassistenter og hjælpewidgets (sådan bygger du en AI-chatbot-app)
• Resuméer, omskrivninger og udkast til svar
• Udtrækning af felter fra dokumenter, e-mails og formularer
• Besvarelse af spørgsmål ud fra dit eget indhold
• Agenter, der kalder din apps funktioner via tool use

For flere idéer, se sådan tilføjer du AI-funktioner til din app.

Messages API i korte træk

Ifølge Anthropics API-reference er en forespørgsel et POST til https://api.anthropic.com/v1/messages med:

API'et er statsløst: for at fortsætte en samtale skal du sende de tidligere tur igen med hver forespørgsel. Derfor koster lange chats mere pr. besked.

Anthropic udgiver officielle SDK'er til Python, TypeScript, C#, Go, Java, PHP og Ruby. De sætter headerne, læser svarene og understøtter streaming. Brug et af dem i stedet for rå HTTP, medmindre du har en god grund.

Valg af model

Anthropic tilbyder flere Claude-modeller, der veksler mellem kapacitet, hastighed og pris, og udvalget ændrer sig. Vælg den mindste model, der løser din opgave godt, test den på rigtige eksempler, og gem model-ID'et i konfigurationen, så du kan skifte uden en kodeændring. Tjek Anthropics sider for modeller og priser for de aktuelle muligheder og satser.

Opsætning af din konto

1. Log ind i Claude Console på platform.claude.com, og tilføj betaling.
2. Opret en API-nøgle. Hold én nøgle pr. miljø (test og produktion), så du kan tilbagekalde den ene uden at ødelægge den anden.
3. Sæt en forbrugsgrænse. Anthropics fejlside noterer, at når forbruget når en grænse, du har sat, returnerer API'et en 400-fejl, så din app bør vise en tydelig besked, når det sker.
4. Gennemgå hastighedsgrænserne for din konto i Console; de måles pr. organisation.

Forespørgselsflowet

1. Brugeren gør noget i din app: sender en besked, klikker på "Opsummer".
2. Browseren kalder din serverroute, aldrig Anthropic direkte.
3. Din server tjekker, at brugeren er logget ind og må bruge funktionen, og anvender en grænse pr. bruger.
4. Den bygger forespørgslen: en system-prompt med dine regler, brugerens input og eventuelle data, opgaven kræver fra din database.
5. Den kalder Messages API med nøglen fra miljøet og en fornuftig max_tokens.
6. Den streamer svaret til browseren og logger tokenforbrug fra svaret.

Muligheder og afvejninger

Prompts til din AI-builder

En første funktion:

Tilføj et "Spørg om dette dokument"-panel. Det kalder en serverroute POST /api/ask, som tjekker at brugeren er logget ind og ejer dokumentet, og derefter kalder Claude Messages API med det officielle Anthropic SDK og den hemmelige ANTHROPIC_API_KEY. Læs model-ID'et fra den hemmelige CLAUDE_MODEL. System-prompt: "Svar kun ud fra det givne dokument. Hvis svaret ikke står i det, så sig det." Send dokumentteksten og spørgsmålet, sæt max_tokens til 800, stream svaret til siden, og eksponér aldrig nøglen i browseren.

Beskyttelse og fejl:

Begræns hver bruger til 20 spørgsmål i timen, gemt i databasen. Log input- og output-tokens fra hvert svar sammen med bruger-ID og forespørgsels-ID. Ved 429- eller 529-fejl skal du prøve igen med eksponentiel backoff op til 3 gange og respektere eventuel retry-after-header, og derefter vise "Assistenten er travl, prøv igen om lidt." Hvis API'et melder om en fejl ved forbrugsgrænsen, vis "AI-funktioner er sat på pause" og underret administratoren.

Fejl du skal være forberedt på

Fra Anthropics fejldokumentation, dem din app faktisk vil møde:

Anthropics dokumentation siger, at de officielle SDK'er automatisk prøver igen ved midlertidige fejl (forbindelsesfejl, hastighedsgrænser og 5xx-fejl) to gange som standard med eksponentiel backoff, og at du kan konfigurere det. Hvert svar indeholder en request-id-header; log den, så support kan spore problemer.

Almindelige fejl

• At kalde API'et fra browseren. Din nøgle bliver offentlig. Gå altid gennem din server. Se sådan holder du API-nøgler sikre.
• At glemme at max_tokens er et loft, ikke et mål. Sæt det til det, funktionen har brug for; for lavt afkorter svar, for højt risikerer lange, dyre svar.
• At lægge regler i brugerbeskeden. Faste instruktioner hører hjemme i system-prompten; rettigheder hører hjemme i din kode.
• At sende hele chatten for evigt. Beskær eller opsummér gamle tur, efterhånden som samtaler vokser.
• Ingen forbrugsgrænse eller grænse pr. bruger.
• At hardcode et model-ID. Modeller opdateres og udfases.
• At ignorere stop-årsagen. Hvis svaret stoppede, fordi det ramte max_tokens, så fortæl brugeren det eller hæv loftet.

Tjekliste

• API-nøgle oprettet i Claude Console og gemt som en hemmelighed på serveren
• Separate nøgler til test og produktion
• Forbrugsgrænse sat; tydelig besked, når den er nået
• Alle forespørgsler går gennem din server med rettighedstjek
• System-prompten indeholder reglerne; model-ID er konfigurerbart
• max_tokens sat pr. funktion; lange svar streamet
• Grænse for forespørgsler pr. bruger i din app
• 429 og 529 håndteret med backoff; request-ID'er logget
• Venlig fejlvisning, der ikke ødelægger siden
• Testet med tomme, meget lange og fjendtlige input

Brug af Claude API i Mythex

I apps, du bygger på Mythex, bruger Claude-funktioner din egen Anthropic-nøgle og faktureres til din Anthropic-konto, ikke til Mythex-byggekreditter. Det er adskilt fra Mythex-agenten, der skriver din kode. Tilføj ANTHROPIC_API_KEY som en projekthemmelighed via /secrets, projektindstillinger eller hemmelighedskortet i chatten, og beskriv derefter funktionen med prompts som dem ovenfor. Publicér igen, efter du har ændret hemmeligheder på en live-app. Se Tilføj AI-funktioner med dine egne API-nøgler for en startprompt. Hvis du vælger mellem udbydere, dækker sådan integrerer du OpenAI API det samme for OpenAI.

Spørgsmål