VPS-ல் OpenCode எப்படி install செய்து இயக்குவது

OpenCode என்றால் என்ன, மற்றும் நீங்கள் என்ன அமைக்கப் போகிறீர்கள்

OpenCode என்பது terminal-க்காக உருவாக்கப்பட்ட திறந்த மூல AI coding agent ஆகும். நீங்கள் ஒரு project directory-க்குள் இதைத் தொடங்குவீர்கள். உங்கள் குறியீட்டை இது படிக்கும். மாற்றங்களைப் பரிந்துரைக்கும். files-ஐத் திருத்தும். commands-ஐ இயக்கும். இவை அனைத்தும் ஒரு terminal user interface (TUI) வழியாக நிகழும். இது MIT உரிமம் பெற்றது. 75-க்கும் மேற்பட்ட model providers உடன் இணைகிறது. 2026 நடுப்பகுதியின்படி ஏறக்குறைய 165,000 GitHub stars கொண்டுள்ளது. எனவே இதுவே அதிக நட்சத்திரங்கள் பெற்ற திறந்த மூல coding agent ஆகும். ஒரு VPS-ல் OpenCode-ஐ இயக்க, நீங்கள் ஒரு பிரத்யேக unprivileged user-க்கு கீழ் இதை நிறுவுவீர்கள். உங்கள் model API key-ஐ ஒரு தனிப்பட்ட file-ல் வைப்பீர்கள். உங்கள் இணைப்பு துண்டிக்கப்பட்டாலும் session தொடர, tmux-க்குள் இதைத் தொடங்குவீர்கள். இந்த வழிகாட்டி இதையே, இதே வரிசையில் செய்கிறது.

குழப்பத்தைத் தவிர்க்க ஒரு பெயரிடல் குறிப்பு உதவும். அதிகாரப்பூர்வ repository என்பது anomalyco/opencode ஆகும். இதை Anomaly team (முன்பு SST என அறியப்பட்டது) பராமரிக்கிறது. இந்த project முன்பு sst/opencode-ல் இருந்தது. GitHub-ல் opencode-ai/opencode என்ற பெயரில் ஒரு பழைய, தொடர்பற்ற repository உள்ளது. எனவே நீங்கள் சரியான project-ன் docs-ஐ படிக்கிறீர்களா என சரிபார்க்கவும். அதிகாரப்பூர்வ தளம் opencode.ai ஆகும்.

OpenCode-ஐ ஒரு VPS-ல் ஏன் இயக்க வேண்டும்

ஒரு coding agent அமர்வு நீண்ட நேரம் நடக்கும். ஒரு refactor அல்லது test suite-ஐ OpenCode பல நிமிடங்கள் செலவிடும். உங்கள் மடிக்கணினியில் அது இயங்கினால், lid மூடினாலோ Wi-Fi இணைப்பு துண்டிக்கப்பட்டாலோ பணி நடுவே அமர்வு முடிந்துவிடும். tmux-க்குள் ஒரு VPS-ல் இயங்கினால், நீங்கள் துண்டித்த பிறகும் agent தொடர்ந்து வேலை செய்யும். பிறகு நீங்கள் மீண்டும் இணைந்து அது என்ன செய்தது என்பதைப் படிக்கலாம். இது tmux உடன் ஒரு VPS-ல் Claude Code-ஐ இயக்குவது போன்ற அதே முறை. ஒரு agent-ஐ உங்கள் மடிக்கணினியிலிருந்து மாற்றுவதால் கிடைக்கும் மிகப்பெரிய நன்மை இதுவே.

இரண்டாவது காரணம் இடமச்சம். ஒரு VPS உங்கள் deploy செய்யும் code-க்கு அருகில் இருக்கும். repository, build tools, test database, மற்றும் staging environment பெரும்பாலும் ஏற்கனவே அங்கோ அதற்கு அருகிலோ இருக்கும். code-ஐ திருத்தி test-களை இயக்கும் ஒரு agent, அந்த test-கள் உண்மையில் இயங்கும் கணினியில் சிறப்பாக வேலை செய்யும். அந்த பெட்டி உங்கள் கட்டுப்பாட்டில் உள்ள ஒரு server என்பதால், நீங்கள் வேண்டுமென்றே agent-க்கு ஒரு தனிப்பட்ட சூழலைக் கொடுக்க முடியும். அடுத்த பிரிவு அதைச் செய்கிறது.

நீங்கள் இன்னும் ஒரு கருவியைத் தேர்ந்தெடுத்துக் கொண்டிருந்தால், ஒரு VPS-ல் coding AI agent-ஐ இயக்குவது Aider மற்றும் Goose உட்பட பரந்த துறையை ஒப்பிடுகிறது.

OpenCode-க்கு ஒரு தனிப் பயனரை ஒதுக்கவும்

உண்மையான தொடக்கம் இதுதான்: ஒரு கோடிங் ஏஜென்ட் கோப்புகளைத் திருத்துகிறது; கட்டளைகளை இயக்குகிறது. இதுதான் அதன் வேலை. இதுவே ஆபத்தும் கூட. OpenCode பில்டுகள், டெஸ்டுகள், மற்றும் பணிக்குத் தேவைப்படும் எந்த shell கட்டளையையும் இயக்கும். மாதிரியின் தீர்ப்பு நல்லது, ஆனால் குறைகள் இல்லை என்று சொல்ல முடியாது. ஏஜென்ட் எந்தக் கணக்கில் இயங்குகிறதோ, அதுதான் ஒரு தவறான கட்டளை எவ்வளவு பாதிப்பை ஏற்படுத்த முடியும் என்பதற்கான உச்சவரம்பு. எனவே இதை root ஆக இயக்க வேண்டாம். சர்வரை நிர்வகிக்கும் பயனராகவும் இதை இயக்க வேண்டாம்.

பின்னணி ஏஜென்டைப் போல் அல்லாமல், OpenCode ஊடாடும் முறையில் இயங்குகிறது. எனவே அதற்கு ஒரு உண்மையான shell மற்றும் ஒரு home டைரக்டரி தேவை:

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

ஏஜென்ட் வேலை செய்ய வேண்டிய பிராஜெக்டுகளை /home/opencode கீழ் வைக்கவும். அந்தப் பயனரால்தான் அவற்றை clone செய்ய வேண்டும். இந்தக் கணக்கிற்கு sudo உரிமைகள் எதுவும் தர வேண்டாம். ஏஜென்ட் ஒரு அழிவுதரும் கட்டளையை இயக்கினால், அது இந்த ஒரு கணக்கிற்குச் சொந்தமானவற்றை மட்டுமே அழிக்க முடியும். இது சேவைகளை அதிகாரமற்ற பயனராக இயக்குவது என்பதற்கான அதே காரணம். மேலும் ஒரு git ரெப்போசிடரிக்குள் வேலை செய்யவும். ஏனெனில் ஒரு ரெப்போசிடரி எந்தத் தவறான திருத்தத்தையும் இழப்பாக மாற்றாமல் ஒரு git revert ஆக மாற்றும்.

OpenCode-ஐ நிறுவுதல்

இந்தத் திட்டம் இரண்டு நிறுவல் முறைகளை ஆவணப்படுத்துகிறது. நிறுவல் ஸ்கிரிப்ட் மிக விரைவானது. அதை opencode பயனராக இயக்கினால், அனைத்தும் அந்தப் பயனரின் முகப்பு அடைவிற்குள்ளேயே இருக்கும்:

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

வழக்கமான curl | bash பழக்கம் இங்கும் பொருந்தும்: முக்கியமான சேவையகத்தில் முதலில் ஸ்கிரிப்டைப் பதிவிறக்கவும், படிக்கவும், பிறகு இயக்கவும். நிறுவலுக்குப் பிறகு, நிறுவி செய்யும் PATH மாற்றம் நடைமுறைக்கு வர, புதிய shell தொடங்கவும். பின்னர் binary பதிலளிக்கிறதா எனச் சரிபார்க்கவும்:

opencode --version

நீங்கள் package manager-ஐ விரும்பினால், Node.js ஏற்கனவே இயந்திரத்தில் இருந்தால், npm வழி அதே கருவியை முழு அமைப்பிலும் நிறுவுகிறது. இது ஒவ்வொரு பயனருக்கும் PATH-இல் opencode binary-ஐ வைக்கிறது:

sudo npm install -g opencode-ai

எப்படி நிறுவினாலும், சரிபார்ப்பு ஒன்றே: opencode --version ஒரு version எண்ணை அச்சிடுகிறது. ஸ்கிரிப்ட் நிறுவலுக்குப் பிறகு command not found வந்தால், தற்போதைய shell இன்னும் புதுப்பிக்கப்பட்ட PATH-ஐ படிக்கவில்லை எனப் பொருள். எனவே opencode பயராக வெளியேறி மீண்டும் உள்நுழையவும்.

API விசையை ஒரு தனிப்பட்ட கோப்பில் வைக்கவும்

OpenCode-க்கு நீங்கள் பயன்படுத்தும் மாதிரி வழங்குநருக்கான விசை தேவை. அந்த விசை உங்கள் பணத்தைச் செலவிடக்கூடும். எனவே அதை கடவுச்சொல்லைப் போல கையாளுங்கள். opencode பயனர் மட்டுமே படிக்கக்கூடிய ஒரு கோப்பை உருவாக்குங்கள். அதன் அனுமதி நிலை 600 ஆக இருக்கட்டும். விசையை அதில் வையுங்கள். கட்டளைகளில் நேரடியாக தட்டச்சு செய்ய வேண்டாம். அப்படி செய்தால் அது உங்கள் shell வரலாற்றில் சேமிக்கப்படும்:

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

உங்கள் வழங்குநரின் மாறியை அதில் வையுங்கள். உதாரணமாக ANTHROPIC_API_KEY=... அல்லது உங்கள் வழங்குநருக்கான நிகரான மாறியைச் சேர்க்கவும். OpenCode தரப்படுத்தப்பட்ட வழங்குநர் சூழல் மாறிகளைத் தானாகவே எடுத்துக்கொள்ளும். முகவரைத் தொடங்குவதற்கு முன், இந்தக் கோப்பை உங்கள் shell-இல் ஏற்றவும்:

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

OpenCode-க்கு ஒரு ஊடாடும் மாற்று வழியும் உள்ளது. TUI-க்குள் உள்ள /connect கட்டளை ஒரு வழங்குநரைச் சேர்ப்பதற்கான படிகளை வழிநடத்தும். சான்றளவை பயனரின் முகப்பு அடைவில் ~/.local/share/opencode/auth.json-இல் சேமிக்கும். நீங்கள் அந்த வழியைப் பயன்படுத்தினால், chmod 600 ~/.local/share/opencode/auth.json கொண்டு அந்தக் கோப்பு தனிப்பட்டதாக இருப்பதை உறுதிப்படுத்திக் கொள்ளுங்கள். இரண்டு வழிகளுமே விசையை உங்கள் கட்டளை வரிகளுக்கு வெளியே வைக்கின்றன. ஒன்றைத் தேர்ந்தெடுத்து அதிலேயே தொடர்ந்திருங்கள்.

tmux க்குள் OpenCode-ஐ தொடங்கு

tmux தான் VPS அமைப்பை பயனுள்ளதாக ஆக்குகிறது. ஏனெனில் உங்கள் SSH இணைப்பு துண்டிக்கப்பட்டாலும் tmux அமர்வு தொடர்ந்து இயங்கும். ஒரு அமர்வை தொடங்குங்கள். உங்கள் திட்டக் கோப்புறைக்குள் செல்லுங்கள். பின்னர் முகவரை தொடங்குங்கள்:

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

TUI திறக்கப்பட்டிருப்பதைக் காண்பீர்கள். அதன் அடிப்பகுதியில் ஒரு கட்டளை வரி இருக்கும். இடைமுகத்தில் உங்கள் திட்டத்தின் பெயர் காட்டப்பட்டிருக்கும். சாதாரண மொழியில் ஒரு பணியைக் கொடுங்கள். அது கோப்புகளைப் படித்து மாற்றங்களை முன்மொழியத் தொடங்கும். வெளியேற விரும்பும்போது, Ctrl-b பின்னர் d அழுத்தி அமர்வைப் பிரிக்கவும். உங்கள் மடிக்கணினி மூடப்பட்டிருந்தாலும் முகவர் தொடர்ந்து வேலை செய்யும். பின்னர் மீண்டும் இணைக்க இதைப் பயன்படுத்தவும்:

tmux attach -t opencode

அமர்வு, உரையாடல் மற்றும் இயங்கிக் கொண்டிருக்கும் எந்தப் பணியும் நீங்கள் விட்டுச் சென்ற இடத்திலேயே இருக்கும். இது இணைப்பு துண்டிப்பைத் தாங்குகிறது. ஆனால் சேவையக மறுதொடக்கத்தைத் தாங்காது. எனவே மறுதொடக்கத்திற்குப் பிறகு நீங்கள் அதே முறையில் ஒரு புதிய tmux அமர்வைத் தொடங்கவும்.

ஒரு மாதிரியை குறிவைக்கவும்

OpenCode என்பது provider-ஐப் பொறுத்ததல்ல. இது AI SDK மற்றும் Models.dev பட்டியலைப் பயன்படுத்தி 75-க்கும் மேற்பட்ட provider-களை ஆதரிக்கிறது. எனவே Anthropic, OpenAI, Google மற்றும் உள்ளமை சேவையகங்கள் உட்பட பல நிறுவனங்களுக்கும் இதே கருவி செயல்படுகிறது. விரைவான வழி TUI-க்குள் உள்ள /connect கட்டளையாகும். இது provider-களை பட்டியலிடுகிறது மற்றும் நற்சான்றிதழ்களை கையாள்கிறது. நீங்கள் commit செய்து மீண்டும் உருவாக்கக்கூடிய ஒரு அமைப்பிற்கு, project root-ல் ஒரு opencode.json வைத்து, மாதிரியை provider/model-id என அமைக்கவும்:

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

உள்ளமை மாதிரி இதே கோப்பின் வழியாக செயல்படுகிறது. ஏனெனில் OpenAI-உடன் இணக்கமான எந்த சேவையகத்தையும் ஒரு provider-ஆக அறிவிக்கலாம். நீங்கள் ஒரு மாதிரியை அதே VPS-ல் Ollama வழியாக வழங்கினால், config அதன் உள்ளமை API-ஐ குறிவைக்கிறது. மாதிரியின் பெயர் உங்கள் கணினியில் 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 இரண்டு agent-களை வழங்குகிறது. நீங்கள் Tab விசையால் இவற்றுக்கு இடையே மாறலாம்: Build, முழு அணுகலுடன் கூடிய இயல்புநிலை agent, மற்றும் Plan, மாற்றங்களைச் செய்யும் திறனை முடக்கும் agent. ஒரு புதிய பணியை Plan-ல் தொடங்கவும். அது குறியீட்டைப் படித்து ஒரு அணுகுமுறையை முன்மொழியட்டும். நீங்கள் திட்டத்துடன் உடன்படும்போது மட்டுமே Build-க்கு மாறவும். ஒரு சேவையகத்தில், படிப்பதற்கு மட்டுமான முதல் சுற்று ஒரு மலிவான பாதுகாப்பு ஆகும்.

தாக்குதல் பரப்பு, நேர்மையாக

ஒரு குறியீட்டு முகவர் செயலற்றது அல்ல. எனவே, இந்த அமைப்பு எதைக் கொண்டிருக்கிறது மற்றும் எதைக் கொண்டிருக்கவில்லை என்பதை வெளிப்படையாகக் கூறுங்கள். இது கோப்பு சேதத்தைக் கொண்டிருக்கிறது: opencode பயனர் அதன் சொந்த இல்லத்தை மட்டுமே வைத்திருக்கிறார்; வேறு எதையும் வைத்திருக்கவில்லாததால், திருத்தங்களும் நீக்கங்களும் அந்த எல்லையிலேயே நிற்கின்றன. இது நற்பெயர் வெளிப்பாட்டைக் கொண்டிருக்கிறது: விசை ஒரே ஒரு கணக்கில், mode 600 உடன் ஒரே ஒரு கோப்பில் இருக்கிறது. இந்தக் கணக்கு நியாயமாக என்ன செய்ய முடியும் என்பதை இது கொண்டிருக்கவில்லை. எனவே, திட்ட அடைவு உற்பத்தி பயன்பாட்டுச் சான்றுகளைக் கொண்டிருந்தால், முகவர் அவற்றைப் பயன்படுத்த முடியும்; அவற்றை முகவரின் கணக்கிலிருந்து முற்றிலும் வெளியே வையுங்கள்.

OpenClaw போன்ற நுழைவாயில் முகவரைப் போலல்லாமல், OpenCode என்பது ஒரு தொடர்பு முனைய நிரலாகும்; இது ஒரு daemon அல்ல. இது எந்தக் கேட்கும் துறையையும் திறக்காது. நீண்ட நேரம் இயங்கும் சேவை எதையும் கொண்டிருக்காது. எனவே, முகவருக்காக எழுத systemd unit எதுவும் இல்லை; தடுப்புச் சுவருக்காக அமைக்க துறை எதுவும் இல்லை. கட்டுப்பாடு என்பது பயனர் கணக்கு மற்றும் திட்ட அடைவு ஆகியவையே. இதனால்தான் இந்த வழிகாட்டியின் முதல் பிரிவு மிக முக்கியமானது.

இதைச் சுற்றியுள்ள பெட்டிக்கும் நிலையான கவனிப்பு தேவை. ஏனெனில் ஒரு குறியீட்டு VPS என்பதும் ஒரு பொதுச் சேவையகமே: root உள்நுழைவு முடக்கப்பட்ட விசை மட்டுமே SSH, ஒரு VPS-இல் SSH வலுவூட்டல் போன்றது, இயல்புநிலை-மறுப்பு தடுப்புச் சுவர், மற்றும் வழக்கமான புதுப்பிப்புகள். மேலும், முகவர் உருவாக்குவதை மதிப்பாய்வு செய்யுங்கள். நீங்கள் அவற்றைச் செலுத்தும் முன் அதன் diff-களைப் படியுங்கள். ஒரு புதிய பங்களிப்பாளரிடமிருந்து வரும் pull request-ஐ நீங்கள் படிப்பதைப் போலவே, ஏனெனில் விளைவைப் பயன்பாட்டிற்கு கொண்டு செல்பவர் நீங்களே.

இறுதியாக, கருவியை நடப்பில் வையுங்கள். OpenCode அடிக்கடி வெளியீடுகளைக் கொண்டிருக்கிறது. உங்கள் சேவையகத்தில் கட்டளைகளை இயக்கும் நிரலுக்கு முக்கியமான திருத்தங்களை புதுப்பிப்புகள் கொண்டு வருகின்றன. புதுப்பித்தல் நீங்கள் நிறுவிய அதே வழியைப் பயன்படுத்துகிறது: opencode பயனராக நிறுவல் சுருளை மீண்டும் இயக்கவும், அல்லது npm மூலம் நிறுவியிருந்தால் sudo npm update -g opencode-ai-ஐ இயக்கவும், பிறகு புதிய பதிப்பை opencode --version மூலம் உறுதிப்படுத்தவும். இப்போதும் இதற்கும் ஒரு நிமிடம் பராமரிப்பு செய்வது, பல மாதங்கள் பழைய கட்டமைப்பு ஏற்கனவே திருத்திய நடத்தையை வழுநீக்கம் செய்வதை விட எளிதானது.

FAQ

OpenCode கட்டண APIக்கு பதிலாக உள்ளூர் மாதிரியைப் பயன்படுத்த முடியுமா?

ஆம். OpenCode எந்த ஒரு OpenAI-இணக்க சேவையகத்தையும் ஒரு provider ஆகக் கருதுகிறது. எனவே அதே VPS-இல் Ollama வழங்கும் மாதிரி செயல்படும்: opencode.json-இல் உள்ளூர் baseURL மற்றும் Ollama தரும் மாதிரியின் பெயருடன் அந்த provider-ஐ அறிவிக்கவும். இங்கே தடை வன்பொருள் தான். நிஜ குறியீட்டு வேலைக்கு ஏற்ற மாதிரிக்கு அதிக நினைவகம் தேவை. எனவே மாதிரியைப் பதிவிறக்குவதற்கு முன், மாதிரிக்கு ஏற்றவாறு சேவையகத்தின் அளவை தீர்மானிக்கவும்.

என் மடிக்கணினியை மூடிய பிறகும் OpenCode-ஐ இயங்கும்படி எப்படி வைப்பது?

VPS-இல் tmux-க்குள் அதை இயக்கவும். tmux new -s opencode கொண்டு பெயரிடப்பட்ட ஒரு session-இல் agent-ஐ தொடங்கவும். Ctrl-b உடன் d அழுத்தி detach செய்யவும். உங்கள் SSH இணைப்பு முடிந்த பிறகும் சேவையகத்தில் அந்த session தொடர்ந்து இயங்கும். tmux attach -t opencode கொண்டு எப்போது வேண்டுமானாலும் மீண்டும் இணைக்கலாம். உரையாடலும் இயங்கும் எந்தப் பணியும் அப்படியே இருக்கும். சேவையகம் மறுதொடக்கம் செய்யப்பட்டால் session முடிந்துவிடும். எனவே மறுதொடக்கத்திற்கு பிறகு புதியதை தொடங்கவும்.

என் VPS-இல் OpenCode கட்டளைகளை இயக்க அனுமதிப்பது பாதுகாப்பானதா?

நீங்கள் அதை கட்டுப்பாட்டிற்குள் வைத்தால் பாதுகாப்பானது. OpenCode-க்கு sudo இல்லாத ஒரு சிறப்பு இல்லாத பயனரை கொடுக்கவும். ஒவ்வொரு திருத்தத்தையும் மீளமுடியக்கூடியதாக மாற்ற அதன் திட்டங்களை git-இல் வைக்கவும். API key-ஐ 600 mode கொண்ட கோப்பில் சேமிக்கவும். Build agent எதையாவது மாற்றுவதற்கு முன், அதன் Plan agent-ஐ பயன்படுத்தி முதலில் read-only பார்வையிடவும். பிறகு agent அதன் சொந்த கணக்கு சொந்தமானவற்றை மட்டுமே சேதப்படுத்த முடியும். சேவையகத்தின் மீதமுள்ள பகுதிகள் பாதுகாப்பாக இருக்கும்.

OpenCode மற்றும் Claude Code இடையே உள்ள வேறுபாடு என்ன?

OpenCode திறந்த மூல (MIT) ஆகும். இது provider-களைப் பொறுத்ததல்ல. ஒரே இடைமுகம் வழியாக உள்ளூர் மாதிரிகள் உட்பட 75-க்கும் மேற்பட்ட model provider-களுடன் இணைகிறது. Claude Code என்பது Anthropic-இன் சொந்த terminal agent ஆகும். இது Anthropic-இன் மாதிரிகளை மையமாகக் கொண்டு கட்டப்பட்டது. பல provider-களுக்கு ஒரே கருவி வேண்டும் என்றாலோ, அல்லது உள்ளூர் மாதிரியுடன் முழுமையாக self-hosted stack வேண்டும் என்றாலோ, OpenCode பொருத்தமானது. இரண்டும் ஒரே இல்லாத பயனர் அமைப்புடன் VPS-இல் tmux-க்குள் நன்றாக இயங்கும்.