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

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

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 साइडकार) चलाता है। अधिकांश समस्याएं खराब व्यवहार करने वाले प्लगइन, दूषित कैश, या गलत सर्वर सेटिंग के कारण होती हैं।

त्वरित जांच

ऐप को पूरी तरह से बंद करें और पुनः लॉन्च करें।
यदि ऐप एरर स्क्रीन दिखाता है, तो रीस्टार्ट पर क्लिक करें और एरर विवरण कॉपी करें।
केवल macOS: OpenCode मेनू -> 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 पेस्ट करें

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

{
  "$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 से कनेक्ट कर सकता है।

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

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

होम स्क्रीन से, सर्वर पिकर खोलने के लिए सर्वर नाम (स्टेटस डॉट के साथ) पर क्लिक करें। डिफ़ॉल्ट सर्वर सेक्शन में, साफ करें पर क्लिक करें।

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

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

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

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

OPENCODE_PORT अनसेट करें (या एक फ्री पोर्ट चुनें) और पुनः प्रारंभ करें।

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

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

यदि आप 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)

नया issue बनाने से पहले, मौजूदा issues खोजें यह देखने के लिए कि क्या आपकी समस्या पहले से रिपोर्ट की गई है।
हमारे 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 मिलता है, तो संभवतः आपके पास अमान्य या दूषित कॉन्फ़िगरेशन है।

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

पहले, प्रदाता गाइड का पालन करके सत्यापित करें कि आपका प्रदाता सही ढंग से सेट अप है
यदि समस्या बनी रहती है, तो अपना संग्रहीत कॉन्फ़िगरेशन साफ करने का प्रयास करें:
```
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
# या
apt install -y xsel

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

apt install -y wl-clipboard

हेडलेस एनवायरनमेंट के लिए:

apt install -y xvfb
# और चलाएं:
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

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

Enterprise Windows (WSL)