Slik integrerer du Claude API i appen din

For å integrere Claude API lager du en API-nøkkel i Anthropics Claude Console, lagrer den som en hemmelighet på serveren (vanligvis ANTHROPIC_API_KEY), og kaller Messages API fra en rute på din egen server ved hjelp av en av Anthropics offisielle SDK-er. Hver forespørsel angir en modell, setter max_tokens (det lengste svaret du godtar) og sender samtalen som messages, med instruksjonene dine i en egen system-prompt. Sett en forbruksgrense, strøm lange svar, og håndter feil for hastighetsgrenser (429) og overbelastning (529) med nye forsøk.

Denne guiden dekker oppsett, en sikker forespørselsflyt, ledetekster for en AI-appbygger og feilene du bør planlegge for. Anthropic-detaljene er hentet fra dokumentasjonen deres per september 2026. For hvordan tokens og priser fungerer generelt, se slik bruker du LLM-API-er.

Hva du kan bygge med det

• Chatassistenter og hjelpevinduer (slik bygger du en AI-chatbot-app)
• Oppsummeringer, omskrivinger og utkast til svar
• Å hente felt fra dokumenter, e-poster og skjemaer
• Å svare på spørsmål fra ditt eget innhold
• Agenter som kaller funksjonene i appen din gjennom verktøybruk

For flere ideer, se slik legger du til AI-funksjoner i appen din.

Messages API i korte trekk

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

API-et er statsløst: for å fortsette en samtale må du sende de tidligere rundene på nytt med hver forespørsel. Det er derfor lange chatter koster mer per melding.

Anthropic publiserer offisielle SDK-er for Python, TypeScript, C#, Go, Java, PHP og Ruby. De setter headerne, leser svarene og støtter strømming. Bruk en av dem i stedet for rå HTTP med mindre du har en god grunn til det.

Velge en modell

Anthropic tilbyr flere Claude-modeller som veksler mellom kapasitet, hastighet og pris, og utvalget endres. Velg den minste modellen som gjør oppgaven din godt, test den på ekte eksempler, og hold modell-ID-en i konfigurasjonen slik at du kan bytte uten kodeendring. Sjekk Anthropics sider for modeller og priser for gjeldende valg og satser.

Sette opp kontoen din

1. Logg inn i Claude Console på platform.claude.com og legg til betaling.
2. Lag en API-nøkkel. Ha én nøkkel per miljø (test og produksjon), slik at du kan tilbakekalle én uten å knekke den andre.
3. Sett en forbruksgrense. Anthropics feilside nevner at når forbruket når en grense du har satt, returnerer API-et en 400-feil, så appen din bør vise en tydelig melding når det skjer.
4. Se gjennom hastighetsgrensene for kontoen din i Console; de måles per organisasjon.

Forespørselsflyten

1. Brukeren handler i appen din: sender en melding, klikker «Oppsummer».
2. Nettleseren kaller din serverrute, aldri Anthropic direkte.
3. Serveren din sjekker at brukeren er innlogget og har lov til å bruke funksjonen, og bruker en grense per bruker.
4. Den bygger forespørselen: en systemprompt med reglene dine, brukerens inndata og eventuelle data fra databasen din som oppgaven trenger.
5. Den kaller Messages API med nøkkelen fra miljøet og en fornuftig max_tokens.
6. Den strømmer svaret til nettleseren og logger tokenforbruket fra svaret.

Valg og avveininger

Ledetekster til AI-appbyggeren din

En første funksjon:

Legg til et panel «Spør om dette dokumentet». Det kaller en serverrute POST /api/ask som sjekker at brukeren er innlogget og eier dokumentet, og kaller Claude Messages API med den offisielle Anthropic-SDK-en og hemmeligheten ANTHROPIC_API_KEY. Les modell-ID-en fra hemmeligheten CLAUDE_MODEL. Systemprompt: «Svar bare ut fra dokumentet som er gitt. Hvis svaret ikke står der, si det.» Send dokumentteksten og spørsmålet, sett max_tokens til 800, strøm svaret til siden, og eksponer aldri nøkkelen for nettleseren.

Sikkerhetsrekkverk og feil:

Begrens hver bruker til 20 spørsmål per time, lagret i databasen. Logg inndata- og utdatatokens fra hvert svar med bruker-ID og forespørsels-ID. Ved 429- eller 529-feil, prøv igjen med eksponentiell backoff opptil 3 ganger, og respekter eventuell retry-after-header; vis deretter «Assistenten er opptatt, prøv igjen om litt.» Hvis API-et melder en feil for forbruksgrense, vis «AI-funksjoner er satt på pause» og varsle administratoren.

Feil du bør planlegge for

Fra Anthropics dokumentasjon om feil, de appen din faktisk vil møte:

Anthropics dokumentasjon sier at de offisielle SDK-ene automatisk prøver på nytt ved midlertidige feil (tilkoblingsfeil, hastighetsgrenser og 5xx-feil) to ganger som standard, med eksponentiell backoff, og at dette kan konfigureres. Hvert svar har en request-id-header; logg den, slik at support kan spore problemer.

Vanlige feil

• Å kalle API-et fra nettleseren. Nøkkelen din blir offentlig. Gå alltid via serveren din. Se slik holder du API-nøkler trygge.
• Å glemme at max_tokens er en grense, ikke et mål. Sett den til det funksjonen trenger; for lav kutter av svarene, for høy gir lange, kostbare svar.
• Å legge reglene i brukermeldingen. Faste instruksjoner hører hjemme i system-prompten; tillatelser hører hjemme i koden din.
• Å sende hele chatten for alltid. Kutt ned eller oppsummer eldre runder etter hvert som samtalene vokser.
• Ingen forbruksgrense eller grense per bruker.
• Å hardkode en modell-ID. Modeller oppdateres og utfases.
• Å ignorere stoppårsaken. Hvis svaret stoppet fordi det nådde max_tokens, si det til brukeren eller øk grensen.

Sjekkliste

• API-nøkkel laget i Claude Console og lagret som en hemmelighet på serveren
• Separate nøkler for test og produksjon
• Forbruksgrense satt; tydelig melding når den er nådd
• Alle forespørsler går via serveren din med tillatelsessjekk
• Systemprompten holder reglene; modell-ID-en kan konfigureres
• max_tokens satt per funksjon; lange svar strømmes
• Grense for forespørsler per bruker i appen din
• 429 og 529 håndtert med backoff; forespørsels-ID-er logget
• Vennlig feiltilstand som ikke knekker siden
• Testet med tomme, svært lange og fiendtlige inndata

Bruke Claude API i Mythex

I apper du bygger på Mythex bruker Claude-funksjoner din egen Anthropic-nøkkel, og de faktureres på din Anthropic-konto, ikke på Mythex-byggekreditter. Det er adskilt fra Mythex-agenten som skriver koden din. Legg til ANTHROPIC_API_KEY som en hemmelighet i prosjektet via /secrets, prosjektinnstillinger eller hemmelighetskortet i chatten, og beskriv deretter funksjonen med ledetekster som de over. Publiser på nytt etter at du har endret hemmeligheter i en live-app. Se Legg til AI-funksjoner med dine egne API-nøkler for en startprompt. Hvis du velger mellom leverandører, dekker slik integrerer du OpenAI API det samme for OpenAI.

Spørsmål