OpenCode நிறுவல் மற்றும் OmniProxy உள்ளமைவு

OpenCode என்பது ஒரு ஓப்பன் சோர்ஸ் கோடிங் உதவியாளர், இது டெர்மினல், IDE அல்லது டெஸ்க்டாப் மூலம் குறியீட்டை எழுத உங்களை அனுமதிக்கிறது. இது உங்கள் குறியீட்டையோ அல்லது சூழலையோ சேமிக்காது, இது தனியுரிமை உணர்திறன் கொண்ட புராஜெக்ட்டுகளுக்கு ஏற்றதாக அமைகிறது. build ஒரு புராஜெக்ட்டை மாற்றியமைக்கப் பயன்படுகிறது, அதே சமயம் plan இயல்புநிலையாக வாசிப்புக்கு மட்டுமே (read-only) மற்றும் அறிமுகமில்லாத குறியீட்டைப் புரிந்துகொள்வதற்கும் மாற்றங்களைச் செய்வதற்கு முன் திட்டமிடுவதற்கும் பயனுள்ளதாக இருக்கும். உங்கள் தேவைகளின் அடிப்படையில் நீங்கள் ஒரு மாடல் சேவையைத் தேர்ந்தெடுக்கலாம்.

தொடங்குவதற்கு முன்

நிறுவல் ஸ்கிரிப்ட் எளிதான விருப்பமாகும். உங்களுக்கு நவீன டெர்மினல் தேவை—கட்டளைகளை இயக்கக்கூடிய மற்றும் புராஜெக்ட் கோப்புகளுடன் வேலை செய்யக்கூடிய டெர்மினல் அப்ளிகேஷன்—உதாரணமாக WezTerm, Alacritty, Ghostty அல்லது Kitty. Windows-ல், WSL பரிந்துரைக்கப்படுகிறது. இது Windows-க்குள் அதிக செயல்திறன் மற்றும் செயல்பாட்டுடன் கூடிய Linux சூழலை வழங்குகிறது.

மிக எளிதானது

நிறுவல் ஸ்கிரிப்ட்

• curl opencode.ai/install
• macOS Linux-ல் நேரடியாகப் பயன்படுத்தவும்
• Windows-ல் WSL பரிந்துரைக்கப்படுகிறது

macOS Linux

Homebrew tap

• anomalyco/tap/opencode
• ஃபார்முலாவை விட அடிக்கடி புதுப்பிக்கப்படுகிறது
• Arch-க்கும் ஒரு பேக்கேஜ் கிடைக்கிறது

நேட்டிவ் Windows

பேக்கேஜ் மேனேஜர்

• choco அல்லது scoop
• அல்லது npm மூலம் உலகளவில் நிறுவவும்
• நீங்கள் Releases-லிருந்தும் பதிவிறக்கலாம்

தற்போதைய மாடல் பட்டியலிலிருந்து மாடல் ஐடியையும் தயார் செய்யவும். மாடல் ஐடி என்பது ஒரு குறிப்பிட்ட மாடலைத் துல்லியமாக அடையாளம் காண சேவை பயன்படுத்தும் பெயராகும்.

முதல் முறையாக நிறுவுதல் மற்றும் தொடங்குதல்

மிக எளிதான நிறுவல் கட்டளை இதுதான்:

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

நீங்கள் இந்த நிறுவல் முறைகளில் ஒன்றையும் பயன்படுத்தலாம்:

• Node.js: npm install -g opencode-ai. Bun, pnpm மற்றும் Yarn ஆகியவற்றிற்கும் தொடர்புடைய குளோபல் நிறுவல் கட்டளைகள் உள்ளன; இந்த வழிகாட்டியின் முடிவில் உள்ள அறிமுகப் பக்கத்தைப் பார்க்கவும்.
• macOS மற்றும் Linux-ல் Homebrew: brew install anomalyco/tap/opencode. இந்த tap-ஐப் பயன்படுத்தவும், ஏனெனில் இது Homebrew குழுவால் பராமரிக்கப்படும் brew install opencode-ஐ விட அடிக்கடி புதுப்பிக்கப்படுகிறது.
• Arch Linux: நிலையான வெளியீட்டிற்கு sudo pacman -S opencode-ஐப் பயன்படுத்தவும், அல்லது புதிய பதிப்பிற்கு AUR பேக்கேஜ் opencode-bin-ஐப் பயன்படுத்தவும்.
• Windows: choco install opencode அல்லது scoop install opencode-ஐப் பயன்படுத்தவும். நீங்கள் npm install -g opencode-ai-ஐயும் பயன்படுத்தலாம். பைனரி கோப்புகளை Releases-லிருந்தும் பதிவிறக்கலாம். Windows-ல் Bun மூலம் நிறுவுவதற்கான ஆதரவு இன்னும் செயல்பாட்டில் உள்ளது.

உங்கள் புராஜெக்ட் டைரக்டரியை உள்ளிட்டு, OpenCode-ஐத் தொடங்கவும்:

cd /path/to/project
opencode

முதல்முறை பயன்படுத்தும்போது, நீங்கள் /init-ஐ இயக்கலாம். இது புராஜெக்ட்டை ஆய்வு செய்து புராஜெக்ட் ரூட்டில் AGENTS.md-ஐ உருவாக்குகிறது. இந்த கோப்பை Git-ல் கமிட் செய்யலாம், இதனால் புராஜெக்ட் இந்த வழிமுறைகளைத் தக்கவைத்துக்கொள்ளும்.

OmniProxy-லிருந்து இணைப்பு மதிப்புகளைப் பெறுதல்

baseURL: https://your-omniproxy-origin.example/v1
API Key: <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

baseURL என்பது சேவை முகவரி, API Key என்பது அணுகல் சான்று (access credential), மற்றும் Model ID என்பது மாடலின் முழுப் பெயர்.

/v1/chat/completions-ஐப் பயன்படுத்தும்போது, npm பேக்கேஜை @ai-sdk/openai-compatible-க்கு அமைக்கவும். Chat Completions என்பது ஒரு வகை சாட் கோரிக்கை இடைமுகமாகும். மாடல் /v1/responses-ஐப் பயன்படுத்தும்போது மட்டுமே @ai-sdk/openai-க்கு மாறவும். OmniProxy சாட் கம்ப்ளீஷன்ஸ் எண்ட்-பாயிண்ட் வழியாகப் பயன்படுத்தப்படும்போது, இணக்கத்தன்மை பேக்கேஜை வைத்துக்கொள்ளவும்.

OmniProxy-ன் தற்போதைய பட்டியலிலிருந்து முழு மாடல் ஐடியையும் நகலெடுக்கவும், ஸ்லாஷ்கள் உட்பட. 2026-10-09 நிலவரப்படி, இரண்டு குறிப்பு ஐடிகள் claude-sonnet-5-5 மற்றும் gpt-6-luna ஆகும். gpt-6-luna Chat Completions-ஐ ஆதரிக்கிறது; Chat Completions வழியாக ஃபங்க்ஷன் அழைப்பு reasoning_effort என்பது none ஆக இருக்கும்போது மட்டுமே ஆதரிக்கப்படும். பட்டியலில் இல்லாத ஐடியை நகலெடுக்க வேண்டாம்.

டூல் உள்ளமைவை உள்ளிடுதல்

வழங்குநரை (Provider) OpenCode மாடல் சேவையுடன் இணைக்கப் பயன்படுத்தும் உள்ளமைவு மதிப்புகளின் தொகுப்பாகப் புரிந்துகொள்ளலாம். வழங்குநர் ஆவணங்கள் /connect-ன் கீழ் பட்டியலிடப்படாத OpenAI-இணக்கமான சேவையை ஒரு தனிப்பயன் வழங்குநராகக் கருதுகின்றன. OpenAI-இணக்கமான சேவை அதே கோரிக்கை வடிவத்தைப் பயன்படுத்துகிறது மற்றும் அதே வகை கிளையண்டால் அழைக்கப்படலாம்.

1. OpenCode-ல் /connect-ஐ இயக்கி Other-க்கு ஸ்க்ரோல் செய்யவும்.
2. ஒரு வழங்குநர் ஐடியை உள்ளிடவும். கீழே உள்ள உதாரணம் omniproxy-ஐப் பயன்படுத்துகிறது. நினைவில் கொள்ள எளிதான ஐடியைத் தேர்ந்தெடுக்கவும், ஏனெனில் உள்ளமைவுக் கோப்பில் அதே ஐடியைப் பயன்படுத்த வேண்டும்.
3. OmniProxy API கீயை உள்ளிடவும். இந்த படி சான்றை மட்டுமே சேமிக்கிறது; முகவரி மற்றும் மாடல்கள் இன்னும் opencode.json-ல் சேர்க்கப்பட வேண்டும். சான்று ~/.local/share/opencode/auth.json-ல் சேமிக்கப்படுகிறது.
4. புராஜெக்ட் டைரக்டரியில் opencode.json-ஐ உருவாக்கவும் அல்லது மாற்றவும்:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "omniproxy": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OmniProxy",
      "options": {
        "baseURL": "https://your-omniproxy-origin.example/v1"
      },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "gpt-6-luna": { "name": "GPT-6 Luna" }
      }
    }
  }
}

5. /models-ஐ இயக்கவும். தனிப்பயன் வழங்குநர் மற்றும் அதன் மாடல்கள் பட்டியலில் தோன்றும்.

/connect-ன் கீழ் உள்ளிடப்பட்ட ஐடி opencode.json-ல் உள்ள கீயுடன் பொருந்த வேண்டும். இந்த கோப்பில் உண்மையான ரகசிய கீயை வைக்க வேண்டாம். நீங்கள் /connect-ஐப் பயன்படுத்தவில்லை என்றால், options.apiKey-ல் {env:VARIABLE_NAME} போன்ற என்விரான்மென்ட் வேரியபிள் தொடரியலைப் பயன்படுத்தலாம். OpenCode 1.18.34-உடன் 2026-10-09 அன்று நடந்த சோதனையில், /connect-ஐப் பயன்படுத்தாமல் புராஜெக்ட்டின் options.apiKey-ல் நேரடியாக கீயை வைத்ததும் வெற்றிகரமாக இணைக்கப்பட்டது. Gateway கீயைச் சரிபார்க்கவில்லை என்றால், இந்த மதிப்பு உள்ளூர் கணினியில் மட்டுமே பயன்படுத்தப்படும் பிளேஸ்ஹோல்டர் சரமாக இருக்கலாம். models-ன் கீழ் உள்ள கீகள் பட்டியலிலிருந்து முழுமையான ஐடிகளைப் பயன்படுத்த வேண்டும்.

கீ

/connect

• கீழே Other-ஐத் தேர்ந்தெடுக்கவும்
• உங்கள் சொந்த வழங்குநர் ஐடியைத் தேர்ந்தெடுக்கவும்
• auth.json-ல் சேமிக்கப்படுகிறது

புராஜெக்ட்

opencode.json

• வழங்குநர் கீ அதே பெயரைப் பயன்படுத்த வேண்டும்
• இணக்கமான npm பேக்கேஜைப் பயன்படுத்தவும்
• baseURL /v1-ல் முடிவடைகிறது

தேர்ந்தெடுக்கவும்

/models

• மாடல் பட்டியலில் தோன்றுகிறது
• கேள்வி கேட்பதற்கு முன் ஒன்றைத் தேர்ந்தெடுக்கவும்
• Gateway பட்டியலிலிருந்து ஐடியைப் பயன்படுத்தவும்

உண்மையான பணியைச் சரிபார்க்கவும்

முதலில் புராஜெக்ட் டைரக்டரியிலிருந்து ஒரு உண்மையான பணியை இயக்கவும். மாடல் குறிப்பு வடிவம் Provider ID/model ID; மாடல் ஐடிக்குள் உள்ள ஸ்லாஷ்களைப் பாதுகாக்கவும்:

opencode run --model omniproxy/claude-sonnet-5-5 --auto "Explain what a file you specify does. Do not modify the file."

--auto இந்த இயக்கம் கோப்பு வாசிப்பு கருவிகள் போன்ற கருவிகளைப் பயன்படுத்த அனுமதிக்கிறது. OpenCode 1.18.34-உடன் 2026-10-09 அன்று நடந்த சோதனையில், அது குறிப்பிட்ட கோப்பின் உள்ளடக்கங்களை வெற்றிகரமாக வாசித்தது. முதல் இயக்கத்திற்கு சுமார் இரண்டு நிமிடங்கள் ஆனது.

ஊடாடும் பயன்பாட்டிற்கு (interactive use), opencode-ஐ இயக்கி, பின்னர் /models மூலம் ஒரு மாடலைத் தேர்ந்தெடுக்கவும். கோப்புகளைத் தேட நீங்கள் @-ஐப் பயன்படுத்தலாம். /connect மூலம் சேமிக்கப்பட்ட சான்றை உறுதிப்படுத்த opencode auth list-ஐப் பயன்படுத்தவும், பின்னர் ஆதாரம் மற்றும் மாடல் ஐடியைச் சரிபார்க்க OmniProxy-ன் கோரிக்கை பதிவுகளைப் பார்க்கவும்.

தொடங்குதல்

opencode தொடங்குகிறது

• முதலில் புராஜெக்ட்டுக்கு cd செய்யவும்
• auth பட்டியல் ஐடியைக் காட்டுகிறது
• உள்ளமைவுக் கோப்பு புராஜெக்ட்டில் உள்ளது

பணி

இது குறியீட்டை வாசித்தது

• குறிப்பிட்ட கோப்பைப் பற்றி கேட்கவும்
• அதன் விளக்கத்தை மதிப்பாய்வு செய்யவும்
• தவறாக இருந்தால் /undo-வைப் பயன்படுத்தவும்

பதிவுகள்

Gateway-ல் தெரியும்

• ஆதாரம் OpenCode
• மாடல் ஐடி பொருந்துகிறது
• கீயை கமிட் செய்ய வேண்டாம்

பொதுவான பிழைகள்

• OmniProxy /models-ன் கீழ் தோன்றவில்லை: /connect-ன் கீழ் உள்ளிடப்பட்ட ஐடி opencode.json-ல் உள்ள கீயுடன் பொருந்துகிறதா, npm என்பது @ai-sdk/openai-compatible என்று அமைக்கப்பட்டுள்ளதா, மற்றும் baseURL என்பது /v1-ல் முடிவடைகிறதா என்று சரிபார்க்கவும்.
• சான்று விடுபட்டுள்ளது: opencode auth list-ஐ இயக்கவும். என்விரான்மென்ட் வேரியபிள்களைச் சார்ந்திருக்கும் Bedrock போன்ற வழங்குநர்கள் இங்கே தோன்ற மாட்டார்கள்; /connect வழியாக உள்ளமைக்கப்பட்ட தனிப்பயன் வழங்குநர் தெரிய வேண்டும்.
• Windows செயல்பாடு முழுமையடையவில்லை: WSL-க்குள் நிறுவல் ஸ்கிரிப்டைப் பயன்படுத்தவும்.
• மாடல் ஐடி தவறானது: OmniProxy-ன் தற்போதைய பட்டியலிலிருந்து அதை மீண்டும் நகலெடுத்து models-ன் கீழ் உள்ள தொடர்புடைய கீயைப் புதுப்பிக்கவும்.
• கோரிக்கைகள் தவறான எண்ட்-பாயிண்டிற்குச் செல்கின்றன: சாட் கம்ப்ளீஷன்ஸிற்கு @ai-sdk/openai-compatible-ஐ வைத்துக்கொள்ளுங்கள். OmniProxy-ல் உள்ள அந்த மாடல் உண்மையில் /v1/responses-ஐப் பயன்படுத்தினால் ஒழிய, பதில்கள் இடைமுகத்திற்கான பேக்கேஜை மாற்ற வேண்டாம்.

அதிகாரப்பூர்வ குறிப்புகள்

நிறுவலுக்கு, OpenCode introduction-ஐப் பார்க்கவும். தனிப்பயன் வழங்குநர்களுக்கு, Providers-ஐப் பார்க்கவும். எடுத்துக்காட்டுகளில் பயன்படுத்தப்படும் மாடல் ஐடிகளுக்கு, Claude model overview மற்றும் GPT-6 Luna-ஐப் பார்க்கவும்.

உங்கள் சொந்த OmniProxy அமைப்பிலிருந்து ஒவ்வொரு ஒதுக்கிடத்தையும் மதிப்புகளால் மாற்றவும். உண்மையான திறவுகோலை எங்கும் பகிர வேண்டாம்.

சேமிக்கப்பட்ட விடை அல்லது HTTP 200 மட்டுமே முழு ஏஜெண்ட் பொருத்தத்தை நிரூபிக்காது. OmniProxy-ன் கோரிக்கைப் பதிவில் மூலம் மற்றும் மாதிரியைச் சரிபார்க்கவும்.

அதிகாரப்பூர்வ மூலங்கள் · OpenCode ↗