AI परिचय 2. Claude Code में AI-vibecoding के लिए macOS परिवेश की सेटिंग

यह पाठ Claude Code (Codex), GitHub, Python, JavaScript, ऑडियो, Google-सेवाओं, plugins, MCP, AGENTS.md, skills और फ़ोल्डरों की कमांड संरचना के साथ काम करने के लिए macOS तैयार करने के सही क्रम का वर्णन करता है।

चरण 1. अद्यतन macOS और व्यवस्थापक अधिकारों वाला macOS खाता

Claude Code (Codex) पर AI-vibecoding के लिए परिवेश सेट करने से पहले, यह सुनिश्चित करना आवश्यक है कि स्वयं कंप्यूटर ऑपरेटिंग सिस्टम के स्तर पर इस कार्य के लिए तैयार है।

1. आधुनिक macOS का उपयोग करें

Claude Code (Codex) के साथ केवल अद्यतन, आधुनिक macOS 26 Tahoe संस्करण पर काम करना आवश्यक है, जिसमें अपडेट का समर्थन हो। ऑपरेटिंग सिस्टम के 3-5 वर्ष पुराने संस्करणों पर काम नहीं किया जा सकता।

पुराना macOS लगभग अनिवार्य रूप से समस्याओं की ओर ले जाएगा:

एक्सेस त्रुटियां;
अधिकारों की त्रुटियां;
आधुनिक डेवलपमेंट टूल्स के साथ असंगतता;
पैकेज और dependencies इंस्टॉल करने में समस्याएं;
टर्मिनल, ब्राउज़र, IDE, Claude Code (Codex) और संबंधित उपकरणों का अस्थिर काम।

AI-vibecoding के लिए यह महत्वपूर्ण है कि सिस्टम developer tools, shell-उपकरणों, ब्राउज़रों, Node.js, Python, Docker/OrbStack, GitHub CLI और परिवेश के अन्य घटकों के आधुनिक संस्करणों का समर्थन करे।

2. सभी उपलब्ध macOS अपडेट इंस्टॉल करें

केवल नया macOS होना पर्याप्त नहीं है। अपने Desktop या Laptop पर AI परिवेश सेट करना शुरू करने से पहले, आज की तारीख के सभी उपलब्ध सिस्टम अपडेट इंस्टॉल करने चाहिए।

जांच यहां से की जाती है:

System Settings -> General -> Software Update

यदि macOS अपडेट प्रस्तावित करता है, तो Claude Code (Codex)-परिवेश सेट करने से पहले उन्हें इंस्टॉल करना चाहिए।

यह निम्न से जुड़ी आकस्मिक त्रुटियों का जोखिम कम करता है:

पुराने सिस्टम libraries;
अधूरे security updates;
Xcode Command Line Tools की असंगति;
permissions की समस्याएं;
टर्मिनल, shell-स्क्रिप्ट और package managers का अस्थिर काम।

3. मुख्य व्यवस्थापक खाते से काम करें

AI-vibecoding परिवेश को व्यवस्थापक अधिकारों वाले मुख्य macOS खाते से सेट और उपयोग करना चाहिए।

सीमित खाते, guest-अकाउंट या admin-access रहित प्रोफ़ाइल से सेटअप शुरू नहीं करना चाहिए।

व्यवस्थापक अधिकार इन कामों के लिए आवश्यक हैं:

developer tools इंस्टॉल करना;
Homebrew और सिस्टम dependencies इंस्टॉल करना;
shell और paths सेट करना;
macOS permissions प्रबंधित करना;
ब्राउज़र, IDE, CLI-उपकरण और स्थानीय सेवाएं इंस्टॉल करना;
फ़ाइलों, certificates, keys और स्थानीय servers तक पहुंच की समस्याएं दूर करना।

नियम

किसी भी इंस्टॉलेशन से पहले पहला कदम:

macOS आधुनिक, पूरी तरह अपडेटेड होना चाहिए और व्यवस्थापक खाते से उपयोग किया जाना चाहिए।

यदि यह शर्त पूरी नहीं होती है, तो Claude Code (Codex) के लिए परिवेश सेटअप शुरू न करना बेहतर है: आगे की त्रुटियां Claude Code, Node.js, Python, Git या Homebrew की समस्याओं जैसी दिखेंगी, जबकि वास्तव में कारण तैयार न किया गया सिस्टम होगा।

चरण 2. Claude Code इंस्टॉल करें और प्रोजेक्ट्स के लिए कार्य फ़ोल्डर बनाएं

macOS, अपडेट और व्यवस्थापक अधिकारों की जांच के बाद अगला कदम Claude Code (Codex) इंस्टॉल करना और फ़ाइल सिस्टम में वह स्थान तैयार करना है जहां AI-vibecoding प्रोजेक्ट्स रखे जाएंगे।

1. macOS पर Claude Code प्रोजेक्ट्स कहां रखें

macOS पर परिचित "My Documents" फ़ोल्डर का समकक्ष है:

~/Documents

Claude Code (Codex) के साथ काम के लिए इसके भीतर अलग फ़ोल्डर बनाना बेहतर है:

~/Documents/Claude
~/Documents/Codex

ठीक यहीं उन प्रोजेक्ट फ़ोल्डरों को रखना चाहिए जिनके साथ Claude Code काम करेगा:

~/Documents/Claude/
  AI/
  Product/
  Project-1/
  Project-2/
  Product-docs/
  Experiments/

बुनियादी टीम onboarding के लिए तुरंत दो शुरुआती फ़ोल्डर बनाए जा सकते हैं:

~/Documents/Claude/
  AI/
  Product/

AI Claude Code की सेटिंग, प्रशिक्षण, handoff-दस्तावेज़ों, AI-उपकरणों के प्रयोगों और AI-workflow की सामग्रियों का फ़ोल्डर है।

Product उत्पाद संबंधी काम का फ़ोल्डर है: PRD, specifications, transcripts, Markdown-दस्तावेज़, ज्ञान आधार और वे फ़ाइलें जो बाद में GitHub, Confluence या अन्य टीम प्रणालियों के साथ सिंक्रनाइज़ हो सकती हैं।

फ़ोल्डर नाम लैटिन वर्णों में लिखना बेहतर है: AI, Product, Claude। इस प्रकार shell-स्क्रिप्ट, paths, CI, package managers और डेवलपमेंट टूल्स में समस्याओं का सामना करने की संभावना कम होती है।

क्यों ठीक `~/Documents/Claude, और Desktop या Downloads में यादृच्छिक फ़ोल्डरों का उपयोग करना बेहतर है:

path मनुष्य और एजेंट के लिए स्पष्ट है;
AI प्रोजेक्ट्स में फ़ोल्डरों और फ़ाइलों के सही एक्सेस अधिकार (सबसे महत्वपूर्ण);
प्रोजेक्ट एक पूर्वानुमेय स्थान पर रहते हैं;
downloads और अस्थायी दस्तावेज़ों के बीच फ़ाइलें खोने का जोखिम कम;
Claude को context देना अधिक सुविधाजनक: "~/Documents/Claude/... में प्रोजेक्ट पर काम करो";
backups बनाना आसान;
कार्य संरचना को नए Mac पर स्थानांतरित करना आसान।

फ़ोल्डर Finder से या Terminal से बनाया जा सकता है:

mkdir -p "$HOME/Documents/Claude"

2. Claude Code CLI इंस्टॉल करें

Claude Code CLI टर्मिनल से काम करने के लिए आवश्यक है: प्रोजेक्ट फ़ोल्डर खोलना, claude चलाना, एजेंट को कार्य देना, उसे फ़ाइलें पढ़ने, कोड संपादित करने और कमांड चलाने की अनुमति देना।

macOS/Linux पर इंस्टॉलेशन का वर्तमान आधिकारिक तरीका:

curl -fsSL https://chatgpt.com/codex/install.sh | sh

इंस्टॉलेशन के बाद जांचना चाहिए कि कमांड उपलब्ध है:

codex --version

फिर कार्य फ़ोल्डर में जाकर Claude Code (Codex) चलाया जा सकता है:

cd "$HOME/Documents/Claude Code (Codex)"
codex

पहली शुरुआत पर Claude Code (Codex) ChatGPT-अकाउंट या OpenAI API key के माध्यम से लॉग इन करने को कहेगा।

3. Claude Code desktop app इंस्टॉल करें

CLI के बाद, macOS पर Claude Code (Codex) desktop app इंस्टॉल करना आवश्यक है। AI infrastructure के साथ पूर्ण काम के लिए आपको Claude का desktop संस्करण चाहिए, जिसमें Claude Code और Claude Co-work शामिल हैं। केवल ब्राउज़र संस्करण के माध्यम से Claude के साथ काम करना आपकी क्षमताओं को काफी सीमित करता है।

Claude Code (Codex) app इन कार्यों के लिए आवश्यक है:

स्थानीय रूप से इंस्टॉल किए गए फ़ोल्डरों और फ़ाइलों के साथ काम
स्थानीय रूप से इंस्टॉल की गई programming languages के साथ काम
plugins के साथ पूर्ण काम, Google, Atlassian, Github सेवाओं से जुड़ना
coding और vibecoding
coding में voice interface और pictures/screenshots interface का उपयोग
कई प्रोजेक्ट्स के साथ काम;
dev server, tests, build जैसी actions चलाना;
केवल टर्मिनल की अपेक्षा अधिक सुविधाजनक दैनिक AI-vibecoding।

Apple Silicon वाले Mac पर Codex Desktop app इंस्टॉल करते समय Apple Silicon build चुनना चाहिए। Intel Core processors वाले Mac पर Intel build चुनें।

4. Mac पर बुनियादी संरचना कैसी दिखनी चाहिए

पहले चरण में स्थानीय फ़ोल्डरों की न्यूनतम संरचना:

~/Documents/Claude/
  AI/
  Product/

उपयोगकर्ता Documents के भीतर मुख्य Claude फ़ोल्डर में अपने प्रोजेक्ट्स के फ़ोल्डर बनाता है:

cd "$HOME/Documents/Claude/Product"
claude

और फिर इन प्रोजेक्ट्स को Claude Code desktop app में Project -> Use an existing folder द्वारा जोड़ता है।

महत्वपूर्ण: यदि फ़ोल्डर उस प्रोजेक्ट के लिए बनाया जा रहा है जिस पर टीम पहले से काम कर रही है, तो उसमें तुरंत यादृच्छिक फ़ाइलें नहीं लिखनी चाहिए। प्रोजेक्ट से संबंधित GitHub repository ढूंढना चाहिए और फिर GitHub repository से प्रोजेक्ट की सामग्री भरनी चाहिए।

अन्यथा प्रोजेक्ट के दो अलग-अलग "वर्तमान" संस्करण प्राप्त करना बहुत आसान है।

5. नियम

सेटअप का दूसरा चरण:

Claude Code CLI इंस्टॉल करें, Claude Code Desktop App इंस्टॉल करें और उन सभी प्रोजेक्ट्स के लिए जिनके साथ Claude Code काम करेगा, स्थायी कार्य फ़ोल्डर `~/Documents/Claude बनाएं।

प्रोजेक्ट्स को Desktop, Downloads और यादृच्छिक अस्थायी फ़ोल्डरों में नहीं बिखेरना चाहिए। Claude Code तब बेहतर काम करता है जब उसके पास सही अधिकारों और स्थानीय फ़ोल्डरों व फ़ाइलों तक पहुंच के साथ स्थिर, स्पष्ट फ़ाइल सिस्टम संरचना होती है।

चरण 03. macOS पर टर्मिनल और कमांड लाइन

Claude Code (Codex) इंस्टॉल करने के बाद सही ढंग से तय करना चाहिए कि टीम Mac पर किस कमांड लाइन के माध्यम से काम करती है।

कमांड लाइन application, या terminal, coding और vibecoding के दौरान ऑपरेटिंग सिस्टम और फ़ाइलों के लिए निम्न-स्तरीय कमांड चलाने और निष्पादित करने हेतु आवश्यक है।

Windows में हम अक्सर कहते हैं "PowerShell 7 इंस्टॉल करना"। macOS पर स्थिति अलग है: मूल कमांड लाइन पहले से सिस्टम में अंतर्निहित है।

1. macOS पर PowerShell 7 का समकक्ष क्या है

macOS में दो अलग-अलग चीजें हैं जिन्हें अक्सर भ्रमित किया जाता है:

terminal application, अर्थात वह विंडो जिसमें कमांड दर्ज किए जाते हैं;
shell, अर्थात वह प्रोग्राम जो इन कमांड्स को समझता और निष्पादित करता है।

अंतर्निहित terminal application का नाम है:

Terminal.app

आधुनिक macOS में अंतर्निहित मानक shell:

zsh

zsh को अलग से इंस्टॉल करने की आवश्यकता नहीं है। यह पहले से आधुनिक macOS में शामिल है और सामान्यतः मानक Terminal.app में डिफ़ॉल्ट रूप से चलता है।

अर्थात Mac पर कार्यशील कमांड लाइन का बुनियादी समकक्ष PowerShell नहीं, बल्कि यह संयोजन है:

Terminal.app + zsh

यह इंस्टॉलेशन कमांड्स चलाने, Claude Code (Codex) CLI चलाने, Git, Homebrew, Node.js, Python और प्रोजेक्ट्स के साथ काम करने के लिए पर्याप्त है।

जांचें कि अभी कौन-सा shell उपयोग हो रहा है:

echo "$SHELL"

सामान्य अपेक्षित परिणाम:

/bin/zsh

zsh संस्करण जांचें:

zsh --version

2. क्या अंतर्निहित Terminal.app पर्याप्त है

हां, शुरुआत के लिए अंतर्निहित Terminal.app पर्याप्त है।

यह पहले से macOS में मौजूद है और यहां स्थित है:

Applications -> Utilities -> Terminal

या इसे Spotlight से खोला जा सकता है:

Cmd + Space -> Terminal -> Enter

AI परिवेश की पहली सेटिंग के लिए अतिरिक्त terminal इंस्टॉल करने की आवश्यकता नहीं है। कार्यशील Claude Code तक जितने कम अतिरिक्त चरण हों, उतना बेहतर है।

4. iTerm2 कब इंस्टॉल करना उचित है

मूल सेटअप के बाद iTerm2 को अधिक सुविधाजनक terminal application के रूप में इंस्टॉल किया जा सकता है।

iTerm2 shell को नहीं बदलता। वह केवल terminal की विंडो को बदलता है। इसके अंदर भी सामान्यतः वही zsh चलता है।

iTerm2 उपयोगी है यदि किसी व्यक्ति को चाहिए:

सुविधाजनक tabs और split panes;
profiles;
output history में तेज खोज;
fonts और colors की अधिक लचीली सेटिंग;
terminal में आरामदायक दैनिक काम।

लेकिन iTerm2 अनिवार्य पहला कदम नहीं होना चाहिए। पहले टीम को सामान्य Terminal.app खोलना और बुनियादी कमांड्स निष्पादित करना आना चाहिए।

6. टीम के प्रत्येक सदस्य को क्या आना चाहिए

परिवेश की आगे की इंस्टॉलेशन से पहले व्यक्ति को यह आना चाहिए:

Terminal.app खोलना;
प्रोजेक्ट फ़ोल्डर में जाना:

cd "$HOME/Documents/Claude"

वर्तमान फ़ोल्डर देखना:

pwd

फ़ाइलों की सूची देखना:

ls

फ़ोल्डर बनाना:

mkdir -p "$HOME/Documents/Claude"

Claude Code चलाना:

claude

7. नियम

सेटअप का तीसरा चरण:

macOS पर टीम अंतर्निहित Terminal.app और मानक shell zsh के माध्यम से काम करती है। iTerm2 को बाद में अधिक सुविधाजनक terminal विंडो के रूप में इंस्टॉल किया जा सकता है, लेकिन शुरुआत की अनिवार्य शर्त के रूप में नहीं।

यह दृष्टिकोण सरल है, macOS के अधिक निकट है और AI-vibecoding में उपयोग होने वाले अधिकांश developer tools के साथ बेहतर संगत है।

चरण 04. Claude Code के साथ काम के लिए macOS पर स्क्रीनशॉट्स

Claude Code (Codex) के साथ AI-vibecoding के लिए स्क्रीनशॉट्स context देने के मुख्य तरीकों में से एक हैं। टीम को आवश्यक विंडो या स्क्रीन क्षेत्र को तेज़ी से कैप्चर करना और तुरंत छवि Claude Code में डालना आना चाहिए।

1. क्या अलग screenshot tool आवश्यक है

पहले चरण में अलग screenshot tool इंस्टॉल करने की आवश्यकता नहीं है।

macOS में पहले से अंतर्निहित screenshot tool है। Claude Code के साथ बुनियादी काम के लिए यह पर्याप्त रूप से अच्छा है:

पूरी स्क्रीन कैप्चर करना;
चयनित क्षेत्र कैप्चर करना;
किसी विशिष्ट विंडो को कैप्चर करना;
screenshot तुरंत clipboard में कॉपी करना;
फ़ाइल को डिस्क पर सहेजे बिना screenshot को Claude Code (Codex) में डालना।

स्क्रीनशॉट्स और voice messages के माध्यम से Claude Code (Codex) के साथ संवाद के लिए ठीक यही परिदृश्य आवश्यक है।

2. मुख्य आवश्यकता

screenshot tool के लिए मुख्य आवश्यकता:

hotkey दबाएं, विशिष्ट विंडो या क्षेत्र चुनें, चित्र को clipboard में रखें और उसे तुरंत Claude Code (Codex) में डालें।

Mac पर paste सामान्यतः Ctrl+V से नहीं, बल्कि इसके माध्यम से किया जाता है:

Cmd+V

अर्थात कार्यशील परिदृश्य ऐसा है:

स्क्रीनशॉट लिया -> स्क्रीनशॉट clipboard में गया -> Claude Code (Codex) खोला -> Cmd+V दबाया

3. macOS के बुनियादी hotkeys

स्क्रीन क्षेत्र का screenshot फ़ाइल में:

Shift+Cmd+4

स्क्रीन क्षेत्र का screenshot तुरंत clipboard में:

Ctrl+Shift+Cmd+4

इसके बाद आवश्यक क्षेत्र को mouse से चुनना होगा। screenshot अलग फ़ाइल के रूप में नहीं सहेजा जाएगा, बल्कि clipboard में चला जाएगा। फिर इसे Cmd+V द्वारा Claude Code (Codex) में डाला जा सकता है।

विशिष्ट विंडो का screenshot clipboard में:

Ctrl+Shift+Cmd+4 -> Space -> आवश्यक विंडो पर क्लिक

यह Claude Code (Codex) के साथ काम का सबसे महत्वपूर्ण विकल्प है, क्योंकि यह एजेंट को तेज़ी से विशिष्ट विंडो दिखाने देता है: browser, terminal, error, IDE, macOS settings या application के काम का परिणाम।

Screenshot panel:

Shift+Cmd+5

इसके माध्यम से screenshot या screen recording का मोड चुना जा सकता है, तथा यह भी सेट किया जा सकता है कि screenshots कहां सहेजे जाएं।

4. टीम के लिए Best practice

टीम मानक:

मुख्य उपकरण: अंतर्निहित macOS Screenshot
अनिवार्य कौशल: क्षेत्र या विंडो का स्क्रीनशॉट सीधे clipboard में
Claude Code (Codex) में मुख्य paste: Cmd+V
तृतीय-पक्ष screenshot tool: शुरुआत में आवश्यक नहीं

टीम के प्रत्येक सदस्य को कम से कम दो कमांड सीखनी चाहिए:

Ctrl+Shift+Cmd+4

clipboard में क्षेत्र के screenshot के लिए।

Ctrl+Shift+Cmd+4 -> Space -> click

clipboard में विशिष्ट विंडो के screenshot के लिए।

5. नियम

सेटअप का चौथा चरण:

टीम अंतर्निहित macOS Screenshot उपयोग करती है और अनिवार्य रूप से क्षेत्र या विशिष्ट विंडो का screenshot तुरंत clipboard में लेना जानती है, ताकि उसे Cmd+V से Claude Code (Codex) में डाला जा सके।

यह महत्वपूर्ण है, क्योंकि Claude Code (Codex) के साथ प्रभावी काम केवल टेक्स्ट पर नहीं, बल्कि errors, interfaces, terminal, browser और application के काम के परिणामों के तेज़ screenshots पर भी आधारित होता है।

चरण 05. macOS पर Xcode Command Line Tools

Windows पर JavaScript/Node.js प्रोजेक्ट्स के लिए कभी-कभी Microsoft Visual Studio Build Tools 2022 इंस्टॉल करने की आवश्यकता होती है, ताकि native dependencies compile हो सकें: ऐसे packages जो npm install या pnpm install के दौरान node-gyp के माध्यम से C/C++-code compile करते हैं।

macOS पर Xcode Command Line Tools इंस्टॉल किए जाते हैं।

यह बिंदु Git, GitHub CLI, Homebrew, Python-packages, Node.js-packages और FFmpeg इंस्टॉल करने से पहले पूरा करना चाहिए, क्योंकि Xcode Command Line Tools macOS को बुनियादी developer toolchain देते हैं।

1. macOS पर Xcode Command Line Tools

macOS पर Build tools Apple के उपकरण हैं:

Xcode Command Line Tools

इन्हें यह भी कहा जाता है:

Command Line Tools for Xcode

वे सिस्टम को compiler toolchain देते हैं, जो native packages बनाने के लिए आवश्यक है:

clang;
make;
headers;
SDK;
developer command-line utilities.

2. क्या यह डिफ़ॉल्ट रूप से macOS में शामिल होता है

Xcode Command Line Tools macOS के लिए Apple के उपकरण हैं, लेकिन वे हमेशा नए Mac पर इंस्टॉल नहीं होते।

वे पहले से इंस्टॉल हो सकते हैं, उदाहरण के लिए:

Git इंस्टॉल करते समय;
पहली developer command चलाने पर;
Homebrew इंस्टॉल करते समय;
Xcode इंस्टॉल करते समय;
xcode-select --install निष्पादित करते समय।

इसलिए सही दृष्टिकोण:

अनुमान न लगाएं, जांचें

3. इंस्टॉलेशन कैसे जांचें

active developer tools का path जांचें:

xcode-select -p

यदि tools इंस्टॉल हैं, तो कमांड एक path दिखाएगी, उदाहरण के लिए:

/Library/Developer/CommandLineTools

compiler जांचें:

clang --version

make जांचें:

make --version

यदि ये कमांड्स काम करती हैं, तो बुनियादी build tools तैयार हैं।

4. Xcode Command Line Tools कैसे इंस्टॉल करें

यदि tools इंस्टॉल नहीं हैं:

xcode-select --install

macOS एक सिस्टम इंस्टॉलेशन विंडो खोलेगा। इंस्टॉलेशन के लिए सहमत होना और उसके पूरा होने की प्रतीक्षा करनी चाहिए।

इंस्टॉलेशन के बाद फिर जांचें:

xcode-select -p
clang --version
make --version

5. पूर्ण Xcode सामान्यतः आवश्यक नहीं है

पूर्ण Xcode application बहुत जगह लेता है और हमेशा आवश्यक नहीं होता।

Claude Code (Codex), Node.js, Python, Homebrew, Git और native npm/pnpm dependencies के अधिकांश कार्यों के लिए पर्याप्त है:

Xcode Command Line Tools

पूर्ण Xcode केवल तब आवश्यक है यदि प्रोजेक्ट स्पष्ट रूप से जुड़ा है:

iOS development;
macOS app development;
Swift/Objective-C projects;
Xcode projects;
iPhone/iPad simulators;
Apple-applications के build से।

यदि ऐसे कार्य नहीं हैं, तो डिफ़ॉल्ट रूप से पूर्ण Xcode इंस्टॉल नहीं करते।

6. Node.js और pnpm से संबंध

कुछ JavaScript-packages इंस्टॉलेशन के समय node-gyp चला सकते हैं और native module बना सकते हैं।

यदि Xcode Command Line Tools इंस्टॉल नहीं हैं, तो इस प्रकार की त्रुटियां दिख सकती हैं:

gyp ERR!
No Xcode or CLT version detected
make failed
clang not found

ऐसी स्थिति में Xcode Command Line Tools की जांच और इंस्टॉलेशन करना चाहिए।

7. निर्देश स्वयं न खोजें

सख्त नियम:

यदि pnpm install, npm install, Python package install या Homebrew macOS पर build error के साथ विफल होता है, तो Claude Code (Codex) से पूछना चाहिए कि कौन-से build tools आवश्यक हैं। इंटरनेट पर यादृच्छिक निर्देश नहीं खोजने चाहिए।

सही अनुरोध:

Claude, macOS पर Node.js/Python packages इंस्टॉल करते समय native dependency का build विफल हो रहा है। यहां पूरा error log है। जांचें कि Xcode Command Line Tools इंस्टॉल हैं या नहीं, और बताएं कि कौन-सी commands निष्पादित करनी हैं।

यदि सिस्टम इंस्टॉलेशन विंडो दिखाई दे:

Claude, macOS Command Line Tools for Xcode इंस्टॉल करने का प्रस्ताव दे रहा है। क्या यह Claude Code परिवेश के लिए आवश्यक है? यहां screenshot है।

8. developer tools को अनुमान से ठीक न करें

बिना निर्देश के इस प्रकार की commands निष्पादित नहीं करनी चाहिए:

sudo xcode-select --switch ...
sudo rm -rf /Library/Developer/CommandLineTools

यह Homebrew, Git, Python packages और Node.js native builds को तोड़ सकता है।

यदि xcode-select या clang अजीब व्यवहार करते हैं, तो Claude Code (Codex) को यह दिखाना चाहिए:

xcode-select -p
xcode-select --version
clang --version
make --version

और त्रुटि का पूरा टेक्स्ट।

9. नियम

सेटअप का पांचवां चरण:

macOS पर Claude Code परिवेश के लिए Xcode Command Line Tools इंस्टॉल करते हैं। यह चरण Git और बाकी developer tools इंस्टॉल करने से पहले पूरा किया जाता है। यदि Xcode इंस्टॉलेशन समझ न आने वाली त्रुटियां देता है, या Xcode के साथ काम के दौरान त्रुटियां आती हैं, तो दो चरण पीछे जाएं और जांचें कि आपका macOS नया और साफ है या नहीं। यदि नहीं है, तो अपनी व्यक्तिगत और कार्य फ़ाइलें पहले सहेजकर macOS पुनः इंस्टॉल करें। साफ macOS पर Xcode के साथ त्रुटियां नहीं होंगी।

जांच:

xcode-select -p
clang --version
make --version

आवश्यक होने पर इंस्टॉलेशन:

xcode-select --install

अतिरिक्त नियम:

यदि JavaScript/Python-packages का build विफल होता है, तो compiler toolchain को अनुमान से ठीक नहीं करते। Claude Code (Codex) से पूछते हैं और macOS के लिए सटीक निर्देश के अनुसार कार्य करते हैं।

चरण 06. Git इंस्टॉल और कॉन्फ़िगर करें

Git Claude Code (Codex) के साथ AI-vibecoding के लिए अनिवार्य उपकरण है। Git के बिना कोड को सुरक्षित रूप से बदलना, diff जांचना, त्रुटियां rollback करना, commits करना, pull request खोलना और एजेंट ने वास्तव में क्या बदला यह समझना कठिन और यहां तक कि असंभव है।

इस बिंदु से पहले Xcode Command Line Tools इंस्टॉल या जांचे जा चुके होने चाहिए। macOS पर वही बुनियादी developer-tools देते हैं जिनके माध्यम से अक्सर Git इंस्टॉल या सक्रिय होता है।

1. क्या Git डिफ़ॉल्ट रूप से macOS में है

macOS पर Xcode Command Line Tools इंस्टॉल करने के बाद Git अक्सर पहले से उपलब्ध होता है।

Terminal.app में जांचा जा सकता है:

git --version

यदि Git पहले से इंस्टॉल है, तो कमांड एक संस्करण दिखाएगी, उदाहरण के लिए:

git version 2.x.x

यदि Git इंस्टॉल नहीं है, तो macOS Xcode Command Line Tools इंस्टॉल करने का प्रस्ताव दे सकता है। Mac के लिए यह सामान्य तरीका है।

Xcode Command Line Tools इंस्टॉल करने की कमांड:

xcode-select --install

इंस्टॉलेशन के बाद फिर जांचें:

git --version

2. Git का लिंक स्वयं न खोजें

यदि आपको Git डाउनलोड करने का अद्यतन लिंक चाहिए या यह समझ नहीं आ रहा है कि कौन-सा इंस्टॉलेशन तरीका चुनना है, तो इसे यादृच्छिक लेखों और वीडियो में स्वयं नहीं खोजना चाहिए।

नियम:

Git इंस्टॉल करने का अद्यतन लिंक या तरीका Claude Code (Codex) से पूछना चाहिए।

अनुरोध का उदाहरण:

Claude, मुझे macOS पर Git इंस्टॉल करना है। मेरे मामले के लिए अद्यतन आधिकारिक इंस्टॉलेशन तरीका बताएं और यदि आवश्यक हो तो लिंक दें।

macOS पर अक्सर लिंक की बिल्कुल आवश्यकता नहीं होती: Xcode Command Line Tools या Homebrew पर्याप्त होता है। लेकिन यदि Claude Code (Codex) installer डाउनलोड करने की सिफारिश करता है, तो उसे अद्यतन आधिकारिक लिंक देना चाहिए और समझाना चाहिए कि यही विकल्प क्यों चुना गया।

3. installer में checkboxes का अनुमान न लगाएं

Windows Git-installer में वास्तव में settings और checkboxes वाली बहुत सी screens होती हैं। macOS पर ऐसा परिदृश्य कम मिलता है, लेकिन फिर भी नियम टीम के लिए सामान्य होना चाहिए।

सख्त नियम:

Git installer की settings का अनुमान न लगाएं। यदि स्क्रीन पर checkboxes, PATH विकल्प, editor, line endings, SSH, credential helper या अन्य समझ न आने वाली settings दिखाई दें, तो Claude Code में screenshot भेजकर पूछना चाहिए कि क्या चुनना है।

सही अनुरोध:

Claude, मैं अभी Git इंस्टॉल कर रहा हूं और settings वाली screens के screenshots भेजूंगा। कृपया बताएं कि macOS पर Claude Code के साथ AI-vibecoding के लिए Git कॉन्फ़िगर करने हेतु कौन-से checkboxes और विकल्प चुनने हैं।

इसके बाद इंस्टॉलेशन के हर न समझ आने वाले चरण के screenshots Claude Code में भेजते हैं और वह बताता है कि क्या और क्यों चुनना है।

यह महत्वपूर्ण है, क्योंकि गलत Git settings समस्याओं की ओर ले सकती हैं:

Git टर्मिनल में नहीं मिलता;
commits गलत नाम या email से बनते हैं;
SSH-keys काम नहीं करतीं;
GitHub बार-बार password मांगता है;
फ़ाइलों में line breaks बदलते हैं;
Claude Code diff में अतिरिक्त बदलाव देखता है;
pull/push अस्थिर रूप से काम करते हैं।

4. macOS पर Git इंस्टॉल करने का अनुशंसित तरीका

टीम के लिए मूल तरीका यह है:

Terminal.app खोलें।
Git जांचें:

git --version

यदि Git इंस्टॉल नहीं है, Xcode Command Line Tools इंस्टॉल करें:

xcode-select --install

इंस्टॉलेशन के बाद फिर जांचें:

git --version

बाद में, Homebrew इंस्टॉल होने के बाद, आवश्यकता होने पर Homebrew से अधिक नया Git इंस्टॉल किया जा सकता है:

brew install git

लेकिन पहले चरण में जटिलता नहीं बढ़ानी चाहिए। यदि Xcode Command Line Tools का Git काम करता है, तो शुरुआत के लिए पर्याप्त है।

5. Git की बुनियादी सेटिंग

इंस्टॉलेशन के बाद commits के लिए एक बार नाम और email बताना चाहिए:

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

settings जांचें:

git config --global --list

कम से कम ये दिखाई देने चाहिए:

user.name=Your Name
[email protected]

वह email उपयोग करना बेहतर है जो GitHub-account से जुड़ा हो। यदि निजी GitHub noreply email उपयोग होता है, तो उसे GitHub settings से लेकर यहां डालना चाहिए।

6. Git को Claude Code प्रोजेक्ट्स के फ़ोल्डर से काम करना चाहिए

सेटअप के बाद कार्य फ़ोल्डर में Git जांचें:

cd "$HOME/Documents/Claude"
git --version

यदि कमांड Git संस्करण दिखाती है, तो Claude Code CLI भी प्रोजेक्ट्स के भीतर Git का उपयोग कर सकेगा।

किसी विशिष्ट प्रोजेक्ट के लिए जांचना उपयोगी है:

git status

यदि फ़ोल्डर पहले से Git-repository है, तो कमांड working copy की स्थिति दिखाएगी। यदि नहीं है, तो Git ईमानदारी से कहेगा कि यह repository नहीं है। यह सामान्य है।

7. Claude Code (Codex) के लिए और क्या महत्वपूर्ण है

AI-vibecoding के लिए Git केवल "इंस्टॉल होना" नहीं है। यह एक सुरक्षा प्रणाली के रूप में आवश्यक है।

बड़े कार्य से पहले साफ status होना वांछनीय है:

git status

यदि महत्वपूर्ण uncommitted changes हैं, तो Claude Code द्वारा प्रोजेक्ट को सक्रिय रूप से बदलना शुरू करने से पहले उन्हें सहेजना या commit करना चाहिए।

Claude Code के काम के बाद फिर देखें:

git diff
git status

इस प्रकार व्यक्ति समझता है कि कौन-सी फ़ाइलें बदलीं और एजेंट ने वास्तव में क्या किया।

8. नियम

सेटअप का छठा चरण:

Git इंस्टॉल होना चाहिए, Terminal.app से उपलब्ध होना चाहिए, सही user.name और user.email के साथ कॉन्फ़िगर होना चाहिए, और `~/Documents/Claude फ़ोल्डर में जांचा जाना चाहिए।

अतिरिक्त सख्त नियम:

यादृच्छिक निर्देश न खोजें और Git installer के checkboxes का अनुमान न लगाएं। इंस्टॉलेशन का अद्यतन तरीका और सभी न समझ आने वाली settings Claude Code (Codex) से पूछनी चाहिए, इंस्टॉलेशन screens के screenshots भेजते हुए।

इस प्रकार Git कंप्यूटर पर कोई यादृच्छिक प्रोग्राम नहीं, बल्कि कोड के साथ Claude Code (Codex) के सुरक्षित काम की सामान्य बुनियाद बनता है।

चरण 07. Homebrew इंस्टॉल करें

Xcode Command Line Tools और Git के बाद Homebrew इंस्टॉल करना चाहिए।

Homebrew macOS के लिए package manager है। इसकी आवश्यकता developer tools, command-line utilities, libraries और कुछ desktop-applications को सुविधाजनक रूप से इंस्टॉल और अपडेट करने के लिए होती है।

Claude Code (Codex) परिवेश के लिए Homebrew विशेष रूप से उपयोगी है, क्योंकि इसके माध्यम से सुविधाजनक रूप से इंस्टॉल किए जा सकते हैं:

GitHub CLI (gh);
FFmpeg;
Python audio-packages के लिए libsndfile;
Node.js, यदि टीम Homebrew-पथ चुनती है;
Python versions, यदि टीम Homebrew-पथ चुनती है;
अतिरिक्त command-line tools।

1. Homebrew macOS में शामिल नहीं है

Homebrew macOS का मानक हिस्सा नहीं है।

इसे अलग से इंस्टॉल करना चाहिए।

जांचें कि Homebrew इंस्टॉल है या नहीं:

brew --version

यदि कमांड नहीं मिलती, तो Homebrew अभी इंस्टॉल नहीं है या PATH में नहीं जोड़ा गया है।

2. Homebrew को Git के बाद क्यों इंस्टॉल करते हैं

Homebrew macOS की developer-infrastructure और GitHub का सक्रिय रूप से उपयोग करता है।

इसलिए सही क्रम:

Xcode Command Line Tools -> Git -> Homebrew

Xcode Command Line Tools compiler/developer toolchain देते हैं।

Git repositories के साथ काम के लिए आवश्यक है और Homebrew द्वारा उपयोग किया जा सकता है।

Homebrew इसी बुनियादी layer के ऊपर इंस्टॉल होता है।

3. इंस्टॉलेशन कमांड स्वयं न खोजें

सख्त नियम:

Homebrew का लिंक और Homebrew इंस्टॉलेशन की कमांड Claude Code (Codex) से पूछनी चाहिए। इंटरनेट पर यादृच्छिक निर्देश नहीं खोजने चाहिए और लेखों, वीडियो या forums से commands कॉपी नहीं करनी चाहिए।

सही अनुरोध:

Claude, मुझे Claude Code परिवेश के लिए macOS पर Homebrew इंस्टॉल करना है। अद्यतन आधिकारिक installation command बताएं, चरणों का क्रम जांचें और बताएं कि installation के बाद PATH के साथ क्या करना है।

इस निर्देश को लिखने के समय आधिकारिक Homebrew install script ऐसा दिखता है:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

लेकिन टीम के लिए कार्य निर्देश में मुख्य नियम वही रहता है:

अद्यतन command Claude Code (Codex) से लेते हैं, और Claude Code को Homebrew की आधिकारिक साइट पर आधारित होना चाहिए।

4. इंस्टॉलेशन

इंस्टॉलेशन से पहले जांचें:

xcode-select -p
git --version

यदि दोनों चरण काम करते हैं, तो Claude Code से Homebrew की अद्यतन installation command पूछें और उसे Terminal.app में निष्पादित करें।

installer चलाने के बाद output को ध्यान से पढ़ें। Homebrew installer सामान्यतः बताता है कि वह क्या करने जा रहा है और व्यवस्थापक password मांग सकता है।

यदि कोई न समझ आने वाला prompt आए, तो उत्तर का अनुमान न लगाएं:

Claude, मैं macOS पर Homebrew इंस्टॉल कर रहा हूं। यहां installer का screenshot/output है। बताएं कि क्या चुनना है और क्या जारी रखना सुरक्षित है।

5. Homebrew इंस्टॉलेशन के बाद PATH

Homebrew इंस्टॉलेशन के बाद लगभग हमेशा Next steps block प्रिंट करता है।

उसमें commands हो सकती हैं जिन्हें shell config में जोड़ना होगा, ताकि brew Terminal.app में मिले।

Apple Silicon Mac के लिए Homebrew सामान्यतः यहां इंस्टॉल होता है:

/opt/homebrew

Intel Mac के लिए Homebrew सामान्यतः यहां इंस्टॉल होता है:

/usr/local

लेकिन PATH की commands हाथ से नहीं गढ़नी चाहिए।

सख्त नियम:

Next steps block की commands Claude Code (Codex) को दिखानी चाहिए या Claude Code में कॉपी करनी चाहिए और केवल पुष्टि के बाद निष्पादित करनी चाहिए। विशेष रूप से यदि बात ~/.zprofile, ~/.zshrc या PATH की हो।

सही अनुरोध:

Claude, Homebrew इंस्टॉल हो गया और उसने Next steps दिखाए। यहां पूरा टेक्स्ट है। बताएं कि मेरे Mac पर brew को PATH में सही तरह जोड़ने के लिए कौन-सी commands चलानी हैं।

6. इंस्टॉलेशन की जांच

इंस्टॉलेशन के बाद Terminal.app की नई विंडो खोलें और निष्पादित करें:

brew --version
brew doctor

brew --version को Homebrew संस्करण दिखाना चाहिए।

brew doctor warnings दिखा सकता है। सभी warnings महत्वपूर्ण नहीं हैं, लेकिन उन्हें पढ़ना चाहिए।

यदि brew doctor न समझ आने वाली warning या error दिखाता है, तो अनुमान से ठीक न करें:

Claude, यहां macOS पर brew doctor का output है। समझाएं कि Claude परिवेश के लिए कौन-सी warnings महत्वपूर्ण हैं और क्या सुरक्षित रूप से ठीक किया जा सकता है।

7. Homebrew के माध्यम से क्या इंस्टॉल किया जा सकता है

Homebrew इंस्टॉल करने के बाद developer tools इंस्टॉल किए जा सकते हैं:

brew install gh
brew install ffmpeg
brew install libsndfile

लेकिन हर विशिष्ट installation command संबंधित निर्देश के बिंदु से लेना या Claude Code (Codex) से पूछना बेहतर है।

Homebrew का अर्थ यह नहीं है कि हर चीज़ को वैश्विक रूप से इंस्टॉल कर दिया जाए।

8. यादृच्छिक sudo का उपयोग न करें

यदि कोई यादृच्छिक निर्देश Homebrew को इस प्रकार ठीक करने का प्रस्ताव दे:

sudo chown
sudo chmod
sudo rm -rf

तो रुकना चाहिए और Claude Code (Codex) से पूछना चाहिए।

Homebrew इंस्टॉलेशन के समय password मांग सकता है, लेकिन नियमित brew install ... काम सामान्यतः sudo-commands के अराजक समूह में नहीं बदलना चाहिए।

9. नियम

सेटअप का सातवां चरण:

Xcode Command Line Tools और Git के बाद Homebrew इंस्टॉल करते हैं। Homebrew macOS में शामिल नहीं है, लेकिन GitHub CLI, FFmpeg, audio libraries और अन्य developer tools इंस्टॉल करने के package manager के रूप में आवश्यक है।

अतिरिक्त सख्त नियम:

Homebrew का लिंक, installation command और PATH-setup Claude Code (Codex) से लेते हैं। इंटरनेट पर यादृच्छिक निर्देश नहीं खोजते, shell config को अनुमान से संपादित नहीं करते और बिना समझे sudo-commands नहीं चलाते।

चरण 08. GitHub CLI इंस्टॉल करें

Git और Homebrew इंस्टॉल करने के बाद GitHub CLI इंस्टॉल करना चाहिए। यह GitHub का command line interface है, जो Terminal.app से GitHub के साथ काम करने देता है: authenticate करना, repositories जांचना, pull request बनाना, issues देखना, CI status पढ़ना और ब्राउज़र में स्विच किए बिना अन्य कार्य करना।

GitHub CLI इस command से चलता है:

gh

1. पहले GitHub खाता चाहिए

GitHub CLI केवल तब इंस्टॉल और कॉन्फ़िगर करना चाहिए जब व्यक्ति के पास पहले से corporate GitHub-account हो।

क्यों:

gh इंस्टॉल करने के बाद GitHub में authenticate करना होगा;
authentication के लिए मौजूदा GitHub-account आवश्यक है;
authorization के बिना GitHub CLI इंस्टॉल तो होता है, लेकिन वास्तविक काम के लिए लगभग बेकार है;
यदि उपयोगकर्ता GitHub में लॉग इन नहीं है, तो Claude Code (Codex) स्थानीय gh के माध्यम से pull request, issues और GitHub workflows में सहायता नहीं कर पाएगा।

नियम:

पहले GitHub-account बनाएं या तैयार करें, फिर GitHub CLI इंस्टॉल और authorize करें।

2. installation command स्वयं न खोजें

Windows में GitHub CLI को अक्सर विशेष command से सीधे command line से इंस्टॉल किया जाता है। macOS पर भी command-based इंस्टॉलेशन है, लेकिन इसे इंटरनेट पर हाथ से नहीं खोजना चाहिए।

सख्त नियम:

GitHub CLI की अद्यतन installation command Claude Code (Codex) से पूछनी चाहिए।

अनुरोध का उदाहरण:

Claude, मुझे macOS पर GitHub CLI इंस्टॉल करना है। मेरे Mac के लिए अद्यतन आधिकारिक installation command बताएं और ध्यान रखें कि मेरे पास Homebrew है या नहीं।

यह महत्वपूर्ण है, क्योंकि इंस्टॉलेशन का तरीका स्थिति पर निर्भर करता है:

Homebrew इंस्टॉल है या नहीं;
Apple Silicon Mac है या Intel Mac;
सामान्य GitHub.com है या GitHub Enterprise;
packages इंस्टॉल करने पर corporate restrictions हैं या नहीं;
package manager से या आधिकारिक binary/pkg से इंस्टॉल करना है।

इस निर्देश को लिखने के समय Homebrew द्वारा macOS के लिए आधिकारिक बुनियादी तरीका:

brew install gh

लेकिन टीम के लिए कार्य निर्देश में मुख्य नियम वही है: यादृच्छिक लेख नहीं खोजने, बल्कि Claude Code (Codex) से पूछने और आधिकारिक तरीका उपयोग करने का।

3. इंस्टॉलेशन जांचें

इंस्टॉलेशन के बाद जांचें कि gh command उपलब्ध है:

gh --version

यदि कमांड GitHub CLI का संस्करण दिखाती है, तो इंस्टॉलेशन सफल हुआ।

यदि Terminal.app लिखता है कि gh नहीं मिला, तो समाधान का अनुमान न लगाएं, बल्कि Claude Code (Codex) से पूछें:

Claude, मैंने macOS पर GitHub CLI इंस्टॉल किया है, लेकिन Terminal.app में gh command नहीं मिल रही है। PATH जांचने और इंस्टॉलेशन ठीक करने में सहायता करें।

4. GitHub में authorize करें

इंस्टॉलेशन के बाद authorization निष्पादित करना चाहिए:

gh auth login

सामान्यतः GitHub CLI कुछ प्रश्न पूछेगा:

GitHub.com या GitHub Enterprise Server;
HTTPS या SSH;
authorization के लिए browser खोलें या token paste करें;
डिफ़ॉल्ट रूप से कौन-सा Git protocol उपयोग करें।

यदि व्यक्ति को पता न हो कि क्या चुनना है, तो उसे Claude Code (Codex) में screenshot भेजकर पूछना चाहिए।

अनुरोध का उदाहरण:

Claude, मैं macOS पर gh auth login चला रहा हूं। यहां विकल्पों वाला screenshot है। बताएं कि सामान्य GitHub और Claude Code काम के लिए क्या चुनना है।

5. authorization जांचें

लॉग इन के बाद status जांचें:

gh auth status

अपेक्षित परिणाम: GitHub CLI को दिखाना चाहिए कि उपयोगकर्ता GitHub में authorized है।

यदि कई accounts या GitHub Enterprise उपयोग हो रहा है, तो स्पष्ट रूप से जांचना चाहिए कि किस account में लॉग इन है।

6. Claude Code प्रोजेक्ट्स के फ़ोल्डर में काम जांचें

इंस्टॉलेशन और authorization के बाद कार्य फ़ोल्डर में जाएं:

cd "$HOME/Documents/Claude"

और जांचें:

gh auth status
gh repo list

यदि gh repo list account की repositories दिखाता है, तो GitHub CLI काम के लिए तैयार है।

विशिष्ट GitHub-repository के भीतर जांचना उपयोगी है:

gh repo view

यदि command वर्तमान repository की जानकारी दिखाती है, तो स्थानीय फ़ोल्डर GitHub से जुड़ा है।

7. macOS की विशेषताएं

macOS पर GitHub CLI को सबसे सुविधाजनक रूप से सामान्यतः Homebrew से इंस्टॉल किया जाता है:

brew install gh

लेकिन यह मानता है कि Homebrew पहले से इंस्टॉल है। यदि Homebrew अभी इंस्टॉल नहीं है, तो पहले Homebrew संबंधी निर्देश के बिंदु पर जाना चाहिए या Claude Code (Codex) से पूछना चाहिए कि अभी कौन-सा इंस्टॉलेशन तरीका चुनना है।

Mac पर याद रखना महत्वपूर्ण है:

commands Terminal.app में चलती हैं;
shell सामान्यतः zsh है;
text और screenshots सामान्यतः Cmd+V से paste होते हैं;
यदि सिस्टम access requests दिखाई दें, तो यादृच्छिक रूप से क्लिक न करें, बल्कि Claude Code में screenshot भेजें;
यदि authorization browser खोलता है, तो ठीक उसी आवश्यक GitHub-account में लॉग इन करें।

8. नियम

सेटअप का आठवां चरण:

GitHub CLI केवल GitHub-account तैयार करने के बाद इंस्टॉल होता है। अद्यतन installation command Claude Code से पूछनी चाहिए। इंस्टॉलेशन के बाद अनिवार्य रूप से gh auth login चलाएं और परिणाम gh auth status से जांचें।

अतिरिक्त नियम:

यदि GitHub CLI इंस्टॉल या authorize करते समय न समझ आने वाले विकल्प, checkboxes, HTTPS/SSH, browser login, token या GitHub Enterprise से जुड़े प्रश्न दिखाई दें, तो व्यक्ति उत्तर का अनुमान न लगाए, बल्कि Claude Code (Codex) में screenshot भेजे।

GitHub CLI स्थानीय प्रोजेक्ट फ़ोल्डर, GitHub और Claude Code (Codex) के बीच मानक पुल बनना चाहिए।

चरण 09. macOS पर Python इंस्टॉल करें

Claude Code (Codex) के परिवेश में Python इसलिए आवश्यक नहीं है कि हमें यह भाषा पसंद है या नहीं।

Python इसलिए आवश्यक है क्योंकि AI-vibecoding में अधिकांश सरल automations Python-scripts के माध्यम से सुविधाजनक रूप से किए जाते हैं:

एक फ़ाइल से data लेना और दूसरी में रखना;
CSV, JSON, Markdown, HTML या text log parse करना;
छोटा report बनाना;
फ़ाइलों के समूह का नाम बदलना;
फ़ोल्डर संरचना जांचना;
import के लिए data तैयार करना;
तेज़ी से one-time utility script लिखना;
ऐसे routine action को automate करना जिसे हाथ से करना लंबा और जोखिमपूर्ण है।

Claude Code (Codex) के लिए Python स्वाद का प्रश्न नहीं, बल्कि अनिवार्य कार्य उपकरण है।

1. Python अनिवार्य है

Claude Code (Codex) के साथ AI-vibecoding के लिए तैयार प्रत्येक Mac में कार्यशील Python 3 होना चाहिए।

Python की उपस्थिति जांचें:

python3 --version

pip जांचें:

python3 -m pip --version

यदि ये commands काम नहीं करतीं या अनुपयुक्त संस्करण दिखाती हैं, तो Python इंस्टॉल करना चाहिए।

2. लिंक स्वयं न खोजें

Python डाउनलोड करने का अद्यतन लिंक या अद्यतन installation command इंटरनेट पर स्वयं नहीं खोजनी चाहिए।

नियम:

Python डाउनलोड का लिंक और इंस्टॉलेशन तरीका Claude Code (Codex) से पूछना चाहिए।

अनुरोध का उदाहरण:

Claude, मुझे AI-vibecoding के लिए macOS पर Python इंस्टॉल करना है। अद्यतन आधिकारिक लिंक या installation command बताएं। सबसे नए experimental/latest संस्करण के बजाय Python 3.12.x का स्थिर संस्करण चाहिए।

यह महत्वपूर्ण है, क्योंकि Python साइट पर नवीनतम संस्करण वाला बड़ा बटन हो सकता है, लेकिन हमारे कार्य के लिए सबसे नया संस्करण आवश्यक नहीं है। हमें दैनिक automations के लिए Python programming language का सबसे स्थिर और संगत संस्करण चाहिए।

3. Python का कौन-सा संस्करण इंस्टॉल करें

हमारे Claude Code (Codex)-परिवेश के लिए बुनियादी मानक:

Python 3.12.x

18 जून 2026 को 3.12 branch का नवीनतम संस्करण Python 3.12.13 है।

साथ ही, आधिकारिक रूप से नए branches पहले से मौजूद हैं: Python 3.13 bugfix support में है, Python 3.14 latest feature release है। लेकिन स्थिर AI-vibecoding के लिए हम सबसे नए संस्करण का पीछा नहीं करते।

हम 3.12.x क्यों चुनते हैं:

परिपक्व और व्यापक रूप से समर्थित branch;
libraries के साथ अच्छी compatibility;
ताज़ा परिवर्तनों से सरल automation scripts टूटने का कम जोखिम;
अधिकांश आधुनिक Python-tools के लिए पर्याप्त नया संस्करण;
टीम के लिए अधिक पूर्वानुमेय environment।

सख्त नियम:

बुनियादी Claude Code परिवेश के लिए Python 3.12.x इंस्टॉल करते हैं। Python 3.14 और नए संस्करण डिफ़ॉल्ट रूप से इंस्टॉल नहीं करते, जब तक टीम अलग से मानक अपडेट करने और compatibility जांचने का निर्णय न ले।

4. macOS में अंतर्निहित Python

macOS में Python से जुड़े सिस्टम components या developer tools हो सकते हैं।

नियम:

macOS के system Python को न छुएं और Claude Code (Codex) के लिए कार्यशील Python के रूप में उस पर निर्भर न रहें।

system Python स्वयं macOS या Apple developer tools के लिए आवश्यक है। उसे हटाना, overwrite करना या हाथ से ठीक करना नहीं चाहिए।

Claude Code (Codex) के साथ काम के लिए अलग user/developer Python इंस्टॉल किया जाता है।

5. macOS पर Python कहां इंस्टॉल करें

Windows पर कभी-कभी Python को disk C:\ के root में इंस्टॉल किया जाता है, ताकि Python का स्थान पूर्वानुमेय रहे।

macOS पर ऐसा नहीं करना चाहिए। macOS की फ़ाइल सिस्टम संरचना और developer tools इंस्टॉल करने का तरीका अलग है।

सही दृष्टिकोण:

Python को disk के root में इंस्टॉल न करें;
system folders को हाथ से न बदलें;
python.org का आधिकारिक macOS installer या package manager उपयोग करें;
Terminal.app के माध्यम से उपलब्धता जांचें।

आधिकारिक macOS Python installer सामान्यतः Python को अपेक्षित developer-location जैसे स्थान पर इंस्टॉल करता है:

/Library/Frameworks/Python.framework/Versions/3.12

और Python 3.12 चलाने की commands को मानक paths में जोड़ता है।

यदि Python को Homebrew से इंस्टॉल किया जाता है, तो वह Homebrew-prefix में इंस्टॉल होगा:

/opt/homebrew

Apple Silicon Mac पर, या:

/usr/local

Intel Mac पर।

दोनों विकल्प सामान्य हैं। टीम के लिए भौतिक installation folder से अधिक महत्वपूर्ण यह है कि Terminal.app में ये commands स्थिर रूप से काम करें:

python3 --version
python3 -m pip --version

6. अनुशंसित इंस्टॉलेशन तरीका

package managers के साथ आत्मविश्वास से काम न करने वाले टीम सदस्यों के लिए सबसे स्पष्ट तरीका:

Claude Code (Codex) से macOS के लिए Python 3.12.x का अद्यतन आधिकारिक लिंक पूछें।
python.org से आधिकारिक macOS installer डाउनलोड करें।
installer चलाएं।
यदि न समझ आने वाली settings आएं, तो उनका अनुमान न लगाएं; Claude Code (Codex) में screenshot भेजें।
इंस्टॉलेशन के बाद नया Terminal.app खोलें।
जांचें:

python3 --version
python3 -m pip --version

जिन लोगों के पास पहले से Homebrew है, उनके लिए यह विकल्प संभव है:

brew install [email protected]

लेकिन installation command फिर भी पहले Claude Code (Codex) से पूछनी चाहिए, क्योंकि Homebrew, PATH और टीम की नीति भिन्न हो सकती है।

7. इंस्टॉलेशन के बाद जांच

इंस्टॉलेशन के बाद चलाएं:

python3 --version

हमारे मानक के लिए अपेक्षित परिणाम:

Python 3.12.x

pip जांचें:

python3 -m pip --version

जांचें कि Python कहां स्थित है:

which python3

जांचें कि Python सरल script निष्पादित कर सकता है:

python3 -c "print('Python is ready for Claude Code (Codex) automation')"

8. Virtual environments

प्रोजेक्ट्स के लिए आवश्यकता न होने पर सभी Python-libraries को global रूप से इंस्टॉल नहीं करना महत्वपूर्ण है।

विशिष्ट प्रोजेक्ट के भीतर virtual environment उपयोग करना बेहतर है:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip

.venv सक्रिय करने के बाद libraries global Python के बजाय प्रोजेक्ट के भीतर इंस्टॉल होती हैं।

यदि Python-scripts विशिष्ट प्रोजेक्ट से संबंधित हैं, तो Claude Code (Codex) को ऐसा environment देखना और उपयोग करना चाहिए।

9. यदि संस्करण मेल न खाए तो क्या करें

यदि इंस्टॉलेशन के बाद command:

python3 --version

Python 3.12.x नहीं दिखाती, तो अनुमान से Python हटाना या system files बदलना नहीं चाहिए।

Claude Code (Codex) से पूछना चाहिए:

Claude, मैंने macOS पर Python इंस्टॉल किया है, लेकिन python3 --version गलत संस्करण दिखा रहा है। यह समझने में सहायता करें कि अभी कौन-सा Python उपयोग हो रहा है, वह कहां इंस्टॉल है, और Claude Code (Codex) के लिए Python 3.12.x को सुरक्षित रूप से कैसे सेट करें।

10. नियम

सेटअप का नौवां चरण:

Claude Code परिवेश के लिए Python अनिवार्य है, क्योंकि अधिकांश सरल automations Python-scripts से सुविधाजनक रूप से की जाती हैं। बुनियादी स्थिर परिवेश के लिए Python 3.12.x इंस्टॉल करते हैं, macOS के system Python को नहीं छूते और Python को disk के root में हाथ से इंस्टॉल नहीं करते।

अतिरिक्त नियम:

डाउनलोड लिंक, installation command और installer की कोई भी न समझ आने वाली settings Claude Code (Codex) से पूछनी चाहिए, न कि यादृच्छिक स्रोतों में खोजनी या अनुमान लगाना चाहिए।

चरण 10. must-have Python-packages इंस्टॉल करें

Python इंस्टॉल करने के बाद Python-packages का बुनियादी set तैयार करना चाहिए, जो Claude Code (Codex) के साथ दैनिक काम में उपयोग होता है।

यह अत्यंत महत्वपूर्ण चरण है, क्योंकि vibecoding में आपकी tasks के लिए programming languages के आवश्यक packages के बिना आप आसानी से overspending या loop में फंस सकते हैं क्योंकि package अनुपस्थित है, और आपका Claude Code आपको इसके बारे में नहीं बता सकता। परिणामस्वरूप आप बहुत समय और tokens खर्च करेंगे।

बड़े कार्य या प्रोजेक्ट से पहले हमेशा पहले सोचें और Claude Code से पूछें कि हम यह कार्य किस programming language में करेंगे, और हमें language के किन आवश्यक packages की आवश्यकता होगी।

ये packages "हर स्थिति के लिए" नहीं, बल्कि वास्तविक AI-vibecoding scenarios के लिए आवश्यक हैं:

OpenAI API के साथ काम;
images के साथ काम;
audio के साथ काम;
voice transcriptions की तैयारी और processing;
voice activity detection;
स्थानीय ML/audio utilities।

1. Packages global नहीं, virtual environment में इंस्टॉल होते हैं

मुख्य नियम:

Claude Code प्रोजेक्ट्स के लिए Python-packages को आवश्यकता के बिना global रूप से इंस्टॉल नहीं किया जाता। उन्हें विशिष्ट प्रोजेक्ट के भीतर .venv में या परिवेश के अलग bootstrap-project में इंस्टॉल करना चाहिए।

कारण सरल है: अलग-अलग Python-packages और packages के अलग संस्करण एक दूसरे के साथ असंगत हो सकते हैं। यदि सब कुछ global रूप से इंस्टॉल किया जाए, तो देर-सबेर एक automation दूसरे को तोड़ देगा।

कार्यशील template:

cd "$HOME/Documents/Claude Code (Codex)"
mkdir -p python-tooling
cd python-tooling
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip

environment सक्रिय करने के बाद terminal prompt सामान्यतः (.venv) दिखाता है।

2. Compatible pinned package-set

हमारे अभ्यास के लिए versions का compatible set निर्धारित करते हैं:

imageio-ffmpeg==0.6.0
openai==2.33.0
numpy==1.26.4
torch==2.5.1
librosa==0.10.2.post1
soundfile==0.12.1
webrtcvad==2.0.10
Resemblyzer==0.1.4
setuptools==80.9.0

यह महत्वपूर्ण है: versions सौंदर्य के लिए नहीं पिन किए गए हैं, बल्कि इसलिए कि व्यावहारिक काम में Python-packages के अलग संस्करण अक्सर एक-दूसरे से conflict करते हैं।

सख्त नियम:

इन packages को स्वचालित रूप से नए versions में अपडेट न करें। यदि package अपडेट करना है, तो पहले Claude Code (Codex) से पूछें, compatibility जांचें और अलग .venv में test installation चलाएं।

3. requirements फ़ाइल बनाएं

प्रोजेक्ट के भीतर फ़ाइल बनानी चाहिए:

requirements-codex-python-tooling.txt

सामग्री:

imageio-ffmpeg==0.6.0
openai==2.33.0
numpy==1.26.4
torch==2.5.1
librosa==0.10.2.post1
soundfile==0.12.1
webrtcvad==2.0.10
Resemblyzer==0.1.4
setuptools==80.9.0

इंस्टॉलेशन:

python -m pip install -r requirements-codex-python-tooling.txt

4. ये packages क्या करते हैं

openai==2.33.0 OpenAI API के साथ काम के लिए आवश्यक है।

numpy==1.26.4 संख्यात्मक data, arrays, audio और ML-dependencies के लिए बुनियादी library के रूप में आवश्यक है।

torch==2.5.1 ML/audio-tasks और Resemblyzer जैसी dependencies के लिए आवश्यक है।

librosa==0.10.2.post1 audio files के analysis और processing के लिए आवश्यक है।

soundfile==0.12.1 audio files पढ़ने और लिखने के लिए आवश्यक है।

imageio-ffmpeg==0.6.0 उन tasks के लिए आवश्यक है जिनमें Python के माध्यम से ffmpeg-processing चाहिए।

webrtcvad==2.0.10 voice activity detection के लिए आवश्यक है: निर्धारित करना कि audio में कहां आवाज़ है और कहां silence या noise है।

Resemblyzer==0.1.4 speaker/audio embeddings और आवाज़ से संबंधित tasks के लिए आवश्यक है।

setuptools==80.9.0 Python-packages के लिए बुनियादी build-dependency के रूप में आवश्यक है।

5. macOS की विशेषताएं

macOS पर कुछ packages को system developer tools की आवश्यकता हो सकती है।

इस set को इंस्टॉल करने से पहले पिछले चरण पूरे होने चाहिए:

आधुनिक macOS इंस्टॉल हो;
सिस्टम updates इंस्टॉल हों;
उपयोगकर्ता admin-account से काम करे;
Git इंस्टॉल हो;
Xcode Command Line Tools इंस्टॉल हों;
Python 3.12.x इंस्टॉल हो।

Xcode Command Line Tools जांच:

xcode-select -p

यदि tools इंस्टॉल नहीं हैं:

xcode-select --install

6. `soundfile` और libsndfile

soundfile package system library libsndfile के माध्यम से काम करता है।

यदि soundfile इंस्टॉल हो गया लेकिन import या audio reading libsndfile की error के साथ विफल हो, तो Homebrew से system library इंस्टॉल करनी चाहिए:

brew install libsndfile

इसके बाद फिर जांचें:

python -c "import soundfile; print(soundfile.__version__)"

7. `webrtcvad` source से build हो सकता है

webrtcvad==2.0.10 को compilation की आवश्यकता हो सकती है। इसलिए package इंस्टॉल करने से पहले Xcode Command Line Tools इंस्टॉल होने चाहिए।

यदि विशिष्ट Mac पर webrtcvad==2.0.10 इंस्टॉलेशन टूटता है, तो सभी packages के versions को अराजक ढंग से नहीं बदलना चाहिए।

Claude Code (Codex) से पूछना चाहिए:

Claude, macOS पर Python 3.12 .venv में webrtcvad==2.0.10 इंस्टॉल नहीं हो रहा है। यहां पूरा error text है। यह समझने में सहायता करें कि compiler tools, wheel, pip/setuptools की कमी है या compatible fallback चाहिए।

अलग प्रोजेक्ट के लिए संभावित fallback webrtcvad-wheels package है, जिसमें macOS के लिए binary wheels हैं। लेकिन यह टीम के अलग निर्णय के बिना बुनियादी pinned-set का प्रतिस्थापन नहीं है।

8. macOS पर `torch`

PyTorch macOS का समर्थन करता है, लेकिन इंस्टॉलेशन Python version, Mac architecture और उपलब्ध wheel-packages पर निर्भर करता है।

हमारे baseline के लिए उपयोग करते हैं:

torch==2.5.1

यदि विशिष्ट Mac पर torch==2.5.1 इंस्टॉल नहीं होता, तो पूरे requirements-file को तुरंत अपडेट नहीं करना चाहिए।

Claude Code (Codex) से पूछना चाहिए:

Claude, macOS पर Python 3.12 .venv में torch==2.5.1 इंस्टॉल नहीं हो रहा है। यहां error है। मेरे Mac architecture के साथ compatibility जांचें और बाकी pinned-set को तोड़े बिना सुरक्षित विकल्प दें।

9. इंस्टॉलेशन जांच

packages इंस्टॉल करने के बाद imports जांचें:

python - <<'PY'
import imageio_ffmpeg
import openai
import numpy
import torch
import librosa
import soundfile
import webrtcvad
import resemblyzer
import setuptools

print("imageio-ffmpeg", imageio_ffmpeg.__version__)
print("openai", openai.__version__)
print("numpy", numpy.__version__)
print("torch", torch.__version__)
print("librosa", librosa.__version__)
print("soundfile", soundfile.__version__)
print("webrtcvad import ok")
print("Resemblyzer import ok")
print("setuptools", setuptools.__version__)
PY

यदि सभी imports सफल हुए, तो Python tooling काम के लिए तैयार है।

10. Python से पहले packages इंस्टॉल न करें

सही Python इंस्टॉल और जांचे जाने से पहले packages इंस्टॉल नहीं किए जा सकते।

सही क्रम:

Python 3.12.x इंस्टॉल है।
python3 --version Python 3.12.x दिखाता है।
.venv बनाया गया है।
.venv सक्रिय है।
pip अपडेट किया गया है।
pinned requirements-file इंस्टॉल हुई है।
imports की जांच की गई है।

11. नियम

सेटअप का दसवां चरण:

Must-have Python-packages केवल .venv में, strictly pinned-versions के अनुसार, requirements-file के माध्यम से इंस्टॉल होते हैं। यह set OpenAI API, images, audio, transcriptions और Claude Code (Codex) के सरल automations के लिए आवश्यक है।

अतिरिक्त नियम:

यदि macOS पर एक package इंस्टॉल नहीं होता, तो पूरे set को अनुमान से अपडेट न करें। Claude Code को पूरा error text भेजें और विशिष्ट Mac, Python 3.12.x और वर्तमान pinned-set के लिए सुरक्षित fix मांगें।

काम के लिए हमेशा केवल कड़ाई से आधिकारिक और सुरक्षित packages उपयोग करें, अज्ञात स्रोत के packages का उपयोग नहीं किया जा सकता, यह आपके code में vulnerability ला सकता है।

चरण 11. JavaScript-परिवेश इंस्टॉल करें: Node.js और pnpm

Python के बाद JavaScript-परिवेश तैयार करना चाहिए। Claude Code (Codex) के लिए यह भी must-have layer है, क्योंकि बहुत बड़ी संख्या में आधुनिक projects, frontend-tools, dev servers, CLI-utilities, build-systems और AI-integrations Node.js के माध्यम से काम करते हैं।

हमें JavaScript-परिवेश इसलिए नहीं चाहिए कि JavaScript Python से बेहतर या बदतर है, बल्कि इसलिए कि वास्तविक AI-vibecoding काम में Claude Code (Codex) लगातार सामना करता है:

web-applications;
frontend-projects;
React, Next.js, Vite और समान frameworks;
npm/pnpm/yarn-packages;
dev servers;
Playwright/browser automation;
JavaScript/TypeScript के लिए OpenAI SDK;
Node tooling के माध्यम से files, images, audio और video processing।

इसी प्रकार MiniApps script programming languages पर काम करते हैं।

1. क्या इंस्टॉल करना चाहिए

बुनियादी JavaScript set:

Node.js
pnpm

Node.js वह runtime है जो browser के बाहर JavaScript चलाता है।

pnpm वह package manager है जो सामान्य npm की अपेक्षा dependencies के साथ अक्सर तेज़ और अधिक सुव्यवस्थित रूप से काम करता है। यदि project pnpm-lock.yaml उपयोग करता है, तो काम ठीक pnpm से करना चाहिए।

महत्वपूर्ण:

इस चरण में केवल Node.js और pnpm इंस्टॉल करते हैं। OpenAI, audio, video, images, frontend और tests के सभी संभावित JavaScript-packages पहले से इंस्टॉल नहीं करते।

npm तकनीकी रूप से सामान्यतः Node.js के साथ इंस्टॉल होता है, लेकिन हमारे projects के command standard के रूप में हम pnpm को प्राथमिकता देते हैं, यदि विशिष्ट project को दूसरे package manager की आवश्यकता न हो।

Node.js में अंतर्निहित core modules भी हैं, उदाहरण के लिए fs, path, http, crypto। ये स्वयं Node.js का हिस्सा हैं, इन्हें अलग से इंस्टॉल या हटाया नहीं जा सकता और न ही आवश्यक है। हमारे निर्देश में "सभी packages के बिना Node.js" वाक्यांश का अर्थ है:

Node.js runtime इंस्टॉल करते हैं, लेकिन project-dependencies को global रूप से इंस्टॉल नहीं करते

2. Node.js macOS में अंतर्निहित नहीं है

zsh के विपरीत, Node.js macOS का मानक हिस्सा नहीं है।

इसे अलग से इंस्टॉल करना चाहिए।

जांचें कि Node.js इंस्टॉल है:

node --version

npm जांचें:

npm --version

pnpm जांचें:

pnpm --version

यदि node या pnpm नहीं मिलता, तो JavaScript-परिवेश अभी तैयार नहीं है।

3. Node.js का कौन-सा संस्करण इंस्टॉल करें

Claude Code (Codex)-परिवेश के लिए Node.js का स्थिर LTS-version इंस्टॉल करना चाहिए, Current/latest नहीं।

18 जून 2026 को आधिकारिक Node.js LTS यह है:

Node.js v24.17.0 LTS

साथ ही Node.js v26.x Current के रूप में पहले से मौजूद है, लेकिन बुनियादी स्थिर परिवेश के लिए इसे डिफ़ॉल्ट रूप से इंस्टॉल नहीं करते।

नियम:

टीम के लिए Node.js LTS इंस्टॉल करते हैं। Current/latest केवल तभी इंस्टॉल करते हैं जब विशिष्ट project की स्पष्ट आवश्यकता हो।

4. डाउनलोड लिंक या installation command स्वयं न खोजें

Node.js का अद्यतन डाउनलोड लिंक या installation command Claude Code (Codex) से पूछनी चाहिए।

अनुरोध का उदाहरण:

Claude, मुझे AI-vibecoding के लिए macOS पर Node.js इंस्टॉल करना है। अद्यतन आधिकारिक installation तरीका बताएं। LTS-version चाहिए, Current नहीं।

यह महत्वपूर्ण है, क्योंकि Node.js साइट पर कई विकल्प हो सकते हैं:

LTS;
Current;
macOS installer;
Homebrew;
version manager;
Apple Silicon;
Intel Mac।

अनुमान से नहीं चुनना चाहिए।

5. macOS पर अनुशंसित दृष्टिकोण

टीम के लिए दो सामान्य विकल्प हैं।

विकल्प 1: nodejs.org का आधिकारिक installer।

यह रास्ता beginners के लिए सरल है। व्यक्ति LTS installer डाउनलोड करता है, Node.js इंस्टॉल करता है, फिर जांचता है:

node --version
npm --version

विकल्प 2: version manager, उदाहरण के लिए fnm या nvm।

यह रास्ता उन developers के लिए बेहतर है जो अलग-अलग Node.js versions पर कई projects के साथ काम करते हैं।

macOS पर Mac architecture को ध्यान में रखना चाहिए:

Apple Silicon: arm64
Intel Mac: x64

यदि व्यक्ति installer हाथ से डाउनलोड करता है, तो उसे अपने Mac के लिए सही विकल्प चुनना चाहिए। यदि वह सुनिश्चित नहीं है, तो Claude Code से पूछें और डाउनलोड पृष्ठ का screenshot या यह output भेजें:

uname -m

अपेक्षित विकल्प:

arm64
x86_64

टीम मानक इस प्रकार तैयार किया जा सकता है:

Beginners के लिए: आधिकारिक Node.js LTS installer.
कई projects वाले developers के लिए: version manager.
मुख्य नियम: हर जगह Node.js LTS उपयोग करते हैं, यदि project को अन्य की आवश्यकता न हो।

यदि व्यक्ति नहीं समझता कि कौन-सा विकल्प चुनना है, तो वह Claude Code (Codex) से पूछता है।

6. pnpm इंस्टॉल करें

Node.js इंस्टॉल करने के बाद pnpm इंस्टॉल या सक्षम करना चाहिए।

आधुनिक सुरक्षित विकल्प अक्सर Corepack के माध्यम से किया जाता है, जो Node.js के साथ आता है:

corepack enable
corepack prepare pnpm@latest --activate

इसके बाद जांचें:

pnpm --version

यदि टीम corporate Mac पर काम कर रही है और corepack enable अधिकार मांगता है या permissions के कारण विफल होता है, तो इंटरनेट से यादृच्छिक sudo-commands नहीं चलानी चाहिए। Claude Code (Codex) को पूरा error output भेजना चाहिए।

यदि Corepack उपलब्ध नहीं है या command काम नहीं करती, तो fix का अनुमान न लगाएं। Claude Code से पूछें:

Claude, मैंने macOS पर Node.js LTS इंस्टॉल किया है, लेकिन Corepack से pnpm सक्षम नहीं कर पा रहा हूं। यहां terminal output है। pnpm सुरक्षित रूप से इंस्टॉल करने में सहायता करें।

7. project-packages global रूप से इंस्टॉल न करें

Global रूप से केवल node, npm, pnpm जैसे बुनियादी tools उपलब्ध होने चाहिए।

Project-dependencies विशिष्ट प्रोजेक्ट के भीतर इंस्टॉल करनी चाहिए:

cd "$HOME/Documents/Claude Code (Codex)/my-project"
pnpm install

या, यदि project npm उपयोग करता है:

npm install

इस तरह के packages को अनुमान से global रूप से इंस्टॉल नहीं करना चाहिए:

npm install -g openai
npm install -g typescript
npm install -g vite

यदि project स्पष्ट रूप से इसकी मांग नहीं करता।

हमारी टीम के लिए यह अलग सख्त नियम है:

Node.js अतिरिक्त JS-packages के global set के बिना इंस्टॉल होता है। OpenAI, voice, audio, transcription, images, video, frontend और tests के सभी packages विशिष्ट project के भीतर केवल package.json और lockfile की जांच के बाद इंस्टॉल किए जाते हैं।

8. प्रोजेक्ट पर काम से पहले आवश्यक JS-packages के बारे में पूछें

विशिष्ट JavaScript/TypeScript-project पर काम शुरू करने से पहले Claude Code (Codex) से पूछना चाहिए कि ठीक इस project के लिए कौन-सी dependencies आवश्यक हैं।

अनुरोध का उदाहरण:

Claude, मैं macOS पर इस project के साथ काम शुरू कर रहा हूं। package.json, lockfile और project structure देखें। बताएं कि कौन-से Node.js-packages इंस्टॉल करने हैं और कौन-सा package manager उपयोग करना है: npm, pnpm या yarn।

OpenAI, voice, audio, transcription, images और video वाले projects के लिए अलग प्रश्न पूछना चाहिए:

Claude, project OpenAI API, voice, audio, transcription, images और video के साथ काम करेगा। जांचें कि कौन-से JavaScript/TypeScript-packages चाहिए, कौन-से versions compatible हैं, और dependency conflicts के बिना installation प्रस्तावित करें।

Claude Code (Codex) को देखना चाहिए:

package.json;
pnpm-lock.yaml;
package-lock.json;
yarn.lock;
README;
.nvmrc;
.node-version;
package.json में engines;
मौजूदा scripts।

9. प्रोजेक्ट में package manager कैसे चुनें

package manager का अनुमान से चुनाव न करें।

नियम:

यदि pnpm-lock.yaml है -> pnpm उपयोग करें।
यदि package-lock.json है -> npm उपयोग करें।
यदि yarn.lock है -> yarn उपयोग करें।
यदि lockfile नहीं है -> Claude Code (Codex) से पूछें कि project के लिए क्या चुनना है।

नए projects के लिए pnpm उपयोग किया जा सकता है यदि कोई प्रतिबंध न हों।

10. AI/media-projects के लिए सामान्य packages

इन सभी packages को हर project में पहले से इंस्टॉल नहीं करना चाहिए, लेकिन टीम को समझना चाहिए कि सामान्यतः कौन-सी categories मिलती हैं:

OpenAI API: openai;
schemas और validation: zod;
images: sharp, jimp;
browser automation: playwright;
ffmpeg के माध्यम से video/audio: fluent-ffmpeg, ffmpeg-static;
audio/video metadata पढ़ना: music-metadata;
WAV/audio utilities: wavefile, node-wav;
TypeScript tooling: typescript, tsx, ts-node;
tests: vitest, jest, playwright/test।

लेकिन फिर से:

ये packages स्वचालित रूप से इंस्टॉल नहीं होते। इन्हें विशिष्ट project और विशिष्ट task के अनुसार चुनना चाहिए।

11. इंस्टॉलेशन जांच

JavaScript-परिवेश इंस्टॉल करने के बाद निष्पादित करें:

node --version
npm --version
pnpm --version

सरल JavaScript निष्पादित होना जांचें:

node -e "console.log('Node.js is ready for Claude Code (Codex) automation')"

प्रोजेक्ट्स फ़ोल्डर जांचें:

cd "$HOME/Documents/Claude Code (Codex)"
node --version
pnpm --version

12. नियम

सेटअप का ग्यारहवां चरण:

macOS पर Node.js LTS, npm और pnpm इंस्टॉल करना चाहिए। Node.js macOS में अंतर्निहित नहीं है। अद्यतन installation command या लिंक Claude Code (Codex) से पूछते हैं, इंटरनेट पर यादृच्छिक रूप से नहीं खोजते।

अतिरिक्त नियम:

प्रत्येक JavaScript/TypeScript-project पर काम से पहले Claude Code (Codex) से पूछना चाहिए कि कौन-सा package manager उपयोग करना है और OpenAI, voice, audio, transcription, images, video और प्रोजेक्ट के अन्य tasks के लिए कौन-से exact-packages आवश्यक हैं।

इस प्रकार JavaScript-परिवेश प्रबंधित बनता है, न कि यादृच्छिक रूप से इंस्टॉल किए global packages का समूह।

चरण 12. Claude Code और developer tools को macOS पर इंटरनेट के साथ काम करने की अनुमति दें

Windows पर Claude Code (Codex) Windows Defender Firewall या अन्य security rules के कारण इंटरनेट पर नहीं जा सकता। macOS पर भी ऐसी समस्या संभव है, लेकिन इसकी संरचना अलग है।

मुख्य अंतर:

अंतर्निहित macOS Firewall मुख्यतः Mac के लिए incoming connections प्रबंधित करता है। outgoing internet की समस्याएं अधिकतर स्वयं macOS Firewall से नहीं, बल्कि VPN, proxy, corporate MDM-policies, DNS, antivirus, network filters या third-party firewall-applications से जुड़ी होती हैं।

इसलिए macOS पर कई layers जांचनी चाहिए।

1. किसे इंटरनेट access होना चाहिए

Claude Code (Codex) परिवेश के सामान्य काम के लिए इन applications और tools को इंटरनेट चाहिए:

Claude Code (Codex) Desktop app;
Claude Code (Codex) CLI;
Terminal.app;
वह browser जिसके माध्यम से login किया जाता है;
Git;
GitHub CLI (gh);
Homebrew;
Node.js/npm/pnpm;
Python/pip;
विशिष्ट projects के package managers और dev servers।

यदि इनमें से कोई tool इंटरनेट पर नहीं जा सकता, तो Claude Code अजीब errors के साथ टूटेगा: packages डाउनलोड नहीं होते, login नहीं होता, GitHub नहीं खुलता, क्योंकि Claude Code (Codex) network functions उपयोग नहीं कर सकता।

2. Terminal.app से बुनियादी इंटरनेट जांचें

firewall सेट करने से पहले जांचें कि इंटरनेट terminal से काम करता है:

curl -I https://www.apple.com
curl -I https://github.com
curl -I https://api.openai.com

यदि इन commands को response नहीं मिलता, तो समस्या स्वयं Claude Code (Codex) में नहीं है। network, DNS, proxy, VPN या corporate restrictions diagnose करने चाहिए।

3. macOS Firewall जांचें

settings खोलें:

Apple menu -> System Settings -> Network -> Firewall

यदि Firewall बंद है, तो अंतर्निहित macOS Firewall को Claude Code (Codex) block नहीं करना चाहिए।

यदि Firewall चालू है, तो खोलें:

Firewall -> Options

और जांचें कि Claude Code (Codex) app, Terminal.app, browser या अन्य developer tools के लिए कोई स्पष्ट deny तो नहीं है।

यदि application सूची में जोड़ा गया है और उसके साथ block/deny है, तो rule को allow में बदलना चाहिए।

महत्वपूर्ण:

बिना कारण firewall को पूरी तरह बंद करने की आवश्यकता नहीं है। पहले विशिष्ट application या service को अनुमति देनी चाहिए।

सख्त नियम:

Claude Code, Terminal.app, dev server या किसी अन्य developer tool के लिए macOS Firewall को सही तरह कॉन्फ़िगर करना Claude Code से पूछना चाहिए। settings स्वयं नहीं गढ़नी चाहिए और इंटरनेट पर यादृच्छिक निर्देश नहीं खोजने चाहिए।

सही अनुरोध:

Claude, मैं Claude Code और developer tools के लिए macOS Firewall सेट कर रहा हूं। यहां मौजूदा Firewall/Options settings का screenshot और समस्या का विवरण है। बताएं कि कौन-से applications को अनुमति देनी है और कौन-सी settings चुननी हैं।

4. Firewall Options के माध्यम से application को अनुमति दें

यदि Claude Code (Codex) Desktop app या अन्य आवश्यक application block हो रहा है:

System Settings खोलें।
Network पर जाएं।
Firewall खोलें।
Options पर क्लिक करें।
+ द्वारा आवश्यक application जोड़ें।
Allow incoming connections चुनें।
settings सहेजें।

यह विशेष रूप से उन applications के लिए महत्वपूर्ण है जो local server, dev server चलाते हैं या local connections स्वीकार करते हैं।

5. Outgoing internet: वास्तविक समस्या सामान्यतः कहां होती है

यदि Claude Code, curl, git, gh, brew, npm, pnpm या pip इंटरनेट से नहीं जुड़ सकते और macOS Firewall स्पष्ट deny नहीं दिखाता, तो जांचें:

VPN चालू है या नहीं;
corporate proxy है या नहीं;
Mac MDM से प्रबंधित है या नहीं;
third-party firewall इंस्टॉल है या नहीं: Little Snitch, LuLu, Radio Silence, corporate endpoint security;
openai.com, chatgpt.com, api.openai.com, github.com, npmjs.com, pypi.org domains block तो नहीं हैं;
DNS टूटा हुआ तो नहीं है;
नेटवर्क captive portal login तो नहीं मांगता, उदाहरण के लिए office, hotel या airport में।

Mac पर ठीक ये layers अधिकतर applications के outgoing connections को block करती हैं।

6. permissions का अनुमान न लगाएं

यदि macOS network permission वाला popup, firewall warning या security prompt दिखाता है, तो व्यक्ति को अनुमान से क्लिक नहीं करना चाहिए।

नियम:

popup का screenshot लें और Claude Code में भेजकर पूछें कि क्या दबाना है।

अनुरोध का उदाहरण:

Claude, macOS Claude Code/Terminal/dev server के लिए network permission दिखा रहा है। यहां screenshot है। बताएं कि Claude Code इंटरनेट और local dev-servers के साथ काम कर सके, लेकिन सुरक्षा को अनावश्यक रूप से कमजोर किए बिना, क्या चुनना है।

7. Claude Code CLI जांचें

network सेट करने के बाद Claude Code CLI जांचें:

codex --version

फिर चलाएं:

codex

यदि login या network request नहीं होता, तो error कॉपी करें या Claude Code (Codex) में screenshot भेजें।

8. package managers जांचें

जांचें कि मुख्य package managers इंटरनेट पर जाते हैं:

git ls-remote https://github.com/openai/codex.git
gh auth status
brew update
python3 -m pip index versions openai
pnpm view openai version

यदि कोई command विफल होती है, तो पूरे tool को तुरंत reinstall नहीं करना चाहिए। यह निर्धारित करना चाहिए कि कौन-सी network layer access रोक रही है।

9. टीम मानक

टीम के लिए निर्धारित करते हैं:

macOS Firewall जांचते हैं, लेकिन उसे network problems का एकमात्र कारण नहीं मानते।
Claude Code app, Terminal.app और developer tools के पास network permission होना चाहिए।
Outgoing blocks अधिकतर VPN/proxy/MDM/third-party firewall में खोजते हैं।
अस्पष्ट security और firewall prompts को screenshot के रूप में Claude Code में भेजते हैं।

10. नियम

सेटअप का बारहवां चरण:

macOS पर जांचना चाहिए कि Claude Code (Codex) Desktop app, Claude Code CLI, Terminal.app, Git, GitHub CLI, Homebrew, pip और pnpm इंटरनेट तक पहुंच सकते हैं। अंतर्निहित macOS Firewall सामान्यतः incoming connections प्रबंधित करता है, लेकिन यदि application स्पष्ट रूप से block हो तो उसके Options जांचने चाहिए।

अतिरिक्त नियम:

यदि Claude Code या developer tools इंटरनेट पर नहीं जा रहे, तो सुरक्षा को आंख बंद करके बंद न करें। Firewall, VPN, proxy, DNS, MDM और third-party network filters जांचें, और permissions की सभी न समझ आने वाली विंडोज़ के screenshots Claude Code को भेजें।

चरण 13. macOS पर PATH सेट करें

Windows में Path variable होता है, जिसमें उन programs वाले folders दर्ज किए जाते हैं जिन्हें terminal से चलना चाहिए। macOS में वही विचार है, लेकिन इसे सामान्यतः कहा जाता है:

PATH

PATH folders की सूची है जिनमें shell commands खोजता है।

यदि command कंप्यूटर पर है, लेकिन उसका folder PATH में नहीं पहुंचा, तो Terminal.app और Claude Code (Codex) उसे सामान्य रूप से नहीं चला सकेंगे।

1. Claude Code के लिए PATH क्यों महत्वपूर्ण है

Claude Code लगातार commands चलाता है:

git;
gh;
codex;
python3;
pip;
node;
npm;
pnpm;
brew;
curl।

यदि कोई command नहीं मिलती, तो Claude Code loop में फंस सकता है, workarounds प्रस्तावित कर सकता है, अनावश्यक चीजें reinstall कर सकता है या समस्या का गलत diagnosis कर सकता है। इससे समय और tokens की भारी बर्बादी होती है।

इसलिए प्रत्येक tool इंस्टॉल करने के बाद केवल इंस्टॉलेशन का तथ्य नहीं, बल्कि यह भी जांचना चाहिए कि command Terminal.app से उपलब्ध है।

2. PATH कैसे देखें

वर्तमान PATH दिखाएं:

echo "$PATH"

अधिक पठनीय विकल्प:

echo "$PATH" | tr ':' '\n'

हर line एक अलग folder है, जहां shell executable commands खोजता है।

3. विशिष्ट command कैसे जांचें

जांचें कि command मिलती है या नहीं:

command -v git
command -v gh
command -v codex
command -v python3
command -v node
command -v pnpm
command -v brew

यह भी उपयोग किया जा सकता है:

which git
which gh
which codex
which python3
which node
which pnpm
which brew

यदि command सही कॉन्फ़िगर है, तो macOS executable file का path दिखाएगा, उदाहरण के लिए:

/usr/bin/git
/opt/homebrew/bin/brew
/opt/homebrew/bin/node

यदि command नहीं मिली, तो इस प्रकार की error होगी:

command not found

या खाली परिणाम।

4. macOS पर PATH के सामान्य folders

macOS पर अक्सर ये paths मिलते हैं:

/usr/bin
/bin
/usr/sbin
/sbin
/usr/local/bin
/opt/homebrew/bin

Apple Silicon Mac के लिए Homebrew सामान्यतः यहां होता है:

/opt/homebrew/bin

Intel Mac के लिए Homebrew अक्सर यहां होता है:

/usr/local/bin

python.org के Python installer के लिए इस प्रकार के paths दिख सकते हैं:

/Library/Frameworks/Python.framework/Versions/3.12/bin

version manager के माध्यम से इंस्टॉल किए Node.js के लिए उपयोगकर्ता के home folder के भीतर paths दिख सकते हैं।

5. zsh में PATH कहां सेट होता है

आधुनिक macOS में मानक shell zsh है।

zsh के लिए सामान्यतः ये files उपयोग होती हैं:

~/.zprofile
~/.zshrc

लेकिन इन्हें बिना समझे हाथ से संपादित नहीं करना चाहिए।

महत्वपूर्ण:

.zshrc, .zprofile, .bash_profile या अन्य shell-files में अनुमान से lines नहीं डालनी चाहिए।

PATH में गलत line terminal, package managers को तोड़ सकती है या गलत Python/Node/Git version चलने का कारण बन सकती है।

6. Homebrew और PATH

macOS पर Homebrew इंस्टॉल करने के बाद वह सामान्यतः स्वयं command दिखाता है जिसे shell profile में जोड़ना चाहिए।

Apple Silicon पर यह अक्सर ऐसा दिखता है:

eval "$(/opt/homebrew/bin/brew shellenv)"

लेकिन इस line को बिना जांच हर किसी को कॉपी नहीं करना चाहिए।

सही कार्यवाही:

Homebrew installer का screenshot लें या output कॉपी करें -> Claude Code में भेजें -> वही exact command निष्पादित करें जिसे Claude Code ने विशिष्ट Mac के लिए पुष्टि की है

7. PATH सेट करने के बाद क्या काम करना चाहिए

न्यूनतम checklist:

git --version
gh --version
codex --version
python3 --version
node --version
pnpm --version

यदि Homebrew इंस्टॉल है:

brew --version

यदि सभी commands नए Terminal.app window से चलती हैं, तो PATH Claude Code के लिए पर्याप्त रूप से सेट है।

8. PATH बदलने के बाद नया Terminal.app खोलना चाहिए

shell profile बदलने के बाद पुरानी Terminal.app window परिवर्तनों को नहीं देख सकती।

करना चाहिए:

वर्तमान Terminal.app window बंद करें।
नई Terminal.app window खोलें।
फिर से checks चलाएं:

echo "$PATH" | tr ':' '\n'
command -v codex
command -v gh
command -v python3
command -v node
command -v pnpm

9. PATH के निर्देश स्वयं न खोजें

सख्त नियम:

macOS पर PATH सेट करते समय यह स्पष्ट रूप से समझना चाहिए कि कौन-सी exact line किस exact file में जोड़नी है। यह Claude Code से पूछना चाहिए, न कि इंटरनेट पर खोजना या स्वयं गढ़ना चाहिए।

सही अनुरोध:

Claude Code, मैं Claude Code परिवेश के लिए macOS पर PATH सेट कर रहा हूं। यहां echo "$PATH", command -v brew, command -v codex, command -v gh, command -v python3, command -v node, command -v pnpm का output है। बताएं कि ~/.zprofile या ~/.zshrc में कुछ जोड़ना आवश्यक है या नहीं, और exact command दें।

यदि कोई command नहीं मिलती:

Claude Code, macOS पर node/pnpm/gh/codex/python3 command Terminal.app में नहीं मिल रही है। यहां echo "$PATH" और command -v का output है। PATH को सुरक्षित रूप से ठीक करने में सहायता करें।

10. बिना कारण sudo का उपयोग न करें

PATH सेट करने के लिए लगभग कभी sudo की आवश्यकता नहीं होती।

यदि इंटरनेट से कोई निर्देश प्रस्तावित करे:

sudo nano /etc/paths

या system PATH files संपादित करने का सुझाव दे, तो यह red flag है।

सामान्य Claude Code परिवेश के लिए लगभग हमेशा user shell-files पर्याप्त होती हैं:

~/.zprofile
~/.zshrc

/etc/paths जैसी system files को स्पष्ट कारण और Claude Code की पुष्टि के बिना नहीं बदलना चाहिए।

11. नियम

सेटअप का तेरहवां चरण:

macOS पर जांचना चाहिए कि Claude Code परिवेश की सभी मुख्य commands Terminal.app से PATH के माध्यम से उपलब्ध हैं: git, gh, codex, python3, node, pnpm, brew।

अतिरिक्त सख्त नियम:

macOS पर PATH को अनुमान से सेट नहीं करते। इंटरनेट पर यादृच्छिक commands नहीं खोजते, .zshrc, .zprofile और system files को बिना समझे संपादित नहीं करते। हमेशा Claude Code से पूछते हैं, वर्तमान PATH दिखाते हैं और विशिष्ट Mac के लिए exact instruction निष्पादित करते हैं।

चरण 14. Audio और video के साथ काम के लिए FFmpeg इंस्टॉल करें

हमारे काम में Claude Code को अक्सर audio से संबंधित tasks मिलते हैं:

voice transcription तैयार करना;
audio file काटना;
format convert करना;
video से audio निकालना;
file duration जांचना;
आगे की processing के लिए file normalize या तैयार करना;
ऐसे Python- और JavaScript-tools उपयोग करना जिन्हें ffmpeg चाहिए।

इसलिए FFmpeg Claude Code (Codex) परिवेश के लिए अनिवार्य system tool है।

1. FFmpeg क्या है

FFmpeg audio और video के साथ काम के लिए command-line tools का set है।

सबसे महत्वपूर्ण commands:

ffmpeg
ffprobe

ffmpeg conversion, cutting, audio extraction और अन्य operations करता है।

ffprobe media file की technical information दिखाता है: duration, codecs, tracks, bitrate, sample rate और अन्य parameters।

2. FFmpeg macOS में अंतर्निहित नहीं है

FFmpeg सामान्यतः macOS का मानक भाग नहीं है।

इसे अलग से इंस्टॉल करना चाहिए।

जांचें कि FFmpeg इंस्टॉल है:

ffmpeg -version
ffprobe -version

यदि commands नहीं मिलतीं, तो FFmpeg इंस्टॉल करना चाहिए।

3. लिंक या command स्वयं न खोजें

Windows पर FFmpeg अक्सर हाथ से इंस्टॉल किया जाता है: लिंक से archive डाउनलोड करना, unzip करना, disk C:\ के root folder में रखना, फिर Path में path दर्ज करना।

macOS पर मुख्य दृष्टिकोण अलग है। अधिकतर FFmpeg package manager, सामान्यतः Homebrew, के माध्यम से इंस्टॉल होता है।

सख्त नियम:

FFmpeg का डाउनलोड लिंक, installation command और path दर्ज करने के निर्देश Claude Code से पूछने चाहिए। इंटरनेट पर यादृच्छिक निर्देश नहीं खोजने चाहिए और path स्वयं नहीं गढ़ना चाहिए।

सही अनुरोध:

Claude, मुझे audio, video और transcriptions के साथ काम के लिए macOS पर FFmpeg इंस्टॉल करना है। मेरे Mac के लिए अद्यतन आधिकारिक/अनुशंसित इंस्टॉलेशन तरीका बताएं और कहें कि PATH सेट करना आवश्यक है या नहीं।

यदि इंस्टॉलेशन manual है:

Claude, मैं macOS पर FFmpeg हाथ से इंस्टॉल कर रहा हूं। बताएं कि ffmpeg और ffprobe को सही जगह कहां रखना है, और zsh के लिए PATH में कौन-सी line जोड़नी है। यहां मेरा वर्तमान echo "$PATH" और uname -m है।

4. macOS पर अनुशंसित तरीका

यदि Homebrew पहले से इंस्टॉल और कार्यशील है, तो अनुशंसित तरीका:

brew install ffmpeg

इंस्टॉलेशन के बाद जांचें:

ffmpeg -version
ffprobe -version

यदि commands काम करती हैं, तो सामान्यतः अलग से path दर्ज करने की आवश्यकता नहीं होती: Homebrew binaries को अपने prefix में इंस्टॉल करता है, जो पहले से PATH में होना चाहिए।

Apple Silicon Mac पर यह सामान्यतः है:

/opt/homebrew/bin

Intel Mac पर यह अक्सर है:

/usr/local/bin

5. यदि Homebrew इंस्टॉल नहीं है

यदि Homebrew अभी इंस्टॉल नहीं है, तो तुरंत यादृच्छिक FFmpeg archive डाउनलोड नहीं करना चाहिए।

Claude Code (Codex) से पूछना चाहिए:

Claude, मेरे Mac पर अभी Homebrew नहीं है, लेकिन मुझे Claude Code परिवेश के लिए FFmpeg इंस्टॉल करना है। क्या सही है: पहले Homebrew इंस्टॉल करना या manual binary उपयोग करना? macOS के लिए सुरक्षित निर्देश दें।

अधिकांश मामलों में टीम के लिए सही मार्ग:

पहले Homebrew -> फिर brew install ffmpeg

manual binary installation केवल तभी स्वीकार्य है जब Homebrew उपयोग न करने का कारण हो।

6. macOS पर manual installation

macOS पर FFmpeg की manual installation डिफ़ॉल्ट रूप से नहीं करते।

यदि फिर भी आवश्यक हो, तो Windows की तरह files को disk के root में नहीं रखना चाहिए।

macOS पर user या standard Unix-location उपयोग करना बेहतर है, उदाहरण के लिए:

~/bin

या दूसरा folder जिसे Claude Code ने विशिष्ट Mac के लिए स्पष्ट रूप से पुष्टि की हो।

इसके बाद उस folder का path PATH में पहुंचना चाहिए।

लेकिन फिर से:

ठीक ffmpeg और ffprobe को कहां रखना है और ~/.zprofile या ~/.zshrc में कौन-सी exact line जोड़नी है, यह वर्तमान PATH को ध्यान में रखते हुए Claude Code से पूछना चाहिए।

7. PATH जांचें

इंस्टॉलेशन के बाद जांचें कि Terminal.app commands देखता है:

command -v ffmpeg
command -v ffprobe

Apple Silicon पर Homebrew द्वारा इंस्टॉल होने पर अपेक्षित परिणाम:

/opt/homebrew/bin/ffmpeg
/opt/homebrew/bin/ffprobe

Intel Mac पर Homebrew द्वारा इंस्टॉल होने पर अपेक्षित परिणाम:

/usr/local/bin/ffmpeg
/usr/local/bin/ffprobe

यदि command -v कुछ नहीं दिखाता, तो FFmpeg गलत जगह इंस्टॉल हुआ है या folder PATH में नहीं पहुंचा।

तब Claude Code से पूछना चाहिए:

Claude Code, FFmpeg macOS पर इंस्टॉल है, लेकिन command -v ffmpeg कुछ नहीं दिखा रहा। यहां echo "$PATH", brew --prefix और आवश्यक folder का ls output है। FFmpeg को PATH में सुरक्षित रूप से जोड़ने में सहायता करें।

8. किसी file पर काम जांचें

इंस्टॉलेशन के बाद केवल version नहीं, ffprobe का काम भी जांचना उपयोगी है।

उदाहरण:

ffprobe -hide_banner path/to/audio-or-video-file

यदि अभी file नहीं है, तो पर्याप्त है:

ffmpeg -version
ffprobe -version

9. Python और JavaScript से संबंध

कुछ Python- और JavaScript-packages अंदर FFmpeg उपयोग कर सकते हैं:

imageio-ffmpeg;
audio/video processing scripts;
transcription pipelines;
video conversion utilities;
tools that extract audio from video।

यह समझना महत्वपूर्ण है:

Python-package imageio-ffmpeg उस स्थिति में system ffmpeg की आवश्यकता समाप्त नहीं करता जब project या Claude Code scripts command-line commands ffmpeg और ffprobe की अपेक्षा करते हैं।

इसलिए ffmpeg -version की जांच अनिवार्य है।

10. बिना कारण sudo उपयोग न करें

Homebrew से इंस्टॉलेशन के समय सामान्यतः हाथ से sudo उपयोग करने की जरूरत नहीं होती।

यदि कोई यादृच्छिक निर्देश प्रस्तावित करे:

sudo cp ffmpeg /usr/bin
sudo nano /etc/paths

तो यह red flag है।

रुकना चाहिए और Claude Code से पूछना चाहिए।

11. नियम

सेटअप का चौदहवां चरण:

macOS पर audio, video और transcriptions के साथ काम के लिए FFmpeg इंस्टॉल करना चाहिए और ffmpeg और ffprobe commands जांचनी चाहिए।

अनुशंसित मार्ग:

brew install ffmpeg

अतिरिक्त सख्त नियम:

FFmpeg का डाउनलोड लिंक, installation command और PATH निर्देश हमेशा Claude Code से पूछते हैं। इंटरनेट पर यादृच्छिक निर्देश नहीं खोजते, files को system folders में नहीं रखते और paths का अनुमान से दर्ज नहीं करते।

चरण 15. Markdown और YAML के लिए text editor इंस्टॉल करें

macOS पर Claude Code (Codex) परिवेश के लिए एक अच्छा text editor अनिवार्य है।

उसका काम IDE को बदलना और programming का मुख्य tool बनना नहीं है। उसका काम सरल और अधिक महत्वपूर्ण है:

Markdown-file तेज़ी से खोलना;
YAML-file तेज़ी से खोलना;
document structure पढ़ना;
text, headings, lists, configs सुधारना;
syntax highlighting देखना;
encoding न तोड़ना;
plain text को rich text में न बदलना;
invisible formatting न जोड़ना।

1. TextEdit पर्याप्त क्यों नहीं है

macOS में अंतर्निहित TextEdit है, लेकिन Claude Code (Codex) परिवेश के लिए हम इसे पर्याप्त editor नहीं मानते।

कारण: TextEdit केवल plain text पर नहीं, rich text पर भी केंद्रित है। इससे Markdown, YAML या configuration file को गलती से तोड़ने का जोखिम बढ़ता है।

हमारे काम के लिए ठीक plain-text editor चाहिए।

2. मुख्य formats

editor को कम से कम इन formats के साथ भरोसेमंद रूप से काम करना चाहिए:

.md
.markdown
.yaml
.yml
.txt
.json
.toml
.env

विशेष रूप से महत्वपूर्ण:

Markdown
YAML

Markdown instructions, documentation, prompts, handoff-files, product docs और Claude Code (Codex) materials के लिए आवश्यक है।

YAML configs, CI/CD, GitHub Actions, docker-compose, automation-files और infrastructure descriptions के लिए आवश्यक है।

3. macOS पर Best practice editors

macOS के लिए सामान्य विकल्प:

CotEditor
Sublime Text
BBEdit
Visual Studio Code

CotEditor

एक अच्छा मुफ्त macOS-native plain-text editor।

यदि Markdown/YAML के लिए सरल, तेज़ और स्पष्ट editor चाहिए, तो टीम के लिए बुनियादी विकल्प के रूप में उपयुक्त है।

Sublime Text

बहुत तेज़ professional editor।

उन लोगों के लिए paid या shareware विकल्प के रूप में उपयुक्त, जिन्हें Notepad++ के बजाय Sublime की आदत है।

BBEdit

क्लासिक professional macOS text editor।

बड़ी text files, search, plain text, Markdown, HTML/XML और technical texts के लिए अच्छा है।

4. टीम के लिए अनुशंसित मानक

न्यूनतम मानक:

CotEditor

विस्तृत मानक:

CotEditor + Visual Studio Code

Paid/professional विकल्प:

Sublime Text या BBEdit

मुख्य बात:

Mac पर कम से कम एक सामान्य plain-text editor होना चाहिए, जो Markdown और YAML तेज़ी से खोलता हो।

5. लिंक स्वयं न खोजें

सख्त नियम:

Text editor का डाउनलोड लिंक और इंस्टॉलेशन तरीका Claude Code (Codex) से पूछना चाहिए। इंटरनेट पर यादृच्छिक download-sites नहीं खोजने चाहिए।

सही अनुरोध:

Claude, मुझे Claude Code परिवेश में Markdown और YAML के लिए macOS पर text editor इंस्टॉल करना है। CotEditor/Sublime Text/BBEdit के लिए आधिकारिक download source बताएं और मेरे कार्य के लिए सर्वोत्तम विकल्प सुझाएं।

यदि व्यक्ति ने पहले ही editor चुन लिया है:

Claude, मैं macOS पर Sublime Text/CotEditor/BBEdit इंस्टॉल करना चाहता हूं। आधिकारिक download source दें और जांचें कि Apple Silicon या Intel Mac के लिए कौन-सा build चुनना है।

6. इंस्टॉलेशन

संभावित सुरक्षित स्रोत:

editor की आधिकारिक साइट;
Mac App Store;
आधिकारिक Homebrew cask, यदि टीम पहले से Homebrew उपयोग करती है।

random download-sites, mirrors, "free cracked", "portable build" और ऐसे स्रोतों से editors डाउनलोड नहीं करने चाहिए।

यदि इंस्टॉलेशन Homebrew से हो रहा है, तो command भी Claude Code से पूछते हैं:

Claude, क्या चुने हुए text editor को macOS पर Homebrew cask से इंस्टॉल किया जा सकता है? सुरक्षित command और आधिकारिक source दें।

7. इंस्टॉलेशन के बाद जांच

इंस्टॉलेशन के बाद जांचना चाहिए:

Editor खुलता है।
.md खोला जा सकता है।
.yaml और .yml खोले जा सकते हैं।
Syntax highlighting दिखाई देती है।
File plain text के रूप में सहेजी जाती है।
Editor rich-text formatting नहीं जोड़ता।

Test files:

test.md
test.yaml

YAML का उदाहरण:

name: codex-macos-setup
tools:
  - codex
  - git
  - homebrew

Markdown का उदाहरण:

# Claude Code macOS setup

- Markdown works
- YAML works

8. files खोलना सेट करें

इंस्टॉलेशन के बाद .md, .yaml, .yml के लिए default editor सेट किया जा सकता है।

लेकिन इसे सभी लोगों के लिए एक समान करना अनिवार्य नहीं है।

यदि editor को default application बनाना हो, तो Claude Code से पूछें:

Claude, मैं macOS पर CotEditor/Sublime Text/BBEdit को .md, .yaml और .yml के लिए default editor बनाना चाहता हूं। Finder के माध्यम से step-by-step निर्देश दें।

9. जांच के बिना अतिरिक्त extensions इंस्टॉल न करें

यदि VS Code या extensions/plugins वाले दूसरे editor का उपयोग होता है, तो यादृच्छिक extensions इंस्टॉल नहीं करने चाहिए।

नियम:

Markdown, YAML, GitHub, OpenAI, formatting और preview के extensions केवल Claude Code (Codex) से जांचने के बाद इंस्टॉल करें।

कारण: extensions को project files तक पहुंच होती है और वे security, formatting और editor के behavior को प्रभावित कर सकते हैं।

10. नियम

सेटअप का पंद्रहवां चरण:

macOS पर Markdown और YAML के साथ तेज़ी से काम के लिए plain-text editor अनिवार्य रूप से इंस्टॉल होना चाहिए। न्यूनतम अनुशंसित विकल्प CotEditor है। Professional alternatives Sublime Text या BBEdit हैं। अधिक भारी code editor के रूप में VS Code उपयोग किया जा सकता है।

अतिरिक्त सख्त नियम:

डाउनलोड लिंक, installation तरीका, Apple Silicon/Intel build का चुनाव और default editor की setting Claude Code से पूछें। editors को random download-sites से डाउनलोड न करें और extensions को जांचे बिना इंस्टॉल न करें।

चरण 16. Product Markdown-documents के लिए Obsidian इंस्टॉल करें

यदि आप product work करते हैं, तो सामान्य text editor बहुत जल्दी अपर्याप्त हो सकता है।

Markdown-files की संख्या बढ़ती है। folders, subfolders, drafts, translations, handoff-files, source of truth, call notes, product theses, ADR, vision documents और अन्य materials आते हैं।

सामान्य text editor में तेज़ी से भ्रमित होना संभव है:

आवश्यक file कहां है;
कौन-सा version वर्तमान है;
कौन-से documents एक-दूसरे से जुड़े हैं;
product folder Data कहां है;
project से क्या संबंधित है और पुराने draft से क्या;
कौन-सी files तैयार हैं और कौन-सी अभी काम में हैं।

इसके लिए Obsidian चाहिए।

1. Obsidian क्या है

Obsidian Markdown-files और knowledge base के साथ काम करने का स्थानीय application है।

महत्वपूर्ण:

Obsidian स्थानीय रूप से काम करता है।
Obsidian सामान्य Markdown-files वाले folder के ऊपर काम करता है।
Obsidian आपके documents को बंद web-format में नहीं बदलता।
Obsidian को बुनियादी काम के लिए अनिवार्य authorization की आवश्यकता नहीं है।
Obsidian उपयोग के लिए मुफ्त है।

यह web-service नहीं, SaaS नहीं और GitHub/Google Drive/Confluence का प्रतिस्थापन नहीं है।

यह Markdown-documents वाले आपके folder के साथ सुविधाजनक काम की स्थानीय shell है।

2. पहली superpower: product files की संरचना देखना

Obsidian को आपके product folder से जोड़ा जा सकता है, उदाहरण के लिए:

~/Documents/Claude/Product/Data

या किसी अन्य folder से जहां product knowledge base रखी हो।

इसके बाद Obsidian दिखाता है:

file tree;
folders;
Markdown-documents;
notes के बीच connections;
तेज़ search;
Markdown preview;
सुविधाजनक navigation।

यह product work के लिए विशेष रूप से महत्वपूर्ण है, जहां केवल एक file खोलना नहीं, बल्कि documents की पूरी संरचना समझना आवश्यक है।

3. दूसरी superpower: AI के साथ parallel editing

Obsidian व्यक्ति और AI के संयुक्त काम के लिए बहुत सुविधाजनक है।

परिदृश्य:

एक ओर Obsidian खुला है।
उसमें व्यक्ति हाथ से Markdown-document संपादित करता है।
दूसरी ओर Claude Code/Codex/AI-interface खुला है।
व्यक्ति AI से उसी document को बदलने के लिए कहता है: term बदलना, block फिर से लिखना, section संरचित करना, repetition हटाना, text translate करना या file को template में लाना।
बदलाव file में प्रकट होता है।
Obsidian तुरंत updated document दिखाता है।

यह लगभग व्यक्ति और AI द्वारा document के संयुक्त editing जैसा महसूस होता है।

Tasks के उदाहरण:

Claude Code (Codex), इस document में term MetaSites को Metasites से बदलें।
Claude Code (Codex), इस Markdown को Source of Truth की संरचना में लाएं।
Claude Code (Codex), Dima के लिए सभी questions को अलग section में निकालें।
Claude Code (Codex), जांचें कि YAML frontmatter टूटा नहीं है।
Claude Code (Codex), structure खोए बिना English के पास Russian translation बनाएं।

Product work के लिए यह बहुत प्रभावी है।

4. तीसरी superpower: Obsidian plugins

Obsidian में plugins की विकसित प्रणाली है।

Plugins सहायता कर सकते हैं:

knowledge base व्यवस्थित करना;
tables के साथ काम करना;
search बेहतर करना;
dashboards बनाना;
documents जोड़ना;
templates के साथ काम करना;
navigation बेहतर करना;
tasks प्रबंधित करना।

लेकिन Obsidian plugins को तुरंत बड़ी संख्या में इंस्टॉल नहीं करना चाहिए।

सख्त नियम:

शुरुआत में Obsidian को local Markdown workspace के रूप में उपयोग करते हैं। plugins बाद में केवल तभी इंस्टॉल करते हैं जब स्पष्ट हो कि वे कौन-सा कार्य हल करते हैं।

plugin इंस्टॉल करने से पहले Claude Code (Codex) से पूछें:

Claude, मैं अपनी product Markdown-files base के लिए Obsidian plugin इंस्टॉल करना चाहता हूं। समझाएं कि क्या इसकी आवश्यकता है, क्या यह सुरक्षित है, और यह कौन-सा विशिष्ट task हल करता है।

5. चौथी क्षमता: knowledge graph

Obsidian में graph view है: documents के बीच connections का visual graph।

Knowledge graph बनाया जा सकता है और यह दिलचस्प दिखता है।

लेकिन ईमानदार वर्तमान स्थिति:

हमने अभी तक रोज़मर्रा के product work में graph view को प्रभावी रूप से उपयोग करना नहीं सीखा है।

इसलिए graph view का अध्ययन किया जा सकता है, लेकिन इसे basic workflow का अनिवार्य भाग नहीं मानना चाहिए।

वर्तमान में हमारे लिए अधिक महत्वपूर्ण है:

folders की संरचना;
तेज़ search;
Markdown का सुविधाजनक editing;
AI के साथ parallel work;
documents को सामान्य local .md files के रूप में रखना।

6. Obsidian इंस्टॉलेशन

Obsidian केवल आधिकारिक source से डाउनलोड करना चाहिए।

सख्त नियम:

Obsidian डाउनलोड का लिंक और installation तरीका Claude Code (Codex) से पूछना चाहिए। यादृच्छिक download-sites नहीं खोजनी चाहिए।

सही अनुरोध:

Claude, मुझे product Markdown-base के साथ काम के लिए macOS पर Obsidian इंस्टॉल करना है। आधिकारिक download source दें, बताएं कि Mac के लिए कौन-सा build चुनना है, और समझाएं कि local Data folder को vault के रूप में कैसे जोड़ा जाए।

macOS के लिए आधिकारिक installer सामान्यतः Obsidian site से डाउनलोड होता है, जिसके बाद application को Applications में खींचा जाता है।

7. product folder कैसे जोड़ें

Obsidian में कार्य folder को कहा जाता है:

vault

Product work के लिए vault को पहले से मौजूद Markdown-files वाले folder की ओर इंगित करना चाहिए।

उदाहरण के लिए:

~/Documents/Claude/Product/Data

या:

~/Documents/Claude/<project>/Data

यदि आपके पास documents वाला कार्य folder पहले से है, तो यादृच्छिक नया vault नहीं बनाना चाहिए।

Claude Code (Codex) से पूछना चाहिए:

Claude, मेरी product work के लिए सही Obsidian vault folder चुनने में सहायता करें। यहां ~/Documents/Claude की संरचना है। मैं product Markdown-files संपादित करना चाहता हूं और GitHub/Confluence के साथ संबंध नहीं तोड़ना चाहता।

8. Obsidian और Git

Obsidian disk पर सामान्य files संपादित करता है।

यदि यह folder Git repository है, तो Obsidian के बदलाव इनसे दिखाई देंगे:

git status
git diff

यह सुविधाजनक है, लेकिन अनुशासन मांगता है।

नियम:

Obsidian में documents के mass AI-editing से पहले git status जांचना चाहिए, ताकि समझ सकें कि कौन-से बदलाव पहले से मौजूद हैं।

9. Obsidian Confluence का विकल्प नहीं है

Obsidian केवल Markdown के साथ local work के लिए सुविधाजनक है।

Confluence publication, joint reading, corporate access और agreed pages के लिए आवश्यक है।

सही संयोजन:

Obsidian = Markdown का स्थानीय editing और structure
Claude Code (Codex) = AI-editing और automation
GitHub = version और synchronization
Confluence = publication और corporate consumption

10. नियम

सेटअप का सोलहवां चरण:

यदि आप product work करते हैं, तो Markdown-documents के लिए local shell के रूप में Obsidian इंस्टॉल करें और इसे सही Data folder या अन्य product knowledge base से जोड़ें।

अतिरिक्त सख्त नियम:

Obsidian केवल उसी आधिकारिक source से डाउनलोड करते हैं जो Claude Code (Codex) से पूछते हैं। Vault को सचेत रूप से चुनते हैं: उसे सही local documents folder की ओर इंगित करना चाहिए, न कि नई यादृच्छिक संरचना बनानी चाहिए।

चरण 17. IDE या code editor इंस्टॉल करें, लेकिन उसे मुख्य AI-interface न बनाएं

Markdown और YAML के लिए plain-text editor इंस्टॉल करने के बाद पूर्ण code editor इंस्टॉल किया जा सकता है: VS Code, Cursor या समान।

शब्दों को सावधानी से अलग करना महत्वपूर्ण है।

VS Code, Cursor, Windsurf और समान applications को अक्सर IDE कहा जाता है, लेकिन तकनीकी रूप से उनमें से कई अधिक निकट हैं:

code editor / AI code editor

पूर्ण IDE में सामान्यतः अधिक भारी अंतर्निहित क्षमताओं का set शामिल होता है: project system, debugger, profiler, GUI builders, language-specific tooling आदि। लेकिन दैनिक भाषा में developers अक्सर VS Code और Cursor को IDE कहते हैं। इस निर्देश में सामान्य term उपयोग किया जा सकता है:

IDE / code editor

1. IDE आवश्यक है, लेकिन यह पहला और मुख्य चरण नहीं है

पुरानी developer habits में VS Code, Cursor या अन्य IDE का इंस्टॉलेशन अक्सर कंप्यूटर setup का पहला और मुख्य चरण माना जाता है।

Claude Code (Codex) परिवेश में अब ऐसा नहीं है।

IDE आवश्यक है:

code पढ़ने और संपादित करने के लिए;
project navigation के लिए;
syntax highlighting के लिए;
Git diff के साथ काम करने के लिए;
scripts local रूप से चलाने के लिए;
debugging;
TypeScript/Python/React/Node.js workflows;
files के targeted manual editing के लिए।

लेकिन IDE AI के साथ संवाद का मुख्य interface नहीं होना चाहिए।

2. मुख्य AI-interface Claude Code (Codex) GUI क्यों है

Claude Code (Codex) के साथ हमारा काम केवल text पर आधारित नहीं है।

हम लगातार उपयोग करते हैं:

voice messages;
कार्य की बड़ी मौखिक descriptions;
errors के screenshots;
interfaces के screenshots;
AI-questionnaires;
images और layouts;
files;
sequential dialogue;
results की जांच;
सामान्य human language में context की व्याख्या।

Claude Code (Codex) GUI इस mode के लिए अधिक सुविधाजनक है, क्योंकि यह agent के साथ बातचीत, screenshots, voice context और files देने के लिए बेहतर अनुकूल है।

IDE/code editor code के भीतर अच्छा है, लेकिन AI-vibecoding के लिए मुख्य conversational interface के रूप में कमजोर है।

3. कठोर नई वास्तविकता

Developers सोचने के आदी हैं:

पहले IDE इंस्टॉल करते हैं -> फिर काम शुरू करते हैं

Claude Code (Codex)-काम के लिए अधिक सही है:

पहले macOS, Claude Code, terminal, Git, Homebrew, Python, Node.js, PATH और media-tools तैयार करते हैं -> फिर IDE/code editor को अतिरिक्त working tool के रूप में इंस्टॉल करते हैं

IDE अब पूरे development का केंद्र नहीं है।

AI-vibecoding workflow का केंद्र Claude Code (Codex) और सही ढंग से तैयार environment है।

4. केवल IDE के माध्यम से AI-work क्यों नहीं करना चाहिए

हम VS Code, Cursor और analogs को प्रतिबंधित नहीं करते।

लेकिन हम पूरी AI-work केवल IDE के माध्यम से बनाने की दृढ़ता से अनुशंसा नहीं करते, क्योंकि:

IDE में voice input सामान्यतः विशेष रूप से संगठित Claude Code (Codex) workflow की अपेक्षा कम सुविधाजनक होता है;
screenshots और images के साथ काम कम तेज़ हो सकता है;
बड़े context को voice से देना हमेशा सुविधाजनक नहीं होता;
लंबा product या architectural dialogue चलाना हमेशा सुविधाजनक नहीं होता;
IDE तुरंत code में जाने के लिए प्रेरित करता है, न कि पहले task को सही ढंग से तैयार करने के लिए;
developer files के स्तर पर agent से बहस शुरू कर देता है, पूर्ण context, acceptance criteria और constraints पहले देने के बजाय।

हां, आधुनिक editors विकसित हो रहे हैं। VS Code में Copilot Chat, extensions, voice/speech capabilities और image inputs हैं। Cursor खुद को agent-first editor के रूप में स्थापित करता है। लेकिन यह अभी हमारे team rule को समाप्त नहीं करता:

IDE/code editor code के साथ काम का tool है। Claude Code (Codex) GUI tasks देने, voice communication, screenshots, files और agent work का मुख्य interface है।

5. macOS पर कौन-सा IDE/code editor इंस्टॉल करें

सामान्य विकल्प:

Visual Studio Code
Cursor
Windsurf
JetBrains IDEs

हमारी टीम के लिए मूल विकल्प:

Visual Studio Code

यदि व्यक्ति पहले से Cursor उपयोग करता है, तो Cursor इंस्टॉल किया जा सकता है, लेकिन उसे टीम का एकमात्र AI-interface नहीं बनाना चाहिए।

JetBrains IDEs विशिष्ट stacks के लिए उपयोगी हैं: Java, Kotlin, backend, mobile, heavy refactoring। लेकिन वे बुनियादी Claude Code (Codex)-परिवेश के लिए अनिवार्य नहीं हैं।

6. IDE को यादृच्छिक स्रोतों से डाउनलोड न करें

सख्त नियम:

VS Code, Cursor या अन्य IDE/code editor का डाउनलोड लिंक Claude Code (Codex) से पूछना चाहिए। इंटरनेट पर installer स्वयं नहीं खोजना चाहिए।

सही अनुरोध:

Claude, मुझे Claude Code परिवेश के लिए macOS पर VS Code/Cursor इंस्टॉल करना है। आधिकारिक download source दें, बताएं कि Apple Silicon या Intel Mac के लिए कौन-सा build चुनना है, और इंस्टॉलेशन के बाद क्या जांचना है।

यदि Homebrew से इंस्टॉलेशन हो:

Claude, क्या VS Code/Cursor को macOS पर Homebrew cask से इंस्टॉल किया जा सकता है? सुरक्षित command और आधिकारिक source दें।

7. इंस्टॉलेशन के बाद क्या जांचें

IDE/code editor इंस्टॉल करने के बाद जांचें:

Application खुलता है।
`~/Documents/Claude से project folder खोला जा सकता है।
Project files दिखाई देती हैं।
.md, .yaml, .json, .ts, .js, .py खुलते हैं।
Editor के भीतर terminal commands देखता है:

git --version
python3 --version
node --version
pnpm --version
codex --version

Editor line endings, encoding और YAML indentation नहीं तोड़ता।

यदि IDE का built-in terminal commands नहीं देखता, लेकिन सामान्य Terminal.app देखता है, तो समस्या IDE के भीतर shell/PATH में है। इसे Claude Code (Codex) को दिखाना चाहिए।

8. Extensions और plugins

तुरंत बहुत से extensions इंस्टॉल नहीं करने चाहिए।

न्यूनतम उपयोगी categories:

Markdown;
YAML;
Git/GitHub;
Python;
JavaScript/TypeScript;
केवल विशिष्ट project के लिए formatter/linter।

सख्त नियम:

Extensions केवल Claude Code से जांचने के बाद और केवल विशिष्ट task के लिए इंस्टॉल करते हैं। यादृच्छिक AI/extensions packs इंस्टॉल नहीं करते।

कारण: extensions को workspace, files, terminal, environment variables और कभी-कभी tokens तक पहुंच होती है और वे केवल official versions और सुरक्षित होने चाहिए। अज्ञात extension इंस्टॉल करना आपके desktop पर vulnerability ला सकता है।

9. developers को यह कैसे समझाएं

टीम के लिए wording:

हम आपसे VS Code या Cursor नहीं ले रहे हैं। आप उन्हें code पढ़ने और संपादित करने के लिए उपयोग कर सकते हैं।

लेकिन टीम का मुख्य AI-workflow Claude Code (Codex) GUI के माध्यम से चलता है, क्योंकि वहां voice से tasks देना, screenshots attach करना, files देना, architecture पर चर्चा करना और result जांचना तेज़ और अधिक स्वाभाविक है।

IDE code के साथ manual work का tool बना रहता है। Claude Code (Codex) GUI AI-agent के साथ काम का मुख्य interface बनता है।

यह स्वाद का प्रश्न नहीं है। यह speed, context quality और errors की संख्या घटाने का प्रश्न है।

10. नियम

सेटअप का सत्रहवां चरण:

macOS पर IDE/code editor, सामान्यतः VS Code या Cursor, इंस्टॉल किया जा सकता है और करना चाहिए। लेकिन IDE टीम का मुख्य AI-interface नहीं है। AI-vibecoding का मुख्य interface Claude Code (Codex) GUI है।

अतिरिक्त सख्त नियम:

IDE केवल Claude Code (Codex) से पूछे गए official source से डाउनलोड करते हैं। Extensions सावधानी से और केवल जांच के बाद इंस्टॉल करते हैं। यदि IDE terminal git, python3, node, pnpm या codex नहीं देखता, तो अनुमान से ठीक न करें, बल्कि Claude Code (Codex) को command output और वर्तमान PATH दिखाएं।

चरण 19. यह पूरा सेटअप क्यों आवश्यक है

पिछले सभी बिंदु पूरे करने के बाद उपयोगकर्ता को Claude Code, Codex और अन्य AI-development tools के साथ काम करने के लिए गुणवत्ता से कॉन्फ़िगर किया हुआ macOS-परिवेश मिलता है।

यह निर्देश औपचारिकता या programs इंस्टॉल करने के प्रेम के लिए नहीं है।

यह इसलिए आवश्यक है ताकि AI-vibecoding तेज़, पूर्वानुमेय, सुरक्षित और आर्थिक रूप से समझदारी भरा हो।

1. AI को अनुपस्थित tools विकसित करने के लिए मजबूर न करें

यदि कंप्यूटर पर Git, Python, Node.js, pnpm, FFmpeg, GitHub CLI, Xcode Command Line Tools या कोई अन्य बुनियादी tool इंस्टॉल नहीं है, तो AI-agent task पर नहीं, अनुपस्थित environment ठीक करने पर समय खर्च करने लगता है।

यह खराब scenarios की ओर ले जाता है:

Claude Code (Codex) अनुपस्थित tool को temporary script से बदलने की कोशिश करता है;
Claude Code workarounds खोजने लगता है;
agent अनावश्यक installations प्रस्तावित करता है;
task फैलता जाता है;
token खर्च बढ़ता है;
execution time बढ़ता है;
काम की अंतिम लागत कई गुना अधिक हो जाती है।

महत्वपूर्ण है कि vibecoding के दौरान आपका Claude Code आपको अनुपस्थित tool के बारे में न बताए, और आप इसके बारे में कभी न जानें। लेकिन AI agent को अंतहीन समस्याएं हल करते हुए बहुत लंबे समय तक देखते रहेंगे।

सही निष्कर्ष:

बुनियादी tools पहले से इंस्टॉल होने चाहिए। AI को उस चीज़ को आविष्कार करने में काम का समय खर्च नहीं करना चाहिए जो environment का हिस्सा होना चाहिए।

2. AI को accesses और permissions से लड़ने के लिए मजबूर न करें

खराब ढंग से तैयार Mac Claude Code (Codex) का काम code error के कारण नहीं, environment के कारण तोड़ सकता है:

व्यवस्थापक अधिकार नहीं हैं;
पुराना macOS;
updates इंस्टॉल नहीं हैं;
Terminal.app commands नहीं देखता;
PATH टूटा हुआ है;
firewall या VPN network block करता है;
GitHub CLI authorized नहीं है;
Google API enabled नहीं हैं;
FFmpeg नहीं मिलता;
Python packages global रूप से इंस्टॉल हैं और conflict करते हैं;
Node.js-packages गलत package manager से इंस्टॉल हुए हैं;
IDE terminal अलग environment देखता है।

ऐसी परिस्थितियों में AI task से नहीं, कंप्यूटर से लड़ने लगता है।

इससे AI-vibecoding धीमा, महंगा और अप्रिय हो जाता है। अक्सर इस निराशा की ओर ले जाता है कि AI मूर्ख है और खराब काम करता है।

महत्वपूर्ण है कि vibecoding के दौरान आपका Claude Code आपको अनुपस्थित access या permission के बारे में न बताए, और आप इसके बारे में कभी न जानें। लेकिन AI agent को access की अंतहीन समस्याएं हल करते हुए बहुत लंबे समय तक देखते रहेंगे।

सही निष्कर्ष:

Environment इस तरह सेट होना चाहिए कि Claude Code (Codex) तुरंत files पढ़ सके, commands चला सके, dependencies डाउनलोड कर सके, GitHub, audio, video, Python, Node.js और Google APIs के साथ काम कर सके।

3. Looping से सुरक्षा

AI-development की सबसे महंगी समस्याओं में से एक looping है।

Looping तब उत्पन्न होती है जब agent बार-बार एक ही infrastructure problem हल करने का प्रयास करता है:

command नहीं मिलती;
package इंस्टॉल नहीं होता;
PATH अपडेट नहीं हुआ;
permissions file पढ़ने या लिखने नहीं देतीं;
network request block होती है;
API enabled नहीं है;
credentials काम नहीं करते;
compiler अनुपस्थित है;
FFmpeg नहीं मिला;
Python/Node versions conflict करते हैं।

ऐसा प्रत्येक cycle खर्च करता है:

उपयोगकर्ता का समय;
tokens;
पैसा;
ध्यान;
AI-tool पर विश्वास।

महत्वपूर्ण है कि vibecoding में यदि आपका Claude Code looping में फंसता है, तो वह आपको वास्तविक समस्या के बारे में नहीं बताएगा; संभव है कि आप केवल messages के context से इसका अनुमान लगा सकें।

सही निष्कर्ष:

Environment का अच्छा पूर्व-सेटअप Claude Code या Codex की looping से सुरक्षा है।

4. क्रम क्यों महत्वपूर्ण है

इंस्टॉलेशन का क्रम आकस्मिक नहीं है।

IDE से शुरू करके यह आशा नहीं कर सकते कि बाकी सब अपने-आप आ जाएगा।

सही क्रम errors की संख्या कम करता है:

macOS -> admin account -> Claude Code (Codex) -> Terminal/zsh -> screenshots -> Xcode Command Line Tools -> Git -> Homebrew -> GitHub CLI -> Python -> Python packages -> Node.js/pnpm -> network/firewall -> PATH -> FFmpeg -> text editor -> IDE -> plugins -> Google APIs

यदि क्रम तोड़ा जाए, तो अजीब errors मिल सकती हैं:

Git इंस्टॉल है, लेकिन compiler tools नहीं हैं;
Homebrew इंस्टॉल है, लेकिन brew PATH में नहीं है;
GitHub CLI इंस्टॉल है, लेकिन GitHub account नहीं है;
Python packages गलत Python version में इंस्टॉल हो रहे हैं;
Node.js है, लेकिन pnpm काम नहीं करता;
FFmpeg इंस्टॉल है, लेकिन Claude Code (Codex) उसे नहीं देखता;
Google API credentials हैं, लेकिन APIs enabled नहीं हैं।

5. आर्थिक अर्थ

ये नियम बचाते हैं:

समय;
पैसा;
tokens;
nerves;
टीम के कार्य घंटे।

वे result की quality भी बढ़ाते हैं:

Claude Code (Codex) कम विचलित होता है;
कम यादृच्छिक installations;
versions के कम conflicts;
कम access errors;
कम network blocks;
कम manual panic;
अधिक स्थिर development।

6. मानवीय अर्थ

इस निर्देश का लक्ष्य AI के साथ काम को सुखद बनाना है, निराशाजनक नहीं।

खराब ढंग से सेट environment यह भावना बनाता है कि AI "धीमा सोच रहा है", "loop में है", "नहीं जानता", "package इंस्टॉल नहीं कर सकता", "Mac नहीं समझता" या "project तोड़ देता है"।

अक्सर समस्या AI में नहीं होती।

समस्या यह होती है कि कंप्यूटर AI-vibecoding के लिए तैयार नहीं था।

सही environment काम की भावना बदलता है:

कम संघर्ष -> अधिक परिणाम
कम diagnostics -> अधिक development
कम irritation -> AI से अधिक आनंद

7. अंतिम नियम

सेटअप का उन्नीसवां चरण:

पूरे निर्देश और इंस्टॉलेशन क्रम का पालन bureaucracy के लिए नहीं, बल्कि समय, पैसे और ध्यान बचाने के लिए करें। अच्छा environment Claude Code और Codex को अनुपस्थित tools विकसित करने, accesses से लड़ने और महंगे error cycles में फंसने नहीं देता।

निष्कर्ष:

सही ढंग से सेट Mac AI-vibecoding को तेज़, सस्ता, शांत और बहुत अधिक सुखद बनाता है।

चरण 20. Claude Code (Codex) plugins और MCP-servers सेट करें

macOS-परिवेश सेट होने के बाद, स्वयं Claude Code (Codex) सेट करने की ओर बढ़ा जा सकता है।

इस चरण पर ऐसे plugins इंस्टॉल करना महत्वपूर्ण है जो Claude Code (Codex) को टीम की कार्य सेवाओं से जोड़ते हैं: mail, calendar, documents, tasks, repositories, design और internal systems।

1. Claude Code (Codex) में plugin क्या है

Claude Code (Codex) में plugin एक installable bundle है जो agent की क्षमताएं बढ़ाता है।

Plugin में शामिल हो सकते हैं:

skills;
app integrations/connectors;
MCP servers;
commands;
hooks;
assets;
settings और metadata।

सरलीकृत रूप में ऐसे सोच सकते हैं:

plugin = Claude Code (Codex) के लिए capabilities का तैयार package

अक्सर plugin के भीतर वास्तव में MCP server और उसके साथ काम के लिए skills का set होता है। लेकिन तकनीकी रूप से plugin केवल "MCP server + skills" से व्यापक हो सकता है।

2. MCP-server क्या है

MCP server AI-interface और external backend/service के बीच की layer है।

यह Claude Code (Codex) को tools के माध्यम से external system के साथ काम करने देता है:

data पढ़ना;
data खोजना;
tasks बनाना;
documents अपडेट करना;
files के साथ काम करना;
context प्राप्त करना;
अनुमत operations चलाना।

सरल सूत्र:

MCP server = AI-chat और दूसरे product के backend के बीच पुल

उदाहरण के लिए, MCP-server Claude Code (Codex) को इनसे जोड़ सकता है:

GitHub;
Gmail;
Google Drive;
Google Calendar;
Jira;
Confluence;
Figma;
internal backend;
Xolo;
Metasites;
ऐसा कोई भी अन्य product जिसका MCP-interface हो।

3. Plugins और MCP एक ही चीज़ नहीं हैं

यह अलग करना महत्वपूर्ण है:

Plugin
MCP server
Connector/App integration
Skill

Plugin capabilities की packaging है।

MCP server Claude Code (Codex) को external service के साथ काम के tools देने के तरीकों में से एक है।

Skill instruction या workflow है जो Claude Code (Codex) को विशिष्ट प्रकार के tasks सही तरह से करना सिखाता है।

Connector/app integration Google Drive, Gmail, Calendar, GitHub या Atlassian जैसी service से authorized connection है।

दैनिक बातचीत में "Gmail plugin" या "GitHub plugin" कहा जा सकता है, लेकिन समझना महत्वपूर्ण है कि भीतर अलग components का set हो सकता है।

4. पहले कौन-से plugins चाहिए

हमारे product, corporate और development work के लिए बुनियादी set:

Google services
Atlassian Rovo
GitHub
Figma

Google services

इनके साथ काम के लिए आवश्यक:

Gmail;
Google Calendar;
Google Drive;
Google Docs;
Google Sheets;
Google Slides।

ये plugins/connectors Claude Code (Codex) को mail, calendar, documents, files, tables और presentations के साथ सहायता करने देते हैं।

Atlassian Rovo

इनके साथ काम के लिए आवश्यक:

Jira;
Confluence;
tasks;

महत्वपूर्ण: Jira के लिए plugin का सही नाम Atlassian Rovo है

GitHub

development coordination के लिए आवश्यक:

repositories;
issues;
pull requests;
review comments;
CI;
GitHub Actions;
draft PR;
development handoff-scenarios।

Figma

design के साथ काम के लिए आवश्यक:

design-context पढ़ना;
layouts बनाना या अपडेट करना;
components के साथ काम करना;
screens बनाना;
design-to-code workflow तैयार करना;
FigJam/Slides के साथ काम करना, यदि आवश्यक हो।

Figma हर व्यक्ति के लिए अनिवार्य plugin नहीं है, लेकिन product और design-संबंधित काम के लिए बहुत प्रभावी है।

5. plugins कहां इंस्टॉल करें

Claude Code (Codex) app में section खोलें:

Plugins

फिर:

आवश्यक plugin खोजें।
उसका details खोलें।
install/add दबाएं।
यदि plugin को external service से connection चाहिए, तो authorization पूरी करें।
इंस्टॉलेशन के बाद नया thread शुरू करें या working session पुनः आरंभ करें, यदि Claude Code (Codex) इसकी मांग करता है।

Claude Code (Codex) CLI में plugins इस प्रकार खोले जा सकते हैं:

/plugins

7. Authorization अनिवार्य है

अधिकांश working plugins इंस्टॉल करने के बाद authorize करना चाहिए।

यह सामान्य है: authorization plugin को विशिष्ट service में केवल आपके data तक access देती है।

उदाहरण:

Gmail plugin को Gmail तक access मिलना चाहिए;
Google Calendar plugin को calendar तक access मिलना चाहिए;
Google Drive plugin को Drive/Docs/Sheets/Slides तक access मिलना चाहिए;
GitHub plugin को GitHub तक access मिलना चाहिए;
Atlassian Rovo को Jira/Confluence workspace तक access मिलना चाहिए;
Figma plugin को Figma-files तक access मिलना चाहिए।

Authorization के बिना plugin इंस्टॉल हो सकता है, लेकिन वास्तविक data के साथ काम नहीं कर पाएगा।

8. Authorization की सुरक्षा

Plugins को authorize केवल इस तरह करना चाहिए:

संरक्षित work computer पर;
सही work account में;
उन services के लिए जिनका आप वास्तव में उपयोग करते हैं;
यह समझते हुए कि कौन-सी permissions दी जा रही हैं;
अतिरिक्त access दिए बिना।

यदि authorization window ऐसे scopes/permissions दिखाए जो स्पष्ट नहीं हैं, तो screenshot लेकर Claude Code (Codex) से पूछना चाहिए।

सही अनुरोध:

Claude, मैं Gmail/Google Drive/GitHub/Atlassian/Figma के लिए plugin authorize कर रहा हूं। यहां permissions का screenshot है। समझाएं कि मैं वास्तव में क्या अनुमति दे रहा हूं और क्या यह working task के लिए सुरक्षित है।

9. MCP-servers का direct connection

सभी external systems तैयार marketplace plugin के रूप में नहीं आते।

कभी-कभी Claude Code या Codex settings के माध्यम से MCP server सीधे जोड़ना होता है।

उदाहरण:

MCP server Xsolla;
MCP server Metasites;
किसी विशिष्ट product का MCP server;
custom backend;
development के लिए local MCP server।

नियम:

यदि MCP server marketplace का official plugin नहीं है, तो उसका connection केवल server owner के exact instructions के अनुसार और Claude Code (Codex) से जांच के बाद करना चाहिए।

10. अज्ञात plugins और MCP-servers न जोड़ें

Plugins और MCP-servers work data तक access प्राप्त कर सकते हैं।

इसलिए नहीं करना चाहिए:

random plugins इंस्टॉल करना;
अस्पष्ट MCP endpoints जोड़ना;
समझे बिना permissions देना;
work accounts के बजाय personal accounts उपयोग करना;
असुरक्षित computer से corporate services जोड़ना;
tokens/secrets को open files में सहेजना।

11. Claude Code (Codex) के लिए सही अनुरोध

plugin इंस्टॉल करने से पहले:

Claude, मुझे working Claude Code environment के लिए plugins सेट करने हैं। मैं Gmail, Google Calendar, Google Drive, Jira, Confluence, GitHub और Figma उपयोग करता हूं। बताएं कि कौन-से official plugins इंस्टॉल करने हैं, किस क्रम में, और कौन-से authorization steps की अपेक्षा करनी है।

MCP server जोड़ने से पहले:

Claude, मुझे Claude Code से MCP server जोड़ना है। यहां server owner की documentation या endpoint है। सुरक्षा जांचें, समझाएं कि यह कौन-से tools देगा, और बताएं कि इसे settings में सही ढंग से कैसे जोड़ना है।

12. नियम

सेटअप का बीसवां चरण:

macOS-परिवेश सेट करने के बाद Claude Code (Codex) plugins सेट करने चाहिए: Google services, Atlassian Rovo, GitHub, Figma और अन्य working integrations जिनकी व्यक्ति को वास्तव में आवश्यकता है।

अतिरिक्त सख्त नियम:

प्रत्येक plugin को सही work account में authorize करना चाहिए और समझना चाहिए कि उसे कौन-सी permissions मिलती हैं। MCP-servers केवल trusted sources से, owner के निर्देश पर और Claude Code (Codex) से जांच के बाद जोड़ते हैं।

चरण 21. AGENTS.md, skills और project folders की संरचना सेट करें

plugins, connectors और MCP-servers सेट करने के बाद अपने projects के भीतर Claude Code/Codex के behavior को सेट करना चाहिए।

तीन बड़े विषय:

AGENTS.md
skills
folders की सही संरचना

यह अब operating system का installation नहीं है। यह इस बात की सेटिंग है कि AI-agent आपके काम, आपके rules, आपके projects और आपकी team processes को कैसे समझेगा।

1. AGENTS.md - AI-agent के लिए सामान्य rules

AGENTS.md Claude Code (Codex) के लिए instructions file है।

यह स्थिर rules निर्धारित करती है:

project के साथ कैसे काम करना है;
कौन-सी commands चलानी हैं;
किन files को नहीं छूना है;
कौन-सी checks अनिवार्य हैं;
result को कैसे तैयार करना है;
Git के साथ कैसे काम करना है;
security के प्रति दृष्टिकोण;
किन project agreements का पालन करना है।

सरलीकृत रूप में:

AGENTS.md = आपके workspace में Claude Code (Codex) के behavior rules

2. Global और project AGENTS.md

Rules के अलग-अलग levels हैं।

Global file:

~/.codex/AGENTS.md

यह सभी projects के लिए उपयोगकर्ता के personal rules निर्धारित करती है।

Project file:

<project-root>/AGENTS.md

यह विशिष्ट project या repository के rules निर्धारित करती है।

Subfolders के भीतर अधिक विशिष्ट rules हो सकते हैं:

<project-root>/services/payments/AGENTS.md
<project-root>/apps/web/AGENTS.md

Claude Code (Codex) instructions को सामान्य level से अधिक विशिष्ट level की ओर पढ़ता है। इसलिए वर्तमान project folder के निकट rules अधिक सामान्य rules को स्पष्ट या override कर सकते हैं।

3. AGENTS.md को अलग सेटअप चाहिए

AGENTS.md को यादृच्छिक रूप से नहीं लिखना चाहिए।

यह लंबी philosophy का स्थान नहीं है और विरोधाभासी इच्छाओं का स्थान नहीं है।

अच्छा AGENTS.md होना चाहिए:

छोटा;
विशिष्ट;
जांचने योग्य;
वास्तविक project commands से जुड़ा;
AI के लिए स्पष्ट;
दोहराए जाने वाले tasks के लिए उपयोगी।

AGENTS.md के विषयों के उदाहरण:

यदि pnpm-lock.yaml है तो pnpm उपयोग करें।
बदलावों से पहले git status जांचें।
secrets commit न करें।
Python-scripts बदलने के बाद pytest चलाएं, यदि tests हैं।
frontend बदलने के बाद lint/build चलाएं, यदि commands उपलब्ध हैं।
पुष्टि के बिना नई production dependencies न जोड़ें।

4. Skills - reusable workflows

Skills Claude Code (Codex) के लिए reusable workflows हैं।

Skill में हो सकते हैं:

SKILL.md;
instructions;
reference-files;
scripts;
templates;
assets।

सरलीकृत रूप में:

skill = दोहराया जाने वाला working skill जिसे Claude Code (Codex) invoke कर सकता है

उदाहरण के लिए:

Markdown-files को Confluence में upload करना;
service desk के साथ काम;
task triage;
status report generate करना;
Product-documents publish करना;
transcript process करना;
Jira tickets तैयार करना;
internal pipelines के साथ काम।

5. Skills समय क्यों बचाते हैं

यदि आप हर दिन समान operation करते हैं, तो उसे skill में बदलना चाहिए।

उदाहरण:

Confluence में file upload करना

Skill के बिना Claude Code (Codex) को हर बार फिर से समझना पड़ता है:

file कहां है;
कौन-सा script उपयोग करना है;
कौन-से credentials चाहिए;
dry-run कैसे करना है;
result कैसे जांचना है;
कौन-सी errors सामान्य हैं;
publication को कैसे न तोड़ें।

Skill के साथ यह स्थिर workflow में बदल जाता है।

निष्कर्ष:

Skills समय बचाते हैं, errors कम करते हैं और Claude Code (Codex) को यादृच्छिक assistant के बजाय प्रशिक्षित team member जैसा बनाते हैं।

6. Skills कहां रखे जाते हैं

Project skills के लिए:

<project-root>/.agents/skills

उपयोगकर्ता के personal skills के लिए:

~/.agents/skills

Team या system skills के लिए अन्य managed locations उपयोग हो सकती हैं।

महत्वपूर्ण:

Skills को सचेत रूप से इंस्टॉल और स्टोर करना चाहिए। यह समझे बिना कि वे क्या करते हैं, यादृच्छिक skills कॉपी नहीं करनी चाहिए।

7. Company और Neuronet skills

यदि कंपनी में तैयार skills पहले से हैं, तो उनका उपयोग करना चाहिए।

विशेष रूप से उपयोगी:

Confluence में files upload करने के skills;
service desks के skills;
Jira के skills;
Confluence के skills;
internal workflows के skills;
दोहराए जाने वाले product/documentation tasks के skills;
Neuronet-scenarios के skills।

यह सजावट नहीं है। यह विशाल समय बचत है।

नियम:

यदि कंपनी में task के लिए तैयार skill है, तो पहले skill उपयोग करते हैं, Claude Code (Codex) से हर बार process को फिर से आविष्कार करने के लिए नहीं कहते।

8. Folders की सही संरचना

AGENTS.md और skills के अलावा folders को सही ढंग से सेट करना चाहिए।

सबसे महत्वपूर्ण संयोजन:

local project folder
Claude Code या Codex में folder/workspace
GitHub repository

इन तीन layers को उसी एक project की ओर इंगित करना चाहिए।

यदि वे अलग हो जाएं, तो समस्याएं शुरू होती हैं:

Claude Code (Codex) गलत folder में काम करता है;
GitHub repo स्थानीय files से मेल नहीं खाता;
AI गलत project बदलता है;
AGENTS.md instructions load नहीं होतीं;
skills गलत स्थान पर हैं;
Git status गलत changes दिखाता है;
pull request गलत branch से जाता है;
टीम को समझ नहीं आता कि वर्तमान version कहां है।

9. अनुशंसित संरचना

Mac पर projects का बुनियादी folder:

~/Documents/Claude

इसके भीतर:

~/Documents/Claude/AI
~/Documents/Claude/Product
~/Documents/Claude/project-a
~/Documents/Claude/project-b
~/Documents/Claude/product-docs

पहले team onboarding के लिए दो शुरुआती folders विशेष रूप से उपयोगी हैं:

~/Documents/Claude/AI
~/Documents/Claude/Product

AI Claude Code की सेटिंग, AI-instructions, handoff-documents, training और AI-processes की working materials के लिए है।

Product product base, Markdown-documents, PRD, specifications, transcripts और उन files के लिए है जो GitHub और Confluence के साथ सिंक्रनाइज़ हो सकती हैं।

हर project folder को अपने GitHub repository से मेल खाना चाहिए या स्पष्ट रूप से non-code workspace होना चाहिए।

उदाहरण:

~/Documents/Claude/my-app
  .git/
  AGENTS.md
  .agents/skills/
  package.json
  README.md

Claude Code/Codex को ठीक project folder में खोलना चाहिए, न कि किसी यादृच्छिक parent folder में।

10. नए सदस्य का onboarding: folders, Claude Code (Codex) और GitHub

नए team member के लिए क्रम ऐसा होना चाहिए:

Documents खोलें।
Claude Code (Codex) folder बनाएं।
भीतर शुरुआती folders AI और Product या अन्य folders बनाएं जिन्हें टीम ने पहले से सहमति दी है।
Claude Code/Codex में project "शुरू से" नहीं, बल्कि Use Existing Folder, Open Existing Folder या मौजूदा folder चुनने के समान button द्वारा बनाएं।
पूरे Documents के बजाय विशिष्ट project folder चुनें, उदाहरण के लिए ~/Documents/Claude Code (Codex)/Product।
GitHub repository, approved template या मौजूदा source of truth से आरंभिक भराई से पहले नए team folder में यादृच्छिक files न लिखें।
corporate GitHub-account और आवश्यक repository तक access प्राप्त करें। Team work के लिए सामान्यतः personal GitHub के बजाय corporate account चाहिए।
repository owner से उपयोगकर्ता को collaborator के रूप में जोड़ने या organization के माध्यम से access देने को कहें।
Git remote या सही clone के माध्यम से local folder को GitHub repository से जोड़ें।
यदि काम में उपयोग होते हैं तो Claude Code (Codex) में GitHub CLI और GitHub plugin authorize करें।
जांचें कि local folder, Claude Code (Codex) workspace और GitHub repository उसी एक project की ओर इंगित करते हैं।

मुख्य विचार:

पहले सही folder बनाते हैं, फिर उसी को Claude Code में खोलते हैं, फिर उसे GitHub से जोड़ते हैं। अलग-अलग स्थानों पर project की parallel copies नहीं बनाते।

यदि local folder पहले से बना है, तो Claude Code में ठीक वही existing folder चुनना चाहिए। यदि वास्तविक folder से जुड़े बिना नए projects बनाना शुरू करें, तो बहुत जल्दी अराजकता होगी: Claude Code एक directory में काम करेगा, GitHub दूसरी से जुड़ा होगा, और व्यक्ति तीसरी में files खोजेगा।

11. Project के भीतर chats और agents का अनुशासन

Claude Code और Codex में project के भीतर chat केवल यादृच्छिक correspondence नहीं है। व्यावहारिक रूप से प्रत्येक chat एक निश्चित function वाले working agent की तरह व्यवहार करने लगता है।

इसलिए गंभीर काम के लिए सभी विषयों को एक chat में नहीं मिलाना चाहिए।

अलग chats के अच्छे उदाहरण:

Claude Code setup
GitHub Updates
Product docs
Confluence upload
Lessons
Bug triage

खराब practice:

Claude Code setup, GitHub sync, product decisions, bugs, transcripts और personal notes के लिए एक ही chat।

सामान्य ChatGPT में mixed chat फिर भी सहनीय हो सकती है। Claude Code/Codex में यह जल्दी हानिकारक हो जाता है, क्योंकि AI-agent असंबद्ध contexts, tasks, folders और rules को आपस में जोड़ने लगता है।

नियम:

प्रत्येक working chat का स्पष्ट function होना चाहिए। यदि नया बड़ा विषय आया है, तो मौजूदा का context तोड़ने के बजाय उसी project के भीतर अलग chat बनाना बेहतर है।

महत्वपूर्ण chat का अलग उदाहरण:

GitHub Updates

ऐसी chat केवल local folder को GitHub के साथ synchronization के tasks के लिए उपयोग की जा सकती है: changes जांचना, commit करना, pull request तैयार करना, updates pull करना, repository status जांचना। यह टीम को उस स्थिति से बचाता है जब GitHub-operations यादृच्छिक conversations में फैल जाती हैं।

12. Folders के संयोजन की जांच

गंभीर काम से पहले जांचें:

pwd
git status
git remote -v
ls

समझें:

मैं कहां हूं;
यह सही project है या नहीं;
Git repo है या नहीं;
कौन-सा GitHub remote जुड़ा है;
AGENTS.md दिखाई दे रहा है या नहीं;
.agents/skills है या नहीं;
ऐसे uncommitted changes तो नहीं हैं जिन्हें खोया नहीं जा सकता।

यदि संदेह हो, तो Claude Code (Codex) से पूछना चाहिए:

Claude, जांचें कि मेरा local project folder, Claude Code workspace और GitHub repository सही तरह जुड़े हैं। यहां pwd, git status और git remote -v का output है।

13. Working folders को न मिलाएं

उसी एक project को कई असहमत folders में एक साथ नहीं चलाना चाहिए:

~/Downloads/project
~/Desktop/project
~/Documents/Claude/project

यह लगभग निश्चित रूप से भ्रम पैदा करेगा।

नियम:

प्रत्येक project के लिए एक मुख्य local folder, एक स्पष्ट Claude Code (Codex)/Claude Code workspace और एक GitHub repository होनी चाहिए।

14. Claude Code के माध्यम से क्या सेट करें

इन विषयों को अनुमान से नहीं सेट करना चाहिए।

Claude Code (Codex) से पूछना चाहिए:

Claude, इस project के लिए AGENTS.md सेट करने में सहायता करें। पहले README, package.json/pyproject, folder structure और existing commands पढ़ें। फिर छोटा AGENTS.md प्रस्तावित करें।

Claude, Confluence, Jira, service desk और Product docs के साथ काम के लिए मुझे company के कौन-से skills इंस्टॉल करने चाहिए?

Claude, project folder structure और GitHub के साथ संबंध जांचें। बताएं कि AGENTS.md कहां होना चाहिए और project skills कहां होने चाहिए।

15. नियम

सेटअप का बाईसवां चरण:

plugins और MCP इंस्टॉल करने के बाद AGENTS.md, skills, folder structure और working chats का अनुशासन सेट करना चाहिए। यह AI-agent के behavior rules निर्धारित करता है, reusable workflows जोड़ता है और local folder, Claude Code/Codex workspace और GitHub repository के बीच भ्रम से बचाता है।

अतिरिक्त सख्त नियम:

AGENTS.md, skills, folder structure और GitHub connection को अनुमान से नहीं सेट करते। पहले Claude Code से project पढ़ने, GitHub connection जांचने और विशिष्ट काम के लिए न्यूनतम, सटीक rules प्रस्तावित करने को कहते हैं।

चरण 1. अद्यतन macOS और व्यवस्थापक अधिकारों वाला macOS खाता

1. आधुनिक macOS का उपयोग करें

2. सभी उपलब्ध macOS अपडेट इंस्टॉल करें

3. मुख्य व्यवस्थापक खाते से काम करें

नियम

चरण 2. Claude Code इंस्टॉल करें और प्रोजेक्ट्स के लिए कार्य फ़ोल्डर बनाएं

1. macOS पर Claude Code प्रोजेक्ट्स कहां रखें

2. Claude Code CLI इंस्टॉल करें

3. Claude Code desktop app इंस्टॉल करें

4. Mac पर बुनियादी संरचना कैसी दिखनी चाहिए

5. नियम

चरण 03. macOS पर टर्मिनल और कमांड लाइन

1. macOS पर PowerShell 7 का समकक्ष क्या है

2. क्या अंतर्निहित Terminal.app पर्याप्त है

4. iTerm2 कब इंस्टॉल करना उचित है

6. टीम के प्रत्येक सदस्य को क्या आना चाहिए

7. नियम

चरण 04. Claude Code के साथ काम के लिए macOS पर स्क्रीनशॉट्स

1. क्या अलग screenshot tool आवश्यक है

2. मुख्य आवश्यकता

3. macOS के बुनियादी hotkeys

4. टीम के लिए Best practice

5. नियम

चरण 05. macOS पर Xcode Command Line Tools

1. macOS पर Xcode Command Line Tools

2. क्या यह डिफ़ॉल्ट रूप से macOS में शामिल होता है

3. इंस्टॉलेशन कैसे जांचें

4. Xcode Command Line Tools कैसे इंस्टॉल करें

5. पूर्ण Xcode सामान्यतः आवश्यक नहीं है

6. Node.js और pnpm से संबंध

7. निर्देश स्वयं न खोजें

8. developer tools को अनुमान से ठीक न करें

9. नियम

चरण 06. Git इंस्टॉल और कॉन्फ़िगर करें

1. क्या Git डिफ़ॉल्ट रूप से macOS में है

2. Git का लिंक स्वयं न खोजें

3. installer में checkboxes का अनुमान न लगाएं

4. macOS पर Git इंस्टॉल करने का अनुशंसित तरीका

5. Git की बुनियादी सेटिंग

6. Git को Claude Code प्रोजेक्ट्स के फ़ोल्डर से काम करना चाहिए

7. Claude Code (Codex) के लिए और क्या महत्वपूर्ण है

8. नियम

चरण 07. Homebrew इंस्टॉल करें

1. Homebrew macOS में शामिल नहीं है

2. Homebrew को Git के बाद क्यों इंस्टॉल करते हैं

3. इंस्टॉलेशन कमांड स्वयं न खोजें

4. इंस्टॉलेशन

5. Homebrew इंस्टॉलेशन के बाद PATH

6. इंस्टॉलेशन की जांच

7. Homebrew के माध्यम से क्या इंस्टॉल किया जा सकता है

8. यादृच्छिक sudo का उपयोग न करें

9. नियम

चरण 08. GitHub CLI इंस्टॉल करें

1. पहले GitHub खाता चाहिए

2. installation command स्वयं न खोजें

3. इंस्टॉलेशन जांचें

4. GitHub में authorize करें

5. authorization जांचें

6. Claude Code प्रोजेक्ट्स के फ़ोल्डर में काम जांचें

7. macOS की विशेषताएं

8. नियम

चरण 09. macOS पर Python इंस्टॉल करें

1. Python अनिवार्य है

2. लिंक स्वयं न खोजें

3. Python का कौन-सा संस्करण इंस्टॉल करें

4. macOS में अंतर्निहित Python

5. macOS पर Python कहां इंस्टॉल करें

6. अनुशंसित इंस्टॉलेशन तरीका

7. इंस्टॉलेशन के बाद जांच

8. Virtual environments

9. यदि संस्करण मेल न खाए तो क्या करें

10. नियम

चरण 10. must-have Python-packages इंस्टॉल करें

1. Packages global नहीं, virtual environment में इंस्टॉल होते हैं

2. Compatible pinned package-set

3. requirements फ़ाइल बनाएं

4. ये packages क्या करते हैं

5. macOS की विशेषताएं

6. soundfile और libsndfile

7. webrtcvad source से build हो सकता है

6. `soundfile` और libsndfile

7. `webrtcvad` source से build हो सकता है

8. macOS पर `torch`