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

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. ঘরগুলো ভরুন:

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 পেজে আপনার key বসানো অবস্থায় একই ঘরগুলো দেখতে পাবেন। Key না থাকলে আগে একটা বানিয়ে নিন, 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-এর মতো।

{
  "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 করুন:

export TOKENS_API_KEY=tok_live_your_key

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

আসল limit বসান#

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

কোন npm package নেবেন#

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

@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 ব্যবহার করতে পারে তা দেখতে:

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

Agent-এর কাজে কোন model মানায়, তা Choosing a model পেজে আছে।

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

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-এ গিয়ে সাবস্ক্রিপশন নিন বা টাকা যোগ করুন, অথবা 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 পেজে ব্যাখ্যা করা আছে।

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

সূত্র: Kilo Code docs, OpenAI Compatible provider, অক্টোবর 2026-এ দেখা।