...
Eroare Aplicații AI cu LLM · Instalare, import, chei API și facturare

KeyError: 'ANTHROPIC_API_KEY'

Pe scurt

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

Greșit
PYTHON
import os
from dotenv import load_dotenv

cheie = os.environ["ANTHROPIC_API_KEY"]
Corect
PYTHON
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

Greșit
PYTHON
# terminal 1
export ANTHROPIC_API_KEY=sk-ant-...
# terminal 2 (alt proces, nu vede variabila)
python app.py
Corect
PYTHON
export ANTHROPIC_API_KEY=sk-ant-...
python app.py   # în același terminal

Variabilele 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

Greșit
PYTHON
# .env
ANTHROPIC_KEY=sk-ant-...

cheie = os.environ["ANTHROPIC_API_KEY"]
Corect
PYTHON
# .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ă tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
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.

Alte forme ale mesajului

  • KeyError: 'OPENAI_API_KEY'
  • raise KeyError(key) from None KeyError: 'ANTHROPIC_API_KEY'

Cum o eviți pe viitor

  • Încarcă .env cu load_dotenv() chiar la începutul programului, înainte de orice citire din os.environ.
  • Citește cu os.environ.get(...) și oprește programul cu un mesaj clar când lipsește.
  • Ține un .env.example cu 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

← Toate erorile Aplicații AI cu LLM

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.