Skip to content
SVENNISAIWe speak Claude.
Blog · Claude API

Cheia API Claude: cum o creezi în Claude Console și ce plătești

Ghid pas cu pas pentru cheia API Claude: organizația firmei în Claude Console, workspace-uri, crearea și păstrarea cheii, costuri și creditele lunare din Team și Max.

10 min de citit
Articol · 10 min de citit
O cheie de alamă băgată într-un contor electric, cu o stivă de monede alături: acces plătit după consum.

Cheia API Claude pe scurt: ce este și cum o obține o firmă

Cheia API Claude (în engleză, Claude API key) o creezi în Claude Console, pe o organizație deschisă pe numele firmei. Pașii sunt puțini. Faci organizația și un workspace, apeși Create Key și copiezi cheia o singură dată. Apoi cumperi credite și pui cheia într-o variabilă de mediu. Ghidul de mai jos ia fiecare pas pe rând.

Cheia API este un cod unic de acces prin care un program al firmei se autentifică și folosește modelele Claude. Tot prin ea urmărești consumul fiecărei integrări. Documentația Anthropic cere un cont în Claude Console și o metodă de autentificare, potrivit ghidului de start al platformei Claude. Pentru lucrul pe calculatorul programatorului, ghidul recomandă acum conectarea din linia de comandă, cu ant auth login. Pentru un program care rulează singur, pe server, rămâne cheia API.

Același lucru circulă și sub alte nume. API-ul Claude se numește oficial și Anthropic API, după compania care face Claude. De aici vin căutări ca „anthropic api key” sau „Anthropic Console”. Ghidurile mai vechi folosesc des aceste denumiri.

Cheia nu înlocuiește abonamentul. Claude Team sau Max îi dau Claude oamenilor, în aplicație și în browser. Cheia API servește aplicațiile și agenții pe care îi construiești tu. Dacă diferența nu e încă limpede, ghidul despre ce este Claude o explică pe înțeles.

Organizația din Claude Console trebuie să fie a firmei, nu a unui angajat

Organizația din Claude Console este contul de vârf al firmei pe platforma Claude. În ea stau workspace-urile, membrii, cheile și plata. Deschide-o pe o adresă de e-mail a firmei, la care au acces cel puțin doi oameni.

Greșeala clasică e cheia făcută de un angajat pe contul lui personal. Merge bine până când angajatul pleacă sau își schimbă cardul. Atunci integrarea se oprește. Nimeni din firmă nu mai are acces să facă o cheie nouă.

Organizația are și o parte de administrare pentru oamenii tehnici. Unele operații de administrare se fac prin API, nu doar din interfață. Schimbarea rolului unui cont de serviciu cere un token OAuth cu scope-ul org:admin. Tokenul vine din comanda ant auth login --scope org:admin, iar cheile Admin API nu sunt acceptate pentru operația asta. Pentru tine, concluzia e simplă: drepturile de administrator stau la un om de încredere, nu la toată echipa.

Înainte să creezi prima cheie, stabilește trei lucruri:

  • cine deține organizația și cine îl înlocuiește;
  • cu ce metodă de plată cumpără firma credite;
  • cine are voie să creeze chei noi.

Workspace-urile separă proiectele și rolurile din organizație

Un workspace este o zonă separată în organizația din Claude Console, cu membrii și rolurile ei. Fiecare workspace are un identificator propriu, care începe cu wrkspc_. Un workspace pe proiect sau pe departament ține lucrurile curate. Agentul de oferte stă într-o parte, testele echipei tehnice în alta.

Documentația API listează cinci roluri de workspace:

  • workspace_admin
  • workspace_billing
  • workspace_developer
  • workspace_restricted_developer
  • workspace_user

Dă fiecărui om rolul cel mai mic cu care își poate face treaba. Un cont de serviciu (service account) este o identitate pentru un program, nu pentru un om. Identificatorul lui începe cu svac_. Fiecare cont de serviciu are automat un membership implicit în workspace-ul implicit, cu rolul workspace_user, care nu poate fi șters.

Un cont de serviciu nu poate primi rolul workspace_billing. Pentru firma ta, asta înseamnă că facturarea rămâne la oameni, nu la programe.

Două detalii contează la curățenie. Un workspace arhivat întoarce eroarea 400 la cereri. Lista membrilor unui workspace nu include membership-ul implicit. Un audit făcut doar pe listă poate scăpa un cont de serviciu.

Crearea cheii API în Claude Console, pas cu pas

Cheia API se creează din meniul din stânga al Console. Intri pe API keys, apoi apeși Create Key. Fereastra următoare îți arată cheia o singură dată și nu se mai deschide. Dacă pierzi cheia, faci alta.

Pașii, în ordine:

  1. Intri în Claude Console cu contul firmei.
  2. Alegi API keys din meniul din stânga.
  3. Apeși Create Key și dai cheii numele integrării pe care o servește.
  4. Copiezi cheia direct în managerul de parole al firmei sau într-un secret manager.

Fă o cheie separată pentru fiecare automatizare nouă. Fiecare conexiune are astfel cheia ei. Consumul și o eventuală scurgere se văd pe integrare, nu pe toată firma.

Comenzile de mai jos instalează SDK-ul oficial pentru Python și pun cheia într-o variabilă de mediu. Le rulezi în terminal, pe calculatorul sau pe serverul unde va rula programul.

# pasul 1: SDK-ul Anthropic pentru Python
pip install anthropic

# pasul 2: cheia API pentru SDK
export ANTHROPIC_API_KEY="cheia-copiata-din-console"

Schimbi doar textul dintre ghilimele cu cheia ta. SDK-ul citește automat variabila ANTHROPIC_API_KEY. Cheia nu apare deloc în codul programului.

Ce plătești pentru API: consum în tokeni, credite și limite de rată

Pe API plătești consumul, nu un abonament pe persoană. Anthropic taxează textul trimis (input) și textul primit (output). Taxează separat și prompt caching-ul, adică salvarea unor părți din prompt pentru cererile următoare. Tariful depinde de model. Prețurile curente pe model, în euro, sunt în pagina cu prețurile Claude.

Tokenii sunt bucăți de text. Un prompt mai lung folosește mai mulți tokeni și costă mai mult. Pentru o estimare înainte de lansare, Anthropic are un endpoint de numărare a tokenilor.

Ca să folosești API-ul, cumperi credite în Console. Un autor de pe Reddit avertizează că, în experiența lui, creditele API expiră la 12 luni de la cumpărare. Cumpără deci cât consumi într-o perioadă scurtă. Înainte să dai cheia mai departe, verifică în Console ce limite de cheltuială poți seta.

Utilizarea foarte mare poate declanșa limite de rată. Ele blochează temporar accesul la API. Anthropic pune fiecare organizație pe un nivel de utilizare: Start, Build, Scale sau Custom. O organizație nouă poate porni și de pe un nivel de evaluare, cu limite mai mici, care cresc automat pe măsură ce contul capătă istoric. Fiecare nivel are și un plafon lunar de cheltuieli. Nivelul și limitele tale le vezi în Console, pe pagina Rate limits, după cum arată documentația despre limitele de rată.

NivelPlafon lunar de cheltuieliCereri pe minut, Claude Opus 5.5
Start500 USD4.000
Build1.000 USD10.000
Scale200.000 USD13.000
CustomFără plafon, stabilit cu AnthropicStabilite cu Anthropic

Modelul ales schimbă mult factura. Dacă nu știi ce model să alegi, documentația recomandă să pornești cu Claude Opus 5.5. Claude Haiku 5.5 a fost lansat pentru sarcini de volum mare, sensibile la cost.

Creditele API lunare incluse în Claude Team și Max

Planurile Claude Team și Max includ acum credite API lunare pentru aplicațiile și agenții tăi pe Claude Platform, iar noul plan Ultra le include și el. Anunțul apare în notele de lansare Claude, la 7 octombrie 2026. O firmă care plătește deja Claude Team poate porni primul agent fără un buget nou de API.

Creditele lunare se folosesc tot prin platformă. Ai nevoie deci de aceeași bază: o organizație în Claude Console și o cheie API. Abonamentul Team acoperă oamenii din aplicație. Creditele lunare acoperă programele care cheamă API-ul.

Valoarea exactă a creditelor și pașii de activare nu îi repetăm aici, pentru că se pot schimba. Verifică în schimb patru lucruri:

  • în ce organizație din Console intră creditele lunare;
  • dacă organizația aceea e pe numele firmei;
  • cât consumă agentul într-o lună de test, față de creditele incluse;
  • cum se plătește consumul peste credite.

Dacă echipa ta nu lucrează încă pe Claude Team, Pilot Claude B instalează Claude Team în 30 de zile. Creditele lunare vin apoi odată cu planul.

Păstrarea și rotirea cheii API: unde stă și cât trăiește

O cheie API se păstrează ca o parolă de bancă. Nu o pui în e-mail, în chat sau în codul sursă. Ghidurile de automatizare recomandă cinci reguli de bază:

  • nu publici cheia nicăieri, nici într-un document partajat;
  • o ții în variabile de mediu sau într-un secret manager;
  • o rotești periodic;
  • urmărești consumul ei;
  • dai acces doar sistemelor și oamenilor care au nevoie.

Rotirea cheii înseamnă o cheie nouă pusă în program, apoi renunțarea la cea veche. Documentația platformei arată cum setezi expirarea cheii. O cheie uitată nu mai trăiește astfel la nesfârșit. Tot acolo găsești comparația dintre cheile API și Workload Identity Federation, o altă metodă de autentificare.

La Svennis facem o cheie separată pentru fiecare agent și pentru fiecare mediu, una de test și una de producție, iar cheia de producție stă doar pe server. Problema pe care o vedem cel mai des este o cheie personală, de pe contul unui fost angajat, care ține în viață un flux important fără ca cineva să știe.

Exemplu: cheia API pentru un agent de oferte, de la organizație la primul apel

Să luăm o firmă de distribuție care vrea un agent AI (Claude) ce pregătește drafturi de oferte din Zoho CRM. Drumul până la primul apel are trei etape.

Organizația și workspace-ul

Directorul deschide organizația în Claude Console cu o adresă comună a firmei. Creează un workspace numit oferte-agent. Programatorul primește în workspace rolul workspace_developer. Persoana care se ocupă de plăți primește rolul de facturare, workspace_billing.

Cheia și creditele

Programatorul intră pe API keys, apasă Create Key și numește cheia oferte-productie. Copiază cheia direct în managerul de parole al firmei. Directorul cumpără un prim pachet mic de credite. Dacă firma are Claude Team, verifică întâi creditele lunare incluse.

Primul apel

Pe server, programatorul instalează SDK-ul cu pip install anthropic și pune cheia în ANTHROPIC_API_KEY. Exemplul din ghidul oficial trimite o cerere cu client.messages.create. Folosește modelul claude-opus-5-5 și max_tokens setat la 1000, adică limita de tokeni pentru răspuns.

Înainte de cod, promptul poate fi încercat în Playground, care până de curând se numea Workbench. Playground este zona din Console unde testezi API-ul direct în browser. Agentul primește acces la CRM abia după ce drafturile arată bine, întâi doar pentru citire.

Lista de verificare înainte să pui cheia API în producție

Lista de verificare de mai jos adună pașii din acest ghid. Pentru fiecare pas arată cine răspunde și ce verifici înainte de lansare.

PasCine răspundeCe verifici
Organizația în Claude ConsoleProprietarul firmeiE pe adresa firmei, cu doi administratori
Workspace pe proiectResponsabilul tehnicFiecare om are rolul minim necesar
Cheia APIProgramatorulO cheie pe integrare, cu nume clar
Păstrarea cheiiProgramatorulDoar în variabilă de mediu sau secret manager
Expirare și rotireResponsabilul tehnicData de expirare setată, rotirea planificată
Credite și consumCine plăteșteConsum urmărit lunar, creditele Team sau Max verificate
Audit conturi de serviciuResponsabilul tehnicVerificat și membership-ul implicit, care lipsește din listă

Un rând fără un nume în dreptul lui e semn de risc. Acolo apar de obicei cheile uitate și facturile neașteptate. Completează tabelul cu oamenii din firma ta înainte de primul agent în producție.

Ce înseamnă cheia API pentru o firmă din România

Pentru o firmă din România, cheia API contează mai ales când legi Claude de facturare și de vânzări. Nu orice conexiune cere însă o cheie API Claude. Un MCP server este un program care expune datele și acțiunile unei aplicații către Claude.

Factureaza.ro are propriul MCP server. Îl adaugi în Claude ca connector personalizat, cu autorizare OAuth. Verifică în contul Factureaza.ro ce abonament include această opțiune. Aici nu lipești nicio cheie API Claude, ci lucrezi din Claude, cu abonamentul echipei.

Pentru SmartBill, conexiunea se face printr-un connector sau un MCP server construit special. Dacă acea integrare rulează ca agent pe API, folosește cheia firmei.

Instrumentele de automatizare cer și ele cheia. Make, de exemplu, îți cere să lipești cheia Anthropic în câmpul conexiunii. Din acel moment, cheia stă și în acel instrument. Fă o cheie separată pentru fiecare instrument, ca să o poți retrage fără să oprești restul.

Dacă cineva îți oferă o cheie gata făcută sau acces revândut, refuză. Cheia trebuie să fie a organizației tale, cu plata și controlul la tine. Pe Reddit, un comentator avertizează că unii utilizatori își laudă propriile produse fără să spună că sunt ale lor.

Pentru Factureaza.ro lucrezi direct din Claude, iar agentul care rulează singur cere cheia firmei. Connector în Claude (Factureaza.ro) / Agent pe API (SmartBill, Make). Cheie API Claude: Nu, autorizare OAuth / Da, cheia firmei din Console; Unde lucre

Pașii următori pentru firma ta

Primul pas este să numești persoana care deține organizația din Claude Console. Restul pașilor vin în ordinea din acest ghid:

  1. Deschizi organizația pe adresa firmei și un workspace pentru primul proiect.
  2. Creezi o cheie pentru acel proiect, cu expirare setată, păstrată într-un secret manager.
  3. Verifici dacă planul Claude Team sau Max aduce credite lunare în organizația ta.
  4. Testezi promptul în Playground, apoi faci primul apel din program.
  5. Treci în calendar o dată de rotire a cheii.

Dacă vrei ca primul agent să fie construit împreună cu tine, Pilot Claude A pune un agent AI (Claude) pe API, pentru un singur proces, în 30 de zile. Pentru fiecare conexiune cu programele tale îți arătăm opțiunile: connector, MCP server, plugin sau skill, fiecare cu costul ei. Tu alegi varianta.

Oferta are patru pași: Workshop-ul, apoi Pilot Claude A sau Pilot Claude B, Activarea departamentului și operarea lunară. Ultimul pas e descris în pagina despre operarea AI lunară.

Surse

  1. Claude Help Center: Release notes
  2. Claude Platform Docs: Get started with Claude
  3. Claude Platform Docs: Models overview
  4. Claude API Reference: Update Service Account Workspace Member
  5. Claude API Reference: List Service Account Workspace Members
  6. Make: Claude API, how to get an API key
  7. Reddit r/ClaudeAI: A "just use API" guide
  8. HeyHelp: Claude API keys for automation
  9. Claude Platform Docs: Rate limits
  10. Claude Help Center: Monthly API credits for Max, Ultra, and Team plans
Gratuit, 30 de minute

Alege o oră. Vino cu procesul la care te-ai gândit citind articolul.

Pleci cu un da sau un nu la automatizare și cu prețul de pe scara publicată. Vorbești cu cine construiește agenții, nu cu un agent de vânzări.

Preferi să suni? +40 722 945 189 · Încă nu vrei să vorbim? Vezi întâi pe firma ta.

30 de minute · apel video · gratuit
  1. 1Ora
  2. 2Datele tale
  3. 3Programat