1 
2A Claude Agent SDK programozasi hozzeferest biztosit ugyanahhoz az agens ciklushoz, amely a Claude Code-ot hajtja. Az agenseid fajlokat olvashatnak, shell parancsokat futtathatnak, kereshetnek a weben, kodot szerkeszthetnek, kulso API-kat hivhatnak MCP szervereken keresztul es sub-agenseket orchestralhatnak  -  mindezt nehany sor TypeScript vagy Python koddal.
3 
4A standard Anthropic Client SDK-val ellentetben, ahol magad epitesz eszkoz ciklust, az Agent SDK belsoen kezeli az eszkozok vegrehajatasat, a kontextus kezeleset, az ujraprobalkozasokat es az orchestraciot. Leirod, mit szeretnel, biztositod az eszkozoket, es az agens megoldja a tobbit.
5 
6## Architektura
7 
8Az SDK egy egyszeru ciklust kovet: **gyujts kontextust, cselekedj, ellenorizd, ismeteld**.
9 
10```mermaid
11graph TD
12    Input[User Prompt] --> Loop[Agent Loop]
13    Loop --> Reason[Claude Reasons]
14    Reason --> Tool[Call Tool]
15    Tool --> Result[Tool Result]
16    Result --> Loop
17    Reason --> Done[Final Response]
18 
19    subgraph "Built-in Tools"
20        T1[Read / Write / Edit]
21        T2[Bash / Terminal]
22        T3[Glob / Grep]
23        T4[WebSearch / WebFetch]
24    end
25 
26    subgraph "Custom Tools via MCP"
27        M1[Your API]
28        M2[Database]
29        M3[Slack / GitHub / etc.]
30    end
31 
32    Tool --> T1
33    Tool --> M1
34```
35 
36A fo belepesi pont a `query()`, amely egy aszinkron iteratort ad vissza, ami uzeneteket streamel, mig az agens dolgozik. Minden uzenet megmondja, mit csinal az agens: gondolkodik, eszkozt hiv, eredmenyt kap vagy a vegleges kimenetet szallitja.
37 
38## Kezdes
39 
40### Telepites
41 
42```bash
43# TypeScript
44npm install @anthropic-ai/claude-agent-sdk
45 
46# Python
47pip install claude-agent-sdk
48```
49 
50Szukseged van egy Anthropic API kulcsra, amelyet `ANTHROPIC_API_KEY`-kent allitasz be a kornyezetedben.
51 
52### Az elso agensed
53 
54```typescript
55import { query } from "@anthropic-ai/claude-agent-sdk";
56 
57const conversation = query({
58  prompt: "Find all TODO comments in the codebase and create a summary",
59  options: {
60    allowedTools: ["Read", "Glob", "Grep"],
61  },
62});
63 
64for await (const message of conversation) {
65  if (message.type === "assistant") {
66    process.stdout.write(message.content);
67  }
68  if (message.type === "result" && message.subtype === "success") {
69    console.log("\nDone:", message.result);
70  }
71}
72```
73 
74Ennyi az egesz. Az agens a Glob-ot hasznalja a fajlok megtalalsahoz, a Grep-et a TODO mintak keresesehez, a Read-et a talalatok vizsgalatahoz, es egy strukturalt osszefoglalast ad vissza. Nem te irod az orchestracis logikat  -  az SDK kezeli helyetted.
75 
76### Python megfeleloje
77 
78```python
79from claude_agent_sdk import query
80 
81async for message in query(
82    prompt="Find all TODO comments in the codebase and create a summary",
83    options={"allowed_tools": ["Read", "Glob", "Grep"]},
84):
85    if message.type == "assistant":
86        print(message.content, end="")
87    if message.type == "result" and message.subtype == "success":
88        print(f"\nDone: {message.result}")
89```
90 
91## Beepitett eszkozok
92 
93Az SDK ugyanazokat az eszkozoket tartalmazza, amelyek a Claude Code-ban elerhetek:
94 
95| Eszkoz | Leiras |
96|------|-------------|
97| **Read** | Fajltartalom olvasasa |
98| **Write** | Uj fajlok letrehozasa |
99| **Edit** | Celzott modositasok meglevo fajlokban |
100| **Bash** | Shell parancsok futtatasa |
101| **Glob** | Fajlok keresese minta alapjan |
102| **Grep** | Fajltartalom keresese regex-szel |
103| **WebSearch** | Kereses a weben |
104| **WebFetch** | URL letoltese es tartalmanak visszaadasa |
105| **AskUserQuestion** | Felhasznaloi bemenet kerese |
106 
107Az `allowedTools`-szal szabalyozod, mely eszkozoket hasznalhatja az agens. Ha egy eszkoz nincs a listan, az agens nem hivhatja meg.
108 
109## Jogosultsagi modok
110 
111Mivel az agensek valos parancsokat hajtanak vegre valos rendszereken, a jogosultsagok szamitanak.
112 
113| Mod | Viselkedes | Hasznalati eset |
114|------|----------|----------|
115| `default` | Egyedi `canUseTool` callback dont hivasokent | Finom szabalyozas |
116| `acceptEdits` | Fajlmuveletek automatikus jovahagyasa, Bash-nel kerdez | Fejlesztesi munkafolyamatok |
117| `dontAsk` | Mindent elutasit, ami nincs az allowedTools-ban | Korliatozott agensek |
118| `bypassPermissions` | Mindent automatikusan jovahagy | Megbizhato sandbox kornyezetek |
119| `auto` | A modell osztalyozoja dont a biztonsagrol | Kiegyensulyozott automatizalas |
120 
121```typescript
122const conversation = query({
123  prompt: "Refactor the auth module to use JWT",
124  options: {
125    allowedTools: ["Read", "Edit", "Glob", "Grep", "Bash"],
126    permissionMode: "acceptEdits",
127  },
128});
129```
130 
131Produkcios hasznalatra mindig futtasd az agenseket sandbox kornyezetben (kontenerek, VM-ek) es hasznald a legszigorubb jogosultsagi modot, amely meg lehetove teszi az agens munkajat.
132 
133## Egyedi eszkozok epitese MCP-vel
134 
135Az SDK igazi ereje az agensek sajat eszkozokkel valo boviteseben rejlik. Az egyedi eszkozok in-process MCP szerverkent vannak definialva  -  nincs alprocess kezeles, nincs halozati terhelts.
136 
137### Pelda: Idojaras eszkoz
138 
139```typescript
140import { tool, createSdkMcpServer, query } from "@anthropic-ai/claude-agent-sdk";
141import { z } from "zod";
142 
143const getTemperature = tool(
144  "get_temperature",
145  "Get the current temperature at a location",
146  {
147    latitude: z.number().describe("Latitude"),
148    longitude: z.number().describe("Longitude"),
149  },
150  async ({ latitude, longitude }) => {
151    const res = await fetch(
152      `https://api.open-meteo.com/v1/forecast?latitude=${latitude}&longitude=${longitude}&current=temperature_2m&temperature_unit=celsius`
153    );
154    const data = await res.json();
155    return {
156      content: [
157        {
158          type: "text",
159          text: `Current temperature: ${data.current.temperature_2m}C`,
160        },
161      ],
162    };
163  }
164);
165 
166const weatherServer = createSdkMcpServer({
167  name: "weather",
168  version: "1.0.0",
169  tools: [getTemperature],
170});
171 
172for await (const message of query({
173  prompt: "What's the weather like in Rome?",
174  options: {
175    mcpServers: { weather: weatherServer },
176    allowedTools: ["mcp__weather__get_temperature"],
177  },
178})) {
179  if (message.type === "result" && message.subtype === "success") {
180    console.log(message.result);
181  }
182}
183```
184 
185Az egyedi eszkozok az `mcp__{szerver_nev}__{eszkoz_nev}` elnevezesi konvenciot kovetik. Hasznalhatsz helyettesito karaktereket az `allowedTools`-ban: az `"mcp__weather__*"` engedlyezi az osszes eszkozt a weather szerverrol.
186 
187### Pelda: Adatbazis lekerdezesi eszkoz
188 
189```typescript
190const queryDb = tool(
191  "query_database",
192  "Run a read-only SQL query against the application database",
193  {
194    sql: z.string().describe("SQL SELECT query to execute"),
195  },
196  async ({ sql }) => {
197    // Validate: only allow SELECT queries
198    if (!sql.trim().toUpperCase().startsWith("SELECT")) {
199      return {
200        content: [{ type: "text", text: "Error: Only SELECT queries are allowed." }],
201      };
202    }
203 
204    const result = await pool.query(sql);
205    return {
206      content: [
207        {
208          type: "text",
209          text: JSON.stringify(result.rows, null, 2),
210        },
211      ],
212    };
213  }
214);
215```
216 
217## Kulso MCP szerverek csatlakoztatasa
218 
219Az in-process eszkozokon tul barmely letezo MCP szerverhez csatlakozhatsz  -  ugyanazokhoz a szerverekhez, amelyek a Claude Desktop-pal, Cursor-ral es mas MCP kliensekkel mukodnek.
220 
221```typescript
222for await (const message of query({
223  prompt: "Check the latest issues in the frontend repo and summarize them",
224  options: {
225    mcpServers: {
226      github: {
227        command: "npx",
228        args: ["-y", "@modelcontextprotocol/server-github"],
229        env: { GITHUB_PERSONAL_ACCESS_TOKEN: process.env.GITHUB_TOKEN },
230      },
231    },
232    allowedTools: ["mcp__github__*"],
233  },
234})) {
235  // ...
236}
237```
238 
239Tobb MCP szervert is kombinalhatsz. Az agens latja az osszes eszkozt az osszes csatlakoztatott szerverrol es szukseg szerint hasznalja oket.
240 
241```mermaid
242graph LR
243    Agent[Your Agent] --> SDK[Agent SDK]
244    SDK --> InProcess[In-process MCP\nCustom Tools]
245    SDK --> GitHub[GitHub MCP Server]
246    SDK --> Postgres[PostgreSQL MCP Server]
247    SDK --> Slack[Slack MCP Server]
248```
249 
250## Tobb agens orchestracioja
251 
252Osszetett munkafolyamatokhoz specializalt sub-agenseket definalhatsz, amelyekre a szulo agens feladatokat delegl. Minden sub-agensnek sajat promptja, eszkozei es fokuszteriilete van.
253 
254```typescript
255for await (const message of query({
256  prompt: "Review the PR, check for security issues, and update the changelog",
257  options: {
258    allowedTools: ["Read", "Edit", "Bash", "Glob", "Grep", "Agent"],
259    agents: [
260      {
261        name: "security-reviewer",
262        description: "Reviews code for security vulnerabilities",
263        prompt: "You are a security expert. Analyze code for OWASP Top 10 vulnerabilities.",
264        allowedTools: ["Read", "Glob", "Grep"],
265      },
266      {
267        name: "changelog-writer",
268        description: "Updates the CHANGELOG.md file based on recent changes",
269        prompt: "You maintain the project changelog. Follow Keep a Changelog format.",
270        allowedTools: ["Read", "Edit", "Bash"],
271      },
272    ],
273  },
274})) {
275  // The parent agent will:
276  // 1. Read the PR diff
277  // 2. Delegate security review to security-reviewer
278  // 3. Delegate changelog update to changelog-writer
279  // 4. Synthesize results
280}
281```
282 
283Add hozza az `"Agent"`-et a szulo agens `allowedTools`-jahoz a delegalas engedelyezesehez. A sub-agensek sajat eszkozikkel futnak, es nem fernek hozza a szulo eszkozeihez, hacsak nem kapnak kifejezett engedelyt.
284 
285```mermaid
286graph TD
287    Parent[Parent Agent] --> SR[Security Reviewer\nRead, Glob, Grep]
288    Parent --> CW[Changelog Writer\nRead, Edit, Bash]
289    SR --> Report[Security Report]
290    CW --> Updated[Updated CHANGELOG]
291    Report --> Parent
292    Updated --> Parent
293    Parent --> Final[Final Summary]
294```
295 
296## Munkamenetek es folytonossag
297 
298Az agensek munkamenetek segitsegevel tobb lekerdezes kozott is fenntarthatjak a kontextust. Ragadd meg a `session_id`-t az elso interakciobol es add at a `resume`-ban a kovetkezo lekerdezeseknel.
299 
300```typescript
301let sessionId: string | undefined;
302 
303// First query
304for await (const message of query({
305  prompt: "Read the project structure and understand the architecture",
306  options: { allowedTools: ["Read", "Glob", "Grep"] },
307})) {
308  if (message.type === "init") {
309    sessionId = message.session_id;
310  }
311}
312 
313// Follow-up query (same session, full context preserved)
314for await (const message of query({
315  prompt: "Now refactor the auth module based on what you learned",
316  resume: sessionId,
317  options: { allowedTools: ["Read", "Edit", "Bash"] },
318})) {
319  // Agent remembers the full project context from the first query
320}
321```
322 
323## Claude Managed Agents
324 
325Ha nem szeretned magad uzemeltetni az agens infrastrukturajat, a **Claude Managed Agents** (2026 aprilisaban indult) teljes mertekben kezelt felhoszolgaltatast biztosit. Az Anthropic futtatja a kontenereket, kezeli a skalazast es streaming API-t biztosit.
326 
327```mermaid
328graph LR
329    subgraph "Self-hosted (Agent SDK)"
330        Code[Your Code] --> SDK2[Agent SDK]
331        SDK2 --> API[Claude API]
332        SDK2 --> Tools[Your Tools]
333    end
334 
335    subgraph "Managed Agents"
336        App[Your App] --> MAPI[Managed Agents API]
337        MAPI --> Container[Anthropic-hosted Container]
338        Container --> API2[Claude API]
339        Container --> Tools2[Tools in Container]
340    end
341```
342 
343A kulcsfontossagu kulonbseg: az Agent SDK-val az agens ciklust a sajat infrastrukturadban futtatod. A Managed Agents-szel az Anthropic hosztolia es futtatja az agenst helyetted. Munkamenet-alapu API-n keresztul kommunikalsz es Server-Sent Events-en keresztul kapod az esemenyeket.
344 
345**Arazes:**
346- **Agent SDK**: csak a standard Claude API token dijak. A hosztolast te biztositod.
347- **Managed Agents**: token dijak plusz 0,08 USD munkamenet-orankent (milliszekundumonkent szamlazva).
348 
349## Produkcios best practice-ek
350 
351### 1. Mindig izolalj
352 
353Soha ne futtass agenseket korlatlan jogosultsagokkal produkcios gepen. Hasznalj kontenereket (Docker, Fly.io, Modal) vagy sandbox kornyezeteket (E2B, Vercel Sandbox).
354 
355### 2. Korlatoz az eszkoz hozzaferest
356 
357Kovasd a legkisebb jogosultsag elvet. Egy jelenteseket generalo agens nem igenyli a `Bash`-t vagy a `Write`-ot.
358 
359```typescript
360// Too permissive
361allowedTools: ["Read", "Write", "Edit", "Bash", "Glob", "Grep"]
362 
363// Better: only what's needed
364allowedTools: ["Read", "Glob", "Grep"]
365```
366 
367### 3. Hasznalj hookokat vedokorlatokent
368 
369A hookok lehetove teszik az eszkoz hivasok elfogasat vegrehajtas elott es utan. Hasznald oket naplozasra, validaciora es sebessegorlatozasra.
370 
371```typescript
372const conversation = query({
373  prompt: "Analyze the codebase",
374  options: {
375    allowedTools: ["Read", "Glob", "Grep"],
376    hooks: {
377      PreToolUse: async (toolName, input) => {
378        console.log(`Tool call: ${toolName}`, input);
379        // Return false to block the call
380        if (toolName === "Bash" && input.command.includes("rm")) {
381          return false;
382        }
383        return true;
384      },
385    },
386  },
387});
388```
389 
390### 4. Kezeld elegansan a hibakat
391 
392Az agens ciklus hibakat produlhat  -  eszkoz meghibasodasok, API limitek, kontextus ablak tulcsordulas. Mindig ellenorizd az uzenet tipusokat.
393 
394```typescript
395for await (const message of conversation) {
396  switch (message.type) {
397    case "assistant":
398      // Agent reasoning
399      break;
400    case "tool_use":
401      // Agent is calling a tool
402      break;
403    case "result":
404      if (message.subtype === "error") {
405        console.error("Agent failed:", message.error);
406      }
407      break;
408  }
409}
410```
411 
412### 5. Figyeld a token felhasznalast
413 
414Az agens ciklusok jelentos mennyisegu tokent fogyaszthatnak, kulonosen nagy kodbazisoknal. Az SDK tartalmaz automatikus kontextus tomoritest, de ettol fuggetlenul erdemes figyelni a felhasznalast.
415 
416## Osszefoglalas
417 
418A Claude Agent SDK egy LLM-et kerdesekre valaszolo gepbol valami olyanra alakit, ami kozelebb all egy junior fejlesztohoz. Az agenseid olvashatnak, irhatnak, vegrehajthatnak, ellenorizhetnek es iteralhatnak  -  ugyanaz a munkafolyamat, amit egy ember kovet.
419 
420Kezdj kiciben: epits egy agenst nehany beepitett eszkozzel. Aztan adj hozza egyedi MCP eszkozoket a sajat szakteruletedhez. Skalazz tobb agens orchestraciora, amikor a munkafolyamataid specializaciot igenyelnek.
421 
422Az agens ciklus ugyanaz, amely a Claude Code-ot hajtja. Ha az kepes szoftvert epiteni, a te agenseid is kepesek ra.
423 
424> **Kezdesi ellenorzo lista:**
425>
426> - [x] Telepitsd az SDK-t (`npm install @anthropic-ai/claude-agent-sdk`)
427> - [x] Allitsd be az `ANTHROPIC_API_KEY`-t a kornyezetedben
428> - [x] Epits egy egyszeru agenst beepitett eszkozokkel (Read, Glob, Grep)
429> - [x] Adj hozza egyedi eszkozt in-process MCP szerveren keresztul
430> - [x] Csatlakoztass kulso MCP szervert (GitHub, PostgreSQL, stb.)
431> - [x] Implementalj tobb agens orchestraciot sub-agensekkel
432> - [x] Allits be sandbox kornyezetet produkciohoz
433> - [x] Adj hozza hookokat naplozashoz es vedokorlatokhoz
434