# Kilo Code-কে Tokens-এর সাথে যুক্ত করুন

> Kilo Code-এ Tokens যোগ করুন custom OpenAI Compatible provider হিসেবে, settings UI বা kilo.json file থেকে, আর model-এর সীমা বসিয়ে দিন যাতে context management ঠিকমতো চলে।

Kilo Code একটা open-source agentic coding extension। এটা VS Code আর JetBrains-এ চলে, CLI-ও আছে। Tokens-এর সাথে এটা যুক্ত হয় **custom provider** হিসেবে, OpenAI Compatible API দিয়ে, যা `https://tokens.bd/v1`-এর সাথে Chat Completions-এ কথা বলে। সেট করা যায় settings UI থেকে, অথবা `kilo.json` file-এ।

এই গাইড Kilo Code v7.8.3-এর সাথে মিলিয়ে দেখা হয়েছে (অক্টোবর 2026)।

## UI-তে Tokens-কে custom provider হিসেবে যোগ করুন

1. Gear আইকনে ক্লিক করুন, **Providers** ট্যাব খুলুন, তারপর **Custom provider**-এ ক্লিক করুন।
2. ঘরগুলো ভরুন:

| Field        | Value                                                                    |
| ------------ | ------------------------------------------------------------------------ |
| Provider ID  | `tokens`                                                                 |
| Display name | `Tokens`                                                                 |
| Provider API | OpenAI Compatible                                                        |
| Base URL     | `https://tokens.bd/v1`                                                   |
| API key      | `tok_live_your_key`                                                      |
| Models       | Fetched from `/v1/models`, or add `deepseek/deepseek-v4.1-flash` by hand |
| Headers      | Leave empty                                                              |

3. Save করুন, তারপর Kilo Code-এর model selector থেকে model-টা বেছে নিন।

Kilo Code `GET /v1/models` পড়ে, তাই model list-এ শুধু সেই model-গুলোই আসে যেগুলো আপনার key ব্যবহার করতে পারে। List ফাঁকা এলে বুঝবেন আপনার অ্যাকাউন্টে এখনো কোনো plan বা Wallet ব্যালান্স নেই, অথবা key-র allow-list খুব ছোট।

[Connect Your Agent](/dashboard/connect) পেজে আপনার key বসানো অবস্থায় একই ঘরগুলো দেখতে পাবেন। Key না থাকলে আগে একটা বানিয়ে নিন, [API keys](/docs/api-keys) দেখুন।

## kilo.json দিয়ে Kilo Code সেট করুন

এক machine থেকে আরেক machine-এ কপি করা যায় এমন সেটআপ চাইলে config file ব্যবহার করুন। Kilo Code global-এ পড়ে `~/.config/kilo/kilo.json`, আর project-এ পড়ে `./kilo.json`। Comment রাখতে চাইলে `kilo.jsonc`-ও চলে। Format-টা OpenCode-এর মতো।

```json title="~/.config/kilo/kilo.json"
{
  "provider": {
    "tokens": {
      "npm": "@ai-sdk/openai-compatible",
      "env": ["TOKENS_API_KEY"],
      "options": { "baseURL": "https://tokens.bd/v1" },
      "models": {
        "deepseek/deepseek-v4.1-flash": {
          "name": "DeepSeek V4.1 Flash",
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  },
  "model": "tokens/deepseek/deepseek-v4.1-flash"
}
```

এরপর Kilo Code যে shell বা profile থেকে চালু হয়, সেখানে key-টা export করুন:

```bash
export TOKENS_API_KEY=tok_live_your_key
```

`env` entry থাকায় key file-এর বাইরে থাকে। এটা জরুরি, বিশেষ করে project-এর `kilo.json` যদি commit করেন। Commit করা config-এ কখনো আসল key লিখবেন না।

### আসল limit বসান

ওপরের `limit`-এর মানগুলো উদাহরণ। এগুলোর জায়গায় [model catalog](/models) থেকে model-এর context window আর output limit বসান। Kilo Code-এর docs বলছে, `limit.context` বা `limit.output` বাদ দিলে ডিফল্ট 0 হয়ে যায়, আর তাতে context management সীমিত হয়ে পড়ে। বাস্তবে এর মানে, লম্বা কথোপকথন কখন compact করতে হবে তা agent বুঝতে পারে না।

### কোন npm package নেবেন

`npm` field ঠিক করে কোন protocol চলবে:

| Package                     | Protocol           | Tokens endpoint        |
| --------------------------- | ------------------ | ---------------------- |
| `@ai-sdk/openai-compatible` | Chat Completions   | `/v1/chat/completions` |
| `@ai-sdk/openai`            | Responses          | `/v1/responses`        |
| `@ai-sdk/anthropic`         | Anthropic Messages | `/v1/messages`         |

`@ai-sdk/openai-compatible`-এ থাকুন। Tokens `/v1/responses`-ও serve করে, কিন্তু কোনো model-এ সেটা চলবে কিনা তা নির্ভর করে পেছনের upstream provider-এর ওপর। Chat Completions-ই একমাত্র path যা প্রতিটা model support করে।

## Model বদলানো

`models`-এর নিচে আরও entry যোগ করুন, প্রতিটার key হবে হুবহু Tokens ID, আর ওপরের স্তরের `model` বদলে করুন `tokens/<model-id>`। Model reference হলো provider ID, একটা slash, তারপর পুরো model ID। তাই `tokens/deepseek/deepseek-v4.1-flash`-এ দুটো slash থাকে। অন্য gateway-র ID-ও এই নিয়মেই লেখা হয়, যদিও Kilo Code-এর docs এটা স্পষ্ট করে বলে না। UI-তে শুধু selector থেকে অন্য model বেছে নিন।

আপনার key কোন কোন ID ব্যবহার করতে পারে তা দেখতে:

```bash
curl -s https://tokens.bd/v1/models -H "Authorization: Bearer $TOKENS_API_KEY"
```

Agent-এর কাজে কোন model মানায়, তা [Choosing a model](/docs/choosing-a-model) পেজে আছে।

## ঠিকমতো চলছে কিনা যাচাই করুন

```bash
curl -s https://tokens.bd/v1/chat/completions \
  -H "Authorization: Bearer $TOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek/deepseek-v4.1-flash", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'
```

এটা completion ফেরত দিলে Kilo Code খুলুন, Tokens-এর model select করুন, আর আপনার project-এর একটা file পড়তে বলুন। একটু পরেই request-টা আপনার Dashboard-এর usage analytics-এ দেখা যাবে।

## সমস্যা হলে

**Model list ফাঁকা।** Plan বা Wallet ব্যালান্স ছাড়া key-র জন্য `GET /v1/models` কিছুই ফেরত দেয় না। [billing](/dashboard/billing)-এ গিয়ে সাবস্ক্রিপশন নিন বা টাকা যোগ করুন, অথবা model হাতে লিখে যোগ করুন।

**kilo.json থাকা অবস্থায় 401 `missing_api_key`।** Kilo Code যে environment থেকে চালু হয়েছে, সেখানে `TOKENS_API_KEY` set নেই। Desktop launcher থেকে খোলা editor আপনার shell profile-এ export করা variable নাও দেখতে পারে। Editor terminal থেকে আবার চালু করুন, অথবা UI-তে key বসান।

**404 `model_not_found`।** `models`-এর নিচের model key হতে হবে provider prefix সহ হুবহু Tokens ID।

**Base URL-এর format।** Kilo Code Base URL ঘরে পুরো endpoint URL-ও নেয়, কিন্তু ব্যবহার করবেন `https://tokens.bd/v1` রূপটাই। `/chat/completions` দুবার জুড়ে দেবেন না।

**লম্বা কাজে context error।** `limit.context` set করা আছে কিনা আর model-এর সাথে মেলে কিনা দেখুন।

**429 error।** `Retry-After` দেখুন। `rate_limited`, `concurrency_limit` আর `window_exhausted` কী, তা [Troubleshooting](/docs/troubleshooting) পেজে ব্যাখ্যা করা আছে।

Kilo Code-এর file format [OpenCode](/docs/opencode)-এর কাছাকাছি, তাই দুটোই চালালে ওই গাইডটাও কাজে আসবে।

সূত্র: [Kilo Code docs, OpenAI Compatible provider](https://kilo.ai/docs/providers/openai-compatible), অক্টোবর 2026-এ দেখা।

---
Page: https://tokens.bd/bn/docs/kilo-code