Coding Agent सेटअप

OpenCode custom मॉडल: API Key, Base URL और JSON सेटअप

/connect और opencode.json से OpenCode को BetterToken Chat Completions से जोड़ें। API Key, Base URL और Model ID सेट करें।

OpenCode @ai-sdk/openai-compatible से BetterToken को कनेक्ट करता है। OpenCode प्रदाता का नाम BetterToken या OpenAI Compatible रखें। सामान्य API Key, Base URL या opencode.json सेटअप के लिए इसी पेज का उपयोग करें। किसी खास मॉडल को चुनने और जांचने के लिए GLM guide या Kimi K3 guide देखें। model plaza से सही Model ID कॉपी करें।

मुख्य सेटिंग

Field	मान
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	`YOUR_MODEL_ID`

आवश्यकताएं

नीचे दी गई commands से OpenCode 1 इंस्टॉल करें
BetterToken API Key बनाएं
मॉडल प्लाज़ा या Key Setup dialog से Model ID कॉपी करें

साइन अप करें और BetterToken API Key पाएँ

पहले से खाता है? साइन इन करें, रिचार्ज करें, फिर कंसोल में कुंजी बनाएँ।

इंस्टॉल करें

ये commands OpenCode 1 इंस्टॉल करती हैं। OpenCode 2 के लिए उसकी इंस्टॉलेशन गाइड उपयोग करें। OpenCode 2 उन्हीं स्थानों से मौजूदा configuration पढ़ता है और समर्थित V1 provider settings को नए प्रारूप में बदलता है; configuration syntax बदलने से पहले migration गाइड देखें।

curl

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

npm

npm install -g opencode-ai

Command-line सेटअप

BetterToken automatic setup script OpenCode में BetterToken प्रदाता बनाता या अपडेट करता है। इसके लिए Node.js आवश्यक है। API Key या Model ID argument में न देने पर script उन्हें दर्ज करने को कहता है।

macOS / Linux

curl -fsSL "https://bettertoken.ai/install-opencode-provider.sh" | bash

Windows

iwr "https://bettertoken.ai/install-opencode-provider.ps1" -OutFile "$env:TEMP\install-opencode-provider.ps1"; powershell -ExecutionPolicy Bypass -File "$env:TEMP\install-opencode-provider.ps1"

Script पूरा होने के बाद bettertoken/YOUR_MODEL_ID चुनें। OpenCode पहले से चल रहा हो तो test से पहले restart करें।

मैन्युअल सेटअप

विकल्प 1: /connect से credential save करें

OpenCode शुरू करके चलाएं:

/connect

Other चुनें, प्रदाता ID के रूप में bettertoken दर्ज करें, फिर YOUR_API_KEY दर्ज करें। OpenCode credential को local रूप से स्टोर करता है।

विकल्प 2: JSON सेट करें

Global file ~/.config/opencode/opencode.json है। Project अपने root में opencode.json उपयोग कर सकता है।

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

/connect उपयोग न करें तो "apiKey": "YOUR_API_KEY" को options के अंतर्गत जोड़ें। वास्तविक Key वाली configuration कभी commit न करें।

यह उदाहरण Chat Completions के लिए @ai-sdk/openai-compatible उपयोग करता है। SDK पैकेज endpoint के protocol से मेल खाना चाहिए; दूसरा protocol उपयोग करने से पहले आधिकारिक provider निर्देश देखें। GPT मॉडल के साथ macOS परीक्षण में OpenCode 1.19.4 और 2.1.4, दोनों ने हर SDK के साथ फ़ाइल पढ़ने वाले tool calls पूरे किए: @ai-sdk/openai-compatible ने /v1/chat/completions और @ai-sdk/openai ने /v1/responses उपयोग किया। read को allow तथा edit और bash को deny करने पर फ़ाइल पढ़ने के सभी चार मामले सफल रहे।

कनेक्शन सत्यापित करें

Project में opencode चलाएं, bettertoken/YOUR_MODEL_ID चुनें और छोटा message भेजें। सामान्य Response सेटअप की पुष्टि करता है। JSON बदलने के बाद OpenCode restart करें।

OpenCode 1 के साथ गैर-इंटरैक्टिव टेक्स्ट जांच के लिए:

opencode run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

OpenCode 2 में इस गैर-इंटरैक्टिव रन के लिए --standalone आवश्यक है:

opencode run --standalone --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

मॉडल बदलें

नया YOUR_MODEL_ID को provider.bettertoken.models के अंतर्गत जोड़ें, top-level model अपडेट करें, save करके restart करें।

सामान्य त्रुटियां

त्रुटि	समाधान
`401`	`/connect` फिर चलाएं या `apiKey` जांचें।
`404`	केवल `https://bettertoken.ai/v1` को `baseURL` के रूप में उपयोग करें; `/chat/completions` न जोड़ें।
मॉडल नहीं मिला	Top-level `model` को `models` के अंतर्गत ID से exactly मिलाएं।
Configuration लागू नहीं	जांचें कि project `opencode.json` global file को override तो नहीं करता, फिर OpenCode restart करें।