Deepseek ArtifactsDeepseek Artifacts
Kimi K3 · دليل Claude Code العملي

ربط Kimi K3 بـ Claude Code: الدليل الكامل للإعداد

توفّر Moonshot نقطة نهاية متوافقة مع Anthropic، لذا يعمل Claude Code على Kimi K3 بمجرد كتلة متغيرات واحدة في settings.json. كل قيمة إعداد في هذه الصفحة منقولة حرفيًا من الدليل الرسمي لـ Kimi، والثمان لقطات الشاشة تتبع جلسة K3 حقيقية من أول أمر حتى لعبة مُتحقَّق منها وقابلة للتشغيل.

ابدأ الدليل المصوّراقرأ الأسئلة الشائعة

الخلاصة — Kimi K3 داخل Claude Code

  • واجهة Messages API من Moonshot متوافقة مع Anthropic: وجّه ANTHROPIC_BASE_URL إلى https://api.moonshot.ai/anthropic، وضع مفتاح Kimi في ANTHROPIC_AUTH_TOKEN، ويحتفظ Claude Code بكل ميزاته بينما يتولّى Kimi K3 التفكير.
  • يربط ملف settings.json الرسمي كل مستويات النموذج بـ kimi-k3[1m] (نسخة السياق الممتد مليون رمز)، ومستوى Haiku بـ kimi-k2.7-code، ويضبط CLAUDE_CODE_AUTO_COMPACT_WINDOW على 1000000 وCLAUDE_CODE_EFFORT_LEVEL على max.
  • طريقتان للتحقق: شغّل /status وتأكد من Base URL واسم النموذج kimi-k3[1m]، أو اكتفِ بقراءة لافتة بدء التشغيل — في العرض التجريبي تقرأ Using kimi-k3 (from .claude/settings.json).
  • يعمل K3 بنظام الدفع حسب الاستخدام على منصة Kimi API Platform: 3 دولارات لكل مليون رمز إدخال، و15 دولارًا للإخراج، و0.30 دولار للإدخال المخزَّن مؤقتًا، بسياق يتجاوز مليون رمز. النموذج نفسه من نوع MoE بـ 2.8 تريليون معامل (104B نشطة) مع تفعيل التفكير دائمًا.

Kimi K3 + Claude Code Demo

عرض توضيحي مرئي:Data Science in your pocket8:11

فتح

Use Kimi in Claude Code — official guide

حقائق المنتج:platform.kimi.aiKimi API Platform docs

فتح

الخطوات 1-4 (التثبيت ومفتاح API وكتلة المتغيرات والتحقق بـ curl) موثّقة من الدليل الرسمي لـ Kimi لأنه لا توجد أي تسجيلة نظيفة لعملية الإعداد — كل شروحات YouTube تحمل كاميرا صاحبها. لقطات الخطوات 5-12 مقتطعة من تسجيل طرفية خالص يعمل فيه Claude Code v2.1.207 على kimi-k3.

اللقطات صور منسوبة إلى الفيديو المصدر، وكل واحدة مربوطة بطابقتها الزمنية. نص هذا الدليل أصلي وليس نقلًا للترجمة.

Kimi K3 في Claude Code، خطوة بخطوة

1 · توجيه Claude Code نحو Kimi K3

  1. 1

    تثبيت Claude Code

    استخدم المثبّت الأصلي من Anthropic: الأمر curl -fsSL https://claude.ai/install.sh | bash على macOS وLinux، أو الأمر irm https://claude.ai/install.ps1 | iex في PowerShell على Windows. مسار npm ممكن أيضًا: الأمر npm install -g @anthropic-ai/claude-code يتطلب Node.js 22 أو أحدث. لديك Claude Code مسبقًا؟ تجاوز هذه الخطوة — لكن إذا عدّلت أداة طرف ثالث ملف ~/.claude/settings.json من قبل، فنظّف أولًا قيم ANTHROPIC_* القديمة من حقل env، لأنها تتجاوز بصمت كل ما تصدّره في الطرفية.

  2. 2

    إنشاء مفتاح API من Kimi

    سجّل الدخول إلى platform.kimi.ai وافتح لوحة التحكم وأنشئ مفتاحًا من قسم API Keys. يُفتح K3 بعد عملية شحن ناجحة حدّها الأدنى دولار واحد — وهذا يكفي لمتابعة الدرس كاملًا. انتبه: هذه منصة Kimi API Platform بنظام الدفع حسب الاستخدام، أما اشتراكات Kimi Code وKimi Membership فهي منتجات مختلفة لا توفّر مفتاح API الذي يحتاجه هذا الإعداد.

  3. 3

    كتابة كتلة المتغيرات في ~/.claude/settings.json

    افتح (أو أنشئ) ملف ~/.claude/settings.json واملأ حقل env تمامًا كما يحدد الدليل الرسمي: ANTHROPIC_BASE_URL إلى https://api.moonshot.ai/anthropic، وANTHROPIC_AUTH_TOKEN بمفتاح Kimi، وANTHROPIC_MODEL مع مستويات OPUS وSONNET وFABLE وCLAUDE_CODE_SUBAGENT_MODEL كلها على kimi-k3[1m]، وANTHROPIC_DEFAULT_HAIKU_MODEL على kimi-k2.7-code، وCLAUDE_CODE_AUTO_COMPACT_WINDOW على 1000000، وCLAUDE_CODE_EFFORT_LEVEL على max. ربط كل مستوى أمر مهم: يرسل Claude Code طلبات الخلفية والوكلاء الفرعيين عبر هذه الأسماء البديلة، وغياب أحدها يعني فشلًا صامتًا. كتلة env تتجاوز متغيرات الطرفية وتخزّن مفتاحك نصًا صريحًا — لا ترفعها أبدًا إلى git.

  4. 4

    إثبات نقطة النهاية والمفتاح بأمر curl

    قبل تشغيل Claude Code، أرسل طلبًا برمز واحد مباشرة إلى المسار المتوافق مع Anthropic: الأمر curl https://api.moonshot.ai/anthropic/v1/messages مع ترويسة Authorization: Bearer تحمل مفتاح Kimi وجسم يتضمن model بقيمة kimi-k3 وmax_tokens بقيمة 1. رد JSON سليم يعني أن نقطة النهاية وبيانات الاعتماد تعملان. أما 401 فيعني أن المفتاح غير صالح أو أن Base URL لا تطابق المنصة التي أصدرت المفتاح أو أن ANTHROPIC_API_KEY متبقٍّ ويتصادم مع ANTHROPIC_AUTH_TOKEN — احذفه.

2 · التشغيل وإثبات أن K3 هو من يعمل

  1. 5

    تشغيل claude وقراءة اللافتة

    شغّل claude داخل مجلد مشروع. اللافتة تحكي القصة كاملة: Claude Code v2.1.207 في العرض التجريبي، ثم kimi-k3 · API Usage Billing، ثم السطر الحاسم — Using kimi-k3 (from .claude\settings.json) · /model. هذه هي كتلة المتغيرات وقد اعتُمدت؛ وملف .claude/settings.json على مستوى المشروع يعمل بالطريقة نفسها. إذا كانت لافتتك ما تزال تعرض سطر فوترة من Claude أو Anthropic، فعُد إلى الخطوة 3 وأعد تشغيل Claude Code.

    Claude Code v2.1.207 startup banner showing kimi-k3 with API Usage Billing and the line Using kimi-k3 (from .claude\settings.json), proof that the settings.json env block is routing Claude Code to Kimi K3
    لافتة البدء تسمّي kimi-k3 وملف settings.json الذي جاء منه.شاهد عند 0:22
  2. 6

    أرسل مهمة حقيقية، لا سؤال «من أنت»

    يبدأ العرض التجريبي بالأمر help me develop a game called snake and ladders. — طلب ملموس قابل للبناء. يفكر K3 قبل الإجابة: Thought for 16s، ثم ينساب الرد مع احتساب شريط الحالة Channeling… 25s · ↓1.0k tokens. انسَ اختبار سؤاله عن هويته: الإعدادات تربط أسماء Claude البديلة بهويات Kimi، فتعرّفه على نفسه لا يثبت شيئًا — الدليل القاطع هو /status واللافتة.

    Claude Code terminal with the prompt help me develop a game called snake and ladders answered after Thought for 16s while the Channeling status counts 25 seconds and 1.0k tokens on Kimi K3
    أول أمر أُرسل وK3 يفكر — عدّاد الرموز يبدأ بالعمل.شاهد عند 1:42
  3. 7

    الإجابة عن أسئلة التوضيح

    لا يخمّن K3 بل يسأل. يظهر منتقي بتبويبات — Platform وPlayers وRules وSubmit — يعرض خيارات مثل Web (HTML/CSS/JS) وPython console وPython + pygame أو نصًا من عندك، مع شرح تحت كل خيار. Enter يختار، وTab والأسهم للتنقل، وEsc للإلغاء. هذا السؤال المنظّم منذ البداية هو نصف سبب خروج النتيجة النهائية بلا إعادة عمل.

    Claude Code clarifying question What platform should the game run on with Web HTML/CSS/JS, Python console and Python + pygame options where Enter selects and Tab with arrow keys navigate, the structured answers Kimi K3 requests before writing code
    واجهة الأسئلة بالتبويبات: Enter يختار، وTab والأسهم للتنقل، وEsc للإلغاء.شاهد عند 2:04

3 · أمر واحد، لعبة واحدة: حلقة عمل K3

  1. 8

    راجع إجاباتك وأرسلها

    قبل أن يعمل أي شيء، يعرض Claude Code شاشة Review your answers: تبويبات Platform وPlayers وRules بعلامات خضراء — Python + pygame و1 player vs computer وClassic في العرض التجريبي — وSubmit answers بانتظار كخيار مميّز. ضغطة Enter واحدة بعدها يحصل الوكيل على المواصفات الكاملة. راجع هنا بعناية: فالخُطة تُبنى من هذه الاختيارات بالذات.

    Claude Code Review your answers screen listing Python + pygame, 1 player vs computer and Classic in green with Submit answers highlighted as the first option, the confirmation step before Kimi K3 starts building
    التبويبات الثلاثة كلها معلّمة — Submit answers تبعد عنك ضغطة Enter واحدة.شاهد عند 2:12
  2. 9

    اقرأ الخطة ودَعْه يثبّت ما ينقص

    تصل الخطة بخطوات قابلة للتحقق: فحص البيئة والتأكد من Python + pygame؛ كتابة اللعبة والتأكد من قابليتها للترجمة؛ اختبار منطق الرسم وعرضه دون واجهة بحيث تنتهي المباريات المحاكاة بفوز يبلغ المربع 100 تمامًا. يكتشف Python 3.13 ويجد pygame مفقودًا فيشغّل بنفسه الأمر python -m pip install pygame. لاحظ وقت التفكير — 4 دقائق و53 ثانية في نَفَس واحد — هذا عمل CLAUDE_CODE_EFFORT_LEVEL=max؛ فـ K3 يستخدم افتراضيًا أقصى جهد استدلال.

    Kimi K3 plan inside Claude Code listing check environment, write snake_and_ladders.py and smoke-test headlessly, then running python -m pip install pygame after detecting Python 3.13 without pygame
    الخطة ثلاثية الأجزاء، ثم التثبيت التلقائي لـ pygame على Python 3.13.شاهد عند 3:42
  3. 10

    وافق على الكتابة وراقب فحص الترجمة

    يكتب K3 ملف snake_and_ladders.py — 279 سطرًا في العرض التجريبي — ثم يتحقق من عمله بنفسه: أولًا فحص ترجمة (python -m py_compile … && echo "compile OK")، ثم اختبار دخان دون واجهة يرسم كل عنصر ويحاكي آلاف المباريات الكاملة. يعرض التذييل accept edits on (shift+tab to cycle)، وهو نمط الأذونات الذي يمرّر الكتابة دون تأكيد لكل ملف. والكتابة المرفوضة قابلة للاسترجاع — العرض نفسه تعافى من رفض عرضي وأعاد المحاولة.

    Claude Code reporting Wrote 279 lines to snake_and_ladders.py and then verifying with a python -m py_compile compile check and a headless smoke test that simulates thousands of full games, all under accept edits on
    كُتبت 279 سطرًا ثم تشغيل python -m py_compile في وضع accept edits on.شاهد عند 6:05

4 · نتيجة مُتحقَّق منها جاهزة للتشغيل

  1. 11

    اقرأ قائمة التحقق

    All checks pass. The game is done and verified — ويسرد Claude Code الأدلة: الترجمة ✓، والرسم — اللوحة والثعابين والسُلَم والنرد كلها ترسم بلا أخطاء ✓، وتخطيط اللوحة — المربع 1 أسفل اليسار بمسار متعرج حتى 100 ✓، والقواعد — التجاوز يُهدر والفوز يتطلب المربع 100 تمامًا ✓، و2000 مباراة محاكاة انتهت كلها بفائز ✓. وبعدها يطبع أمر التشغيل وملخصًا لما ستحصل عليه. هذه عادة تستحق التقليد: لا تصدّق الكود أبدًا، بل تحقّق منه بالمحاكاة.

    Claude Code verification checklist reading All checks pass with compile, rendering, board mapping, rules and 2000 simulated games ticked, above the Run it command python C:\Users\datas\snake_and_ladders\snake_and_ladders.py
    الترجمة والرسم وتخطيط اللوحة والقواعد و2000 مباراة محاكاة — كلها خضراء.شاهد عند 6:55
  2. 12

    شغّلها

    نفّذ الأمر المطبوع — python C:\Users\datas\snake_and_ladders\snake_and_ladders.py في العرض التجريبي — فتنفتح نافذة اللعبة: لوحة 10x10 بثعابين خضراء متعرجة وسُلَم بنية، مع لوحة جانبية SNAKES & LADDERS تعرض مؤشر الدور والنرد وزر Roll الأخضر. المسافة أو النقر يرمي النرد، وR يعيد التشغيل، وEsc يخرج. من جملة واحدة إلى لعبة قابلة للعب ومُتحقَّق منها ذاتيًا في نحو عشر دقائق من وقت K3.

    Snake and Ladders pygame window with a 10x10 board of green snakes and brown ladders beside a SNAKES & LADDERS panel showing Turn You, a dice face and a green Roll button, the game Kimi K3 built end to end in Claude Code
    نافذة Snakes & Ladders المكتملة، أُطلقت بالأمر الذي طبعه K3.شاهد عند 7:35

الأسئلة الشائعة حول Kimi K3 + Claude Code

واصل الاستكشاف

دليل GLM Coding Planدرس Claude Code Routerاستخدم DeepSeek في Cursorدرس DeepSeek مع Clineكل الأدلة