Setup cheie API Anthropic

Scop

Această instrucțiune descrie pașii pentru obținerea unei chei API Anthropic, alimentarea contului cu credit și configurarea cheii pe serverul unei aplicații IZIT care apelează Claude programatic (boți, automatizări, integrări interne etc.).

Este destinată administratorilor de sistem și dezvoltatorilor responsabili cu deploy-ul aplicației.

Când se folosește

La lansarea unei aplicații noi care folosește API-ul Anthropic
La rotația periodică a cheii API (recomandat: anual sau după plecarea unei persoane care a avut acces)
După un incident de securitate (cheie compromisă)

Cerințe

Cont pe console.anthropic.com (sau acces la contul de organizație existent)
Card de debit/credit Visa sau Mastercard (pentru încărcare credit prepaid)
Acces SSH pe serverul aplicației și drepturi de editare pentru fișierul .env

1. Context — Anthropic API vs Claude.ai vs abonament Max

Sunt trei produse diferite, cu trei plăți separate. E important să nu se confunde:

Produs	Pentru cine	Cum se plătește	Folosit aici?
Claude.ai (claude.ai)	Utilizatori care vor chat cu Claude într-un browser	Gratis sau Pro/Max (abonament lunar fix)	Nu
Abonament Max (pe Claude.ai)	Utilizatori care vor limite mai mari în chat	USD 100–200/lună	Nu
Anthropic API (console.anthropic.com)	Aplicații care apelează Claude programatic	Per token folosit (pay-as-you-go)	DA

Important: un abonament Max pe Claude.ai NU oferă credit pe API. Sunt platforme de billing separate. Pentru o aplicație care folosește API-ul, e nevoie de cont distinct pe console.anthropic.com cu credit prepaid.

2. Creare cont pe console.anthropic.com

Deschideți în browser: https://console.anthropic.com
Apăsați Sign up (sau Log in dacă există deja cont API).
- Pentru simplitate, recomandăm același email ca pe Claude.ai, dar nu e obligatoriu.
Confirmați email-ul (primiți un link în inbox).
La primul login vă va întreba:
- Use case — alegeți „Build with Claude" sau „Personal project"
- Organization name — puneți numele companiei sau al proiectului (apare doar în consolă, nu public)
Ajungeți pe Dashboard-ul consolei.

Dacă există deja un cont Anthropic API folosit de altă aplicație IZIT, folosiți același cont. Pot fi create multe chei API într-un singur cont, iar costurile se cumulează pentru o vizibilitate centrală.

3. Setup billing — adăugare credit

API-ul nu funcționează până nu există credit în cont. Pașii:

În consolă: avatar (dreapta sus) → Plans & Billing (sau direct https://console.anthropic.com/settings/billing)
Add Payment Method → introduceți cardul.
- Cardul nu se debitează automat — se folosește doar pentru încărcare manuală de credit prepaid.
Buy credits → recomandare inițială: USD 10.
- Minimul e USD 5. Pentru aplicații cu volum mic, USD 10 oferă autonomie de săptămâni până la luni.
- Creditul nu se reînnoiește automat — la epuizare aplicația oprește răspunsurile și veniți primește email.
Tranzacția durează câteva secunde. După ce apare „Available credit: USD X.XX" în dashboard, e gata.

Opțional — auto-reload: se poate seta reîncărcare automată când creditul scade sub un prag. Pentru aplicații interne mici, NU recomandăm — preferabil să primiți email-ul de notificare și să decideți manual.

4. Generare API key

În consolă: API Keys (sau direct https://console.anthropic.com/settings/keys)
Create Key
Câmpuri:
- Name: nume descriptiv care identifică aplicația (de ex. app-numele-aplicatiei-prod). Important pentru a putea identifica și revoca cheia ulterior fără ambiguitate.
- Workspace: lăsați pe default sau alegeți workspace-ul dedicat aplicației.
Create
ATENȚIE: apare o singură dată un ecran cu valoarea cheii — un string care începe cu sk-ant-... (~100 caractere).
- Copiați valoarea imediat într-un loc sigur (parolar / fișier text local pe stația administratorului).
- Dacă închideți tab-ul fără să o copiați, nu mai poate fi recuperată — singura soluție e generarea altei chei.
Done după copiere.

În lista de API keys cheia nouă apare cu doar primele 4 + ultimele 4 caractere (ex: sk-ant-...XYZ8). Restul rămâne secret.

Securitate: cheia API este echivalentă cu o parolă. Nu se pune în git, în mesaje (WhatsApp, Slack, email), în screenshot-uri sau în log-uri. Pentru reacția corectă la o scurgere, vezi secțiunea 7.

5. Stocare cheii pe serverul aplicației

Aplicațiile IZIT care folosesc API-ul Anthropic citesc cheia din variabila de mediu ANTHROPIC_API_KEY, încărcată dintr-un fișier .env aflat în directorul aplicației.

SSH pe serverul de producție.
Editați .env-ul aplicației:

bash nano /calea/catre/aplicatie/.env
Adăugați la final (înlocuiți cu valoarea reală a cheii):

ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Salvați (în nano: Ctrl+O, Enter, Ctrl+X).
Verificați că linia a fost scrisă corect, fără spații în plus sau ghilimele:

bash grep ANTHROPIC /calea/catre/aplicatie/.env
Restartați aplicația pentru ca noua variabilă de mediu să fie încărcată (comanda concretă depinde de aplicație — systemctl restart, docker compose restart, etc.).

Drepturi pe .env: fișierul trebuie să fie accesibil doar de user-ul aplicației și de root. Verificați cu ls -l .env — recomandat chmod 600 .env.

6. Monitorizare consum și alerte

Pricing curent (Claude Sonnet 4.6)

Input: USD 3 / milion tokens
Output: USD 15 / milion tokens

Formulă de estimare per cerere:

cost ≈ (tokens_input × 3 + tokens_output × 15) / 1.000.000

Pentru cifre actualizate și alte modele (Opus, Haiku): https://www.anthropic.com/pricing

Vizualizare consum în consolă

https://console.anthropic.com/settings/usage
Grafic pe zi / lună cu:
- Tokens consumate (input + output, separat)
- Cost cumulat
- Apeluri per model

Alertă de cheltuieli

Pentru a evita o factură-surpriză (de ex. dacă aplicația intră într-un loop sau dacă cheia ajunge folosită de cineva neautorizat):

Settings → Limits → Spend limit
Setați o limită lunară rezonabilă pentru aplicație (de ex. USD 20–50 pentru o aplicație internă mică).
Când limita e atinsă, API-ul oprește răspunsurile și veniți primește email.

7. Securitate — dacă cheia a fost expusă

Dacă o cheie a fost trimisă accidental într-un mesaj, commit-uită în git, postată online, expusă într-un screenshot etc.:

Imediat: consolă → API Keys → găsiți cheia compromisă → meniul ... → Revoke.
- Asta o face inutilă instant, indiferent unde a leak-uit.
Generați altă cheie nouă (vezi secțiunea 4).
Actualizați .env-ul pe serverul aplicației cu noua cheie.
Restartați aplicația pentru ca noua cheie să fie încărcată.
Verificați Usage pentru a vedea dacă cheia compromisă a fost folosită între momentul leak-ului și momentul revocării.

Anthropic detectează automat chei publicate accidental pe GitHub public și le revocă în câteva minute. Totuși, nu vă bazați pe detecția automată — faceți acțiunea manual de îndată ce sesizați scurgerea.

8. Troubleshooting

Aplicația raportează „API key missing" / „configured: false"

ANTHROPIC_API_KEY lipsește din .env sau aplicația nu a fost restartată după modificare.
Verificați:

bash grep ANTHROPIC /calea/catre/aplicatie/.env
Restartați aplicația și verificați log-urile.

Aplicația raportează „authentication_error" / 401

Cheia este invalidă, a fost revocată, sau a fost copiată incomplet (lipsesc caractere).
Verificați în consolă (API Keys) dacă cheia mai există și e activă.
Dacă a fost revocată, generați alta nouă.

Aplicația raportează „insufficient_credit" / 429 (rate limit) constant

Creditul s-a epuizat → check Usage în consolă → cumpărați credit adițional.
Spend limit lunar a fost atins → creșteți limita din Settings → Limits.

Cost mai mare decât așteptat

Deschideți Usage detaliat → identificați ce model a fost folosit și câte tokens au fost consumate.
Verificați log-urile aplicației pentru tipare suspecte (loop-uri de retry, mesaje masive, abuz din partea utilizatorilor).
Considerați reducerea modelului folosit (Haiku în loc de Sonnet) pentru cazurile mai simple, sau scurtarea system prompt-ului dacă acesta e foarte lung.

Resurse externe

Dashboard API: https://console.anthropic.com
Documentație oficială: https://docs.anthropic.com
Status servicii (în caz de outage): https://status.anthropic.com
Pricing curent: https://www.anthropic.com/pricing

Istoric modificări

Versiune	Data	Autor	Modificări
1.0	26.05.2026	Departamentul IT	Versiunea inițială