VPS वर OpenCode कसे इंस्टॉल करायचे

OpenCode म्हणजे काय आणि तुम्ही काय सेटअप करत आहात

OpenCode हा terminal साठी बनवलेला एक open source AI coding agent आहे. तुम्ही तो project directory मध्ये सुरू करू शकता. तो तुमचा code वाचतो, बदलांचे प्रस्ताव देतो, files edit करतो आणि commands रन करतो; हे सर्व terminal user interface (TUI) मधून घडते. हा MIT licensed आहे आणि पेक्षा जास्त model providers शी जोडलेला आहे. mid-2026 पर्यंत सुमारे 165,000 GitHub stars सह, हा सर्वात जास्त stars असलेला open source coding agent आहे. VPS वर OpenCode चालवण्यासाठी, तुम्हाला तो एका dedicated unprivileged user अंतर्गत install करावा लागतो, तुमची model API key एका private file मध्ये ठेवावी लागते, आणि तो tmux मध्ये सुरू करावा लागतो जेणेकरून connection तुटले तरी session सुरू राहील. हा guide नेमके हेच काम, दिलेल्या क्रमाने करतो.

एक नावाचा फरक गोंधळ टाळण्यास मदत करतो. अधिकृत repository anomalyco/opencode आहे, ज्याची देखभाल Anomaly team (पूर्वीचे नाव SST) करते, आणि हा project पूर्वी sst/opencode वर होता. GitHub वर opencode-ai/opencode नावाचे एक जुने आणि असंबंधित repository देखील आहे, त्यामुळे तुम्ही योग्य project चे docs वाचत आहात याची खात्री करा. अधिकृत साइट opencode.ai आहे.

VPS वर OpenCode का चालवावे

Coding agent चे session दीर्घकाळ चालते. OpenCode ला refactor किंवा test suite पूर्ण करण्यासाठी अनेक मिनिटे लागू शकतात. जर हे तुमच्या laptop वर चालले, तर lid बंद झाल्यामुळे किंवा Wi-Fi कनेक्शन तुटल्यामुळे task मध्येच session थांबते. VPS वर tmux वापरून चालवल्यास, तुम्ही disconnect झाल्यानंतरही agent काम करत राहतो. तुम्ही नंतर पुन्हा reattach करून त्याने काय केले ते पाहू शकता. ही पद्धत running Claude Code on a VPS with tmux सारखीच आहे. agent ला laptop वरून हलवल्यामुळे मिळणारा हा सर्वात मोठा फायदा आहे.

दुसरे कारण म्हणजे placement. VPS हे तुम्ही deploy केलेल्या code च्या जवळ असते: repository, build tools, test database आणि अनेकदा staging environment आधीच तिथे किंवा त्याच्या जवळ असते. कोड edit करणारा आणि tests चालवणारा agent त्याच machine वर सर्वोत्तम काम करतो जिथे ते tests प्रत्यक्षात चालतात. तसेच, VPS हे तुमच्या नियंत्रणाखालील server असल्याने, तुम्ही agent ला जाणीवपूर्वक एक contained environment देऊ शकता, ज्याबद्दल पुढील section मध्ये माहिती दिली आहे.

जर तुम्ही अजूनही tool निवडत असाल, तर running a coding AI agent on a VPS मध्ये Aider आणि Goose सह इतर पर्यायांची तुलना केली आहे.

OpenCode साठी स्वतंत्र user तयार करा

वास्तविक परिस्थिती अशी आहे: coding agent फाईल्स एडिट करतो आणि commands रन करतो. हे त्याचे काम आहे आणि तेच एक मोठे जोखिम देखील आहे. OpenCode बिल्ड्स, टेस्ट्स आणि आवश्यक असलेले shell commands रन करेल. मॉडेलचे निर्णय चांगले असतात, परंतु ते पूर्णपणे अचूक नसतात. agent ज्या account मधून काम करतो, त्या account ची परवानगी हीच त्या चुकीच्या command ची मर्यादा ठरवते. त्यामुळे, OpenCode ला root म्हणून किंवा सर्व्हरचे प्रशासन करणाऱ्या user प्रमाणे रन करू नका.

Background agent च्या विरुद्ध, OpenCode हे interactive आहे. त्यामुळे त्याच्या user ला real shell आणि home directory ची आवश्यकता असते:

sudo useradd --create-home --shell /bin/bash opencode
sudo -iu opencode

ज्या projects वर तुम्हाला काम करायचे आहे, ते /home/opencode मध्ये ठेवा आणि त्या user द्वारे क्लोन करा. त्या account ला sudo rights देऊ नका. जर agent ने एखादी destructive command रन केली, तर तो फक्त त्या एका account च्या मालकीच्या गोष्टी नष्ट करू शकतो. running services as an unprivileged user हे याच कारणास्तव केले जाते. कामासाठी git repository चा वापर करा, कारण repository मुळे कोणतीही चुकीची edit ही नुकसान करण्याऐवजी git revert ठरते.

OpenCode इंस्टॉल करा

या प्रोजेक्टमध्ये दोन इन्स्टॉलेशन पद्धती आहेत. इन्स्टॉलेशन स्क्रिप्ट वापरणे सर्वात जलद आहे. opencode युजर म्हणून स्क्रिप्ट रन केल्यास सर्व फाइल्स त्या युजरच्या home डिरेक्टरीमध्ये राहतात:

curl -fsSL https://opencode.ai/install | bash

इतर सर्व ठिकाणी लागू होतो तसाच curl | bash नियम येथेही लागू होतो: ज्या सर्व्हरवर तुम्हाला काम करायचे आहे, तिथे प्रथम स्क्रिप्ट डाउनलोड करा, ती वाचा आणि नंतर रन करा. इन्स्टॉलेशन पूर्ण झाल्यावर, नवीन shell सुरू करा जेणेकरून इन्स्टॉलरने केलेले PATH बदल लागू होतील. त्यानंतर खालील कमांड वापरून बायनरी तपासा:

opencode --version

जर तुम्हाला package manager वापरायचे असेल आणि सिस्टममध्ये Node.js आधीच असेल, तर npm पद्धत वापरून तुम्ही हे टूल system-wide इंस्टॉल करू शकता. यामुळे प्रत्येक युजरसाठी opencode बायनरी PATH मध्ये समाविष्ट होते:

sudo npm install -g opencode-ai

दोन्ही पद्धतींमध्ये तपासण्याची प्रक्रिया सारखीच आहे: opencode --version कमांड व्हर्जन नंबर प्रिंट करते. जर स्क्रिप्ट इन्स्टॉलेशन नंतर command not found येत असेल, तर याचा अर्थ सध्याच्या shell ने अद्याप अपडेटेड PATH वाचलेला नाही. अशा वेळी, opencode युजर म्हणून लॉग आउट करा आणि पुन्हा लॉग इन करा.

API key एका खाजगी (private) फाईलमध्ये ठेवा

OpenCode ला तुम्ही वापरत असलेल्या model provider साठी की (key) आवश्यक असते. ही की तुमच्या पैशांचा वापर करू शकते, म्हणून तिला पासवर्डप्रमाणे सुरक्षित ठेवा. केवळ opencode युजरला वाचता येईल अशी 600 mode असलेली फाईल तयार करा. की थेट कमांड्समध्ये टाइप करण्याऐवजी त्या फाईलमध्ये साठवा, जेणेकरून ती तुमच्या shell history मध्ये येणार नाही:

install -m 600 /dev/null ~/opencode.env
nano ~/opencode.env

त्या फाईलमध्ये तुमच्या provider ची variable टाका, उदाहरणार्थ ANTHROPIC_API_KEY=... किंवा तुमच्या provider साठी लागू असलेली समकक्ष variable. OpenCode standard provider environment variables वापरते. agent सुरू करण्यापूर्वी ती फाईल तुमच्या shell मध्ये लोड करा:

set -a; source ~/opencode.env; set +a

OpenCode मध्ये एक interactive पर्याय देखील आहे: TUI मधील /connect कमांड तुम्हाला provider ॲड करण्याची प्रक्रिया सांगते आणि credential युजरच्या home डिरेक्टरीमधील ~/.local/share/opencode/auth.json मध्ये सेव्ह करते. जर तुम्ही हा मार्ग निवडला, तर chmod 600 ~/.local/share/opencode/auth.json वापरून फाईल खाजगी असल्याची खात्री करा. दोन्ही पद्धतींमुळे की तुमच्या command lines मध्ये येत नाही; यापैकी एक पद्धत निवडा आणि तीच वापरा.

tmux मध्ये OpenCode सुरू करा

tmux मुळे VPS सेटअप फायदेशीर ठरतो, कारण SSH कनेक्शन संपल्यानंतरही tmux session सुरू राहते. एक session सुरू करा, तुमच्या project मध्ये जा आणि agent सुरू करा:

tmux new -s opencode
cd ~/my-project
opencode

खाली prompt आणि interface मध्ये तुमच्या project चे नाव असलेली TUI उघडलेली दिसेल. साध्या भाषेत एखादे task द्या, आणि agent फाईल्स वाचण्यास आणि बदल सुचवण्यास सुरुवात करेल. बाहेर पडण्यासाठी, Ctrl-b आणि नंतर d दाबून detach करा; यामुळे तुमचा laptop बंद असला तरी agent काम करत राहील. नंतर पुन्हा reattach करण्यासाठी खालील कमांड वापरा:

tmux attach -t opencode

तुमचे session, conversation आणि कोणतेही चालू असलेले task जिथे सोडले होते तिथेच राहतील. हे कनेक्शन तुटले तरी सुरक्षित राहते, परंतु server reboot झाल्यावर ते राहू शकत नाही. त्यामुळे reboot नंतर, त्याच पद्धतीने नवीन tmux session सुरू करा.

मॉडेलकडे निर्देश करा

OpenCode हे provider agnostic आहे. हे 75 पेक्षा जास्त providers ला सपोर्ट करण्यासाठी AI SDK आणि Models.dev catalog वापरते. त्यामुळे हे टूल Anthropic, OpenAI, Google आणि स्थानिक (local) servers सह वापरता येते. TUI मधील /connect कमांड हा सर्वात सोपा मार्ग आहे; ही कमांड providers ची यादी देते आणि credentials हाताळते. तुम्ही commit आणि reproduce करू शकतील अशा सेटअपसाठी, project root मध्ये opencode.json ठेवा आणि model provider/model-id म्हणून सेट करा:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-20250514"
}

स्थानिक (local) model त्याच फाईलद्वारे काम करते, कारण कोणताही OpenAI-compatible server provider म्हणून घोषित केला जाऊ शकतो. जर तुम्ही Ollama on the same VPS वापरत असाल, तर config त्याच्या local API कडे निर्देश करते आणि model name तुमच्या सिस्टमवर ollama list जे दाखवते तेच असेल:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": { "baseURL": "http://127.0.0.1:11434/v1" },
      "models": { "your-model-name": { "name": "Local coding model" } }
    }
  }
}

पहिल्या दिवसापासून एक सवय लावून घेणे फायदेशीर ठरते. OpenCode मध्ये दोन agents आहेत जे तुम्ही Tab key वापरून switch करू शकता: Build, जो पूर्ण access असलेला default agent आहे, आणि Plan, जो बदल करण्याची क्षमता (ability to make changes) अक्षम करतो. Plan मध्ये नवीन task सुरू करा, त्याला code वाचू द्या आणि approach सुचवू द्या, आणि जेव्हा तुम्ही plan शी सहमत असाल तेव्हाच Build वर switch करा. Server वर, सुरुवातीचा read-only pass हा एक सुरक्षित उपाय आहे.

Blast radius बद्दलची वास्तव स्थिती

Coding agent ही निष्क्रिय प्रक्रिया नाही, म्हणून ही setup काय करते आणि काय करत नाही हे स्पष्टपणे समजून घ्या. यामध्ये file damage होण्याची शक्यता आहे: opencode user कडे स्वतःचे home directory आणि इतर काहीही नसते, त्यामुळे edits आणि deletions त्याच मर्यादेपर्यंत मर्यादित राहतात. यामध्ये credential exposure चा धोका आहे: key एकाच फाईलमध्ये mode 600 सह, एकाच account मध्ये असते. यामध्ये account काय काय करू शकते याचे नियंत्रण नसते, त्यामुळे जर project directory मध्ये production deploy credentials असतील, तर agent त्यांचा वापर करू शकतो; त्यामुळे असे credentials agent च्या account मधून पूर्णपणे बाहेर ठेवा.

OpenClaw सारख्या gateway agent च्या विरुद्ध, OpenCode हा एक interactive terminal program आहे, daemon नाही. हा कोणताही listening port उघडत नाही आणि यात कोणतीही long-running service नसते, त्यामुळे systemd unit लिहिण्याची किंवा agent साठी firewall port सेट करण्याची गरज नाही. Containment हे user account आणि project directory पर्यंत मर्यादित आहे, म्हणूनच या guide मधील पहिला विभाग सर्वात महत्त्वाचा आहे.

या मर्यादेत असूनही, यावर नेहमीप्रमाणे काळजी घेणे आवश्यक आहे, कारण coding VPS हा एक public server आहे: SSH hardening on a VPS मधीलप्रमाणे root login अक्षम (disabled) असलेला key-only SSH, default-deny firewall आणि नियमित updates आवश्यक आहेत. तसेच, agent जे काही तयार करतो त्याचे पुनरावलोकन करा. code push करण्यापूर्वी त्याचे diffs वाचा, जसे तुम्ही नवीन contributor कडून आलेल्या pull request चे वाचता, कारण शेवटी deployment तुम्हालाच करायचे आहे.

शेवटी, tool नेहमी अपडेटेड ठेवा. OpenCode चे releases वारंवार येतात आणि updates मध्ये महत्त्वाचे fixes असतात, कारण हे program तुमच्या server वर commands चालवते. अपडेट करण्यासाठी त्याच पद्धतीचा वापर करा ज्याने तुम्ही ते इंस्टॉल केले होते: opencode user म्हणून install script पुन्हा चालवा, किंवा जर तुम्ही npm द्वारे इंस्टॉल केले असेल तर sudo npm update -g opencode-ai चालवा, आणि नंतर opencode --version ने नवीन version तपासा. अधूनमधून केलेली थोडीशी maintenance, महिन्यांपूर्वीच्या build ने आधीच fix केलेल्या bug ला debug करण्यापेक्षा स्वस्त पडते.

FAQ

OpenCode मध्ये पेड API ऐवजी लोकल मॉडेल वापरता येते का?

हो. OpenCode कोणत्याही OpenAI-compatible सर्व्हरला प्रोव्हायडर मानतो, त्यामुळे त्याच VPS वर Ollama द्वारे सर्व्ह केले जाणारे मॉडेल वापरता येते: opencode.json मध्ये लोकल baseURL आणि Ollama कडून मिळालेले मॉडेलचे नाव घोषित करा. मुख्य अडचण हार्डवेअरची आहे, कारण कोडिंगसाठी उपयुक्त मॉडेलला मोठ्या मेमरीची आवश्यकता असते; त्यामुळे मॉडेल डाउनलोड करण्यापूर्वी सर्व्हरची क्षमता तपासा.

लॅपटॉप बंद केल्यानंतरही OpenCode चालू ठेवण्यासाठी काय करावे?

VPS वर tmux वापरून ते चालवा. tmux new -s opencode वापरून एका नावाच्या सेशनमध्ये एजंट सुरू करा, Ctrl-b नंतर d दाबून डिटॅच करा; यामुळे SSH कनेक्शन संपल्यानंतरही सेशन सर्व्हरवर चालू राहील. tmux attach -t opencode वापरून तुम्ही कधीही पुन्हा अटॅच करू शकता, ज्यामुळे तुमची चर्चा आणि चालू असलेले टास्क तसेच राहतील. सर्व्हर रीबूट केल्यास सेशन संपते, त्यामुळे रीबूट नंतर नवीन सेशन सुरू करा.

OpenCode ला माझ्या VPS वर कमांड्स चालवण्यास देणे सुरक्षित आहे का?

जर तुम्ही त्यावर नियंत्रण ठेवले तर ते सुरक्षित आहे. OpenCode ला sudo अधिकार नसलेला एक स्वतंत्र unprivileged user द्या, सर्व प्रोजेक्ट्स git मध्ये ठेवा जेणेकरून प्रत्येक बदल रिव्हर्सिबल असेल, API key 600 मोड असलेल्या फाईलमध्ये साठवा, आणि Build agent ला काहीही बदलू देण्यापूर्वी Plan agent वापरून फक्त 'read-only' तपासणी करा. यामुळे एजंट फक्त त्याच्या स्वतःच्या अकाउंटच्या फाईल्समध्ये बदल करू शकेल आणि सर्व्हरचे उर्वरित भाग सुरक्षित राहतील.

OpenCode आणि Claude Code मध्ये काय फरक आहे?

OpenCode हे ओपन सोर्स (MIT) आहे आणि ते 'provider agnostic' आहे; ते एकाच इंटरफेसद्वारे स्थानिक मॉडेल्ससह 75 पेक्षा जास्त मॉडेल प्रोव्हायडरशी कनेक्ट होऊ शकते. Claude Code हे Anthropic चे स्वतःचे टर्मिनल एजंट आहे, जे Anthropic मॉडेल्ससाठी बनवले आहे. जर तुम्हाला अनेक प्रोव्हायडरसाठी एकच टूल हवे असेल, किंवा लोकल मॉडेलसह पूर्णपणे सेल्फ-होस्टेड स्टॅक हवा असेल, तर OpenCode योग्य आहे; दोन्ही टूल्स VPS वर tmux मध्ये आणि समान unprivileged-user सेटअपसह उत्तम चालतात.