> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kodacode सेटअप: इंस्टॉलेशन, API key, Base URL और कस्टम मॉडल

> Kodacode इंस्टॉल करें, BetterToken Base URL और API key कॉन्फ़िगर करें, संगत provider मॉडल चुनें और सामान्य त्रुटियां ठीक करें।

Kodacode को BetterToken से कनेक्ट करने के लिए API key तैयार करें, नीचे दिया Base URL भरें और model plaza से वर्तमान Model ID चुनें।

## मुख्य सेटिंग्स

| फ़ील्ड   | मान                                                                            |
| -------- | ------------------------------------------------------------------------------ |
| API Key  | BetterToken API key                                                            |
| Base URL | `https://www.bettertoken.ai/v1`                                                |
| मॉडल     | <a href={"https://bettertoken.ai/pricing"}>model plaza</a> से वर्तमान Model ID |

## आवश्यकताएं

* टूल का वर्तमान संस्करण इंस्टॉल है
* BetterToken API key: <a href={"https://bettertoken.ai/register"}>रजिस्टर करें और प्राप्त करें</a>
* <a href={"https://bettertoken.ai/pricing"}>model plaza</a> से Model ID

### अतिरिक्त आवश्यकताएं

* VS Code इंस्टॉल है
* Kodacode / Koda extension इंस्टॉल है
* चुनी गई Model ID **supported provider** से है

## इंस्टॉल करें

Kodacode इंस्टॉल या खोलें, फिर नीचे का मैन्युअल सेटअप जारी रखें।

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

| फ़ील्ड   | मान                                                                            |
| -------- | ------------------------------------------------------------------------------ |
| API Key  | BetterToken API key                                                            |
| Base URL | `https://www.bettertoken.ai/v1`                                                |
| मॉडल     | <a href={"https://bettertoken.ai/pricing"}>model plaza</a> से वर्तमान Model ID |

### सेटअप

<Steps>
  <Step title="Koda panel खोलें और मॉडल जोड़ें">
    VS Code sidebar में **KODA** panel खोलें, input box के नीचे model selector क्लिक करें और **Add model: Agent** चुनें।

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/yi2bQP5Q3QRPQ3t1/images/kodacode/select-model-menu.png?fit=max&auto=format&n=yi2bQP5Q3QRPQ3t1&q=85&s=b4bd4b16361c0367efbcbba78322df4a" alt="Koda panel के मॉडल selector से Add model: Agent चुनें।" style={{ borderRadius: '0.5rem' }} width="3012" height="1600" data-path="images/kodacode/select-model-menu.png" />
    </Frame>
  </Step>

  <Step title="OpenAI-compatible मॉडल सेटिंग भरें">
    मॉडल जोड़ने वाले dialog में ये मान उपयोग करें:

    | फ़ील्ड   | अनुशंसित मान                                                                                                    |
    | -------- | --------------------------------------------------------------------------------------------------------------- |
    | Provider | `Any OpenAI-compatible API`                                                                                     |
    | API Base | `https://www.bettertoken.ai/v1/`                                                                                |
    | Model ID | <a href={"https://bettertoken.ai/pricing"}>model plaza</a> से समर्थित provider की मॉडल ID, जैसे `YOUR_MODEL_ID` |
    | API Key  | आपकी BetterToken API Key                                                                                        |

    फ़ील्ड भरने के बाद **Connect** क्लिक करें।

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/kodacode/add-openai-compatible-model.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=099fa77d6f7720711451f39169f9ff85" alt="Kodacode मॉडल जोड़ने वाले dialog में Any OpenAI-compatible API चुनें और API Base, Model ID व API Key भरें।" style={{ borderRadius: '0.5rem' }} width="3102" height="1656" data-path="images/kodacode/add-openai-compatible-model.png" />
    </Frame>
  </Step>

  <Step title="पुष्टि करें कि मॉडल सक्रिय है">
    कनेक्शन सफल होने पर Koda input box के नीचे मॉडल selector से नया मॉडल, जैसे `YOUR_MODEL_ID`, चुनें। उत्तर मिलने की पुष्टि के लिए छोटा संदेश भेजें।
  </Step>

  <Step title="config.yaml जांचें">
    Kodacode configuration को `~/.koda/config.yaml` में लिखता है। मॉडल जोड़े जाने की पुष्टि के लिए यह फ़ाइल खोलें।

    <Frame>
      <img src="https://mintcdn.com/bettertoken-d796114e/PriHfVE9SgoOFlO4/images/kodacode/config-yaml-result.png?fit=max&auto=format&n=PriHfVE9SgoOFlO4&q=85&s=5112177597f16b97739c7d406f50749b" alt="OpenAI-compatible मॉडल configuration जोड़ी हुई Kodacode config.yaml।" style={{ borderRadius: '0.5rem' }} width="1618" height="1648" data-path="images/kodacode/config-yaml-result.png" />
    </Frame>
  </Step>
</Steps>

### config.yaml उदाहरण

इस पूर्ण संरचना को संदर्भ के रूप में उपयोग करें। `YOUR_API_KEY` को अपनी BetterToken API Key से बदलें और असली API Key को repository में commit न करें।

```yaml theme={null}
name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
  - name: YOUR_MODEL_ID
    provider: openai
    model: YOUR_MODEL_ID
    apiKey: YOUR_API_KEY
    apiBase: https://www.bettertoken.ai/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase
```

<Note>
  `YOUR_MODEL_ID` के अलावा मॉडल इस्तेमाल करें तो `name` और `model` दोनों अपडेट करें ताकि वे <a href={"https://bettertoken.ai/pricing"}>model plaza</a> की समर्थित provider मॉडल ID से मेल खाएं।
</Note>

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

छोटे test prompt भेजें। यदि टूल बिना authentication या Model ID त्रुटि के उत्तर देता है, तो कनेक्शन काम कर रहा है। configuration बदलने के बाद टूल को पूरी तरह रीस्टार्ट करें।

## मॉडल बदलें

मॉडल selector खोलें या configuration में `Model` फ़ील्ड बदलें। <a href={"https://bettertoken.ai/pricing"}>model plaza</a> से सटीक Model ID उपयोग करें, फिर मौजूदा session रीस्टार्ट करें।

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

| त्रुटि                  | क्या जांचें                                              |
| ----------------------- | -------------------------------------------------------- |
| `401` या `Unauthorized` | BetterToken API key जांचें और शुरुआत/अंत के space हटाएं। |
| `404`                   | Base URL जांचें और कोई विशिष्ट endpoint path न जोड़ें।   |
| `model not found`       | model plaza से वर्तमान Model ID कॉपी करें।               |
| बदलाव लागू नहीं होते    | configuration सहेजें और टूल पूरी तरह रीस्टार्ट करें।     |

* कनेक्शन विफल हो तो पुष्टि करें कि **API Base** `https://www.bettertoken.ai/v1/` है और अंतिम `/` रखें।
* मॉडल अनुपलब्ध हो तो पुष्टि करें कि **Model ID** supported provider से है।
* authentication विफल हो तो API Key फिर कॉपी करें और अतिरिक्त space या line break से बचें।
* `config.yaml` के बदलाव लागू न हों तो VS Code रीस्टार्ट करें या **Developer: Reload Window** चलाएं।
* BetterToken को सामान्यतः अतिरिक्त `User-Agent` या custom header की जरूरत नहीं होती।

## उन्नत सेटअप

### समर्थित provider

| Provider | स्थिति         |
| -------- | -------------- |
| Claude   | समर्थित नहीं   |
| GPT      | मैन्युअल सेटअप |
| Kimi     | मैन्युअल सेटअप |
| GLM      | मैन्युअल सेटअप |

<Note>ये स्थितियां केवल इस पेज पर बताए गए BetterToken सेटअप पर लागू होती हैं।</Note>

<Accordion title="सेटअप के तरीकों का अर्थ">
  * **मैन्युअल सेटअप**: API Key, Base URL और Model दर्ज करें।
  * **समर्थित नहीं**: सीधे सेटअप का कोई सत्यापित तरीका अभी उपलब्ध नहीं है।
</Accordion>

### संबंधित गाइड

* [Kodacode प्लगइन अवलोकन](https://docs.kodacode.ru/plugin/overview.html)
* [Kodacode प्लगइन इंस्टॉलेशन गाइड](https://docs.kodacode.ru/plugin/install.html)

## तकनीकी विवरण

<Accordion title="Protocol, endpoint और आंतरिक provider फ़ील्ड">
  यह सेटअप `https://www.bettertoken.ai/v1` उपयोग करता है। टूल OpenAI-compatible endpoint path जोड़ता है। जब तक कोई विशेष फ़ील्ड स्पष्ट रूप से न मांगे, `/chat/completions` या `/responses` न जोड़ें।
</Accordion>