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 میں "فائل پڑھیں اور بگ تلاش کریں" ٹاسک پر ان کا رویہ یہ رہا (تصدیق شدہ 23 ستمبر 2026):

سب سے پہلے یقینی بنائیں کہ 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 پر جاتا ہے، جبکہ استدلال اور ٹولز کی کارروائی 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 آپ کے ہر جملے کے ساتھ ایک سسٹم پرامپٹ اور دو درجن سے زیادہ بلٹ ان ٹولز کی تفصیلات شامل کرتا ہے، اور ایک ٹاسک عام طور پر کئی مراحل لیتا ہے۔ ہمارے رن میں، ہر مرحلے میں تقریباً 20 ہزار ان پٹ ٹوکنز تھے، اور "فائل پڑھیں، غلطی ڈھونڈیں" کام نے دو مراحل لیے — تقریباً 40 ہزار ٹوکنز، جن میں سے تقریباً سبھی ان پٹ تھے۔ اس لیے یہاں ٹوکن کی قیمت اہم ہے۔

JoinGonka Gateway کے ذریعے ٹوکنز کی قیمت فی ملین ان پٹ $0.0069 اور فی ملین آؤٹ پٹ $0.021 ہے — قیمت نیٹ ورک کے تمام ماڈلز کے لیے یکساں ہے اور اس صفحے پر براہ راست سورس سے اپ ڈیٹ ہوتی ہے۔

دائیں کالم میں تخمینے ستمبر 2026 کی قیمتوں کے مطابق ہیں۔ موازنہ کے لیے — 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 میں پروجیکٹ لیول پر پرووائیڈر کی ترتیبات نہیں ہیں۔ کام کے اور ذاتی کیز (keys) کو الگ کرنے کے لیے KIMI_CODE_HOME ویری ایبل استعمال کریں: اس کے ساتھ ترتیبات، سیشنز اور لاگز دوسری ڈائریکٹری میں چلے جاتے ہیں اور اسی ویری ایبل کے ساتھ چلنے والا انسٹالر وہیں لکھتا ہے۔

ایڈیٹر میں۔ Kimi Code زیڈ (Zed)، جیٹ برینز (JetBrains) اور دیگر ACP کلائنٹس کے اندر kimi acp کمانڈ کے ذریعے کام کرتا ہے — اسی ڈیٹا ڈائریکٹری اور اسی پرووائیڈر کے ساتھ۔

جن لیبارٹریز کے ماڈلز نیٹ ورک چلاتا ہے، وہ اپنے ایجنٹس بھی ریلیز کرتی ہیں: MiniMax کا ایک ٹرمینل MiniMax Code ہے، DeepSeek کا DeepSeek Harness ہے، اور Z.ai (GLM کے خالقین) کا ZCode ہے۔ یہ سب ایک ہی گیٹ وے سے ایک ہی کی (key) کے ذریعے جڑتے ہیں۔