डेवकंटेनर में Claude Code

bypassPermissions को सुरक्षित रूप से सक्षम करके Claude Code चलाने के लिए एक सैंडबॉक्स्ड विकास वातावरण। सुरक्षा ऑडिट वर्कफ़्लो के लिए Trail of Bits में निर्मित।

यह क्यों उपयोग करें?

अपने होस्ट मशीन पर bypassPermissions के साथ Claude चलाना जोखिम भरा है—यह बिना पुष्टि के कोई भी कमांड निष्पादित कर सकता है। यह devcontainer फ़ाइलसिस्टम अलगाव प्रदान करता है ताकि आप अपने होस्ट सिस्टम को जोखिम में डाले बिना अप्रतिबंधित Claude के उत्पादकता लाभ प्राप्त कर सकें।

इसके लिए डिज़ाइन किया गया:

• सुरक्षा ऑडिट: अपने होस्ट को जोखिम में डाले बिना क्लाइंट कोड की समीक्षा करें
• अविश्वसनीय रिपॉज़िटरी: अज्ञात कोडबेस को सुरक्षित रूप से एक्सप्लोर करें
• प्रयोगात्मक कार्य: Claude को अलगाव में स्वतंत्र रूप से कोड संशोधित करने दें
• मल्टी-रिपॉज़िटरी कार्य: कई संबंधित रिपॉज़िटरी पर काम करें

पूर्वापेक्षाएँ

• Docker रनटाइम (इनमें से एक):

  • Docker Desktop - सुनिश्चित करें कि यह चल रहा है
  • OrbStack
  • Colima: brew install colima docker && colima start

• टर्मिनल वर्कफ़्लो के लिए (एक बार का इंस्टॉलेशन):

  npm install -g @devcontainers/cli
  git clone https://github.com/trailofbits/claude-code-devcontainer ~/.claude-devcontainer
  ~/.claude-devcontainer/install.sh self-install
  

# Stop and delete current VM (removes containers/images)
colima stop && colima delete

# Start with optimized settings
colima start \
  --cpu 4 \
  --memory 8 \
  --disk 100 \
  --vm-type vz \
  --vz-rosetta \
  --mount-type virtiofs

त्वरित प्रारंभ

अपने वर्कफ़्लो के अनुकूल पैटर्न चुनें:

पैटर्न A: प्रति-प्रोजेक्ट कंटेनर (पृथक)

प्रत्येक प्रोजेक्ट को स्वतंत्र वॉल्यूम के साथ अपना स्वयं का कंटेनर मिलता है। एक बार की समीक्षाओं, अविश्वसनीय रिपॉज़िटरी, या जब आपको प्रोजेक्ट्स के बीच अलगाव की आवश्यकता हो, के लिए सर्वोत्तम।

टर्मिनल:

git clone <untrusted-repo>
cd untrusted-repo
devc .          # Installs template + starts container
devc shell      # Opens shell in container

VS Code / Cursor:

1. Dev Containers एक्सटेंशन इंस्टॉल करें:

   • VS Code: ms-vscode-remote.remote-containers
   • Cursor: anysphere.remote-containers

2. devcontainer सेट अप करें (कोई एक चुनें):

   # Option A: Use devc (recommended)
   devc .
   
   # Option B: Clone manually
   git clone https://github.com/trailofbits/claude-code-devcontainer .devcontainer/
   

3. VS Code में अपना प्रोजेक्ट फ़ोल्डर खोलें, फिर:

   • Cmd+Shift+P (Mac) या Ctrl+Shift+P (Windows/Linux) दबाएं
   • "Reopen in Container" टाइप करें और Dev Containers: Reopen in Container चुनें

पैटर्न B: साझा वर्कस्पेस कंटेनर (समूहीकृत)

एक पैरेंट डायरेक्टरी में devcontainer कॉन्फ़िगरेशन होता है, और आप अंदर कई रिपॉज़िटरी क्लोन करते हैं। सभी रिपॉज़िटरी में साझा वॉल्यूम। क्लाइंट कार्यों, संबंधित रिपॉज़िटरी, या चल रहे कार्य के लिए सर्वोत्तम।

# Create workspace for a client engagement
mkdir -p ~/sandbox/client-name
cd ~/sandbox/client-name
devc .          # Install template + start container
devc shell      # Opens shell in container

# Inside container:
git clone <client-repo-1>
git clone <client-repo-2>
cd client-repo-1
claude          # Ready to work

टोकन-आधारित प्रमाणीकरण (हेडलेस)

हेडलेस सर्वर के लिए या इंटरैक्टिव लॉगिन विज़ार्ड को छोड़ने के लिए:

claude setup-token                          # run on host, one-time
export CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-...
devc rebuild                                # rebuilds with token

टोकन कंटेनर में फॉरवर्ड किया जाता है। प्रत्येक कंटेनर निर्माण पर, post_install.py एक बार का ऑथ हैंडशेक चलाता है ताकि claude बिना लॉगिन विज़ार्ड के शुरू हो।

यह Claude Code के इंटरैक्टिव ऑनबोर्डिंग विज़ार्ड के कंटेनरों में हमेशा दिखने की समस्या का समाधान करता है, वैध क्रेडेंशियल होने पर भी (#8938)।

यदि आप टोकन सेट नहीं करते हैं, तो इंटरैक्टिव लॉगिन प्रवाह पहले की तरह काम करता है।

CLI हेल्पर कमांड्स

devc .              Install template + start container in current directory
devc up             Start the devcontainer
devc rebuild        Rebuild container (preserves persistent volumes)
devc destroy [-f]   Remove container, volumes, and image for current project
devc down           Stop the container
devc shell          Open zsh shell in container
devc exec CMD       Execute command inside the container
devc upgrade        Upgrade Claude Code in the container
devc mount SRC DST  Add a bind mount (host → container)
devc sync [NAME]    Sync Claude Code sessions from devcontainers to host
devc template DIR   Copy devcontainer files to directory
devc self-install   Install devc to ~/.local/bin

नोट: किसी प्रोजेक्ट के Docker संसाधनों को साफ करने के लिए devc destroy का उपयोग करें। कंटेनरों को मैन्युअल रूप से हटाने (जैसे, docker rm) से अनाथ वॉल्यूम और इमेज पीछे रह जाती हैं जिन्हें devc destroy ढूंढ नहीं पाएगा।

/insights के लिए सत्र सिंक

Claude Code का /insights कमांड आपके सत्र इतिहास का विश्लेषण करता है, लेकिन यह होस्ट पर केवल ~/.claude/projects/ से पढ़ता है। devcontainer वॉल्यूम के अंदर के सत्र इसके लिए अदृश्य होते हैं।

devc sync सभी devcontainer (चालू और बंद) से सत्र लॉग को होस्ट पर कॉपी करता है ताकि /insights उन्हें शामिल कर सके:

devc sync              # Sync all devcontainers
devc sync crypto       # Filter by project name (substring match)

Devcontainer Docker लेबल के माध्यम से स्वतः खोजे जाते हैं — कंटेनर नाम या ID जानने की आवश्यकता नहीं है। सिंक वृद्धिशील है, इसलिए इसे बार-बार चलाना सुरक्षित है।

फ़ाइल साझाकरण

VS Code / Cursor

अपने होस्ट से फ़ाइलों को VS Code Explorer पैनल में खींचें — वे स्वचालित रूप से /workspace/ में कॉपी हो जाती हैं। किसी कॉन्फ़िगरेशन की आवश्यकता नहीं है।

टर्मिनल: devc mount

होस्ट डायरेक्टरी को कंटेनर के अंदर उपलब्ध कराने के लिए:

devc mount ~/drop /drop           # Read-write
devc mount ~/secrets /secrets --readonly

यह devcontainer.json में एक बाइंड माउंट जोड़ता है और कंटेनर को पुनः बनाता है। मौजूदा माउंट devc template अपडेट के दौरान संरक्षित रहते हैं।

टिप: अपनी संपूर्ण होम डायरेक्टरी को माउंट किए बिना फ़ाइलें अंदर भेजने के लिए एक साझा "ड्रॉप फ़ोल्डर" उपयोगी है।

सुरक्षा नोट: बड़ी होस्ट डायरेक्टरी (जैसे, $HOME) को माउंट करने से बचें। जब तक --readonly निर्दिष्ट न किया जाए, प्रत्येक माउंटेड पथ कंटेनर के अंदर से लिखने योग्य होता है, जो इस प्रोजेक्ट द्वारा प्रदान किए गए फ़ाइलसिस्टम अलगाव को कमजोर करता है।

नेटवर्क अलगाव

डिफ़ॉल्ट रूप से, कंटेनरों के पास पूर्ण आउटबाउंड नेटवर्क पहुंच होती है। कड़ी सुरक्षा के लिए, नेटवर्क पहुंच को प्रतिबंधित करने हेतु iptables का उपयोग करें।

नेटवर्क अलगाव कब सक्षम करें

• ऐसे कोड की समीक्षा करना जिसमें दुर्भावनापूर्ण निर्भरताएं हो सकती हैं
• टेलीमेट्री या फोन-होम व्यवहार वाले सॉफ़्टवेयर का ऑडिट करना
• अत्यधिक संवेदनशील समीक्षाओं के लिए अधिकतम अलगाव

उदाहरण: Claude + GitHub + पैकेज रजिस्ट्री

sudo iptables -A OUTPUT -d api.anthropic.com -j ACCEPT
sudo iptables -A OUTPUT -d github.com -j ACCEPT
sudo iptables -A OUTPUT -d raw.githubusercontent.com -j ACCEPT
sudo iptables -A OUTPUT -d registry.npmjs.org -j ACCEPT
sudo iptables -A OUTPUT -d pypi.org -j ACCEPT
sudo iptables -A OUTPUT -d files.pythonhosted.org -j ACCEPT
sudo iptables -A OUTPUT -o lo -j ACCEPT
sudo iptables -A OUTPUT -j DROP