
आपके AI एजेंटों के लिए एक स्थानीय सैंडबॉक्स
CodeRunner आपके AI एजेंट्स और उनकी गतिविधियों को एक सैंडबॉक्स के भीतर सैंडबॉक्स करने में मदद करता है।
मुख्य उपयोग मामला: AI एजेंट कोड को एक सैंडबॉक्स में चलाएँ, जिसमें स्पष्ट रूप से चुने गए होस्ट माउंट्स और नेटवर्क एक्सेस हों। आइसोलेशन जोखिम को कम करता है; यह सभी डेटा हानि या डेटा चोरी को नहीं रोकता।
एजेंट्स के लिए क्लाउड-प्रबंधित VMs के लिए, हमने लॉन्च किया है - InstaVM - Instant computers for AI agents
पूर्वापेक्षाएँ: macOS और Apple Silicon (M1/M2/M3/M4) वाला Mac, Python 3.10+
इंस्टॉलर सैंडबॉक्स टोकन को ~/.coderunner/api-token में जनरेट करता है (या आपके द्वारा एक्सपोर्ट किए गए CODERUNNER_API_TOKEN को सहेजता है)। क्लाइंट इसे
Authorization: Bearer <token> के रूप में भेजते हैं; cat ~/.coderunner/api-token इसे प्रिंट करता है। केवल
GET /health सार्वजनिक है, और अनुपस्थित या कमज़ोर टोकन फेल-क्लोज़्ड होता है। Claude
Desktop प्रॉक्सी और उदाहरण वेरिएबल सेट न होने पर उस फ़ाइल से टोकन पढ़ते हैं। देखें authentication and network boundaries।
git clone https://github.com/instavm/coderunner.git
cd coderunner
chmod +x install.sh
./install.sh
काम पूरा होने पर सैंडबॉक्स को रोकें:
container stop coderunner
बाद में उसी सैंडबॉक्स को फिर से शुरू करें, उसका फ़ाइलसिस्टम सुरक्षित रखते हुए। Python कर्नेल की स्थिति अस्थिर होती है और VM या सर्वर पुनः आरंभ होने पर बनी नहीं रहती:
container start coderunner
साफ़ सैंडबॉक्स के साथ फिर से शुरू करने के लिए, कंटेनर हटाएँ और इंस्टॉलर फिर से चलाएँ:
container delete coderunner && ./install.sh
CPU और मेमोरी सीमाएँ इंस्टॉलर विकल्पों या CODERUNNER_CPUS और CODERUNNER_MEMORY पर्यावरण चर के साथ सेट की जा सकती हैं:
./install.sh --cpus 4 --memory 8g
अतिरिक्त होस्ट निर्देशिकाएँ /workspace के अंतर्गत माउंट की जानी चाहिए। वे डिफ़ॉल्ट रूप से केवल-पढ़ने योग्य (read-only) होती हैं; :rw केवल तब जोड़ें जब सैंडबॉक्स को होस्ट पर लिखने की आवश्यकता हो:
./install.sh \
--mount "$HOME/projects/api:/workspace/api" \
--mount "$HOME/projects/output:/workspace/output:rw"
अतिरिक्त माउंट डिफ़ॉल्ट रूप से कोई नहीं होते हैं। कंटेनर बनने पर संसाधन और माउंट सेटिंग्स निश्चित हो जाती हैं; उन्हें बदलने से पहले कंटेनर को हटा दें।
डिफ़ॉल्ट रूप से, सैंडबॉक्स में चल रहे कोड के पास अप्रतिबंधित नेटवर्क एक्सेस होता है। इसे बिना इंटरनेट एक्सेस वाले होस्ट-ओनली नेटवर्क पर चलाने के लिए:
CODERUNNER_NETWORK=none ./install.sh
इस मोड में, MCP सर्वर http://127.0.0.1:8222/mcp पर उपलब्ध है। यह सेटिंग कंटेनर बनाते समय तय होती है; इंस्टॉलर किसी भिन्न नेटवर्क मोड वाले कंटेनर को फिर से शुरू करने से इंकार कर देता है।
Claude Code आपकी मशीन पर, आपके रूप में, केवल अनुमति संकेतों की सीमा के साथ कमांड चलाता है। इसे CodeRunner के टूल्स की ओर इंगित करने पर यह जो कोड लिखता है उसे VM में चलाता है: यह केवल उन फ़ोल्डरों को छू सकता है जिन्हें आपने /workspace के अंतर्गत माउंट किया है, जिस नेटवर्क की आपने अनुमति दी है, और सैंडबॉक्स के अपने फ़ाइलसिस्टम को, चाहे इसे कुछ भी करने को कहा गया हो। उस कोड के लिए सैंडबॉक्स का उपयोग करें जो अविश्वसनीय इनपुट संभालता है या जिसे आप स्वयं नहीं चलाएंगे, और उन कई एजेंटों के लिए जिन्हें स्थिति साझा नहीं करनी चाहिए (नामित सत्र)। यह उन चीज़ों की सुरक्षा नहीं करता जिन्हें आप रीड-राइट माउंट करते हैं।
./install.sh (यदि पहले से नहीं किया गया है)
container exec -it coderunner /bin/bash
root@coderunner:/app# npm install -g @anthropic-ai/claude-code
MCP सर्वर यहाँ उपलब्ध होगा: http://coderunner.local:8222/mcp
इंस्टॉलर Claude Desktop प्रॉक्सी के लिए ~/.coderunner/venv बनाता है। अन्य Python उदाहरणों के लिए, उनकी निर्भरताएँ अपने स्वयं के virtualenv में इंस्टॉल करें:
pip install -r examples/requirements.txt



उदाहरण कॉन्फ़िगरेशन कॉपी करें:
cd examples
cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
कॉन्फ़िगरेशन फ़ाइल संपादित करें और प्लेसहोल्डर पथों को बदलें:
/path/to/your/python को $HOME/.coderunner/venv/bin/python से बदलें, अपनी होम डायरेक्टरी के पूर्ण पथ का उपयोग करते हुए/path/to/coderunner को अपने क्लोन किए गए रिपॉज़िटरी के वास्तविक पथ से बदलेंसंपादन के बाद उदाहरण:
{
"mcpServers": {
"coderunner": {
"command": "/Users/yourname/.coderunner/venv/bin/python",
"args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
}
}
}
Claude Desktop कॉन्फ़िगरेशन अपडेट करें:
Claude में CodeRunner का उपयोग शुरू करें: Claude जो कोड लिखता है, अब वह सैंडबॉक्स में चलता है।
यदि सर्वर के चल रहे होने के बावजूद चैट के टूल मेनू में टूल "Disabled" दिखाई देता है: Claude
Desktop को पूरी तरह बंद करें (Cmd-Q) और इसे फिर से खोलें, सुनिश्चित करें कि command वही venv python है जो इंस्टॉलर ने प्रिंट किया था (इसमें
fastmcp है), और प्रॉक्सी की त्रुटि के लिए ~/Library/Logs/Claude/mcp-server-coderunner.log पढ़ें। प्रॉक्सी
के लिए सैंडबॉक्स का चल रहा होना (container list) और टोकन फ़ाइल ~/.coderunner/api-token आवश्यक है।
त्वरित शुरुआत:
# 1. Install and start CodeRunner (one-time setup; run as yourself, it asks for sudo when it needs it)
git clone https://github.com/instavm/coderunner.git
cd coderunner
./install.sh
# 2. Add the sandbox with its token (the installer prints this command)
claude mcp add --transport http coderunner http://coderunner.local:8222/mcp \
--header "Authorization: Bearer $(cat ~/.coderunner/api-token)"
# 3. Reconnect to MCP servers
/mcp
Claude Code प्लगइन (claude plugin marketplace add https://github.com/instavm/coderunner-plugin) टोकन से पहले का है और 401 प्राप्त करता है जब तक कि यह वही हेडर न भेजे; प्लगइन अपडेट होने तक ऊपर दिए गए कमांड का उपयोग करें।
इंस्टॉलेशन चरण:
Plugin Marketplace पर जाएँ:

InstaVM रिपॉज़िटरी जोड़ें:

Claude Code के साथ Python कोड निष्पादित करें:
