Claude Code Agent SDK का परिचय — स्वायत्त एजेंट तेज़ी से बनाएं

Agent SDK क्या है?

Claude Code Agent SDK एक फ्रेमवर्क है जो Claude मॉडल द्वारा संचालित स्वायत्त एजेंट बनाने के लिए डिज़ाइन किया गया है। साधारण API कॉल के विपरीत, एक एजेंट लक्ष्य प्राप्त करता है, स्वयं टूल्स का चयन करता है, परिणामों का मूल्यांकन करता है, और समाधान तक पहुंचने के लिए मल्टी-स्टेप रीज़निंग लूप चलाता है।

पारंपरिक चैटबॉट एकल अनुरोध-प्रतिक्रिया चक्र में काम करते हैं। Agent SDK के साथ, आप जटिल वर्कफ़्लो — फ़ाइलें पढ़ना, समस्याएं पहचानना, सुधार लागू करना, टेस्ट चलाना और परिणाम रिपोर्ट करना — सब एक निर्देश से पूरा कर सकते हैं।

सेटअप

अपना प्रोजेक्ट इनिशियलाइज़ करें और SDK इंस्टॉल करें।

mkdir my-agent && cd my-agent
npm init -y
npm install @anthropic-ai/claude-code --save

TypeScript विकास के लिए, टाइप डेफिनिशन भी जोड़ें।

npm install typescript @types/node --save-dev
npx tsc --init

ANTHROPIC_API_KEY एनवायरनमेंट वेरिएबल सेट करें, और आप तैयार हैं।

export ANTHROPIC_API_KEY="sk-ant-..."

एक न्यूनतम एजेंट

यहां एक सरल एजेंट है जो फ़ाइल सिस्टम के साथ इंटरैक्ट कर सकता है।

import { Claude } from "@anthropic-ai/claude-code";

const agent = new Claude({
  model: "claude-sonnet-4-20250514",
  maxTurns: 10,
});

async function main() {
  const result = await agent.run(
    "src डायरेक्टरी में सभी TODO कमेंट्स की सूची बनाएं और उन्हें प्राथमिकता के अनुसार क्रमबद्ध करें"
  );
  console.log(result.text);
}

main();

maxTurns पैरामीटर एजेंट द्वारा निष्पादित किए जा सकने वाले अधिकतम चरणों को सीमित करता है। अनंत लूप से बचाव के लिए इसे हमेशा सेट करें।

कस्टम टूल्स परिभाषित करना

Agent SDK की असली शक्ति कस्टम टूल्स में है। एजेंट को बाहरी API या डेटाबेस तक पहुंच देकर, आप अधिक व्यावहारिक ऑटोमेशन सक्षम करते हैं।

import { Claude, Tool } from "@anthropic-ai/claude-code";

const fetchIssueTool: Tool = {
  name: "fetch_github_issue",
  description: "GitHub Issue प्राप्त करें",
  parameters: {
    type: "object",
    properties: {
      owner: { type: "string", description: "रिपॉजिटरी मालिक" },
      repo: { type: "string", description: "रिपॉजिटरी नाम" },
      number: { type: "number", description: "Issue नंबर" },
    },
    required: ["owner", "repo", "number"],
  },
  async execute({ owner, repo, number }) {
    const res = await fetch(
      `https://api.github.com/repos/${owner}/${repo}/issues/${number}`,
      { headers: { Authorization: `token ${process.env.GITHUB_TOKEN}` } }
    );
    return await res.json();
  },
};

const agent = new Claude({
  model: "claude-sonnet-4-20250514",
  tools: [fetchIssueTool],
  maxTurns: 15,
});

इस परिभाषा के साथ, एजेंट आवश्यकता पड़ने पर fetch_github_issue को कॉल करता है और प्राप्त जानकारी के आधार पर अपनी अगली कार्रवाई तय करता है।

मल्टी-स्टेप निष्पादन कैसे काम करता है

आंतरिक रूप से, Agent SDK निम्नलिखित लूप चलाता है:

1. योजना (Planning) — उपयोगकर्ता के निर्देश को आवश्यक चरणों में विभाजित करना
2. टूल चयन (Tool Selection) — उपलब्ध टूल्स में से इष्टतम का चयन
3. निष्पादन (Execution) — टूल चलाना और परिणाम कैप्चर करना
4. मूल्यांकन (Evaluation) — जांचना कि क्या लक्ष्य प्राप्त हो गया
5. दोहराना या पूरा करना — अधूरा होने पर चरण 1 पर वापस, या अंतिम उत्तर तैयार करना

यह लूप हर प्रक्रिया को पहले से हार्डकोड करने की आवश्यकता को समाप्त करता है, जिससे स्थिति के अनुसार लचीली प्रोसेसिंग संभव होती है।

व्यावहारिक उदाहरण: स्वचालित PR रिव्यू एजेंट

एक वास्तविक उपयोग मामला बनाएं — एक स्वचालित Pull Request रिव्यू एजेंट।

const agent = new Claude({
  model: "claude-sonnet-4-20250514",
  tools: [fetchIssueTool, readFileTool, postCommentTool],
  maxTurns: 20,
  systemPrompt: `आप कोड रिव्यू विशेषज्ञ हैं।
PR diff पढ़ें और इन बिंदुओं पर रिव्यू करें:
- संभावित बग
- सुरक्षा जोखिम
- प्रदर्शन समस्याएं
- सुधार सुझाव`,
});

const result = await agent.run(
  "PR #42 की रिव्यू करें और समस्याएं होने पर कमेंट छोड़ें"
);

systemPrompt में एजेंट की भूमिका और मूल्यांकन मानदंड निर्दिष्ट करके, आप सुसंगत और विश्वसनीय रिव्यू प्राप्त करते हैं।

एरर हैंडलिंग और रिट्राई

प्रोडक्शन वातावरण में मज़बूत एरर हैंडलिंग आवश्यक है।

const agent = new Claude({
  model: "claude-sonnet-4-20250514",
  maxTurns: 10,
  onError: (error, context) => {
    console.error(`चरण ${context.turn} पर एरर:`, error.message);
    if (context.turn >= 3) {
      return "abort"; // 3 विफलताओं के बाद रोकें
    }
    return "retry"; // अन्यथा पुनः प्रयास
  },
});

सारांश और अगले कदम

Agent SDK के साथ, आप एकल AI प्रतिक्रियाओं पर निर्भर रहने के बजाय जटिल बहु-चरणीय कार्यों को स्वचालित कर सकते हैं। फ़ाइल व्यवस्थापन या लॉग विश्लेषण जैसे छोटे कार्यों से शुरू करें, फिर धीरे-धीरे टूल्स जोड़कर अपने एजेंट की क्षमताओं का विस्तार करें।

Claude Code की मूल बातों के लिए आरंभ गाइड देखें। API-संचालित विकास के लिए API विकास गाइड देखें। CLI एकीकरण के लिए CLI टूल विकास देखें।

अधिक जानकारी के लिए Anthropic आधिकारिक दस्तावेज़ और Claude Code GitHub रिपॉजिटरी देखें।