KeyError: 'ANTHROPIC_API_KEY'
Codul citește cheia cu os.environ["ANTHROPIC_API_KEY"], dar variabila de mediu nu există în procesul în care rulează programul. Setează variabila (sau încarcă fișierul .env cu load_dotenv() înainte de citire) și folosește os.environ.get(...) cu un mesaj clar când lipsește.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
KeyError înseamnă că ai cerut dintr-un dicționar o cheie care nu există. Aici dicționarul este os.environ, adică variabilele de mediu ale procesului, iar cheia lipsă este numele variabilei cu cheia API.
Eroarea nu vine de la API și nu spune nimic despre cheie în sine: programul nici nu a ajuns să trimită cererea. Variabila pur și simplu nu e vizibilă pentru procesul Python. Cele mai frecvente motive: ai pus cheia în .env, dar n-ai apelat load_dotenv() (sau l-ai apelat după citire); ai setat-o cu export în alt terminal; ai pornit programul din IDE, care nu vede variabilele din terminal; pe server, variabila nu e definită în configurația aplicației.
În stiva de apeluri, ultima linie din codul tău e cea cu os.environ[...]; acolo pui verificarea.
De ce apare: cauzele frecvente
1Cheia e în .env, dar fișierul nu e încărcat
import os
from dotenv import load_dotenv
cheie = os.environ["ANTHROPIC_API_KEY"]import os
from dotenv import load_dotenv
load_dotenv()
cheie = os.environ.get("ANTHROPIC_API_KEY")Fișierul .env nu e citit automat de Python. load_dotenv() îl încarcă în os.environ, iar citirea trebuie să vină după apel.
2Variabila setată în alt terminal sau doar în IDE
# terminal 1
export ANTHROPIC_API_KEY=sk-ant-...
# terminal 2 (alt proces, nu vede variabila)
python app.pyexport ANTHROPIC_API_KEY=sk-ant-...
python app.py # în același terminalVariabilele de mediu se moștenesc doar de procesele pornite din acel shell. Un terminal nou sau IDE-ul nu le văd până nu le setezi și acolo (sau în .env).
3Nume scris diferit
# .env
ANTHROPIC_KEY=sk-ant-...
cheie = os.environ["ANTHROPIC_API_KEY"]# .env
ANTHROPIC_API_KEY=sk-ant-...
cheie = os.environ["ANTHROPIC_API_KEY"]Numele variabilei trebuie să fie identic, cu majuscule. SDK-ul Anthropic caută exact ANTHROPIC_API_KEY, iar cel OpenAI OPENAI_API_KEY.
Repară eroarea, direct în pagină
Programul de mai jos se oprește cu KeyError: 'ANTHROPIC_API_KEY', deși cheia există în fișierul .env al proiectului, iar funcția incarca_env (care face ce face load_dotenv()) e deja scrisă. Repară ordinea: încarcă .env înainte de a citi cheia, citește-o cu os.environ.get(...), afișează Cheie găsită: cu primele 7 caractere și ..., apoi răspunsul asistentului.
import os
import anthropic
MODEL = "claude-haiku-5-5"
def incarca_env(cale=".env"):
"""Ca load_dotenv() din python-dotenv: liniile NUME=valoare din .env ajung în os.environ."""
with open(cale, encoding="utf-8") as f:
for linie in f:
linie = linie.strip()
if linie and not linie.startswith("#") and "=" in linie:
nume, valoare = linie.split("=", 1)
os.environ.setdefault(nume.strip(), valoare.strip())
cheie = os.environ["ANTHROPIC_API_KEY"]
incarca_env()
print("Cheie găsită:", cheie[:7] + "...")
client = anthropic.Anthropic(api_key=cheie)
r = client.messages.create(
model=MODEL,
max_tokens=200,
messages=[{"role": "user", "content": "Până la ce oră e deschis magazinul vineri?"}],
)
print(r.content[0].text)Cheie găsită: sk-ant-... Vineri magazinul este deschis până la ora 21.
Indiciu
Apelul incarca_env() trebuie să fie înainte de linia care citește os.environ.
Reparația
import os
import anthropic
MODEL = "claude-haiku-5-5"
def incarca_env(cale=".env"):
"""Ca load_dotenv() din python-dotenv: liniile NUME=valoare din .env ajung în os.environ."""
with open(cale, encoding="utf-8") as f:
for linie in f:
linie = linie.strip()
if linie and not linie.startswith("#") and "=" in linie:
nume, valoare = linie.split("=", 1)
os.environ.setdefault(nume.strip(), valoare.strip())
incarca_env() # întâi încarci .env, apoi citești
cheie = os.environ.get("ANTHROPIC_API_KEY")
if not cheie:
raise SystemExit("Lipsește ANTHROPIC_API_KEY: pune-o în .env sau în variabilele de mediu.")
print("Cheie găsită:", cheie[:7] + "...")
client = anthropic.Anthropic() # citește singur ANTHROPIC_API_KEY
r = client.messages.create(
model=MODEL,
max_tokens=200,
messages=[{"role": "user", "content": "Până la ce oră e deschis magazinul vineri?"}],
)
print(r.content[0].text)De ce merge
Python nu citește singur fișierul .env: până la încărcare, variabila nu există în os.environ, iar accesul cu paranteze pătrate aruncă KeyError. După incarca_env() (în proiecte reale, load_dotenv()), cheia e în mediu, iar anthropic.Anthropic() o găsește singur, fără api_key= în cod. os.environ.get(...) cu un mesaj clar transformă o eroare confuză într-o instrucțiune pentru coleg, iar afișarea doar a primelor caractere confirmă cheia fără să o expună în loguri.
Alte forme ale mesajului
KeyError: 'OPENAI_API_KEY'raise KeyError(key) from None KeyError: 'ANTHROPIC_API_KEY'
Cum o eviți pe viitor
- Încarcă
.envcuload_dotenv()chiar la începutul programului, înainte de orice citire dinos.environ. - Citește cu
os.environ.get(...)și oprește programul cu un mesaj clar când lipsește. - Ține un
.env.examplecu numele variabilelor, fără valori, ca toți colegii să folosească aceleași nume. - Lasă clientul să citească singur cheia:
anthropic.Anthropic()fărăapi_key=.
Întrebări frecvente
De ce merge în terminal și nu merge în IDE?
IDE-ul pornește programul într-un proces care nu a moștenit variabilele setate cu export în terminal. Pune cheia în .env și încarc-o cu load_dotenv(), sau setează variabila în configurația de rulare a IDE-ului.
Pot să pun cheia direct în cod, ca să scap de eroare?
Nu. Codul ajunge în Git, iar o cheie publicată poate fi folosită de oricine pe factura ta. Ține cheia în mediu sau în .env, iar .env trece în .gitignore.
Erori înrudite
anthropic.AuthenticationError: Error code: 401 - {'type': 'error', 'error': {'type': 'authentication_error', 'message': 'invalid x-api-key'}} API-ul Claude a respins cheia trimisă: e greșită, expirată, ștearsă sau e o cheie de la alt furnizor. Pune o cheie validă de la Anthropic (începe cu `sk-ant-`) în variabila de mediu `ANTHROPIC_API_KEY` și creează clientul fără `api_key=` în cod. openai.AuthenticationError: Error code: 401 - {'error': {'message': 'Incorrect API key provided: sk-proj-****abcd. You can find your API key at https://platform.openai.com/account/api-keys.', 'type': 'invalid_request_error', 'param': None, 'code': 'invalid_api_key'}} OpenAI a respins cheia API: e scrisă greșit, a fost ștearsă, e o valoare de exemplu („cheia-ta-aici”) sau e cheia altui furnizor. Creează o cheie nouă în platforma OpenAI, pune-o în variabila de mediu `OPENAI_API_KEY` și creează clientul cu `OpenAI()`, fără cheie în cod. ModuleNotFoundError: No module named 'anthropic' Python nu găsește pachetul `anthropic` (sau `openai`) în mediul în care rulezi programul. Instalează-l cu `pip install anthropic` în același mediu (venv) cu care rulezi scriptul și verifică dacă numele din `import` e scris corect. Învață Aplicații AI cu LLM de la zero, cu exerciții la fiecare lecție
Curs Aplicații AI cu Claude și OpenAI: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 8 lecții sunt gratuite.
