सेटअप
VPS पर Claude Code चलाना
हमेशा चालू रहने वाला एक छोटा सर्वर Claude Code को आपके लैपटॉप से हटा देता है और आपके न रहने पर भी उसे काम करने देता है। यहाँ एक ऐसा सेटअप है जो जल्दी खड़ा हो जाता है और चलता छोड़ने के लिए सुरक्षित है, और जिसमें दूसरे कोडिंग एजेंट के लिए भी जगह है।
छोटा जवाब
कम से कम 4 GB RAM वाला Linux VPS किराये पर लें, एक non-root यूज़र बनाएँ, और SSH को सिर्फ़ कुंजी से लॉगिन पर कर दें। फिर Claude Code को curl -fsSL https://claude.ai/install.sh | bash से इंस्टॉल करें (Node.js की ज़रूरत नहीं) और claude auth login से लॉगिन करें, कोड को SSH पर वापस पेस्ट करके। सेशन को tmux, Remote Control या Maude जैसे सेशन daemon से चालू रखें।
Claude Code को लैपटॉप के बजाय सर्वर पर चलाने से आपको तीन चीज़ें मिलती हैं। लैपटॉप बंद होने पर भी यह काम करता रहता है। टूटा कनेक्शन यह झेल लेता है। और यह एजेंट को ऐसी मशीन पर रखता है जिसे आप फेंक सकते हैं, न कि उस मशीन पर जिसमें आपकी SSH कुंजियाँ और ब्राउज़र प्रोफ़ाइल हैं। यह गाइड ऐसा सेटअप बताती है जो नई Debian या Ubuntu मशीन पर लगभग पंद्रह मिनट लेता है। यही क़दम छोटे बदलावों के साथ Alpine और Fedora पर भी काम करते हैं।
आपको ऐसा Claude प्लान चाहिए जिसमें Claude Code शामिल हो: Pro, Max, Team या Enterprise, या Console खाता। मुफ़्त claude.ai प्लान में यह शामिल नहीं है। अपने सब्सक्रिप्शन से साइन इन करें, तो न कोई API कुंजी संभालनी है, न ऊपर से उपयोग का बिल।
1. मशीन चुनें
Anthropic की सिस्टम ज़रूरतें 4 GB या ज़्यादा RAM और x64 या ARM64 प्रोसेसर बताती हैं। सपोर्टेड Linux सिस्टम हैं Ubuntu 20.04+, Debian 10+ और Alpine 3.19+। व्यवहार में CLI से ज़्यादा आपके प्रोजेक्ट का टूलचेन तय करता है:
- 4 GB: दस्तावेज़ों में दिया न्यूनतम, सामान्य प्रोजेक्ट पर एक सेशन के लिए ठीक।
- 8 GB: अगर आप कुछ बड़ा बिल्ड करते हैं (bundler, टेस्ट सूट, एक-दो कंटेनर) या एक साथ कई सेशन चलाते हैं।
- 16 GB: अगर आप कई एजेंट समानांतर चलाते हैं, या उनके बगल में कोई डेटाबेस।
Hetzner, DigitalOcean, Scaleway, OVH, Vultr और दूसरे सब चलते हैं, और आपकी डेस्क के नीचे रखी कोई पुरानी मशीन भी। अगर आप कभी उस पर टर्मिनल में टाइप करेंगे, तो अपने पास का क्षेत्र चुनें। ARM इंस्टेंस आमतौर पर प्रति गीगाबाइट सबसे सस्ते होते हैं और Claude Code उन पर नेटिव रूप से चलता है। कोडिंग एजेंट के लिए सबसे अच्छे VPS पर हमारी गाइड प्रदाताओं और साइज़ की तुलना करती है।
2. non-root यूज़र बनाएँ
कई VPS इमेज आपको root के रूप में लॉगिन कराती हैं। एजेंट को root के रूप में न चलाएँ। इससे हर ग़लती पूरे सिस्टम की ग़लती बन जाती है। Claude Code root के रूप में bypass-permissions मोड में शुरू होने से भी इनकार करता है, इसलिए देर-सबेर आपको एक सामान्य यूज़र चाहिए ही होगा। Debian या Ubuntu पर:
adduser dev
usermod -aG sudo dev
rsync --archive --chown=dev:dev ~/.ssh /home/dev
Fedora पर एडमिन ग्रुप sudo के बजाय wheel है। Alpine पर पहले sudo या doas इंस्टॉल करें। आख़िरी लाइन वह कुंजी कॉपी करती है जिससे आप अभी लॉगिन हैं, ताकि कुछ भी बंद करने से पहले आप dev के रूप में दोबारा जुड़ सकें। पहला टर्मिनल बंद करने से पहले दूसरे टर्मिनल से इसे जाँच लें। नए VPS से ख़ुद को बाहर कर लेना एक ऐसी रस्म है जिससे बचना ही बेहतर है।
3. SSH कुंजियाँ और सुरक्षा
अगर आप अब भी पासवर्ड से लॉगिन कर रहे हैं, तो पहले कुंजी पर आएँ। अपने कंप्यूटर पर ssh-keygen -t ed25519 से एक कुंजी बनाएँ, फिर ssh-copy-id dev@your-server से उसे ऊपर कॉपी करें। कुंजी से लॉगिन चलने लगे, तो /etc/ssh/sshd_config एडिट करें:
PermitRootLogin no
PasswordAuthentication no
PubkeyAuthentication yes
फिर SSH रीस्टार्ट करें: Debian और Ubuntu पर sudo systemctl restart ssh। Fedora पर सेवा का नाम sshd है, इसलिए sudo systemctl restart sshd चलाएँ। और सुरक्षा के लिए fail2ban और ऐसा फ़ायरवॉल जोड़ें जो सिर्फ़ SSH की अनुमति दे। अगर मशीन को सार्वजनिक इंटरनेट पर होने की ज़रूरत ही नहीं, तो उसे Tailscale नेटवर्क पर रखें। आपका फ़ोन उसी नेटवर्क से जुड़ता है और सीधे उस तक पहुँचता है।
फ़ोन से: SSH ऐप डिवाइस पर कुंजी बना सकते हैं और उसका public हिस्सा दिखा सकते हैं, जिसे आप ~/.ssh/authorized_keys में पेस्ट करते हैं। Maude यह आपके लिए करता है: उसका "Set up key login" बटन उसी कनेक्शन पर कुंजी बनाता है जिससे आप पहले से साइन इन हैं। वह public हिस्सा इंस्टॉल करता है, नई कुंजी को जाँचता है, और private हिस्सा सिर्फ़ फ़ोन के keychain में रखता है।
4. Claude Code इंस्टॉल करें
Anthropic अब नेटिव इंस्टॉलर की सलाह देता है, जिसके लिए Node.js नहीं चाहिए। इसे अपने सामान्य यूज़र के रूप में चलाएँ, sudo के साथ नहीं:
curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor
यह लॉन्चर को ~/.local/bin/claude पर रखता है और बैकग्राउंड में ख़ुद को अपडेट करता है। claude doctor सेशन शुरू किए बिना इंस्टॉल और आपकी सेटिंग्स की जाँच करता है। कुछ विकल्प, सब सेटअप दस्तावेज़ों से:
- साइन की हुई apt, dnf और apk रिपॉज़िटरी, अगर आप चाहते हैं कि सिस्टम का पैकेज मैनेजर इसे संभाले। ये अपने-आप अपडेट नहीं होतीं; आप बाक़ी सिस्टम के साथ अपग्रेड करते हैं।
- npm अब भी चलता है (
npm install -g @anthropic-ai/claude-code, Node.js 22 या बाद का)। यह वही नेटिव बाइनरी इंस्टॉल करता है। Anthropicsudo npm install -gसे मना करता है। - Alpine को
bash,curl,libgcc,libstdc++औरripgrepचाहिए, साथ में आपकी सेटिंग्स मेंUSE_BUILTIN_RIPGREP=0।
अगर किसी पुरानी गाइड ने आपसे पहले Node इंस्टॉल करने को कहा था, तो अब वह क़दम छोड़ सकते हैं।
5. बिना ब्राउज़र लॉगिन करें
claude (या claude auth login) चलाएँ और निर्देशों का पालन करें। VPS पर ब्राउज़र नहीं होता, इसलिए आप लॉगिन URL किसी दूसरे डिवाइस पर खोलेंगे। Claude Code आपको उसे कॉपी करने के लिए c दबाने देता है। वहाँ साइन इन करें। जब ब्राउज़र Claude Code के लोकल callback तक नहीं पहुँच पाता, जो SSH पर सामान्य है, तो वह एक कोड दिखाता है। उसे Paste code here if prompted वाली लाइन पर पेस्ट करें और लॉगिन सर्वर पर पूरा हो जाता है।
क्रेडेंशियल ~/.claude/.credentials.json में 0600 मोड के साथ सहेजा जाता है। मशीन को उसी हिसाब से बरतें: उस यूज़र के रूप में शेल वाला कोई भी व्यक्ति आपका Claude सब्सक्रिप्शन इस्तेमाल कर सकता है। स्क्रिप्ट और CI के लिए claude setup-token भी है, जो एक साल का टोकन देता है जिसे आप CLAUDE_CODE_OAUTH_TOKEN के रूप में सेट करते हैं। ऑथेंटिकेशन दस्तावेज़ों के अनुसार यह टोकन सिर्फ़ मॉडल अनुरोध कर सकता है और Remote Control सेशन शुरू नहीं कर सकता।
6. इसे चालू रखें
SSH सेशन के foreground में आप जो भी शुरू करते हैं, वह उस कनेक्शन के साथ ख़त्म हो जाता है। आम हल है tmux:
sudo apt install tmux
tmux new -s work
# start claude, then detach with Ctrl-B then D
tmux attach -t work
आप डिटैच कर सकते हैं, सिग्नल खो सकते हैं, घंटों बाद दोबारा कनेक्ट होकर जुड़ सकते हैं, और सेशन जस का तस रहता है। हालाँकि tmux रीबूट नहीं झेलता। रीबूट के बाद claude --continue उस डायरेक्टरी की सबसे हाल की बातचीत उठा लेता है। लैपटॉप बंद करने के बाद भी Claude Code चलाते रहने पर हमारी गाइड systemd और सेशन daemon समेत दूसरे विकल्प बताती है।
7. वही मशीन, ज़्यादा एजेंट
जो सर्वर Claude Code चलाता है, वह उसके बगल में दूसरे कोडिंग एजेंट भी चला सकता है। हर एक आपकी होम डायरेक्टरी में इंस्टॉल होता है और अपना अलग लॉगिन रखता है, इसलिए वे एक-दूसरे के रास्ते में नहीं आते। एक साथ चलने वाले हर एजेंट के लिए RAM में जगह छोड़ें।
| एजेंट | इंस्टॉल | headless लॉगिन |
|---|---|---|
| Codex (OpenAI) | npm install -g @openai/codex | codex login --device-auth (पहले ChatGPT की सुरक्षा सेटिंग्स में डिवाइस-कोड लॉगिन चालू करें) या API कुंजी |
| OpenCode | curl -fsSL https://opencode.ai/install | bash | TUI में /connect, फिर प्रदाता की कुंजी पेस्ट करें |
| Grok Build (xAI) | curl -fsSL https://x.ai/cli/install.sh | bash | पहली बार चलाने पर ब्राउज़र लॉगिन, या XAI_API_KEY |
Antigravity CLI (Google, agy) | curl -fsSL https://antigravity.google/cli/install.sh | bash | SSH पर यह एक URL दिखाता है और आप कोड वापस पेस्ट करते हैं, या GEMINI_API_KEY सेट करें |
स्रोत: Codex auth, OpenCode दस्तावेज़, Grok Build दस्तावेज़, Antigravity CLI इंस्टॉल, अक्टूबर 2026 में जाँचे गए। Codex और Antigravity की अपनी गाइड हैं: VPS पर Codex CLI और सर्वर पर Antigravity CLI। Gemini CLI अब निजी Google खातों के लिए विकल्प नहीं है, और Antigravity CLI उसकी जगह Google का विकल्प है।
8. फ़ोन से उस तक पहुँचें
इसके तीन तरीक़े हैं, सबसे ज़्यादा हाथ से करने वाले से सबसे कम तक:
SSH ऐप और tmux। Termius, Blink या कोई दूसरा क्लाइंट, आपके tmux सेशन से जुड़ा हुआ। यह मुफ़्त और संपूर्ण है, और आप सॉफ़्ट कीबोर्ड से एक फ़ुल-स्क्रीन टर्मिनल चला रहे होते हैं। यह तुलना में कैसा है, यहाँ देखें।
Remote Control। tmux के अंदर claude remote-control शुरू करें और Claude ऐप के Code टैब से सेशन खोलें। यह Pro, Max, Team और Enterprise में शामिल है। Anthropic के दस्तावेज़ ठीक इसी स्थिति के लिए tmux या screen का सुझाव देते हैं। यह सिर्फ़ Claude के लिए काम करता है, और सेशन जो अनुमति अनुरोध उठाता है वे जवाब के लिए फ़ोन पर आते हैं। ऐप सेशन को Auto या Bypass permissions पर नहीं बदल सकता।
Maude। Maude क़दम 4 और 6 आपके लिए करता है, और क़दम 5 आपके फ़ोन पर आ जाता है। आप सर्वर को पते से, ssh … कमांड पेस्ट करके, या curl -fsSL https://maude.pilotdev.fr/setup | sh से छपा QR कोड स्कैन करके जोड़ते हैं। अगर आप root के रूप में लॉगिन हैं, तो एक बटन क़दम 2 वाला non-root यूज़र आपके लिए बना देता है। फिर Maude, SSH से अपना daemon डिप्लॉय करता है और हर एजेंट को ऐसे वर्ज़न पर इंस्टॉल करता है जिसे हमने जाँचा और पिन किया है। आप फ़ोन से Claude, Codex या किसी भी दूसरे में साइन इन करते हैं। ऐप बंद होने पर भी सेशन सर्वर पर चलते रहते हैं, और सर्वर ख़ुद Maude के रिले से जुड़ता है, इसलिए यह बिना खुले पोर्ट के NAT के पीछे भी काम करता है।
9. अनुमतियों पर फ़ैसला करें
अब दिलचस्प सवाल: आप उसे बिना निगरानी कितना करने देते हैं? जिस सर्वर को आप दोबारा बना सकते हैं, वह अनुमतियाँ ढीली करने की सही जगह है, बशर्ते आपने उसे सचमुच फेंकने लायक़ माना हो। Claude Code का auto मोड, जिसमें एक classifier सुरक्षित ऐक्शन मंज़ूर करता है, यह कमी काफ़ी हद तक भरता है। पूरे bypass के अपने नियम हैं, क़दम 2 वाली root पाबंदी समेत। उनका अपना पेज है: पूरी अनुमतियों के साथ Claude Code को सुरक्षित रूप से चलाना।
मशीन को ऐसे सेट करें कि उसे खोना गंभीर नहीं, बस झुंझलाहट भरा हो। अपना काम अक्सर किसी remote पर push करें, उस पर ऐसा कोई secret न रखें जो और कहीं न हो, और मानकर चलें कि आप उसे दोबारा बना सकते हैं। यह सच हो जाए, तो ऊपर का हर फ़ैसला आसान हो जाता है।
इसे फ़ोन से चलाएँ
सर्वर तैयार होने के बाद, फ़ोन पर Claude Code बताता है कि Maude उसे कैसे चलाता है। अगर Claude आपका इकलौता एजेंट नहीं है, तो एजेंट के ओवरव्यू से शुरू करें।
अक्सर पूछे जाने वाले सवाल
Claude Code को कितनी RAM चाहिए?
क्या मैं सर्वर पर बिना ब्राउज़र Claude Code में लॉगिन कर सकता हूँ?
claude या claude auth login चलाएँ, जो URL मिले उसे किसी भी डिवाइस पर खोलें, और साइन इन करें। SSH पर ब्राउज़र आमतौर पर वापस रीडायरेक्ट करने के बजाय एक कोड दिखाता है; उसे टर्मिनल में प्रॉम्प्ट पर पेस्ट करें। बिना इंटरैक्शन वाली स्क्रिप्ट के लिए claude setup-token लंबे समय चलने वाला टोकन देता है, लेकिन वह Remote Control सेशन शुरू नहीं कर सकता।क्या मुझे इसे root के रूप में चलाना चाहिए?
क्या कई एजेंट एक VPS साझा कर सकते हैं?
क्या मुझे अब भी Node.js चाहिए?
क्या बदला
- — इंस्टॉल को Anthropic के नेटिव इंस्टॉलर पर बदला गया (अब Node.js ज़रूरी नहीं); RAM की सलाह दस्तावेज़ों के 4 GB न्यूनतम के अनुरूप की गई; headless लॉगिन का कोड-पेस्ट फ़्लो और setup-token जोड़े गए; उसी मशीन पर Codex, OpenCode, Grok Build और Antigravity चलाने पर नया सेक्शन।
- — पहली बार प्रकाशित।