Codex सैंडबॉक्स: अनुमति प्रोफ़ाइल से npm का सीमित ऐक्सेस
Codex की वर्कस्पेस सुरक्षा बनाए रखते हुए पैकेज रेजिस्ट्री का ऐक्सेस दें। अनुमति प्रोफ़ाइल और नेटवर्क प्रॉक्सी सेट करें, अनुमत और प्रतिबंधित कार्रवाइयाँ जाँचें, और समझें कि कौन-सी फ़ाइलें पढ़ी जा सकती हैं। ऑपरेटिंग सिस्टम की पाबंदियों और कंपनी के प्रोफ़ाइल नियमों का भी ध्यान रखें।
विषय-सूची

अगर Codex रिपॉज़िटरी की फ़ाइलें बदल सकता है, लेकिन npm पैकेज डाउनलोड नहीं कर पाता, तो API सेटिंग बदलने से पहले सैंडबॉक्स की अनुमति प्रोफ़ाइल जाँचें। बिल्ट-इन :workspace प्रोफ़ाइल कमांड का नेटवर्क ऐक्सेस बंद रखती है, इसलिए स्थानीय Codex सत्रों में डिपेंडेंसी इंस्टॉल करने वाले डेवलपरों को यह समस्या आती है। पूरा ऐक्सेस देने के बजाय :workspace से नई प्रोफ़ाइल बनाएँ, नेटवर्क प्रॉक्सी चालू करें और रेजिस्ट्री के होस्टनेम को अनुमति दें।
2026-11-19 को उपलब्ध OpenAI के दस्तावेज़ अनुमति प्रोफ़ाइल को बीटा सुविधा बताते हैं। यह गाइड स्थानीय कमांड चलाने की सेटिंग समझाती है और macOS, Linux या WSL2 में Bash के उदाहरण देती है।
डिफ़ॉल्ट वर्कस्पेस प्रोफ़ाइल क्या करने देती है?
जब Git रिपॉज़िटरी वर्कस्पेस का रूट हो, तब :workspace सैंडबॉक्स की कमांड को सोर्स फ़ाइलें बदलने देता है, लेकिन कुछ डायरेक्टरी सुरक्षित रखता है। हर वर्कस्पेस रूट के अंतर्गत .git, .codex, .agents और .aws सिर्फ़ पढ़ने के लिए उपलब्ध रहते हैं। इससे .codex/config.toml जैसी रिपॉज़िटरी सेटिंग और .git/hooks के हुक सीधे नहीं बदले जा सकते। ये नियम वर्कस्पेस रूट के अंतर्गत आने वाले पाथ पर लागू होते हैं, कंप्यूटर की हर समान नाम वाली डायरेक्टरी पर नहीं।
फ़ाइलें पढ़ने की अनुमति अधिक व्यापक है। ऑपरेटिंग सिस्टम में आपके मौजूदा अधिकार अनुमति दें, तो कमांड रिपॉज़िटरी के बाहर की फ़ाइलें भी पढ़ सकती हैं। OpenAI का डिफ़ॉल्ट सैंडबॉक्स सीमाओं का विवरण बताता है कि इससे बाहर रखे कंपाइलर, SDK, लाइब्रेरी और सेटिंग इस्तेमाल करना संभव होता है। इसका अर्थ यह नहीं कि वे फ़ाइलें Codex की कमांड से छिपी रहती हैं।
नेटवर्क इसलिए बंद रहता है क्योंकि डेटा पढ़ सकने वाली कमांड को उसे बाहर अपलोड करने की अनुमति अपने आप नहीं मिलनी चाहिए। इसी कारण डिपेंडेंसी डाउनलोड करने के लिए अतिरिक्त अनुमति चाहिए। OpenAI यह भी बताता है कि चाइल्ड प्रोसेस अपने पैरेंट की सैंडबॉक्स पाबंदियाँ विरासत में लेते हैं। ये पाबंदियाँ उन वंशज प्रोसेस पर भी लागू रहती हैं जो मूल कमांड समाप्त होने के बाद चलते रहते हैं।
कभी-कभार डाउनलोड करना हो, तो डिफ़ॉल्ट प्रोफ़ाइल बदलने के बजाय नेटवर्क ऐक्सेस का अनुरोध जाँचें। नेटवर्क प्रॉक्सी के विवरण के अनुसार Codex ऐसा अनुरोध आपको या स्वचालित समीक्षा को भेज सकता है। बार-बार डिपेंडेंसी डाउनलोड करनी हों, तो रेजिस्ट्री के लिए सीमित अनुमति वाली प्रोफ़ाइल इस्तेमाल करें। जिन कामों को नेटवर्क नहीं चाहिए, उनके लिए उसे बंद रखें।
npm रेजिस्ट्री के लिए dev प्रोफ़ाइल सेट करें
इंस्टॉल किया गया Codex CLI दस्तावेज़ों में दी गई codex sandbox --permission-profile कमांड का समर्थन करना चाहिए। नीचे की जाँचों के लिए npm, curl और Bash भी चाहिए। नीति जाँचते समय Git की ऐसी अस्थायी वर्किंग कॉपी के रूट से शुरू करें जिसे बाद में हटाया जा सके।
अपनी निजी ~/.codex/config.toml फ़ाइल संपादित करें। नीचे की सेटिंग मौजूदा टेबल में मिलाएँ; एक ही टेबल दोबारा परिभाषित न करें। इससे dev आपकी डिफ़ॉल्ट अनुमति प्रोफ़ाइल बनती है।
इस कॉन्फ़िगरेशन को पुराने sandbox_mode या [sandbox_workspace_write] विकल्पों के साथ न मिलाएँ। अनुमति प्रोफ़ाइल के दस्तावेज़ दोनों तरीकों को मिलाने के बजाय किसी एक को चुनने के लिए कहते हैं।
default_permissions = "dev"
[features]
network_proxy = true
[permissions.dev]
description = "Workspace editing with npm registry access."
extends = ":workspace"
[permissions.dev.filesystem.":workspace_roots"]
".devcontainer" = "read"
".vscode" = "read"
".env" = "deny"
".env.local" = "deny"
"secrets" = "deny"
[permissions.dev.network]
enabled = true
[permissions.dev.network.domains]
"registry.npmjs.org" = "allow"
"example.com" = "deny"
extends = ":workspace" बिल्ट-इन सुरक्षा बनाए रखता है, जिसमें .git और .codex का सिर्फ़ पढ़ने योग्य होना शामिल है। अतिरिक्त फ़ाइल-सिस्टम नियम एडिटर और डेवलपमेंट कंटेनर की सेटिंग बदलने से रोकते हैं। वे हर वर्कस्पेस रूट के अंतर्गत दी गई एनवायरनमेंट फ़ाइलों और secrets डायरेक्टरी के पूरे उपवृक्ष का ऐक्सेस भी रोकते हैं। OpenAI के फ़ाइल-सिस्टम अनुमति मानों में read सिर्फ़ पढ़ना, write पढ़ना और लिखना, और deny ऐक्सेस रोकना दर्शाता है।
नेटवर्क कॉन्फ़िगरेशन में दो अलग स्विच हैं। permissions.dev.network.enabled = true नेटवर्क की अनुमति देता है; network_proxy = true डोमेन के नियम लागू करता है। नेटवर्क अनुमतियों के दस्तावेज़ बताते हैं कि सक्रिय प्रॉक्सी के बिना नेटवर्क चालू करने पर सीधे नेटवर्क ऐक्सेस की अनुमति मिल जाती है। उस स्थिति में डोमेन के नियम लागू नहीं होते। प्रॉक्सी वाली सेटिंग न छोड़ें।
OpenAI की कंपनियों के लिए सुरक्षा गाइड में डिपेंडेंसी ऐक्सेस के उदाहरण में registry.npmjs.org शामिल है। यहाँ example.com को जानबूझकर प्रतिबंधित किया गया है, ताकि रोक की जाँच की जा सके। दस्तावेज़ों में बताए गए डोमेन नियमों के अनुसार स्पष्ट रोक, मेल खाने वाली अनुमति से अधिक प्राथमिकता रखती है। दूसरे पतों के अनुरोध के लिए स्वीकृति चाहिए या वे ब्लॉक हो जाते हैं।
यह कॉन्फ़िगरेशन पैकेज इंस्टॉल करते समय संपर्क किए जा सकने वाले हर होस्ट का असीमित ऐक्सेस नहीं देता। नया होस्टनेम तभी जोड़ें जब समझ लें कि परियोजना को उसकी ज़रूरत क्यों है।
अनुमत और प्रतिबंधित, दोनों कार्रवाइयाँ जाँचें
प्रोफ़ाइल के अंतर्गत सीधे कमांड जाँचने के लिए codex sandbox इस्तेमाल करें। --include-managed-config जोड़ें, ताकि प्रोफ़ाइल लोड करते समय प्रशासक की प्रबंधित आवश्यकताएँ भी शामिल हों। यह तब ज़रूरी है जब कंपनी की नीति आपके विकल्प सीमित करती हो।
पहले Bash से रेजिस्ट्री जाँचें:
codex sandbox --permission-profile dev --include-managed-config -- \
npm ping --registry=https://registry.npmjs.org \
--cache="$PWD/.npm-cache"
सफल npm ping के आउटपुट में PONG आता है। यहाँ cache विकल्प npm का कैश वर्कस्पेस के अंदर रखता है। इससे किसी बाहरी कैश डायरेक्टरी के लिए अलग लिखने की अनुमति नहीं चाहिए। यह रेजिस्ट्री से संपर्क की पुष्टि करता है, हर डिपेंडेंसी या इंस्टॉलेशन स्क्रिप्ट के पूरा होने की नहीं।
अब वर्कस्पेस में लिखना, Git मेटाडेटा की सुरक्षा और प्रतिबंधित डोमेन जाँचें। ये कमांड अलग-अलग चलाएँ। Git वाली जाँच में .git पहले से मौजूद डायरेक्टरी होनी चाहिए, न कि असली रिपॉज़िटरी डायरेक्टरी की ओर इशारा करने वाली फ़ाइल।
# Expect success: create and remove a temporary workspace file.
codex sandbox --permission-profile dev --include-managed-config -- \
bash -c 'p=$(mktemp ./codex-write-check.XXXXXX) && rm "$p"'
# Expect a filesystem permission denial.
codex sandbox --permission-profile dev --include-managed-config -- \
bash -c 'p=$(mktemp .git/codex-write-check.XXXXXX) && rm "$p"'
# Expect a proxy policy rejection.
codex sandbox --permission-profile dev --include-managed-config -- \
curl --fail --head --max-time 15 https://example.com
अपेक्षित परिणाम है: वर्कस्पेस में लिखना सफल हो, .git में लिखना रोका जाए और नेटवर्क अनुरोध अस्वीकार हो। कॉन्फ़िगरेशन की गलती, गायब डायरेक्टरी या कोई अलग कनेक्शन त्रुटि इस बात का प्रमाण नहीं है कि इच्छित रोक काम कर रही है। अगर दोनों प्रतिबंधित कार्रवाइयों में से कोई सफल हो जाए, तो सामान्य काम शुरू करने से पहले रुकें और प्रभावी कॉन्फ़िगरेशन जाँचें। ये आपके चलाने के लिए जाँचें हैं, पहले से किए गए परीक्षणों के परिणाम नहीं।
अपेक्षित परिणाम मिलने के बाद रिपॉज़िटरी के रूट से नया Codex सत्र शुरू करें। /permissions चलाएँ और dev की प्रविष्टि तथा विवरण जाँचें, जैसा OpenAI के प्रोफ़ाइल कॉन्फ़िगरेशन उदाहरण में बताया गया है। प्रोफ़ाइल सक्रिय होने पर अपना मूल डिपेंडेंसी इंस्टॉलेशन कार्य दोबारा करें। कैश वर्कस्पेस के अंदर रखें या केवल उस विशेष बाहरी कैश डायरेक्टरी को write अनुमति दें जिसकी उसे ज़रूरत है।
डाउनलोड फिर भी विफल हो तो क्या जाँचें?
प्रोफ़ाइल लागू नहीं हो रही हो, तो पहले देखें कि लोड किए गए कॉन्फ़िगरेशन में पुराने सैंडबॉक्स विकल्प तो नहीं हैं। फिर कॉन्फ़िगरेशन की प्राथमिकता जाँचें: कमांड-लाइन के विकल्प या विश्वसनीय परियोजना की सेटिंग आपकी निजी डिफ़ॉल्ट सेटिंग को बदल सकती हैं। जिस प्रोफ़ाइल का सत्र इस्तेमाल ही नहीं कर रहा, उसकी अनुमतियाँ बढ़ाते न रहें।
npm ping सफल हो, लेकिन इंस्टॉलेशन विफल हो, तो असफल अनुरोध का पता और फ़ाइल-सिस्टम का पाथ अलग-अलग जाँचें। दूसरे होस्टनेम के लिए नेटवर्क ऐक्सेस पर अलग निर्णय चाहिए। वर्कस्पेस के बाहर कैश लिखने के लिए उपयुक्त फ़ाइल-सिस्टम नियम चाहिए। फ़ाइल-सिस्टम और नेटवर्क की अनुमतियाँ अलग हैं: नेटवर्क खोलने से फ़ाइलें लिखने की अनुमति नहीं मिलती।
अनुमत पते पर भी अनुरोध विफल हो, तो देखें कि क्लाइंट प्रॉक्सी सेटिंग का पालन करता है या नहीं। OpenAI के नेटवर्क प्रॉक्सी के तकनीकी विवरण बताते हैं कि कुछ प्रोग्राम प्रॉक्सी के एनवायरनमेंट वेरिएबल नहीं मानते। सैंडबॉक्स की पाबंदियाँ हटाने के बजाय क्लाइंट या उसकी सेटिंग की समस्या पहचानें।
Codex का मॉडल प्रदाता से न जुड़ पाना, सैंडबॉक्स में पैकेज मैनेजर की कमांड ब्लॉक होने से अलग समस्या है। प्रदाता के प्रमाणीकरण, Base URL या प्रोटोकॉल की सेटिंग के लिए अलग Codex API कनेक्शन गाइड देखें।
क्या व्यापक पढ़ने की अनुमति से API कुंजियाँ दिख सकती हैं?
हाँ। सिर्फ़ पढ़ने की सुरक्षा बदलाव रोकती है, पढ़ना नहीं। OpenAI ने Codex सैंडबॉक्स की बनावट पर अपने लेख में इस समझौते को स्पष्ट किया है। उसका अनुवाद है:
इसका दूसरा पहलू यह है कि कंप्यूटर में दूसरी जगह रखी संवेदनशील फ़ाइलें भी पढ़ी जा सकती हैं, जैसे API कुंजियाँ रखने वाली कॉन्फ़िगरेशन फ़ाइलें।
इसलिए डिफ़ॉल्ट प्रोफ़ाइल यह भरोसा नहीं देती कि रिपॉज़िटरी से बाहर के गोपनीय डेटा को पढ़ा नहीं जा सकता।
उदाहरण केवल रूट के सापेक्ष बताए गए .env और .env.local पाथ तथा secrets के पूरे उपवृक्ष का ऐक्सेस रोकता है। यह क्रेडेंशियल रखने वाली हर फ़ाइल के नाम या स्थान को नहीं समेटता। अपनी व्यवस्था के संवेदनशील पाथ के लिए उपयुक्त deny नियम जोड़ें। जहाँ ज़रूरी हो, वर्कस्पेस से बाहर के पाथ भी शामिल करें। वास्तविक क्रेडेंशियल दिखाने के बजाय हानिरहित परीक्षण फ़ाइलों से जाँचें।
जिन फ़ाइलों में लिखा जा सकता है, उनसे भी जोखिम रहता है। OpenAI बताता है कि node_modules/prettier जैसे इंस्टॉल किए गए पैकेज को बदलने से वह फ़ॉर्मैटर प्रभावित हो सकता है जिसे एडिटर बाद में सैंडबॉक्स के बाहर चलाता है। Git अक्सर node_modules को नज़रअंदाज़ करता है, इसलिए ऐसा बदलाव git status में नहीं दिख सकता। ट्रैक किए गए सोर्स बदलावों के साथ लिखने योग्य टूल और जनरेट की गई डिपेंडेंसी भी जाँचें।
कई कोडिंग एजेंट इस्तेमाल करने वाली टीमों को गोपनीय फ़ाइलों और Git के लिए Claude Code की अनुमतियाँ भी देखनी चाहिए। हर टूल का अपना कॉन्फ़िगरेशन इस्तेमाल करें; Codex की अनुमति कुंजियाँ दूसरे क्लाइंट में न कॉपी करें।
Docker के बजाय ऑपरेटिंग सिस्टम की सैंडबॉक्स सुविधा क्यों?
ऑपरेटिंग सिस्टम की सैंडबॉक्स सुविधा Codex को आपके मौजूदा डेवलपमेंट टूल इस्तेमाल करने देती है और उसके द्वारा चलाई गई कमांड पर पाबंदियाँ लगाती है। OpenAI अपने नेटिव सैंडबॉक्स डिज़ाइन को पूरी डेवलपमेंट व्यवस्था कंटेनर में दोबारा बनाने के विकल्प के रूप में समझाता है।
इसका व्यावहारिक उदाहरण Mac पर iOS ऐप बनाना है। OpenAI के बताए तरीके में Docker कंटेनर, Mac के नेटिव बिल्ड टूल नहीं चला सकता और न ही iPhone सिम्युलेटर शुरू कर सकता है। ये काम Mac होस्ट को सौंपने पर वे कंटेनर की सैंडबॉक्स सीमा से बाहर होते हैं। इसलिए होस्ट पर चलने वाले इन कामों के लिए अलग पाबंदियाँ चाहिए।
macOS पर Codex, Seatbelt इस्तेमाल करता है। Linux और WSL2 के लिए OpenAI के सैंडबॉक्स सेटअप निर्देश डिस्ट्रीब्यूशन के पैकेज मैनेजर से bubblewrap इंस्टॉल करने की सलाह देते हैं। सैंडबॉक्स शुरू न होने की समस्या को रेजिस्ट्री अनुरोध रोके जाने से अलग समझें।
सीधे Windows में चलाने पर अलग जाँच चाहिए। Windows सैंडबॉक्स के दस्तावेज़ संगत उपकरणों पर MXC की सलाह देते हैं। वे चेतावनी भी देते हैं कि पुराना unelevated विकल्प पाथ पढ़ने पर रोक का समर्थन नहीं करता। WSL2 में Bash की जाँच सफल होना, सीधे Windows में पाबंदियाँ लागू होने की जाँच का विकल्प नहीं है।
जब पूरा काम कंटेनर के भीतर होता हो, तब कंटेनर एक विकल्प बना रहता है। होस्ट के टूल पर निर्भर काम के लिए होस्ट पर चलने वाली कार्रवाइयाँ पहचानें और सीमित करें। यह न मानें कि कंटेनर की सीमाएँ होस्ट को सौंपे गए काम पर भी लागू होती हैं।
क्या कंपनी dev प्रोफ़ाइल चुनने से रोक सकती है?
हाँ। प्रशासक प्रबंधित requirements.toml के ज़रिए तय कर सकते हैं कि उपयोगकर्ता कौन-सी प्रोफ़ाइल चुन पाएँगे। स्थानीय प्रोफ़ाइल परिभाषित करने से यह पाबंदी नहीं हटती। OpenAI का प्रबंधित आवश्यकताओं का उदाहरण यह प्रशासकीय नीति दिखाता है:
default_permissions = ":read-only"
[allowed_permission_profiles]
":read-only" = true
":danger-full-access" = false
allowed_permission_profiles मौजूद होने पर अंतिम संयुक्त टेबल, अनुमत प्रोफ़ाइल की पूरी सूची होती है। जो प्रोफ़ाइल उस टेबल में नहीं हैं, वे प्रतिबंधित हैं। जिनका मान स्पष्ट रूप से false है, वे भी प्रतिबंधित हैं। अगर उदाहरण की टेबल आवश्यकताएँ मिलाने के बाद बनी अंतिम सूची है, तो आपकी कस्टम dev प्रोफ़ाइल उपलब्ध नहीं होगी, क्योंकि उसे अनुमति नहीं मिली है। नीति को दरकिनार करने के बजाय प्रशासक से उपयुक्त बिल्ड प्रोफ़ाइल स्वीकृत करने के लिए कहें।
प्रबंधित कॉन्फ़िगरेशन के दस्तावेज़ संस्करण की एक महत्त्वपूर्ण सीमा बताते हैं: अनुमति प्रोफ़ाइल की स्वीकृत सूचियों के लिए Codex 0.138.0 या बाद का संस्करण चाहिए। Codex 0.137.0 और पहले के संस्करण allowed_permission_profiles तथा प्रबंधित default_permissions को नज़रअंदाज़ करते हैं। इस नियंत्रण पर भरोसा करने से पहले हर प्रबंधित क्लाइंट का संस्करण जाँचें।
व्यापक रूप से लागू करने से पहले हर समर्थित ऑपरेटिंग सिस्टम पर एक अनुमत बिल्ड और एक जानबूझकर प्रतिबंधित कार्रवाई जाँचें। रेजिस्ट्री की अनुमतियाँ सीमित रखें, अपेक्षित प्रोफ़ाइल के चयन की पुष्टि करें और क्लाइंट अपडेट करते समय प्रतिबंध वाली जाँचें दोहराएँ।