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

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

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

நிறுவல் ஸ்கிரிப்ட் எளிதான விருப்பமாகும். உங்களுக்கு நவீன டெர்மினல் தேவை—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 என்பது அணுகல் சான்றாகும், மற்றும் Model ID என்பது மாடலின் முழுப் பெயராகும்.

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

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} போன்ற சூழல்-மாறி தொடரியலைப் (environment-variable syntax) பயன்படுத்தலாம். OpenCode 1.18.34 உடன் 2026-10-09 அன்று சோதனையில், /connect-ஐப் பயன்படுத்தாமல் திட்டத்தின் options.apiKey-ல் விசையை நேரடியாக வைத்ததும் வெற்றிகரமாக இணைக்கப்பட்டது. Gateway விசையைச் சரிபார்க்கவில்லை என்றால், இந்த மதிப்பு உள்ளூர் கணினியில் மட்டுமே பயன்படுத்தப்படும் பிளேஸ்ஹோல்டர் சரமாக இருக்கலாம். models-ன் கீழ் உள்ள விசைகள் பட்டியலிலிருந்து முழுமையான ஐடிகளைப் பயன்படுத்த வேண்டும்.

விசை (Key)

/connect

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

திட்டம் (Project)

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 அன்று சோதனையில், அது குறிப்பிட்ட கோப்பின் உள்ளடக்கங்களை வெற்றிகரமாக வாசித்தது. முதல் இயக்கத்திற்கு சுமார் இரண்டு நிமிடங்கள் ஆனது.

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

தொடங்குதல் (Launch)

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

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

பணி

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

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

பதிவுகள் (Logs)

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 ↗