Claude API: kom igång steg för steg

Kom igång

Vad är ett API och en API-nyckel?

Ett API är ett sätt för program att prata med varandra. Ditt program skickar en förfrågan till en adress på internet. Tjänsten svarar med data i ett fast format, oftast JSON, ett textformat för data.

Claude API fungerar på samma sätt. Ditt program skickar text till Claude, och Claudes svar kommer tillbaka till programmet.

En API-nyckel är ett lösenord som visar vem som skickar förfrågan, så att rätt konto får räkningen. Nyckeln är hemlig. Den som har din nyckel kan använda Claude på din bekostnad. Lägg därför aldrig nyckeln i koden, i ett mejl eller i git, programmet som sparar versioner av kod.

Vem är Claude API till för?

Claude API är för dig som vill att ett eget program ska använda Claude.

Apparna i del 1 räcker om du bara vill använda Claude själv. Claude Code i del 2 passar bättre om Claude ska skriva kod i dina filer.

Del 2 förklarar också terminalen, fönstret där du kör kommandona i den här guiden, och orden du möter där.

Exempel på sådant du kan bygga med Claude API:

• en chattbot på en webbplats
• ett skript som sammanfattar dokument
• en tjänst som sorterar kundmejl
• en egen AI-agent

Hur skapar man ett konto och en API-nyckel?

Kontot skapar du i Claude Console på platform.claude.com. Där köper du krediter, och Anthropic drar varje anrop från krediterna.

Nyckeln skapar du på sidan API keys i Console, platform.claude.com/settings/keys. Klicka på Create key, ge nyckeln ett namn och välj hur länge den ska gälla.

Console visar hela nyckeln bara en gång, enligt Anthropics guide om API-nyckeln. Nyckeln börjar med sk-ant-. Kopiera den direkt och spara den på ett säkert ställe, till exempel i en lösenordshanterare. Tappar du bort nyckeln skapar du en ny.

Nyckeln sparar du sedan i miljövariabeln ANTHROPIC_API_KEY. Anthropics programbibliotek, färdig kod som ditt program använder, läser variabeln automatiskt, enligt Anthropics snabbstart. Nyckeln behöver alltså aldrig stå i koden.

Kommandot export på Mac, Linux och WSL och kommandot med $env: i PowerShell gäller tills du stänger terminalfönstret. Med setx sparar Windows nyckeln för alla nya terminalfönster, enligt Anthropics sida om inloggning i deras CLI. Öppna ett nytt fönster efteråt, och byt ut exempelvärdet mot din egen nyckel.

export ANTHROPIC_API_KEY="your-api-key-here"

$env:ANTHROPIC_API_KEY = "your-api-key"

setx ANTHROPIC_API_KEY "sk-ant-api03-..."

Hur skickar man sitt första anrop till Claude API?

Claude API anropar du med curl direkt i terminalen eller med Anthropics programbibliotek för programspråken Python och TypeScript. Exemplen nedan kommer från Anthropics snabbstart. Alla exempel läser nyckeln från ANTHROPIC_API_KEY och ställer samma fråga till samma modell. Modellnamnet i exemplen gäller i skrivande stund, och de aktuella namnen står på Anthropics modellsida.

curl är ett program som skickar förfrågningar över nätet. Förfrågan går till https://api.anthropic.com/v1/messages med tre rubriker. Rubrikerna innehåller nyckeln, API-versionen och uppgiften att innehållet är JSON. Svaret kommer tillbaka som JSON, med Claudes text under content.

Curl-exemplet kör du på Mac, Linux eller WSL. Bakåtstrecken \ i slutet av raderna fungerar inte i PowerShell.

Python-biblioteket kräver Python 3.10 eller senare, enligt Anthropics sida om biblioteket. Skapa först en mapp och en virtuell miljö, en egen plats för projektets bibliotek. Installera sedan biblioteket anthropic med pip, Pythons installationsprogram. Spara koden som quickstart.py i mappen och kör den med python quickstart.py.

TypeScript-biblioteket @anthropic-ai/sdk installerar du med npm. Spara koden som quickstart.ts och kör den med npx tsx quickstart.ts. Programmet skriver ut Claudes svar i terminalen.

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2026-10-21" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1000,
    "messages": [
      {
        "role": "user",
        "content": "What should I search for to find the latest developments in renewable energy?"
      }
    ]
  }'

mkdir claude-quickstart && cd claude-quickstart
python3 -m venv .venv && source .venv/bin/activate
pip install anthropic

mkdir claude-quickstart
cd claude-quickstart
py -m venv .venv
.venv\Scripts\Activate.ps1
pip install anthropic

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What should I search for to find the latest developments in renewable energy?",
        }
    ],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

mkdir claude-quickstart && cd claude-quickstart
npm init -y
npm pkg set type=module
npm install @anthropic-ai/sdk

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const message = await client.messages.create({
  model: "claude-opus-5-5",
  max_tokens: 1000,
  messages: [
    {
      role: "user",
      content: "What should I search for to find the latest developments in renewable energy?"
    }
  ]
});

for (const block of message.content) {
  if (block.type === "text") {
    console.log(block.text);
  }
}

Hur är ett anrop till Claude uppbyggt?

Ett anrop till Messages API, den del av Claude API som tar emot samtal, har tre delar i alla Anthropics exempel. model säger vilken modell som ska svara. max_tokens säger hur långt svaret högst får bli. messages är samtalet.

Varje meddelande i samtalet har en roll. Rollen user är du, och rollen assistant är Claude.

API:t minns ingenting mellan anropen, påpekar Anthropic. Vill du fortsätta ett samtal skickar du med hela historiken varje gång.

En systemprompt lägger du i fältet system. Där står reglerna för hela samtalet, till exempel "svara alltid på svenska och kort". Hur du skriver bra instruktioner står i promptguiden.

Svaret har fältet stop_reason, som säger varför Claude slutade. Anthropics sida om stop reasons listar flera värden. end_turn betyder att svaret är klart. max_tokens betyder att gränsen nåddes. tool_use betyder att Claude vill använda ett verktyg.

Modeller och funktioner

Vilka modeller finns och vad kostar Claude API?

Claude API kostar per miljon tokens enligt Anthropics prissida, med ett pris för det du skickar in och ett högre pris för det Claude skriver. Större modeller kostar mer per token än mindre. Text som läses ur cachen kostar mindre, och frågor i en batch kostar mindre, som avsnitten om prompt caching och Batch API visar.

Opus kostar i skrivande stund 4 dollar per miljon tokens in och 20 dollar per miljon tokens ut, enligt Anthropics prissida. Priserna ändras, så kontrollera alltid prissidan.

Modellerna finns i fyra familjer, och Anthropic beskriver dem så här:

• Fable är den största familjen, för de svåraste och längsta uppgifterna.
• Opus är för komplext arbete och avancerad kod. Anthropic föreslår i skrivande stund att de flesta börjar med Opus.
• Sonnet är den balanserade familjen och passar för vardagligt kod- och agentarbete.
• Haiku är den snabbaste och billigaste familjen, enligt Anthropic.

Vad är streaming?

Streaming betyder att svaret kommer bit för bit medan Claude skriver, i stället för allt på en gång. Du slår på streaming med "stream": true i anropet. Svaret kommer då som server-sent events, en ström av små meddelanden.

Streaming får en chattbot att kännas snabb, eftersom användaren ser de första orden direkt.

Vad är tool use och function calling?

Tool use, även kallat function calling, låter Claude be ditt program om hjälp. Ett verktyg kan till exempel heta get_weather och ta emot en plats.

Verktygen beskriver du i fältet tools. Varje verktyg har ett namn i name, en beskrivning i description och ett schema i input_schema. Schemat talar om vilka uppgifter verktyget tar emot.

När Claude behöver verktyget slutar svaret med stop_reason satt till tool_use. I svaret finns ett block med verktygets namn och indata.

Ditt program kör verktyget och skickar tillbaka resultatet som ett tool_result i nästa meddelande. Claude skriver sedan svaret utifrån resultatet. De flesta AI-agenter fungerar så.

Anthropic har också färdiga verktyg som körs på Anthropics servrar, till exempel webbsökning, hämtning av webbsidor och kodkörning.

Vad är prompt caching?

Prompt caching låter Anthropic spara början av en fråga som du skickar många gånger, till exempel en lång systemprompt eller ett dokument. Du markerar den delen med cache_control. Nästa anrop läser då delen ur cachen, ett snabbminne, i stället för att räkna om den.

Cachen gäller i fem minuter som standard, enligt Anthropics sida om prompt caching. Varje gång cachen används förnyar Anthropic den utan extra kostnad.

Läsning ur cachen kostar bara en liten del av vanligt inpris, enligt sidan om prompt caching. Skrivning till cachen kostar något mer än vanligt inpris, och en cache som ska gälla längre kostar mer att skriva. Faktorerna för varje modell står på samma sida.

Vad är Batch API?

Batch API, även kallat Message Batches, låter dig skicka många frågor på en gång och få svaren senare, i skrivande stund till halva priset enligt Anthropic.

En batch har ett tak för antalet frågor och för storleken, och en batch som inte blir klar i tid löper ut, enligt Anthropics dokumentation. Taken och tiderna står i dokumentationen om batchbearbetning.

Batch passar för stora jobb som inte är bråttom, till exempel att sammanfatta tusentals dokument över natten.

Vad är Claude Agent SDK?

Claude Agent SDK är samma motor som driver Claude Code, som programbibliotek för Python och TypeScript. SDK står för software development kit, ett färdigt paket för den som bygger program.

Med SDK:n får ditt program Claude Codes agentslinga, sessioner och hooks. Dessutom får programmet verktyg för att läsa och ändra filer och köra kommandon. Du behöver inte bygga något av det själv.

SDK:n kräver Python 3.10 eller senare eller Node.js 18.14 eller senare, enligt Anthropics översikt över Agent SDK. Node.js är programmet som kör JavaScript och TypeScript utanför webbläsaren. Du behöver också en API-nyckel i ANTHROPIC_API_KEY.

python3 -m venv .venv
source .venv/bin/activate
pip install claude-agent-sdk

py -m venv .venv
.venv\Scripts\Activate.ps1
pip install claude-agent-sdk

npm init -y
npm pkg set type=module
npm install @anthropic-ai/claude-agent-sdk
npm install --save-dev tsx

Villkor och jämförelse

Vilka gränser har Claude API?

Claude API har gränser för hur mycket du får skicka. Anthropic räknar gränserna i förfrågningar per minut och i tokens per minut, både för det du skickar in och för det Claude skriver.

Felkoden 429 betyder att du har gått över en gräns. Svaret har ofta rubriken retry-after, som säger hur många sekunder du ska vänta.

Gränserna beror på vilken nivå kontot har. Anthropic flyttar upp kontot automatiskt efter hur det har använts och skötts, enligt dokumentationen.

Varje nivå har också ett tak för hur mycket du kan spendera per månad. Taken och gränserna för varje nivå står på Anthropics sida om rate limits.

Används dina data för att träna Claude?

Anthropic tränar inte sina modeller på det du skickar till API:t eller på svaren, enligt Anthropics integritetscenter i skrivande stund. API:t följer Anthropics kommersiella villkor.

Anthropic raderar indata och svar inom 30 dagar, enligt integritetscentret. Undantag gäller bland annat vid avtal om noll lagring, vid brott mot användarvillkoren och när lagen kräver det.

Zero Data Retention är ett avtal som företag kan teckna. Med avtalet sparar Anthropic inte frågor och svar efter att svaret har skickats, enligt Anthropics sida om datalagring i API:t.

Ansvaret för personuppgifter ligger hos dig när du bygger en tjänst åt andra. Är AI säkert? går igenom säkerheten i stort. Läs också om prompt injection, text som försöker lura en AI. Risken gäller även program som bygger på API:t.

Ingår API:t i Claude Pro?

Claude API ingår inte i Claude Pro. Anthropics hjälpsida anger att API:t faktureras separat från de betalda Claude-planerna. Max, Ultra och Team innehåller däremot månatliga krediter för Claude API, enligt samma sida.

Abonnemanget passar när du själv använder Claude. API:t passar när ett program ska göra det.

Claude API, OpenAI API eller Gemini API?

Claude API, OpenAI API och Gemini API är samma sorts tjänst från tre bolag, Anthropic, OpenAI och Google. Skillnaderna finns i modellerna, priserna och de färdiga verktygen.

Prova samma uppgift mot två av dem. Jämför kvalitet och kostnad innan du bygger vidare.

Vanliga frågor om Claude API