Kimi Code CLI: Gonka-এর মাধ্যমে নিজস্ব কী ব্যবহার করে Moonshot AI এজেন্ট

ধাপ ১: Kimi Code ইনস্টল করুন। ডকুমেন্টেশনে দেওয়া অফিসিয়াল উপায়গুলো:

# macOS and Linux: prebuilt binary, no Node.js needed
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

# Windows (PowerShell); Git for Windows is required before the first run
irm https://code.kimi.com/kimi-code/install.ps1 | iex

# npm (Node.js 22.19 or newer)
npm install -g @moonshot-ai/kimi-code

স্ক্রিপ্টটি বাইনারি ~/.kimi-code/bin/kimi-তে রাখে এবং শেল সেটিংস ফাইলের মাধ্যমে ওই ডিরেক্টরি PATH-এ যোগ করে। এর বিল্ড শুধু glibc-র জন্য: Alpine ও musl-ভিত্তিক অন্য সিস্টেমে থেমে যাবে ও npm ব্যবহারের পরামর্শ দেবে। টার্মিনাল আবার খুলে যাচাই করুন: kimi --version।

ধাপ ২: কী সংগ্রহ করুন। gate.joingonka.ai/register-এ নিবন্ধন করুন, ঠিকানা নিশ্চিত করুন এবং “API-কী” বিভাগে jg- প্রিফিক্সের একটি কী তৈরি করুন।

ধাপ ৩: ইনস্টলার চালান।

npx @joingonka/setup --tool kimi-code

ইনস্টলার কী চাইবে (কমান্ড লাইনের আর্গুমেন্টে এটি দেওয়া হয় না) এবং ~/.kimi-code/config.toml-এ শুধু নিজের টেবিলগুলো যোগ করবে:

• openai টাইপের [providers.joingonka] প্রোভাইডার — এটি Chat Completions প্রোটোকল — গেটওয়ে ঠিকানা ও api_key ফিল্ডে কী সহ; ফাইলের অনুমতি হবে 600;
• নেটওয়ার্কের প্রতিটি মডেলের জন্য একটি করে [models."joingonka/…"] টেবিল — প্রকৃত কনটেক্সট উইন্ডো ও উত্তর সীমা এবং স্পষ্ট সক্ষমতাসহ: টুল কল সবাই পায়, রিজনিং পায় DeepSeek V4 Flash ও GLM-5.3 Flash, MiniMax M2.7-এ শুধু টুল;
• default_model — DeepSeek V4 Flash, যদি ডিফল্ট মডেল এখনো বেছে না নেওয়া হয় বা গেটওয়ের নেটওয়ার্ক থেকে সরে যাওয়া কোনো মডেলের দিকে ইঙ্গিত করে; --model ফ্ল্যাগ ছাড়া অন্য প্রোভাইডারের পছন্দ ছোঁয় না, বরং এককালীন চালানোর কমান্ড জানিয়ে দেয়;
• আগের ফাইলের একটি কপি সংরক্ষণ করবে, অন্য প্রোভাইডার ও গেটওয়ে টেবিলে আপনার ফিল্ডগুলো ছোঁবে না, আর শেষে গেটওয়েতে একটি লাইভ অনুরোধ পাঠিয়ে জানাবে কী, ঠিকানা ও মডেল গৃহীত হয়েছে কি না।

আমাদের প্ররানে আউটপুট এমন দেখাচ্ছিল (সংক্ষিপ্ত):

Configured provider "joingonka" in ~/.kimi-code/config.toml
Base URL: https://gate.joingonka.ai/v1 (provider type "openai" — Chat Completions)
Models: joingonka/MiniMaxAI/MiniMax-M2.7, joingonka/deepseek-ai/DeepSeek-V4-Flash-0731, joingonka/zai-org/GLM-5.3-Flash
Default model: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731
…
✓ Verified: the gateway accepted the key, base URL and model.

অন্য ডিফল্ট মডেল ঠিক করে --model ফ্ল্যাগ (glm, minimax বা পূর্ণ আইডেন্টিফায়ার); প্রশ্নহীন মোড পরিবেশ ভেরিয়েবল থেকে কী নেয়:

JOINGONKA_API_KEY=jg-your-key npx @joingonka/setup --tool kimi-code --model glm --non-interactive

KIMI_CODE_HOME ভেরিয়েবলে সরানো ডেটা ডিরেক্টরি ইনস্টলার নিজেই বিবেচনায় নেয়। আর ~/.kimi — সেটি আগের Python ক্লায়েন্ট kimi-cli-র ডিরেক্টরি: Kimi Code 2.x এটি পড়ে না, বরং প্রথম চালানোর সময় সেখান থেকে সেটিংস স্থানান্তরের প্রস্তাব দেয় (একই কাজ করে kimi migrate)।

ইনস্টলার যা করে, সবই হাতে লেখা সম্ভব। Kimi Code সেটিংস সংরক্ষণ করে TOML-এ; ডট বা স্ল্যাশযুক্ত টেবিল কী উদ্ধৃতি চিহ্নে লিখতে হয়। Gonka নেটওয়ার্কের জন্য সম্পূর্ণ অংশ:

default_model = "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"

[providers.joingonka]
type = "openai"
base_url = "https://gate.joingonka.ai/v1"
api_key = "jg-your-key"

[models."joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"]
provider = "joingonka"
model = "deepseek-ai/DeepSeek-V4-Flash-0731"
max_context_size = 380000
max_output_size = 32768
capabilities = ["thinking", "tool_use"]
display_name = "DeepSeek V4 Flash (Gonka)"

[models."joingonka/zai-org/GLM-5.3-Flash"]
provider = "joingonka"
model = "zai-org/GLM-5.3-Flash"
max_context_size = 390000
max_output_size = 8192
capabilities = ["thinking", "tool_use"]
display_name = "GLM 5.3 Flash (Gonka)"

# MiniMax M2.7, unlike DeepSeek and GLM, is declared without thinking
[models."joingonka/MiniMaxAI/MiniMax-M2.7"]
provider = "joingonka"
model = "MiniMaxAI/MiniMax-M2.7"
max_context_size = 200000
max_output_size = 8192
capabilities = ["tool_use"]
display_name = "MiniMax M2.7 (Gonka)"

কী কোথায় রাখবেন। শেল এনভায়রনমেন্ট থেকে Kimi Code কী নেয় না: export OPENAI_API_KEY=… এখানে কাজ করে না। দুটি উপায় আছে, আর একসাথে দুটোই ব্যবহার করা যায় না:

একই টেবিলে দুটি ফিল্ড থাকলে Kimi Code চালু হওয়ার সময় প্রত্যাখ্যান করে: has both apiKey and apiKeyEnv set in config.toml - they are mutually exclusive। মনে রাখবেন, kimi doctor এই ধরনের দ্বন্দ্ব ধরে না — এটি শুধু ফাইলের গঠন যাচাই করে।

কোন ধরনের প্রোভাইডার বেছে নেবেন। Kimi Code একাধিক প্রোটোকল বোঝে, গেটওয়েও তাই:

Kimi Code-এ একটি প্রোভাইডার একটি প্রোটোকলে কথা বলে, তাই দ্বিতীয় প্রোটোকল মানে অন্য নামে দ্বিতীয় প্রোভাইডার। এজেন্টের ভেতরে /provider কমান্ড দিয়ে ইন্টারঅ্যাক্টিভভাবে প্রোভাইডার যোগ ও মুছে ফেলা যায়।

Kimi Code-এ একটি মডেল হলো একটি অ্যালিয়াস, অর্থাৎ [models."…"] টেবিলের নাম। ইনস্টলার এগুলোকে joingonka/<model-id> স্কিমে নাম দেয়, যেমনটা Kimi Code নিজের মডেলগুলোর ক্ষেত্রে করে (kimi-code/k3), আর মডেল নির্বাচনের প্রতিটি জায়গাতেই এই অ্যালিয়াসই লাগে। প্রিফিক্স ছাড়া আইডেন্টিফায়ার, যেমন MiniMaxAI/MiniMax-M2.7, Kimi Code খুঁজে পাবে না।

আমাদের রানে /model দেখতে এমন ছিল:

Select a model  (type to search)
Tab toggle provider · ↑↓ navigate · Enter select · Alt+S session-only · Esc cancel

 All   joingonka

   MiniMax M2.7 (Gonka)       joingonka
 ❯ DeepSeek V4 Flash (Gonka)  joingonka ← current
   GLM 5.3 Flash (Gonka)      joingonka

 Thinking  (←→ to switch)
  [ On ]    Off

Thinking টগল। তালিকার নিচের রিজনিং সুইচটি নেটওয়ার্কের মডেলগুলোর ক্ষেত্রে নিজে থেকে কিছুই বদলায় না: Kimi Code রিজনিং লেভেল পাঠায় শুধু সেই মডেলগুলোকেই, যেগুলোর লেভেল ঘোষণা করা আছে। GLM-5.3 Flash-এর ক্ষেত্রে এটি করা উচিত — এর রিজনিং low মান দিয়ে বন্ধ হয় (বিস্তারিত — মডেল পর্যালোচনায়)। মডেল টেবিলে তিনটি ফিল্ড যোগ করুন:

[models."joingonka/zai-org/GLM-5.3-Flash"]
# … fields written by the installer …
support_efforts = ["low", "high"]
default_effort = "high"
off_effort = "low"

গেটওয়েতে কী যায় তা আমরা যাচাই করেছি: Thinking চালু থাকলে Kimi Code reasoning_effort: "high" পাঠায়, আর মডেল রিজনিং করে; বন্ধ থাকলে — "low", আর উত্তর আসে রিজনিং ব্লক ছাড়াই। ইনস্টলার আবার চালালে এই ফিল্ডগুলো অটুট থাকবে: এটি শুধু নিজের কী-গুলোই সম্পাদনা করে।

সাবএজেন্টের জন্য মডেল। বিল্ট-ইন সাবএজেন্টগুলো (coder, explore, plan) ডিফল্টভাবে মূল এজেন্টের মডেলেই চলে। [secondary_model] সেকশন তাদের একটি পুল দেয়, যা থেকে মূল এজেন্ট নিজেই প্রম্পটের ভিত্তিতে বেছে নেয়। পুলে যেকোনো অ্যালিয়াস চলবে — DeepSeek V4 Flash, GLM-5.3 Flash বা MiniMax M2.7:

[secondary_model]
default_model = "joingonka/deepseek-ai/DeepSeek-V4-Flash-0731"

[secondary_model.models]
"joingonka/deepseek-ai/DeepSeek-V4-Flash-0731" = "Long context and long output: big reads and edits."
"joingonka/zai-org/GLM-5.3-Flash" = "Reasoning model for tricky logic and debugging."

পুলের কী-গুলো অবশ্যই [models]-এর অ্যালিয়াসের সাথে মিলতে হবে: ডকুমেন্টেশন অনুযায়ী ভাঙা লিংক থাকলে সেশন তৈরি হয় না। MiniMax M2.7-এর লাইনও একইভাবে যোগ হয়; নেটওয়ার্ক থেকে বাদ পড়া মডেলের লিংক ইনস্টলার পরের বার চালালে নিজেই মুছে দেবে।

কোন মডেল বেছে নেবেন। নেটওয়ার্কের সব মডেলের দাম একই, তাই পছন্দটা আচরণ নিয়ে। "একটি ফাইল পড়ে বাগ খুঁজে বের করো" টাস্কে Kimi Code 2.0.2-এ তারা এভাবে আচরণ করেছিল (যাচাই: ২৩ সেপ্টেম্বর ২০২৬):

প্রথমে নিশ্চিত করুন যে Kimi Code প্রোভাইডার দেখতে পাচ্ছে এবং ফাইলটি ত্রুটি ছাড়াই পার্স হচ্ছে:

$ kimi provider list
joingonka  type=openai  models=3  source=inline

Default model: joingonka/deepseek-ai/DeepSeek-V4-Flash-0731

$ kimi doctor
OK config.toml  ~/.kimi-code/config.toml

kimi provider list --json-এর আউটপুট কোথাও প্রকাশ করবেন না: এতে কী প্লেইন টেক্সটে থাকে।

এরপর — একবার চালিয়ে দেখা। calc.py ফাইলে এমন একটি যোগ ফাংশন রাখুন যা আসলে বিয়োগ করে, আর মডেলকে ভুলটি খুঁজে বের করতে বলুন:

kimi -p "Read calc.py and tell me in one sentence whether it has a bug."

-p মোডে উত্তর যায় stdout-এ, আর Reasoning ও টুলের ধাপ যায় stderr-এ, তাই স্ক্রিপ্ট দিয়ে আউটপুট পার্স করা সুবিধাজনক। GLM-5.3 Flash এভাবে উত্তর দিয়েছিল:

• Yes: the `add` function in calc.py:2 returns `a - b` instead of `a + b`, so `add(2, 3)` prints `-1`.

মনে রাখবেন: -p মোডে Kimi Code কিছু জিজ্ঞেস করে না এবং নিজেই কমান্ড চালায় — আমাদের চালানোতে মডেল না জিজ্ঞেস করেই অনুমান যাচাই করতে python3 চালানোর চেষ্টা করেছিল। নতুন ডিরেক্টরিতে ইন্টারফেসের প্রথম চালু হওয়া শুরু হয় Trust this folder? প্রশ্ন দিয়ে — এটি প্রোজেক্টের MCP সার্ভার সম্পর্কিত, — আর স্বাগত স্ক্রিনে মডেল দেখা যায়: Model: DeepSeek V4 Flash (Gonka)। যাচাইয়ের দ্বিতীয় অংশ — গেটওয়ে ড্যাশবোর্ড: "Usage" বিভাগে অনুরোধ মডেল ও কী অনুযায়ী ভাগ করে দেখা যাবে।

কিছু ভুল হলে সাধারণত বার্তা থেকেই সমস্যা বোঝা যায়:

Kimi Code আপনার প্রতিটি বার্তার সাথে একটি সিস্টেম প্রম্পট এবং দুই ডজনের বেশি বিল্ট-ইন টুলের ডেসক্রিপশন যোগ করে, এবং একটি কাজ সাধারণত বেশ কয়েকটি ধাপ সম্পন্ন করে। আমাদের টেস্ট রানে, প্রতিটি ধাপে প্রায় ২০ হাজার ইনপুট টোকেন ছিল, এবং "ফাইলটি পড়ুন, ভুল খুঁজুন" কাজটি দুই ধাপে সম্পন্ন হয়েছে — প্রায় ৪০ হাজার টোকেন, যার প্রায় সবটাই ইনপুট। তাই এখানে প্রতি টোকেনের দাম খুব গুরুত্বপূর্ণ।

JoinGonka Gateway এর মাধ্যমে প্রতি মিলিয়ন ইনপুট টোকেনের দাম $0.0069 এবং প্রতি মিলিয়ন আউটপুট টোকেনের দাম $0.021 — এই দাম নেটওয়ার্কের সব মডেলের জন্য একই এবং এই পেজে লাইভ সোর্স থেকে নেওয়া হয়।

ডানদিকের কলামের অনুমানগুলো ২০২৬ সালের সেপ্টেম্বরের দাম অনুযায়ী। তুলনার জন্য — Kimi Code-এ মডেলের জন্য যেভাবে পেমেন্ট করা যায়:

সঠিক খরচ এবং ব্যালেন্স ড্যাশবোর্ডের «Usage» এবং «Billing» সেকশনে দেখা যাবে। আলোচনার দৈর্ঘ্য Kimi Code নিজেই মনিটর করে: স্ট্যাটাস বারে দেখা যায় কতটুকু কন্টেক্সট ব্যবহৃত হয়েছে, এবং /compact কমান্ডটি ম্যানুয়ালি হিস্ট্রি কমপ্যাক্ট করে।

অনুমতি মোডসমূহ (Permission modes). Kimi Code ইন্টারফেসে ডিফল্টভাবে Always Ask মোড কাজ করে: পড়া (reading) তাৎক্ষণিকভাবে সম্পন্ন হয়, কিন্তু পরিবর্তন এবং কমান্ডগুলো আপনার নিশ্চিতকরণের অপেক্ষায় থাকে। Ask When Needed (/yolo অথবা --yolo ফ্ল্যাগ) নিয়মিত পরিবর্তন এবং কমান্ডগুলোকে এড়িয়ে যায়, তবে সংবেদনশীল ফাইল এবং বিপজ্জনক কমান্ড সম্পর্কে জিজ্ঞাসা করে; Never Ask (/auto, --auto) কিছুই জিজ্ঞাসা করে না। শিডিউলিং মোড Shift-Tab এর মাধ্যমে চালু হয়। ওয়ান-টাইম রান kimi -p সর্বদা কোনো জিজ্ঞাসা ছাড়াই সম্পন্ন হয়, তাই এটি কোনো কন্টেইনার বা আলাদা ওয়ার্কিং কপিতে চালান।

যা Moonshot অ্যাকাউন্ট ছাড়াই কাজ করে। আমাদের নিজস্ব প্রোভাইডার মডেল যা কিছু করে তা পরিচালনা করে: কোড পড়া এবং পরিবর্তন করা, কমান্ড, সাব-এজেন্ট, সেশন, এবং MCP-সার্ভার। ওয়েব-সার্চ হলো Moonshot-এর সার্ভিস: অ্যাকাউন্ট ছাড়া WebSearch টুলটি এজেন্টের সেটে থাকে না, তবে অ্যাড্রেস থেকে পেজ লোড করা (FetchURL) কার্যকর থাকে। নেটওয়ার্ক মডেলগুলো টেক্সট-ভিত্তিক, তাই এগুলোতে ছবি বা ভিডিও ইনপুট কাজ করে না।

টেলিমেট্রি এবং আপডেটসমূহ। অ্যানোনিমাস টেলিমেট্রি ডিফল্টভাবে চালু থাকে: এটি বন্ধ করতে config.toml এ telemetry = false লাইনটি যোগ করুন অথবা KIMI_DISABLE_TELEMETRY=1 এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করুন। আপডেটগুলো স্বয়ংক্রিয়ভাবে ইনস্টল হয় (~/.kimi-code/tui.toml ফাইলে [upgrade] auto_install = true); যদি আপনার প্রেডিক্টেবিলিটি প্রয়োজন হয় — তবে এটি বন্ধ করে kimi upgrade কমান্ডের মাধ্যমে আপডেট করুন। গেটওয়ে প্রম্পট বা উত্তরের কোনো কন্টেন্ট সংরক্ষণ করে না — পরিসংখ্যানে শুধুমাত্র ব্যবহারের এগ্রিগেটগুলো থাকে।

একাধিক এনভায়রনমেন্ট। Kimi Code-এ প্রজেক্ট লেভেলে প্রোভাইডার সেটিংস নেই। কাজের এবং ব্যক্তিগত কি-গুলো আলাদা করতে KIMI_CODE_HOME ভেরিয়েবল ব্যবহার করুন: এর মাধ্যমে সেটিংস, সেশন এবং লগগুলো অন্য ডিরেক্টরিতে চলে যায় এবং একই ভেরিয়েবল ব্যবহার করে ইনস্টলার চালালে সেটি সেখানেই লিখবে।

এডিটরে। Kimi Code, Zed, JetBrains এবং অন্যান্য ACP ক্লায়েন্টের ভেতরে kimi acp কমান্ডের মাধ্যমে কাজ করে — একই ডেটা ডিরেক্টরি এবং একই প্রোভাইডার ব্যবহার করে।

যেসব ল্যাবরেটরির মডেলগুলো নেটওয়ার্কে চলে, তারাও নিজস্ব এজেন্ট রিলিজ করে: MiniMax-এর একটি টার্মিনাল MiniMax Code আছে, DeepSeek-এর আছে DeepSeek Harness, এবং Z.ai (GLM-এর নির্মাতা) এর আছে ZCode। এদের সবাই একই গেটওয়েতে একই কি (key) দিয়ে যুক্ত হয়।