Claude Code CLI: संपूर्ण तकनीकी संदर्भ गाइड
अपडेट: 12 दिसंबर, 2025
दिसंबर 2025 अपडेट: Claude Code अब एंटरप्राइज़ इंजीनियरिंग वर्कफ़्लो को शक्ति प्रदान करता है - एजेंटिक मल्टी-फ़ाइल एडिटिंग, 300+ बाहरी सेवाओं के साथ MCP प्रोटोकॉल इंटीग्रेशन, जटिल कार्यों के लिए विशेष सबएजेंट्स, और CI/CD ऑटोमेशन के लिए हुक्स सिस्टम। परमिशन सिस्टम सूक्ष्म स्तर पर सुरक्षा नियंत्रण सक्षम करता है। Haiku (तेज़/सस्ता) और Opus (शक्तिशाली) के बीच मॉडल स्विचिंग लागत-प्रदर्शन ट्रेडऑफ़ को अनुकूलित करती है।
मैंने महीनों Claude Code को प्रोडक्शन कोडबेस, CI/CD पाइपलाइन, और एंटरप्राइज़ डिप्लॉयमेंट में उसकी सीमाओं तक परखा है। यह गाइड उस अनुभव को उस व्यापक संदर्भ में संकलित करती है जो मैं चाहता था कि शुरू करते समय मौजूद होता। यह पहली इंस्टॉलेशन से लेकर उन उन्नत पैटर्न तक सब कुछ कवर करती है जो अधिकांश उपयोगकर्ता कभी नहीं खोज पाते।
Claude Code एक चैट इंटरफ़ेस नहीं है जो संयोग से प्रोग्रामिंग जानता है। यह एक एजेंटिक सिस्टम है जो आपके कोडबेस को पढ़ता है, कमांड एक्ज़ीक्यूट करता है, फ़ाइलें संशोधित करता है, git वर्कफ़्लो प्रबंधित करता है, बाहरी सेवाओं से जुड़ता है, और जटिल कार्यों को विशेष सबएजेंट्स को सौंपता है—यह सब एक कमांड-लाइन इंटरफ़ेस के माध्यम से जो डेवलपर्स के वास्तविक काम करने के तरीके में एकीकृत होता है।
Claude Code को आकस्मिक रूप से उपयोग करने और प्रभावी ढंग से उपयोग करने के बीच का अंतर इसकी आर्किटेक्चर को समझना है: व्यवहार को नियंत्रित करने वाली कॉन्फ़िगरेशन हायरार्की, ऑपरेशन को गेट करने वाला परमिशन सिस्टम, नियतात्मक ऑटोमेशन सक्षम करने वाला हुक सिस्टम, क्षमताओं का विस्तार करने वाला MCP प्रोटोकॉल, और जटिल मल्टी-स्टेप कार्यों को संभालने वाला सबएजेंट सिस्टम। इन सिस्टम में महारत हासिल करें और Claude Code एक फ़ोर्स मल्टीप्लायर बन जाता है। इन्हें मिस करें और आप अधिकांश मूल्य छोड़ रहे हैं।
यह गाइड मानती है कि आप कमांड-लाइन टूल्स के साथ सहज हैं और पूरी तस्वीर चाहते हैं। हर फ़ीचर वास्तविक सिंटैक्स, असली कॉन्फ़िगरेशन उदाहरणों, और उन एज केसेस के साथ प्रलेखित है जो अनुभवी उपयोगकर्ताओं को भी परेशान करते हैं। चाहे आप अपना पहला प्रोजेक्ट सेट कर रहे हों या पूरे एंटरप्राइज़ इंजीनियरिंग ऑर्गनाइज़ेशन में डिप्लॉय कर रहे हों, जानकारी यहाँ है।
Claude Code कैसे काम करता है: मानसिक मॉडल
फ़ीचर्स में गहराई से जाने से पहले, समझें कि Claude Code की आर्किटेक्चर आपके द्वारा इसके साथ किए जाने वाले हर काम को कैसे आकार देती है। सिस्टम तीन परतों में काम करता है:
┌─────────────────────────────────────────────────────────┐
│ CLAUDE CODE परतें │
├─────────────────────────────────────────────────────────┤
│ एक्सटेंशन परत │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ MCP │ │ Hooks │ │ Skills │ │ Plugins │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ बाहरी टूल्स, नियतात्मक ऑटोमेशन, डोमेन │
│ विशेषज्ञता, पैकेज्ड एक्सटेंशन │
├─────────────────────────────────────────────────────────┤
│ डेलीगेशन परत │
│ ┌─────────────────────────────────────────────────┐ │
│ │ सबएजेंट्स (10 तक पैरलल) │ │
│ │ Explore | Plan | General-purpose | Custom │ │
│ └─────────────────────────────────────────────────┘ │
│ फ़ोकस्ड काम के लिए आइसोलेटेड कॉन्टेक्स्ट, सारांश लौटाते हैं │
├─────────────────────────────────────────────────────────┤
│ कोर परत │
│ ┌─────────────────────────────────────────────────┐ │
│ │ मुख्य वार्तालाप कॉन्टेक्स्ट │ │
│ │ Tools: Read, Edit, Bash, Glob, Grep, etc. │ │
│ └─────────────────────────────────────────────────┘ │
│ आपकी प्राथमिक बातचीत; सीमित कॉन्टेक्स्ट; पैसे खर्च होते हैं │
└─────────────────────────────────────────────────────────┘
कोर परत: आपकी मुख्य बातचीत। हर संदेश, फ़ाइल रीड, और टूल आउटपुट साझा 200K टोकन विंडो (प्रीमियम के साथ 1M) से कॉन्टेक्स्ट खपत करता है। जब कॉन्टेक्स्ट भर जाता है, Claude पहले के निर्णयों का ट्रैक खो देता है और गुणवत्ता घटती है। इस परत पर प्रति टोकन पैसे खर्च होते हैं।
डेलीगेशन परत: सबएजेंट्स साफ़ कॉन्टेक्स्ट के साथ स्पॉन होते हैं, फ़ोकस्ड काम करते हैं, और सारांश लौटाते हैं। एक्सप्लोरेशन परिणाम आपकी मुख्य बातचीत को ब्लोट नहीं करते—केवल निष्कर्ष लौटते हैं। एक्सप्लोरेशन के लिए Haiku सबएजेंट्स (सस्ते, तेज़) और इम्प्लीमेंटेशन के लिए Sonnet का उपयोग करें।
एक्सटेंशन परत: MCP बाहरी सेवाओं (डेटाबेस, GitHub, Sentry) से जोड़ता है। हुक्स मॉडल व्यवहार की परवाह किए बिना शेल कमांड के एक्ज़ीक्यूशन की गारंटी देते हैं। स्किल्स डोमेन विशेषज्ञता को एनकोड करती हैं जिसे Claude स्वचालित रूप से लागू करता है। प्लगइन्स इन सभी को वितरण के लिए पैकेज करते हैं।
मुख्य अंतर्दृष्टि: अधिकांश उपयोगकर्ता पूरी तरह से कोर परत में काम करते हैं, कॉन्टेक्स्ट ब्लोट और लागत बढ़ते देखते हैं। पावर यूज़र्स एक्सप्लोरेशन और विशेष काम को डेलीगेशन परत में धकेलते हैं, एक्सटेंशन परत को अपने वर्कफ़्लो के लिए कॉन्फ़िगर रखते हैं, और कोर परत का उपयोग केवल ऑर्केस्ट्रेशन और अंतिम निर्णयों के लिए करते हैं।
विषय सूची
- इंस्टॉलेशन और ऑथेंटिकेशन
- कोर इंटरैक्शन मोड्स
- कॉन्फ़िगरेशन सिस्टम गहराई में
- मॉडल सेलेक्शन और स्विचिंग
- परमिशन सिस्टम और सुरक्षा
- हुक्स सिस्टम
- MCP (Model Context Protocol)
- सबएजेंट्स और टास्क डेलीगेशन
- एक्सटेंडेड थिंकिंग मोड
- आउटपुट स्टाइल्स
- स्लैश कमांड्स
- स्किल्स
- प्लगइन सिस्टम
- मेमोरी और कॉन्टेक्स्ट मैनेजमेंट
- इमेज और मल्टीमोडल इनपुट
- Git इंटीग्रेशन और वर्कफ़्लो
- IDE इंटीग्रेशन
- उन्नत उपयोग पैटर्न
- Claude Code Remote
- बैकग्राउंड एजेंट्स (दिसंबर 2025)
- लागत प्रबंधन और बिलिंग
- प्रदर्शन अनुकूलन
- ट्रबलशूटिंग और डिबगिंग
- एंटरप्राइज़ डिप्लॉयमेंट
- कीबोर्ड शॉर्टकट्स संदर्भ
- सर्वोत्तम प्रथाएं
इंस्टॉलेशन और ऑथेंटिकेशन
सिस्टम आवश्यकताएं
Claude Code macOS 10.15+, Ubuntu 20.04+/Debian 10+, और Windows 10+ पर WSL या Git Bash के माध्यम से चलता है। सिस्टम को न्यूनतम 4 GB RAM और एक सक्रिय इंटरनेट कनेक्शन की आवश्यकता है। शेल संगतता Bash, Zsh, या Fish के साथ सबसे अच्छी काम करती है।
Windows के लिए, WSL 1 और WSL 2 दोनों काम करते हैं। यदि आप नेटिव Windows पसंद करते हैं तो Git Bash भी काम करता है। Alpine Linux और अन्य musl-आधारित सिस्टम को अतिरिक्त पैकेज की आवश्यकता होती है:
apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0
इंस्टॉलेशन विधियां
नेटिव इंस्टॉलेशन (अनुशंसित)
नेटिव बाइनरी बिना Node.js डिपेंडेंसी के सबसे साफ़ अनुभव प्रदान करती है:
# macOS और Linux
curl -fsSL https://claude.ai/install.sh | bash
# Homebrew विकल्प
brew install --cask claude-code
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
संस्करण-विशिष्ट इंस्टॉलेशन के लिए:
# विशिष्ट संस्करण इंस्टॉल करें
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58
# स्पष्ट रूप से नवीनतम इंस्टॉल करें
curl -fsSL https://claude.ai/install.sh | bash -s latest
# Windows PowerShell - विशिष्ट संस्करण
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58
NPM इंस्टॉलेशन
जहां npm को प्राथमिकता दी जाती है उन परिवेशों के लिए:
npm install -g @anthropic-ai/claude-code
npm इंस्टॉलेशन के साथ कभी भी sudo का उपयोग न करें—यह परमिशन समस्याएं पैदा करता है जो डाउनस्ट्रीम में सब कुछ जटिल बनाती हैं।
मौजूदा इंस्टॉलेशन से माइग्रेशन
यदि आपके पास पुरानी npm-आधारित इंस्टॉलेशन है, तो नेटिव बाइनरी में माइग्रेट करें:
claude install
ऑथेंटिकेशन विकल्प
Claude Code तीन ऑथेंटिकेशन पथों का समर्थन करता है, प्रत्येक अलग-अलग ट्रेडऑफ़ के साथ:
Claude Console (API बिलिंग)
console.anthropic.com के माध्यम से सीधे Anthropic के API से जुड़ें। एक खाता बनाएं, बिलिंग सेट करें, और CLI के माध्यम से ऑथेंटिकेट करें। यह पूर्ण API एक्सेस के साथ उपयोग-आधारित बिलिंग प्रदान करता है। एक समर्पित "Claude Code" वर्कस्पेस स्वचालित रूप से बनाया जाता है—आप इस वर्कस्पेस के लिए API कीज़ नहीं बना सकते, लेकिन आप उपयोग की निगरानी कर सकते हैं।
Claude Pro या Max सब्सक्रिप्शन
अपने claude.ai खाता क्रेडेंशियल्स का उपयोग करें। सब्सक्रिप्शन एक मासिक प्लान के तहत वेब इंटरफ़ेस और CLI उपयोग दोनों को कवर करती है। यह उन व्यक्तिगत उपयोगकर्ताओं के लिए बिलिंग को सरल बनाती है जो पूर्वानुमानित लागत चाहते हैं।
एंटरप्राइज़ प्लेटफ़ॉर्म
AWS Bedrock, Google Vertex AI, और Microsoft Foundry प्रत्येक मौजूदा क्लाउड बिलिंग संबंधों के साथ एंटरप्राइज़-ग्रेड एक्सेस प्रदान करते हैं:
# AWS Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export AWS_PROFILE=your-profile
# Google Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project
# Microsoft Foundry
export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource-name
# वैकल्पिक: API key auth (अन्यथा Entra ID का उपयोग करता है)
export ANTHROPIC_FOUNDRY_API_KEY=your-key
प्रॉक्सी के पीछे या LLM गेटवे के माध्यम से एंटरप्राइज़ डिप्लॉयमेंट के लिए:
# कॉर्पोरेट प्रॉक्सी
export HTTPS_PROXY='https://proxy.example.com:8080'
# LLM गेटवे (नेटिव auth स्किप करें)
export CLAUDE_CODE_USE_BEDROCK=1
export ANTHROPIC_BEDROCK_BASE_URL='https://your-gateway.com/bedrock'
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
सत्यापन
claude doctor
यह इंस्टॉलेशन प्रकार, संस्करण, सिस्टम कॉन्फ़िगरेशन, और किसी भी पहचानी गई समस्याओं की रिपोर्ट करता है।
अपडेट्स
Claude Code डिफ़ॉल्ट रूप से ऑटो-अपडेट होता है, स्टार्टअप पर और सेशन के दौरान समय-समय पर जांच करता है। अपडेट्स बैकग्राउंड में डाउनलोड होते हैं और अगले लॉन्च पर लागू होते हैं।
ऑटो-अपडेट्स अक्षम करें:
export DISABLE_AUTOUPDATER=1
या settings.json में:
{
"env": {
"DISABLE_AUTOUPDATER": "1"
}
}
मैनुअल अपडेट:
claude update
अनइंस्टॉलेशन
नेटिव इंस्टॉलेशन (macOS/Linux/WSL):
rm -f ~/.local/bin/claude
rm -rf ~/.claude-code
नेटिव इंस्टॉलेशन (Windows PowerShell):
Remove-Item -Path "$env:LOCALAPPDATA\Programs\claude-code" -Recurse -Force
Remove-Item -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\claude.exe" -Force
कॉन्फ़िगरेशन साफ़ करें (सभी सेटिंग्स हटाता है):
rm -rf ~/.claude
rm ~/.claude.json
rm -rf .claude
rm -f .mcp.json
कोर इंटरैक्शन मोड्स
इंटरैक्टिव REPL
Claude Code को बिना आर्ग्युमेंट्स के लॉन्च करें इंटरैक्टिव रीड-इवैल-प्रिंट लूप में प्रवेश करने के लिए:
cd your-project
claude
REPL टर्न्स के बीच बातचीत कॉन्टेक्स्ट बनाए रखता है। सीधे क्वेरी टाइप करें, प्रतिक्रियाएं प्राप्त करें, और /exit या Ctrl+D के साथ बाहर निकलने तक जारी रखें।
सेशन को फ़ोकस करने के लिए एक प्रारंभिक प्रॉम्प्ट के साथ शुरू करें:
claude "explain the authentication flow in this project"
विशेषज्ञ सुझाव: REPL कॉम्पैक्शन इवेंट्स के बीच स्टेट बनाए रखता है। जब कॉन्टेक्स्ट बहुत बड़ा हो जाता है, Claude स्वचालित रूप से पुरानी बातचीत का सारांश बनाता है जबकि मुख्य निर्णयों और कोड स्निपेट्स को संरक्षित रखता है। आप इसे /compact के साथ मैन्युअल रूप से ट्रिगर कर सकते हैं या क्या संरक्षित करना है इसके लिए कस्टम निर्देश जोड़ सकते हैं।
नॉन-इंटरैक्टिव मोड
प्रिंट मोड (-p) एक क्वेरी एक्ज़ीक्यूट करता है और बाहर निकलता है:
# डायरेक्ट क्वेरी
claude -p "list all TODO comments in this project"
# पाइप्ड इनपुट प्रोसेस करें
cat error.log | claude -p "identify the root cause of these failures"
# अन्य टूल्स के साथ चेन करें
claude -p "generate a README" > README.md
स्क्रिप्ट्स में पार्सिंग के लिए उपयुक्त स्ट्रक्चर्ड आउटपुट के लिए:
claude -p "count lines by file type" --output-format json
JSON आउटपुट में ऑटोमेशन के लिए आवश्यक सब कुछ शामिल है:
{
"type": "result",
"subtype": "success",
"total_cost_usd": 0.0034,
"is_error": false,
"duration_ms": 2847,
"duration_api_ms": 1923,
"num_turns": 4,
"result": "Response text here...",
"session_id": "abc-123-d
[सामग्री अनुवाद के लिए छोटी की गई]
