OpenCode: installation, API और पहला request

OpenCode शुरू करने के लिए क्या चाहिए

OpenCode terminal का coding agent है। वह project files पढ़ता है, selected model से काम करता है और repository में actions कर सकता है। पहले run के लिए चाहिए:

• macOS, Linux या Windows और official installation method तक access;
• आपका BetterToken API Key;
• BetterToken model catalog से current Model ID;
• सुरक्षित test directory जिसमें agent response जाँचा जा सके।

इस setup में BetterToken external API request देता है। वह OpenCode website, installer, GitHub या updates की availability का वादा नहीं करता; third-party downloads और integrations अलग से जाँचें।

Official source से OpenCode install करें

एक method चुनें। Node.js केवल npm installation के लिए जरूरी है।

macOS और Linux: official installer

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

npm

npm install -g opencode-ai

Homebrew

brew install anomalyco/tap/opencode

OpenCode अपना tap recommend करता है, क्योंकि Homebrew-maintained brew install opencode formula बाद में बदल सकती है।

Windows

Official documentation Chocolatey या Scoop बताती है:

choco install opencode

scoop install opencode

Installation के बाद:

opencode --version

Version को command not found के बिना print होना चाहिए। Article किसी specific version को fixed नहीं मानता क्योंकि releases बदलती हैं।

/connect और opencode.json कैसे काम करते हैं

OpenCode credential और provider settings अलग रखता है:

• /connect API Key को ~/.local/share/opencode/auth.json में रखता है;
• global ~/.config/opencode/opencode.json user के providers और models तय करता है;
• project root का opencode.json उसी project की settings बदलता है।

Config files merge होते हैं। Conflict में बाद का source पहले वाले को override करता है। सामान्य local order है: global config → OPENCODE_CONFIG file → project opencode.json; managed organization settings का अलग higher priority हो सकता है।

1. /connect से API Key सहेजें

Test directory में OpenCode चलाएँ:

mkdir opencode-first-test
cd opencode-first-test
opencode

TUI में:

/connect

Other चुनें, provider id bettertoken दें, फिर credential field में अपना API Key डालें। Real key को prompt, opencode.json, screenshot या Git में न रखें। Save के बाद OpenCode से निकलें और provider जाँचें:

opencode auth list

यह key खोले बिना provider दिखाना चाहिए।

2. BetterToken provider जोड़ें

सभी projects के लिए इस file को बनाएँ या update करें:

~/.config/opencode/opencode.json

केवल एक repository में चाहिए तो उसके root में opencode.json रखें। Minimum config:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "bettertoken/YOUR_MODEL_ID",
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {"baseURL": "https://www.bettertoken.ai/v1"},
      "models": {"YOUR_MODEL_ID": {"name": "YOUR_MODEL_ID"}}
    }
  }
}

YOUR_MODEL_ID को current BetterToken catalog के exact ID से बदलें। वही value model, models object key और उसके name में हो। Base URL में /chat/completions न जोड़ें: OpenCode और @ai-sdk/openai-compatible request path स्वयं बनाते हैं। Automatic setup commands और model-group limits के लिए BetterToken OpenCode documentation देखें; model list बदलती है, इसलिए यह article placeholder रखता है।

3. कौन-सी file लागू हुई, जाँचें

Project opencode.json global model या provider को override कर सकता है। Unexpected endpoint पर क्रम से ~/.config/opencode/opencode.json, set होने पर OPENCODE_CONFIG, और current project से Git root तक का opencode.json जाँचें। Files को अनुमान से delete न करें; सभी में model, provider.bettertoken.options.baseURL और provider.bettertoken.models मिलाएँ।

पहला request चलाएँ और जाँचें

JSON बदलने के बाद OpenCode restart करें:

opencode

Model picker खोलें:

/models

bettertoken/YOUR_MODEL_ID चुनें और यह short request भेजें:

केवल JSON लौटाएँ: {"tool":"opencode","sum":4}. फ़ाइलें न बदलें।

First request तब confirmed है जब OpenCode valid JSON लौटाए और files न बदले, TUI में bettertoken/YOUR_MODEL_ID selected हो, Dashboard में expected model और status वाला request दिखे, और वहाँ input/output तथा लागू cache Token और corresponding charge हों। Dashboard को full prompt/response storage न मानें; यहाँ usage metadata और token spending का मिलान है। Record न दिखे तो config override के कारण response दूसरे provider से आया हो सकता है।

सामान्य errors ठीक करें

opencode: command not found

Terminal बंद करके खोलें। npm से install किया हो तो देखें global npm directory PATH में है या नहीं। पहला binary कहाँ गया यह जाने बिना दूसरा installer न चलाएँ।

401 या credential error

/connect फिर चलाएँ और provider id bettertoken चुनें। opencode auth list से जाँचें; quick test के लिए भी key को command line या JSON में न डालें।

404 या API error

provider.bettertoken.options.baseURL में केवल यह Base URL हो:

https://www.bettertoken.ai/v1

/chat/completions न जोड़ें। URL सही हो तो OpenCode restart कर short request फिर चलाएँ।

model not found

Exact Model ID को current documentation और model catalog से मिलाएँ। Top-level model का रूप bettertoken/YOUR_MODEL_ID हो, और provider.bettertoken.models में उसी YOUR_MODEL_ID की key मौजूद हो।

OpenCode दूसरी model या endpoint लेता है

यह आम तौर पर config override है। Global file, OPENCODE_CONFIG और project file मिलाएँ। Standard files में project setting सबसे high priority रखती है। सुधार के बाद OpenCode पूरी तरह restart करें, फिर /models और Dashboard दोबारा जाँचें।

FAQ

क्या API Key को opencode.json में रखना चाहिए?

नहीं। सामान्य setup में /connect उपयोग करें; OpenCode credential को ~/.local/share/opencode/auth.json में रखेगा और config में real key नहीं होगी।

OpenCode को कौन-सा Base URL चाहिए?

OpenAI-compatible provider के लिए BetterToken https://www.bettertoken.ai/v1 लेता है। यह Base URL है, इसलिए /chat/completions manually नहीं जोड़ा जाता।

Global या project opencode.json कौन-सा चुनें?

Common provider/model के लिए global file सुविधाजनक है। जब repository को अलग Model ID या permissions चाहिए तो project file रखें। Conflict में project file global को override करती है।

क्या BetterToken provider के लिए OpenCode account जरूरी है?

Custom provider selected API service का credential लेता है। BetterToken अपना API Key देता है, पर OpenCode website, account या अन्य services का स्थान नहीं लेता। Tool की current requirements official OpenCode documentation से मिलाएँ।

भुगतान और balance top-up

Balance top-up और API payment account dashboard में होते हैं। Available methods और current rates के लिए BetterToken pricing page देखें; dynamic prices को fixed fact न मानें।

लागत example और rates

Input, output और applicable cached tokens अलग गिनें, उस समय की rates pricing page से लें और estimate को current model price का दावा न बनाएं।