Claude Agent SDK, a digitális munkatársad

Sokáig csak álmodoztunk róla, hogy a szkriptek helyett valódi, önállóan gondolkodó programokat írjunk. A Claude Agent SDK megjelenésével ez az álom valósággá vált. Mostantól nem kell bonyolult kódokkal bajlódnod, ha egy „tervez-épít-futtat” logikájú asszisztenst szeretnél. Ez az eszközrendszer strukturált keretet ad a kezedbe, hogy pillanatok alatt CLI (parancssori) alkalmazásokat készíts.

Miért vált ez most fontossá?

A hagyományos automatizálás „ragasztószalaggal” összetákolt megoldásai már nem elegek. A fejlesztőknek olyan eszközre van szükségük, amely képes állapotot kezelni és eszközöket használni.

Ez az új SDK (szoftverfejlesztői készlet) pont ezt nyújtja. Lehetővé teszi, hogy a Claude nyelvi modelljét valódi programozható ügynökké alakítsd. Az így létrehozott szoftverek képesek tervezni, cselekedni és ellenőrizni a saját munkájukat. Nemcsak válaszolnak, hanem feladatokat hajtanak végre a gépeden. Ez a „plan → act → verify” ciklus az autonóm működés alapja.

Telepítés

Mielőtt belevágnánk a kódolásba, szükség lesz néhány alapvető dologra. Győződj meg róla, hogy a Python 3.10-es vagy újabb verziója fut a gépeden. Kelleni fog egy Anthropic API kulcs is, amit a fejlesztői konzolon tudsz generálni.

A telepítés pofonegyszerű, nyiss egy terminált, és futtasd le a következő parancsot:

pip install claude-agent-sdk

Ha a parancssori felületet (CLI) is szeretnéd használni, érdemes a Node.js környezetet is előkészíteni. De a lényeg most a Python csomagban rejlik.

Az első ügynököd megépítése

Most jön az izgalmas rész. Építsünk egy egyszerű ügynököt, amely képes válaszolni és alapvető parancsokat értelmezni. A kód rövid és átlátható lesz.

Először importáljuk a szükséges modulokat és állítsuk be az alapokat:

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    # Itt határozzuk meg az ügynök viselkedését
    options = ClaudeAgentOptions(
        system_prompt="Te egy segítőkész, magyarul beszélő asszisztens vagy.",
        model="claude-sonnet-4-5-20250929" # A legfrissebb modell
    )

    # Elküldjük a kérdést és várjuk a választ
    print("Az ügynök gondolkodik...")
    async for message in query(prompt="Írj egy verset a kódolásról!", options=options):
        # A válasz darabokban érkezik (streaming)
        print(message.text, end="", flush=True)

if __name__ == "__main__":
    asyncio.run(main())

Ez a szkript már képes kommunikálni a modellel. A ClaudeAgentOptions résznél adhatod meg a „személyiségét”. A system_prompt sorban írhatod le, hogy pontosan mit vársz tőle.

Memória és folyamatos beszélgetés

A fenti példa egyetlen kérdés-válasz körre jó. De mi van, ha valódi párbeszédet szeretnél? A Claude Agent SDK erre is kínál megoldást a ClaudeSDKClient osztály segítségével.

Ez az objektum képes megjegyezni az előzményeket, így az ügynök „emlékszik” arra, amit korábban mondtál.

from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

async def chat_session():
    client = ClaudeSDKClient(
        options=ClaudeAgentOptions(
            system_prompt="Rövid, tömör válaszokat adó mérnök vagy."
        )
    )

    print("Kezdődhet a beszélgetés! (Kilépés: 'exit')")
    
    while True:
        user_input = input("\nTe: ")
        if user_input.lower() == "exit":
            break
            
        # A kliens kezeli a beszélgetés előzményeit
        async for response in client.send_message(user_input):
            print(response.text, end="", flush=True)

Eszközök a kézben

Az igazi varázslat akkor történik, amikor eszközöket (tools) adsz az ügynök kezébe. Az SDK lehetővé teszi, hogy saját Python függvényeket köss be.

Így az asszisztens képes lesz fájlokat olvasni, webes keresést végezni vagy akár rendszerparancsokat futtatni. A definíció egyszerű: regisztrálnod kell a függvényt az opciók között, és a modell tudni fogja, mikor használja.

„Az autonóm ügynökök nem a jövő zenéje, hanem a jelen eszköztára.”

A Claude Agent SDK segítségével percek alatt összerakhatsz egy olyan rendszert, amiért régen heteket kellett volna kódolni. A lehetőség adott, most rajtad a sor, hogy mit építesz belőle.