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 टॅप

• anomalyco/tap/opencode
• फॉर्म्युलापेक्षा अधिक वारंवार अपडेट केले जाते
• Arch साठी देखील एक पॅकेज उपलब्ध आहे

नेटिव्ह Windows

पॅकेज मॅनेजर

• choco किंवा scoop
• किंवा npm सह जागतिक स्तरावर इन्स्टॉल करा
• तुम्ही ते रिलीज (Releases) मधून देखील डाउनलोड करू शकता

सध्याच्या मॉडेल यादीतून मॉडेल ID देखील तयार ठेवा. मॉडेल ID हे असे नाव आहे जे सेवा विशिष्ट मॉडेल अचूकपणे ओळखण्यासाठी वापरते.

पहिल्यांदा इन्स्टॉल आणि लाँच करा

सर्वात सोपी इन्स्टॉलेशन कमांड आहे:

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. या टॅपचा वापर करा कारण तो brew install opencodeपेक्षा अधिक वारंवार अपडेट केला जातो, जो Homebrew टीमद्वारे राखला जातो.
• 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. चॅट कंप्लीशन्स हा चॅट विनंती इंटरफेसचा एक प्रकार आहे. स्विच करा @ai-sdk/openai फक्त तेव्हाच जेव्हा मॉडेल वापरते /v1/responses. जेव्हा OmniProxy चॅट कंप्लीशन्स एंडपॉईंटद्वारे वापरले जाते, तेव्हा सुसंगतता पॅकेज ठेवा.

OmniProxy च्या सध्याच्या यादीतून संपूर्ण मॉडेल ID कॉपी करा, कोणत्याही स्लॅशसह. 2026-10-09 पर्यंत, दोन संदर्भ ID होते claude-sonnet-5-5 आणि gpt-6-luna. gpt-6-luna चॅट कंप्लीशन्सना सपोर्ट करते; चॅट कंप्लीशन्सद्वारे फंक्शन कॉलिंग तेव्हाच सपोर्ट केले जाते जेव्हा reasoning_effort आहे none. यादीमध्ये नसलेला ID कॉपी करू नका.

टूल कॉन्फिगरेशन प्रविष्ट करा

प्रदाता (Provider) म्हणजे कॉन्फिगरेशन व्हॅल्यूजचा एक संच जो OpenCode मॉडेल सेवेशी कनेक्ट करण्यासाठी वापरतो. प्रदाता दस्तऐवजीकरण अशा OpenAI-सुसंगत सेवेला वागवते जी खाली सूचीबद्ध नाही /connect एक सानुकूल प्रदाता म्हणून. OpenAI-सुसंगत सेवा समान विनंती फॉरमॅट वापरते आणि त्याच प्रकारच्या क्लायंटद्वारे कॉल केली जाऊ शकते.

1. चालवा /connect OpenCode मध्ये आणि Other वर स्क्रोल करा.
2. एक प्रदाता ID प्रविष्ट करा. खालील उदाहरण वापरते omniproxy. लक्षात ठेवण्यास सोपा असा ID निवडा कारण तुम्हाला कॉन्फिगरेशन फाईलमध्ये तोच वापरावा लागेल.
3. OmniProxy API की (key) प्रविष्ट करा. ही पायरी फक्त क्रेडेंशियल सेव्ह करते; पत्ता आणि मॉडेल्स अजूनही जोडले जाणे आवश्यक आहे opencode.json. क्रेडेंशियल येथे साठवले जाते ~/.local/share/opencode/auth.json. तयार करा किंवा सुधारित करा 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. सानुकूल प्रदाता आणि त्याची मॉडेल्स यादीमध्ये दिसतील.

अंतर्गत प्रविष्ट केलेला ID /connect मधील की (key) शी जुळला पाहिजे opencode.json. या फाईलमध्ये खरी गुप्त की (key) ठेवू नका. जर तुम्ही वापरत नसाल /connect, तुम्ही एन्वायरमेंट-व्हेरिएबल सिंटॅक्स वापरू शकता options.apiKey, जसे की {env:VARIABLE_NAME}. OpenCode 1.18.34 सह 2026-10-09 रोजी केलेल्या चाचणीमध्ये, की (key) थेट प्रोजेक्टच्या options.apiKey मध्ये टाकल्याने /connect वापरल्याशिवाय देखील यशस्वीरित्या कनेक्ट झाले. जर गेटवे की (key) सत्यापित करत नसेल, तर ही व्हॅल्यू स्थानिक मशीनवर वापरली जाणारी प्लेसहोल्डर स्ट्रिंग असू शकते. अंतर्गत की (key) models यादीतील पूर्ण ID वापरणे आवश्यक आहे.

की (key)

/connect

• तळाशी Other निवडा
• तुमचा स्वतःचा प्रदाता ID निवडा
• auth.json मध्ये साठवले आहे

प्रोजेक्ट

opencode.json

• प्रदाता की (key) ने समान नाव वापरले पाहिजे
• सुसंगत npm पॅकेज वापरा
• baseURL /v1 ने संपते

निवडा

/models

• मॉडेल यादीमध्ये दिसते
• प्रश्न विचारण्यापूर्वी एक निवडा
• गेटवे यादीतील ID वापरा

वास्तविक कार्यासह सत्यापित करा

प्रथम प्रोजेक्ट डिरेक्टरीमधून एक वास्तविक कार्य चालवा. मॉडेल संदर्भ फॉरमॅट आहे Provider ID/model ID; मॉडेल 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. तुम्ही वापरू शकता @ फाईल्स शोधण्यासाठी. वापरा opencode auth list द्वारे सेव्ह केलेले क्रेडेंशियल पुष्टी करण्यासाठी /connect, त्यानंतर स्रोत आणि मॉडेल ID सत्यापित करण्यासाठी OmniProxy च्या विनंती नोंदी तपासा.

लाँच

opencode लाँच होते

• प्रथम फोल्डरमध्ये cd करा
• auth list ID दर्शवते
• कॉन्फिगरेशन फाईल प्रोजेक्टमध्ये आहे

कार्य

त्याने कोड वाचला

• विशिष्ट फाईलबद्दल विचारा
• त्याचे स्पष्टीकरण पुनरावलोकन करा
• जर ते चुकीचे असेल तर /undo वापरा

लॉग्स

गेटवेमध्ये दृश्यमान

• स्रोत OpenCode आहे
• मॉडेल ID जुळते
• की (key) कमिट करू नका

सामान्य त्रुटी

• OmniProxy अंतर्गत दिसत नाही /models: तपासा की अंतर्गत प्रविष्ट केलेला ID /connect मधील की (key) शी जुळतो opencode.json, की npm सेट केले आहे @ai-sdk/openai-compatible, आणि की baseURL सह संपते /v1.
• क्रेडेंशियल गहाळ आहे: चालवा opencode auth list. Bedrock सारखे प्रदाते जे एन्वायरमेंट व्हेरिएबल्सवर अवलंबून असतात ते येथे दिसत नाहीत; द्वारे कॉन्फिगर केलेला सानुकूल प्रदाता /connect दृश्यमान असावा.
• Windows कार्यक्षमता अपूर्ण आहे: त्याऐवजी WSL मध्ये इन्स्टॉलेशन स्क्रिप्ट वापरा.
• मॉडेल ID अवैध आहे: OmniProxy च्या सध्याच्या यादीतून ते पुन्हा कॉपी करा आणि संबंधित की (key) अपडेट करा models.
• विनंत्या चुकीच्या एंडपॉईंटवर जात आहेत: ठेवा @ai-sdk/openai-compatible चॅट कंप्लीशन्ससाठी. रिस्पॉन्स इंटरफेससाठी पॅकेज बदलू नका जोपर्यंत OmniProxy वरील ते मॉडेल खरोखर वापरत नाही /v1/responses.

अधिकृत संदर्भ

इन्स्टॉलेशनसाठी, पहा OpenCode introduction. सानुकूल प्रदात्यांसाठी, पहा Providers. उदाहरणांमध्ये वापरलेल्या मॉडेल ID साठी, पहा Claude model overview आणि GPT-6 Luna.

तुमच्या स्वतःच्या OmniProxy कॉन्फिगरेशनमधील मूल्ये वापरून प्रत्येक प्लेसहोल्डर बदला. वास्तविक की कधीही प्रकाशित करू नका.

सेव्ह केलेला निकाल किंवा HTTP 200 फक्त पूर्ण एजंट सुसंगतता सिद्ध करत नाही. OmniProxy च्या कॉल रेकॉर्डमध्ये स्रोत आणि मॉडेल तपासा.

अधिकृत स्रोत · OpenCode ↗