Claude Code Beginner Guide: Install, Safe Permissions और पहले 30 मिनट

Claude Code terminal में चलने वाला AI coding agent है। यह सिर्फ chat नहीं है जहाँ आप code paste करते हैं। यह project files पढ़ सकता है, repository में search कर सकता है, changes suggest कर सकता है, आपकी अनुमति मिलने पर files edit कर सकता है, और tests या build commands चला सकता है।

Beginners की सबसे common problem installation नहीं, बल्कि पहला task बहुत बड़ा रखना है। अगर पहला prompt है “पूरी app improve कर दो”, तो diff इतना बड़ा हो सकता है कि review करना मुश्किल हो जाए। बेहतर शुरुआत है: project पढ़ना, structure समझना, एक छोटा task चुनना, और result verify करना।

यह guide official setup, common workflows, और CLI usage docs के आधार पर लिखी गई है। इसके बाद CLAUDE.md guide और context management guide पढ़ना उपयोगी रहेगा।

Claude Code को कैसे समझें

Claude Code छोटे और clear tasks में बहुत अच्छा है: existing codebase समझना, important files ढूँढना, छोटा bug fix करना, tests जोड़ना, README सुधारना, या PR summary बनाना।

Safe beginner flow:

Step	काम	कारण
1	Install और login	tool चलता है या नहीं
2	Read-only समझना	edit से पहले context
3	छोटा task चुनना	risk कम करना
4	diff और test देखना	evidence से verify
5	rules लिखना	अगली session बेहतर

पहले दिन goal automation नहीं, trust बनाना है।

तैयारी

Production branch पर शुरू न करें। एक safe branch बनाएँ:

git status
git switch -c try-claude-code

पुराने Git में:

git checkout -b try-claude-code

ये भी check करें:

• Claude Code access वाला Claude account
• internet connection
• project root folder
• Git काम कर रहा हो
• test या build command पता हो
• .env, secrets, customer data protected रहें

Windows में PowerShell और CMD commands अलग हो सकती हैं। PS C:\ दिखे तो PowerShell है।

Install

macOS, Linux, WSL:

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell:

irm https://claude.ai/install.ps1 | iex

फिर verify करें:

claude --version
claude doctor

claude doctor शुरुआती समय में बहुत उपयोगी है क्योंकि यह setup और configuration problems जल्दी दिखाता है।

npm install भी available है:

npm install -g @anthropic-ai/claude-code

लेकिन कोई खास reason न हो तो official native installer से शुरू करें। sudo npm install -g avoid करें, क्योंकि इससे permission और security problems आ सकती हैं।

पहले 30 मिनट

Project root में जाएँ:

cd my-project
claude

Login के बाद तुरंत feature build न करवाएँ। पहले read-only prompt दें:

मैं इस project में नया हूँ।
अभी कोई file edit मत करें। सिर्फ पढ़कर explain करें:

- project क्या करता है
- main directories और roles
- dev, test, build commands के candidates
- कौन सी files बदलना risky लगता है
- पहले पढ़ने लायक 5 files

हर बात के साथ file path evidence दें और uncertainty हो तो guess न करें।

फिर छोटे tasks माँगें:

इस repository में beginners के लिए 5 अच्छे tasks suggest करें।
हर task:

- लगभग 30 minutes में हो
- max 2 files बदले
- test या manual verification हो
- auth, billing, secrets, production data से दूर रहे

risk level और verification steps भी दें।

इस तरह Claude Code onboarding assistant बनता है, uncontrolled generator नहीं।

Safe Permissions

Claude Code commands चला सकता है और files edit कर सकता है, इसलिए permissions बहुत जरूरी हैं। शुरुआत में safe mode:

claude --permission-mode plan

Session में:

/permissions

bypassPermissions और --dangerously-skip-permissions से सावधान रहें। इन्हें सिर्फ isolated container या VM में use करें जहाँ नुकसान न हो।

Conservative permission example:

{
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(npm run test *)",
      "Bash(npm run build *)"
    ],
    "deny": [
      "Bash(git push *)",
      "Bash(rm -rf *)",
      "Read(.env)",
      "Read(**/.env)"
    ]
  }
}

Principle simple है: low-risk checks allow करें, secrets block करें, destructive actions manual रखें।

Example 1: README सुधारना

README first task के लिए अच्छा है।

मैं README.md improve करना चाहता हूँ।
पहले README.md और package.json पढ़ें।
क्या missing है list करें, अभी edit न करें।
मेरी approval के बाद सिर्फ README.md edit करें।

Approval के बाद scope छोटा करें:

README.md में सिर्फ दो sections जोड़ें:

- local development
- test command

सिर्फ package.json में दिखने वाले commands use करें।
नए tools या deployment steps invent न करें।

Example 2: छोटा bug fix

Bug clear हो तो result बेहतर होता है:

इस bug को investigate करें।

Problem:
- search input में सिर्फ spaces हों तो app सभी results दिखाती है।

Expected:
- spaces-only input empty search जैसा behave करे।

Constraints:
- पहले probable cause explain करें।
- max 1 file edit करें।
- fix के बाद test या manual checks बताएं।

Diff देखें:

git diff

फिर review कराएँ:

Current git diff review करें।
Unexpected changes, over-engineering, missing tests, edge cases देखें।
सब ठीक हो तो 3 manual verification steps दें।

Example 3: PDF, Product या Consultation CTA

Content site या documentation में Claude Code next action improve कर सकता है।

इस article को पढ़कर beginners के लिए 3 CTA suggest करें।

Goals:
- first-time user की anxiety कम करना
- free PDF, paid resource, consultation से natural connection
- हर CTA 80 characters से कम
- aggressive sales tone न हो

फिर existing pattern follow कराएँ:

Article pages में existing CTA pattern खोजें।
उसी tone में इस article के end पर एक CTA add करें।
नया component न बनाएँ और global styles न बदलें।

Common Mistakes

पहली गलती: task बहुत बड़ा। “app improve करो” task नहीं है। “search spaces case fix करो” task है।

दूसरी गलती: read-only phase छोड़ना। अगर Claude Code architecture explain नहीं कर सकता, तो edit अभी जल्दी है।

तीसरी गलती: permissions बहुत जल्दी खोल देना। Fast automation से ज्यादा जरूरी समझने योग्य diff है।

चौथी गलती: final message पर भरोसा। Tests, build, browser या git diff में से कुछ जरूर देखें।

पाँचवीं गलती: लंबी conversation खींचते रहना। Topic बदल जाए तो summarize करें और clean session शुरू करें। Detail के लिए context management पढ़ें।

Troubleshooting Checklist

• क्या claude --version चलता है?
• claude doctor क्या कहता है?
• क्या आप project root में हैं?
• क्या git status समझ आता है?
• क्या PowerShell और CMD commands mix हुईं?
• क्या WSL, SSH या container login flow अलग है?
• क्या .env या keys पढ़ने की कोशिश हो रही है?
• क्या dangerous permission mode on है?
• क्या test command सच में exist करती है?

Diagnosis prompt:

Claude Code expected तरीके से काम नहीं कर रहा।
Files edit न करें। सिर्फ diagnosis में help करें।

Environment:
- OS:
- shell:
- command:
- error message:
- expected behavior:

सबसे safe checks पहले list करें।

Masa का Verification Note

ClaudeCodeLab में Masa ने articles, translations, CSS fixes और deploy scripts पर यही pattern सबसे stable पाया: read, plan, small edit, verify। जब task boundary छोटी थी, git diff समझ में आया। जब automation लंबी चली, बाद में intention track करना मुश्किल हुआ।

Beginner advice: पहले सप्ताह permission prompts visible रखें, हर git diff पढ़ें, और successful prompts note करें। Stable होने के बाद productivity tips पर जाएँ।

Next Step

आज एक non-critical repository खोलें, read-only project map बनवाएँ, 30-minute improvement चुनें, और diff review करें।

Quick reference चाहिए तो free Claude Code Quick Reference Cheatsheet डाउनलोड करें। Team adoption, training, या real project workflow के लिए site की resources और consultation links से आगे बढ़ें।