Claude API Giltza Nola Erabili: Gida Osoa 2025

\n\n## Sarrera

Claude Anthropic-ek garatutako AI laguntzaile indartsua da, zeregin ugari egiteko gai dena, sormen-edukiak sortzetik hasi eta azalpen zehatzak emateraino. Clauderen gaitasunetara programatikoki sartzeko, API giltza bat behar duzu. Gida honek zure Claude API giltza lortzeko eta erabiltzeko prozesuan zehar gidatuko zaitu, urrats argi eta praktikoak emanez.

Gida honek programazio-kontzeptuen oinarrizko ulermena duzula eta APIak erabiltzen ohituta zaudela suposatzen du. Ez da Clauderekin aurretiko esperientziarik behar. Tutorial honen amaieran, Claude APIarekin autentifikatu eta zure lehen API deia egin ahal izango duzu.

Aurrebaldintzak

Hasi baino lehen, ziurtatu honako hauek dituzula:

• Anthropic Kontua: Anthropic-ekin kontu bat behar duzu haien APIra sartzeko. Joan Anthropic webgunera eta eman izena kontu bat lortzeko.
• API Giltza: Anthropic-en API giltza bat lortu behar duzu. Giltza hau ezinbestekoa da Claude APIrako zure eskaerak autentifikatzeko.
• Programazio Ingurunea: Aukeratu programazio-lengoaia bat (adibidez, Python, Node.js) eta konfiguratu zure garapen-ingurunea. Gida honek Python erabiliko du batez ere adibideetarako.
• Pakete Kudeatzailea: Ziurtatu pakete kudeatzaile bat instalatuta duzula (adibidez, pip Pythonerako, npm Node.js-rako).
• Oinarrizko Programazio Ezagutza: Programazio-kontzeptuen oinarrizko ulermena, hala nola aldagaiak, funtzioak eta HTTP eskaerak egitea, ezinbestekoa da.

1. Urratsa: Eman Izena Anthropic Kontu Batean

Oraindik Anthropic konturik ez baduzu, bat sortu beharko duzu.

1. Bisitatu Anthropic Webgunea: Joan Anthropic webgune ofizialera (anthropic.com).
2. Eman Izena: Bilatu "Eman Izena" edo "Hasi" botoia. Hitz zehatza alda daiteke.
3. Eman Informazioa: Bete beharrezko informazioa, hala nola zure izena, helbide elektronikoa eta pasahitza.
4. Egiaztatu Zure Helbide Elektronikoa: Begiratu zure posta elektronikoko sarrera-ontzia Anthropic-en egiaztapen-mezu bat dagoen. Egin klik egiaztapen-estekan zure kontua baieztatzeko.
5. Osatu Profila (Beharrezkoa bada): Plataforma batzuek zure profilaren informazioa osatzea eska dezakete zure helbide elektronikoa egiaztatu ondoren.

2. Urratsa: Lortu Zure Claude API Giltza

Anthropic kontua duzunean, zure API giltza lor dezakezu.

1. Hasi Saioa: Hasi saioa zure Anthropic kontuan haien webgunean.
2. Nabigatu API Ezarpenetara: Bilatu "API Giltzak", "Garatzaileak" edo "Kontuaren Ezarpenak"-ekin erlazionatutako atal bat. Kokapena alda daiteke Anthropic webgunearen diseinuaren arabera.
3. Sortu API Giltza: Egin klik API giltza berri bat sortzeko aukeran. Baliteke giltzari izen edo deskribapen bat eman behar izatea.
4. Kopiatu eta Gorde Segurtasunez: Giltza sortu ondoren, kopiatu leku seguru batera. Hau ezinbestekoa da, ezin izango baituzu giltza berriro ikusi orria itxi ondoren. Gorde ezazu segurtasunez, pasahitz kudeatzaile batean bezala, eta saihestu bertsio-kontroleko sistemetara (Git) igotzea.

3. Urratsa: Konfiguratu Zure Programazio Ingurunea

Orain, konfiguratu zure programazio-ingurunea Claude APIa erabiltzeko. Python erabiliko dugu adibide honetan.

1. Instalatu Python: Python instalatuta ez baduzu, deskargatu eta instalatu azken bertsioa Python webgune ofizialetik (python.org).

2. Instalatu Anthropic Python Liburutegia: Ireki zure terminala edo komando-gonbita eta erabili pip Anthropic Python liburutegia instalatzeko:

   pip install anthropic
   

   Komando honek Claude APIarekin elkarreragiteko beharrezko Python liburutegia deskargatu eta instalatzen du.

3. Egiaztatu Instalazioa: Liburutegia ondo instalatuta dagoela egiaztatzeko, exekutatu komando hau zure terminalean:

   pip show anthropic
   

   Honek instalatutako Anthropic liburutegiari buruzko informazioa erakutsi beharko luke, bere bertsioa eta kokapena barne.

4. Urratsa: Autentifikatu Claude APIarekin

Claude APIa erabili aurretik, zure eskaerak autentifikatu behar dituzu zure API giltza erabiliz.

1. Inportatu Anthropic Liburutegia: Zure Python script-ean, inportatu Anthropic liburutegia:

   import anthropic
   

2. Ezarri API Giltza: Ezarri ANTHROPIC_API_KEY ingurune-aldagaia edo zuzenean pasa API giltza bezeroa sortzean.

   1. Aukera: Ingurune-Aldagaia Erabiliz (Gomendagarria):

   Ezarri ANTHROPIC_API_KEY ingurune-aldagaia zure sistema eragilean. Honek giltza zure script-ean gogor kodetzea saihesten du.

   • Linux/macOS:

     export ANTHROPIC_API_KEY="ZURE_API_GILTZA"
     

   • Windows:

     set ANTHROPIC_API_KEY=ZURE_API_GILTZA
     

   Ordeztu ZURE_API_GILTZA Anthropic-etik lortu duzun benetako API giltzarekin.

   2. Aukera: API Giltza Zuzenean Pasatzea (Segurtasun Gutxiago):

   API giltza zuzenean pasa dezakezu Anthropic bezeroa sortzean, baina hau segurtasun gutxiagokoa da eta ez da gomendagarria produkzio-inguruneetarako.

   client = anthropic.Anthropic(api_key="ZURE_API_GILTZA")
   

   Ordeztu ZURE_API_GILTZA zure benetako API giltzarekin.

3. Sortu Anthropic Bezeroa: Sortu Anthropic klasearen instantzia bat APIarekin elkarreragiteko:

   client = anthropic.Anthropic() # ANTHROPIC_API_KEY ezarrita dagoela suposatuz
   

   Ingurune-aldagaiaren metodoa erabiltzen ari bazara, bezeroak automatikoki jasoko du API giltza ingurunetik.

5. Urratsa: Egin Zure Lehen API Deia

Autentifikatuta zaudenez, zure lehen API deia egin dezakezu Claude APIra. messages.create endpoint-a erabiliko dugu Clauderi mezu bat bidaltzeko eta erantzun bat jasotzeko.

1. Prestatu Zure Prompt-a: Sortu prompt bat Clauderi bidaltzeko. Prompt-ak argia eta zehatza izan behar du, Clauderi zer egin nahi duzun esanez.

   prompt = "Idatzi olerki labur bat ozeanoari buruz."
   

2. Deitu messages.create Endpoint-ari: Erabili messages.create metodoa zure prompt-a Clauderi bidaltzeko eta erantzun bat jasotzeko.

   message = client.messages.create(
       model="claude-3-opus-20240229", # Ordeztu nahi duzun modeloarekin
       max_tokens=1024,
       messages=[{"role": "user", "content": prompt}],
   )
   

   • model: Erabili nahi duzun Claude modeloa zehazten du. Begiratu Anthropic dokumentazioa eskuragarri dauden azken modeloetarako.
   • max_tokens: Sortutako erantzuneko tokenen gehieneko kopurua zehazten du.
   • messages: Elkarrizketaren historia adierazten duten mezuen zerrenda. Mezu bakoitzak role bat du ("user" edo "assistant") eta content bat.

3. Inprimatu Erantzuna: Inprimatu erantzunaren edukia Claudek sortu duena ikusteko.

   print(message.content[0].text)
   

   Honek Claudek sortutako olerkia inprimatuko du.

6. Urratsa: Adibide Kode Osoa

Hona hemen Python kode osoa Claude APIari API dei bat egiteko: