इस प्रोजेक्ट के बारे में

Clodex एक स्थानीय, ओपन-सोर्स लॉन्चर है जो Claude Code को इंटरैक्टिव कोडिंग हार्नेस के रूप में चलाता है, जबकि मॉडल अनुरोधों को आपके ChatGPT खाते पर Codex तक रूट करता है। यह Claude Code का UI, एजेंट, टूल्स, अनुमतियाँ और वर्कफ़्लो बनाए रखता है; लॉन्च किए गए प्रोसेस के लिए केवल मॉडल ट्रांसपोर्ट और मॉडल उपनाम बदलते हैं। कोई भी रोल अपनी Claude सदस्यता पर वास्तविक Claude मॉडल भी चला सकता है। इसके लिए किसी OpenAI API key, Codex CLI, या बाहरी प्रॉक्सी की आवश्यकता नहीं है: `clodex auth login` से एक बार साइन इन करें। जब आपके पास मौजूदा Codex CLI लॉगिन हो, तो उसे पुनः उपयोग किया जाता है। सामान्य `claude` सत्र अप्रभावित रहते हैं। मुख्य विशेषताएँ: - Claude Code का टर्मिनल अनुभव, सबएजेंट, टूल उपयोग, और अनुमति नियंत्रण बनाए रखें। - मॉडल नाम हार्ड-कोड किए बिना Codex में आपके ChatGPT खाते द्वारा पहुँच योग्य मॉडल उपयोग करें, और अपनी Claude सदस्यता पर Claude मॉडल मिलाएँ। - `/model` से कोई भी मॉडल चुनें, और सबएजेंट को किसी भी प्रदाता से मॉडल दें। - सब कुछ स्थानीय रूप से एक स्व-निहित बाइनरी में, लूपबैक-केवल ब्रिज के पीछे चलाएँ। - सामान्य Claude Code सत्र और वैश्विक मॉडल सेटिंग्स को अछूता छोड़ें। - एक पर्यवेक्षित बैकएंड को समवर्ती Clodex सत्रों में सुरक्षित रूप से साझा करें। आवश्यकताएँ: macOS या Linux, Codex पहुँच वाला ChatGPT खाता, और Claude Code। वैकल्पिक रूप से, `claude-code-proxy` यदि आप अंतर्निहित Codex बैकएंड से बाहरी पर स्विच करते हैं। Clodex Unix डोमेन सॉकेट्स पर निर्भर करता है और मूल Windows का समर्थन नहीं करता। इंस्टॉलेशन: नवीनतम रिलीज़ से अपने प्लेटफ़ॉर्म के लिए आर्काइव डाउनलोड करें, निकालें, और `~/.local/bin/clodex` में इंस्टॉल करें। स्रोत से बनाने के लिए, Rust 1.88+ इंस्टॉल करें और `./scripts/install.sh` चलाएँ। Homebrew के साथ `claude-code-proxy` भी इंस्टॉल करने के लिए `--install-proxy` जोड़ें। त्वरित शुरुआत: ```sh clodex auth login # अपने ChatGPT खाते से Codex में साइन इन करें clodex doctor clodex ``` `clodex auth login` एक ब्राउज़र खोलता है; SSH या हेडलेस मशीनों के लिए `--device` उपयोग करें। यदि आप पहले से Codex CLI उपयोग करते हैं, तो आप साइन इन करना छोड़ सकते हैं। किसी भी प्रोजेक्ट डायरेक्टरी से `clodex` चलाएँ। जो आर्ग्युमेंट Clodex प्रबंधन कमांड नहीं हैं, वे सीधे Claude Code को पास होते हैं: ```sh clodex --resume clodex -p "summarize this repository" clodex -- --resume ``` Clodex एक बैंगनी लॉन्च बैनर दिखाता है, टर्मिनल शीर्षक बदलता है, और Clodex-केवल बैंगनी Claude थीम चुनता है। कमांड में शामिल हैं: `clodex auth login/logout/status/sync`, `clodex models [list]`, `clodex models map`, `clodex config [show]`, `clodex config context <auto|tokens>`, `clodex config compact-at <1..95>`, `clodex config backend <builtin|proxy>`, `clodex config hierarchical-compaction <on|off>`, `clodex config route <role> <claude-model|codex>`, `clodex config allow-tool <exact-name>`, `clodex config forget-tool <exact-name>`, `clodex config path`, `clodex context`, और `clodex doctor`। मॉडल रूटिंग: प्रत्येक लॉन्च पर, Clodex आपके खाते का Codex मॉडल कैटलॉग पढ़ता है, छिपी या API-असमर्थित प्रविष्टियाँ हटाता है, और कैटलॉग प्राथमिकता को Claude Code रोल्स पर मैप करता है। कैटलॉग पाँच मिनट के लिए कैश होता है। लॉन्च किया गया सत्र डिफ़ॉल्ट रूप से Opus रूट पर होता है; Fable और Sonnet मॉडल पिकर से उपलब्ध रहते हैं। Haiku छिपा हुआ है लेकिन Sonnet रूट के माध्यम से समर्थित है। कोई मॉडल नाम हार्ड-कोड नहीं है, इसलिए मैपिंग लाइव Codex कैटलॉग का अनुसरण करती है। आपकी Claude सदस्यता पर Claude मॉडल: कोई भी रोल अपने Codex मॉडल के बजाय वास्तविक Claude मॉडल उपयोग कर सकता है। Claude-रूटेड अनुरोध Claude Code के अपने सदस्यता लॉगिन का पुनः उपयोग करते हैं और आपकी Claude योजना की उपयोग सीमाओं में गिने जाते हैं। Clodex कभी Claude क्रेडेंशियल नहीं पढ़ता, कॉपी करता, या संग्रहीत करता है। रूटेड मॉडल Claude Code को `anthropic/<model>` के रूप में दिखते हैं। `/model` और सबएजेंट में हर मॉडल: प्रत्येक लॉन्च Claude Code के `/model` पिकर में हर रूटेबल Codex मॉडल सूचीबद्ध करता है, साथ ही सदस्यता लॉगिन होने पर वर्तमान Claude मॉडल भी। Clodex सूची को Claude Code के मॉडल-डिस्कवरी कैश में लिखता है और क्यूरेटेड `modelPicker` पंक्तियाँ पास करता है। Agent टूल का `model` पैरामीटर चार रोल उपनाम स्वीकार करता है, और Clodex प्रत्येक सूचीबद्ध मॉडल के लिए एक `--agents` परिभाषा पास करता है। फास्ट मोड: समर्थित Codex मॉडल को पूरे सत्र के लिए प्राथमिकता सेवा टियर पर रखने के लिए `clodex --fast` से लॉन्च करें, जिसमें सबएजेंट और कम्पैक्शन शामिल हैं। Claude रूट सामान्य गति से चलते हैं। `/fast on` और `/fast off` चयनित मॉडल के लिए प्राथमिकता टियर को इंटरैक्टिव रूप से टॉगल करते हैं। कॉन्टेक्स्ट और कम्पैक्शन: डिफ़ॉल्ट `auto` सेटिंग उस सबसे बड़ी क्षमता पर हल होती है जिसे हर रूटेड मॉडल वास्तव में स्वीकार करेगा। स्पष्ट मान ऊपरी सीमा तक सम्मानित होते हैं और उससे ऊपर क्लैंप होते हैं। Clodex Codex बैकएंड को सर्वर-साइड कम्पैक्शन सक्षम के साथ भी चलाता है। पदानुक्रमित कम्पैक्शन (ऑप्ट-इन): एक अत्यधिक बड़े कम्पैक्शन अनुरोध को एक फोल्ड से बदलता है जिसके प्रत्येक राउंड निर्माण से ही फिट होते हैं। राउंड की संख्या बातचीत के आकार का अनुसरण करती है। डिफ़ॉल्ट रूप से बंद क्योंकि प्रत्येक राउंड में एक मॉडल कॉल खर्च होती है। तर्क प्रयास: मॉडल रूटिंग और तर्क प्रयास स्वतंत्र हैं। Claude Code का `/effort` नियंत्रण या `--effort` विकल्प उपयोग करें। विश्वसनीय टूल्स: Clodex `clodex config allow-tool <exact-name>` के माध्यम से मुख्य सत्र और प्रत्येक सबएजेंट को प्रति-लॉन्च सटीक अनुमति नियम प्रदान कर सकता है। अंतर्निहित Codex बैकएंड: बिना किसी बाहरी प्रॉक्सी इंस्टॉल के Codex के लिए Claude Code के अनुरोधों का अनुवाद करता है। यह डिफ़ॉल्ट है। बाहरी प्रॉक्सी `clodex config backend proxy` के माध्यम से उपलब्ध रहता है। साझा प्रॉक्सी जीवनचक्र: पहला सक्रिय सत्र एक उपलब्ध एफेमेरल पोर्ट पर एक सुपरवाइज़र और एक लूपबैक-केवल प्रॉक्सी शुरू करता है। समवर्ती स्टार्टअप एक विशेष फ़ाइल लॉक के साथ क्रमबद्ध किया जाता है। जिस सत्र ने सुपरवाइज़र शुरू किया उसका कोई विशेष स्वामित्व नहीं है; जब तक कोई लीज़ बची है प्रॉक्सी जीवित रहती है। अंतिम लीज़ गायब होने के एक सेकंड बाद, सुपरवाइज़र प्रॉक्सी बंद करता है और सफाई करता है। क्रेडेंशियल और स्थानीय फ़ाइलें: Clodex `clodex auth login` से अपना साइन-इन उपयोग करता है जब कोई हो, अन्यथा `chatgpt` मोड में प्रमाणित होने पर Codex CLI की `~/.codex/auth.json` का पुनः उपयोग करता है। Clodex का अपना साइन-इन `~/.clodex/auth/codex.json` में मोड `0600` के साथ `0700` डायरेक्टरी में संग्रहीत होता है। स्थायी और रनटाइम फ़ाइलें डिफ़ॉल्ट रूप से `~/.clodex/` में config, auth, cache, logs, और run सबडायरेक्टरीज़ के साथ होती हैं। इस पूरी डायरेक्टरी को स्थानांतरित करने के लिए `CLODEX_HOME` सेट करें। समस्या निवारण: `clodex doctor`, `clodex auth status`, `clodex auth sync`, और `clodex context` से शुरू करें। सामान्य समस्याओं में बाधित अपस्ट्रीम Codex प्रतिक्रियाएँ (कनेक्टिविटी बहाल होने के बाद पुनः प्रयास करें, या `clodex config transport websocket` आज़माएँ), 403 WebSocket अपग्रेड विफलताएँ (Clodex अपडेट करें, ट्रांसपोर्ट को http पर सेट करें, सत्र पुनः आरंभ करें), और 413 request_too_large (कॉन्टेक्स्ट क्षमता की रूटेड सीलिंग से तुलना करें; Clodex अपडेट करें और नया सत्र शुरू करें)। Clodex एक स्वतंत्र समुदाय परियोजना है, जो Anthropic या OpenAI से संबद्ध, समर्थित, या उनके द्वारा समर्थित नहीं है। यह MIT के अंतर्गत लाइसेंस प्राप्त है।