समस्या निवारण

सामान्य समस्याएँ और उन्हें कैसे हल करें।

OpenCode की समस्याओं को डीबग करने के लिए, डिस्क पर संग्रहीत लॉग और स्थानीय डेटा की जाँच करके शुरू करें।

लॉग

लॉग फ़ाइलें यहाँ लिखी जाती हैं:

macOS/Linux : ~/.local/share/opencode/log/
Windows : WIN+R दबाएँ और %USERPROFILE%\.local\share\opencode\log पेस्ट करें

लॉग फ़ाइलों को टाइमस्टैम्प के साथ नाम दिया जाता है (जैसे, 2025-01-09T123456.log) और सबसे हाल की 10 लॉग फ़ाइलें रखी जाती हैं।

अधिक विस्तृत डीबग जानकारी प्राप्त करने के लिए आप --log-level कमांड-लाइन विकल्प के साथ लॉग स्तर सेट कर सकते हैं। उदाहरण के लिए, opencode --log-level DEBUG।

स्टोरेज

opencode सत्र डेटा और अन्य एप्लिकेशन डेटा को डिस्क पर यहाँ संग्रहीत करता है:

macOS/Linux : ~/.local/share/opencode/
Windows : WIN+R दबाएँ और %USERPROFILE%\.local\share\opencode पेस्ट करें

इस डायरेक्टरी में शामिल हैं:

auth.json - प्रमाणीकरण डेटा जैसे API कुंजियाँ, OAuth टोकन
log/ - एप्लिकेशन लॉग
project/ - प्रोजेक्ट-विशिष्ट डेटा जैसे सत्र और संदेश डेटा
- यदि प्रोजेक्ट Git रेपो के भीतर है, तो इसे ./<project-slug>/storage/ में संग्रहीत किया जाता है
- यदि यह Git रेपो नहीं है, तो इसे ./global/storage/ में संग्रहीत किया जाता है

डेस्कटॉप ऐप

OpenCode Desktop पृष्ठभूमि में एक स्थानीय OpenCode सर्वर (opencode-cli साइडकार) चलाता है। अधिकांश समस्याएँ किसी गलत व्यवहार वाले प्लगइन, दूषित कैश, या खराब सर्वर सेटिंग के कारण होती हैं।

त्वरित जाँच

ऐप को पूरी तरह से क्विट करें और पुनः लॉन्च करें।
यदि ऐप कोई त्रुटि स्क्रीन दिखाता है, तो Restart पर क्लिक करें और त्रुटि विवरण कॉपी करें।
केवल macOS: OpenCode मेनू -> Reload Webview (यदि UI खाली/फ्रोज़न है तो मदद करता है)।

प्लगइन अक्षम करें

यदि डेस्कटॉप ऐप लॉन्च पर क्रैश हो रहा है, हैंग हो रहा है, या अजीब व्यवहार कर रहा है, तो प्लगइन को अक्षम करके शुरू करें।

ग्लोबल कॉन्फ़िग की जाँच करें

अपनी ग्लोबल कॉन्फ़िग फ़ाइल खोलें और plugin कुंजी की तलाश करें।

macOS/Linux : ~/.config/opencode/opencode.jsonc (या ~/.config/opencode/opencode.json)
macOS/Linux (पुराने इंस्टॉल): ~/.local/share/opencode/opencode.jsonc
Windows : WIN+R दबाएँ और %USERPROFILE%\.config\opencode\opencode.jsonc पेस्ट करें

यदि आपके पास प्लगइन कॉन्फ़िगर हैं, तो कुंजी हटाकर या इसे एक खाली array पर सेट करके उन्हें अस्थायी रूप से अक्षम करें:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [],
}

प्लगइन डायरेक्टरी की जाँच करें

OpenCode डिस्क से स्थानीय प्लगइन भी लोड कर सकता है। इन्हें अस्थायी रूप से हटा दें (या फ़ोल्डर का नाम बदल दें) और डेस्कटॉप ऐप को पुनः आरंभ करें:

ग्लोबल प्लगइन
- macOS/Linux : ~/.config/opencode/plugins/
- Windows : WIN+R दबाएँ और %USERPROFILE%\.config\opencode\plugins पेस्ट करें
प्रोजेक्ट प्लगइन (केवल यदि आप प्रति-प्रोजेक्ट कॉन्फ़िग का उपयोग करते हैं)
- <your-project>/.opencode/plugins/

यदि ऐप फिर से काम करना शुरू कर देता है, तो यह पता लगाने के लिए कि कौन सा समस्या पैदा कर रहा है, एक-एक करके प्लगइन को फिर से सक्षम करें।

कैश साफ़ करें

यदि प्लगइन को अक्षम करना मदद नहीं करता (या कोई प्लगइन इंस्टॉल अटका हुआ है), तो कैश साफ़ करें ताकि OpenCode इसे फिर से बना सके।

OpenCode Desktop को पूरी तरह से क्विट करें।
कैश डायरेक्टरी हटाएँ:

macOS : Finder -> Cmd+Shift+G -> ~/.cache/opencode पेस्ट करें
Linux : ~/.cache/opencode हटाएँ (या rm -rf ~/.cache/opencode चलाएँ)
Windows : WIN+R दबाएँ और %USERPROFILE%\.cache\opencode पेस्ट करें

OpenCode Desktop को पुनः आरंभ करें।

सर्वर कनेक्शन समस्याओं को ठीक करें

OpenCode Desktop या तो अपना स्वयं का स्थानीय सर्वर शुरू कर सकता है (डिफ़ॉल्ट) या आपके द्वारा कॉन्फ़िगर किए गए सर्वर URL से कनेक्ट हो सकता है।

यदि आपको "Connection Failed" डायलॉग दिखता है (या ऐप कभी splash स्क्रीन से आगे नहीं बढ़ता), तो कस्टम सर्वर URL की जाँच करें।

डेस्कटॉप डिफ़ॉल्ट सर्वर URL साफ़ करें

Home स्क्रीन से, Server picker खोलने के लिए सर्वर नाम (status dot के साथ) पर क्लिक करें। Default server अनुभाग में, Clear पर क्लिक करें।

अपनी कॉन्फ़िग से `server.port` / `server.hostname` हटाएँ

यदि आपके opencode.json(c) में एक server अनुभाग है, तो इसे अस्थायी रूप से हटा दें और डेस्कटॉप ऐप को पुनः आरंभ करें।

एनवायरनमेंट वेरिएबल की जाँच करें

यदि आपके एनवायरनमेंट में OPENCODE_PORT सेट है, तो डेस्कटॉप ऐप स्थानीय सर्वर के लिए उस पोर्ट का उपयोग करने का प्रयास करेगा।

OPENCODE_PORT को unset करें (या एक मुफ़्त पोर्ट चुनें) और पुनः आरंभ करें।

Linux: Wayland / X11 समस्याएँ

Linux पर, कुछ Wayland सेटअप खाली विंडो या compositor त्रुटियों का कारण बन सकते हैं।

यदि आप Wayland पर हैं और ऐप खाली है/क्रैश हो रहा है, तो OC_ALLOW_WAYLAND=1 के साथ लॉन्च करने का प्रयास करें।
यदि इससे चीज़ें खराब होती हैं, तो इसे हटा दें और इसके बजाय एक X11 सत्र के तहत लॉन्च करने का प्रयास करें।

Windows: WebView2 रनटाइम

Windows पर, OpenCode Desktop को Microsoft Edge WebView2 Runtime की आवश्यकता होती है। यदि ऐप एक खाली विंडो में खुलता है या शुरू नहीं होता है, तो WebView2 इंस्टॉल/अपडेट करें और फिर से प्रयास करें।

Windows: सामान्य प्रदर्शन समस्याएँ

यदि आप Windows पर धीमे प्रदर्शन, फ़ाइल एक्सेस समस्याओं, या टर्मिनल समस्याओं का अनुभव कर रहे हैं, तो WSL (Windows Subsystem for Linux) का उपयोग करने का प्रयास करें। WSL एक Linux वातावरण प्रदान करता है जो OpenCode की सुविधाओं के साथ अधिक निर्बाध रूप से काम करता है।

सूचनाएँ नहीं दिख रही हैं

OpenCode Desktop केवल तभी सिस्टम सूचनाएँ दिखाता है जब:

आपकी OS सेटिंग्स में OpenCode के लिए सूचनाएँ सक्षम हैं, और
ऐप विंडो फोकस में नहीं है।

डेस्कटॉप ऐप स्टोरेज रीसेट करें (अंतिम उपाय)

यदि ऐप शुरू नहीं होगा और आप UI के अंदर से सेटिंग्स साफ़ नहीं कर सकते, तो डेस्कटॉप ऐप की सहेजी गई स्थिति को रीसेट करें।

OpenCode Desktop को क्विट करें।
इन फ़ाइलों को खोजें और हटाएँ (वे OpenCode Desktop ऐप डेटा डायरेक्टरी में रहती हैं):

opencode.settings.dat (डेस्कटॉप डिफ़ॉल्ट सर्वर URL)
opencode.global.dat और opencode.workspace.*.dat (UI स्थिति जैसे हाल के सर्वर/प्रोजेक्ट)

डायरेक्टरी को जल्दी से खोजने के लिए:

macOS : Finder -> Cmd+Shift+G -> ~/Library/Application Support (फिर ऊपर दिए गए फ़ाइल नामों की खोज करें)
Linux : ऊपर दिए गए फ़ाइल नामों के लिए ~/.local/share के अंतर्गत खोजें
Windows : WIN+R दबाएँ -> %APPDATA% (फिर ऊपर दिए गए फ़ाइल नामों की खोज करें)

मदद प्राप्त करना

यदि आप OpenCode के साथ समस्याओं का अनुभव कर रहे हैं:

GitHub पर समस्याएँ रिपोर्ट करें बग रिपोर्ट करने या सुविधाओं का अनुरोध करने का सबसे अच्छा तरीका हमारी GitHub रिपॉज़िटरी के माध्यम से है: github.com/anomalyco/opencode/issues (opens in a new tab) एक नई समस्या बनाने से पहले, यह देखने के लिए मौजूदा समस्याओं को खोजें कि क्या आपकी समस्या पहले ही रिपोर्ट की जा चुकी है।
हमारे Discord से जुड़ें रीयल-टाइम मदद और कम्युनिटी चर्चा के लिए, हमारे Discord सर्वर से जुड़ें: opencode.ai/discord (opens in a new tab)

सामान्य समस्याएँ

यहाँ कुछ सामान्य समस्याएँ और उन्हें हल करने का तरीका दिया गया है।

OpenCode शुरू नहीं होगा

त्रुटि संदेशों के लिए लॉग की जाँच करें
टर्मिनल में आउटपुट देखने के लिए --print-logs के साथ चलाने का प्रयास करें
सुनिश्चित करें कि आपके पास opencode upgrade के साथ नवीनतम संस्करण है

प्रमाणीकरण समस्याएँ

TUI में /connect कमांड के साथ पुनः प्रमाणीकरण का प्रयास करें
जाँचें कि आपकी API कुंजियाँ मान्य हैं
सुनिश्चित करें कि आपका नेटवर्क प्रदाता के API से कनेक्शन की अनुमति देता है

मॉडल उपलब्ध नहीं

जाँचें कि आपने प्रदाता के साथ प्रमाणित किया है
सत्यापित करें कि आपकी कॉन्फ़िग में मॉडल नाम सही है
कुछ मॉडलों को विशिष्ट एक्सेस या सदस्यता की आवश्यकता हो सकती है

यदि आप ProviderModelNotFoundError का सामना करते हैं तो आप सबसे अधिक संभावना है कि कहीं मॉडल को गलत तरीके से संदर्भित कर रहे हैं। मॉडलों को इस तरह संदर्भित किया जाना चाहिए: <providerId>/<modelId>

उदाहरण:

openai/gpt-4.1
openrouter/google/gemini-2.5-flash
opencode/kimi-k2

यह पता लगाने के लिए कि आपके पास किन मॉडलों तक पहुँच है, opencode models चलाएँ

ProviderInitError

यदि आप ProviderInitError का सामना करते हैं, तो संभवतः आपके पास एक अमान्य या दूषित कॉन्फ़िगरेशन है।

इसे हल करने के लिए:

सबसे पहले, providers guide का अनुसरण करके सत्यापित करें कि आपका प्रदाता सही ढंग से सेट है
यदि समस्या बनी रहती है, तो अपने संग्रहीत कॉन्फ़िगरेशन को साफ़ करने का प्रयास करें:
```
rm -rf ~/.local/share/opencode
```
Windows पर, WIN+R दबाएँ और हटाएँ: %USERPROFILE%\.local\share\opencode
TUI में /connect कमांड का उपयोग करके अपने प्रदाता के साथ पुनः प्रमाणित करें।

AI_APICallError और प्रदाता पैकेज समस्याएँ

यदि आप API कॉल त्रुटियों का सामना करते हैं, तो यह पुराने प्रदाता पैकेज के कारण हो सकता है। opencode आवश्यकतानुसार प्रदाता पैकेज (OpenAI, Anthropic, Google, आदि) को गतिशील रूप से इंस्टॉल करता है और उन्हें स्थानीय रूप से कैश करता है।

प्रदाता पैकेज समस्याओं को हल करने के लिए:

प्रदाता पैकेज कैश साफ़ करें:
```
rm -rf ~/.cache/opencode
```
Windows पर, WIN+R दबाएँ और हटाएँ: %USERPROFILE%\.cache\opencode
नवीनतम प्रदाता पैकेज को पुनः इंस्टॉल करने के लिए opencode को पुनः आरंभ करें

यह opencode को प्रदाता पैकेज के सबसे हाल के संस्करण डाउनलोड करने के लिए बाध्य करेगा, जो अक्सर मॉडल पैरामीटर और API परिवर्तनों के साथ संगतता समस्याओं को हल करता है।

Linux पर कॉपी/पेस्ट काम नहीं कर रहा

कॉपी/पेस्ट कार्यक्षमता के काम करने के लिए Linux उपयोगकर्ताओं को निम्नलिखित में से किसी एक क्लिपबोर्ड उपयोगिता को इंस्टॉल करने की आवश्यकता है:

X11 सिस्टम के लिए:

apt install -y xclip
# or
apt install -y xsel

Wayland सिस्टम के लिए:

apt install -y wl-clipboard

हेडलेस वातावरण के लिए:

apt install -y xvfb
# and run:
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

opencode पता लगाएगा कि क्या आप Wayland का उपयोग कर रहे हैं और wl-clipboard को प्राथमिकता देगा, अन्यथा यह क्लिपबोर्ड टूल को इस क्रम में खोजने का प्रयास करेगा: xclip और xsel।

Enterprise Windows (WSL)