دليل · الذكاء الاصطناعي في Roblox Studio

كيف تربط Claude Code بـ Roblox Studio

Claude Code أداة وكيلة من Anthropic لكتابة الكود. تذكره Roblox كعميل quick connect لخادم MCP المدمج في Studio، لذا يستطيع قراءة مكانك وتعديل السكربتات وتشغيل اختبارات اللعب (playtest) في نافذة Studio المفتوحة عندك. ويستطيع أيضًا العمل على سكربتاتك كملفات عبر Script Sync أو Rojo. هذا الدليل عن جانب Claude Code: ماذا تحتاج، وكيف تربطه، والأذونات، وملف CLAUDE.md بقواعد Roblox، وطريقة العمل الآمنة، وكم يكلف ذلك. عن وكيل OpenAI راجع دليل كيف تستخدم OpenAI Codex مع Roblox Studio (بالإنجليزية)؛ وعن Cursor وClaude Desktop والعملاء الآخرين راجع دليل إعداد Studio MCP.

آخر تحديث ٢٠ نوفمبر ٢٠٢٦القراءة في 19 دبقلم

باختصار

ثبّت Claude Code وسجّل الدخول بخطة Claude مدفوعة أو بحساب Claude Console. في Studio افتح Assistant، واضغط … > Manage MCP Servers، وفعّل Enable Studio as MCP server، ثم فعّل Claude Code في قائمة Quick connect. أعد تشغيل Claude Code، واكتب /mcp لتتأكد أن خادم Studio متصل، وابدأ بطلب يقرأ فقط.

  • Claude Code غير متاح في خطة Free من Anthropic. إنه مضمّن في Pro وMax وTeam وEnterprise، أو يُدفع حسب حجم استخدام API عبر حساب Claude Console (تم التحقق في 9 أكتوبر 2026).
  • استخدم جلسة محلية: الطرفية، أو إضافة VS Code أو Cursor، أو تطبيق سطح المكتب مع اختيار Local. الجلسات السحابية لا تعمل على حاسوبك ولا تصل إلى Studio.
  • بدءًا من v2.1.283 تبدأ جلسات الطرفية وVS Code افتراضيًا في وضع auto حيث يكون متاحًا، لذا أضف قواعد ask لأدوات Studio التي تغيّر المكان. والأمر /rewind في Claude Code لا يتراجع عن التغييرات التي حدثت في Studio، فاحفظ نسخة أولًا.
في هذه الصفحة
  1. ماذا تحتاج
  2. 1. التثبيت والدخول
  3. 2. الربط بـ Studio
  4. 3. الأذونات
  5. 4. الطلب الأول
  6. 5. Script Sync أو Rojo
  7. 6. CLAUDE.md
  8. العمل الآمن
  9. التكلفة
  10. حل المشكلات
  11. وكيل عبر إضافة
  12. الأسئلة الشائعة
  13. المصادر والقراءات

ماذا تحتاج قبل البدء

المتطلبات، حسب توثيق Roblox وAnthropic، 9 أكتوبر 2026
ما تحتاجهالتفاصيل
Roblox Studioأحدث نسخة، على Windows أو macOS. خادم MCP مدمج في Studio، لذا لا تحتاج إلى تثبيت أي شيء آخر من جهة Roblox.
حاسوب يدعم Claude CodemacOS 13.0 أو أحدث، أو Windows 10 1809 أو أحدث، وذاكرة 4 GB على الأقل، واتصال بالإنترنت، وأن تكون في بلد تدعمه Anthropic.
حساب Claude يشمل Claude Codeخطة Claude مدفوعة (Pro أو Max أو Team أو Enterprise) أو حساب Claude Console. تقول صفحة أسعار Anthropic إن Claude Code غير مضمّن في خطة Free.
العمرتنص Consumer Terms من Anthropic (سارية منذ 8 أكتوبر 2025) على أن عمرك يجب ألا يقل عن 18 عامًا أو عن الحد الأدنى لسن الموافقة في بلدك إذا كان أعلى.
اختياريGit لحفظ سجل السكربتات. وVisual Studio Code 1.94.0 أو أحدث أو Cursor إذا أردت Claude Code في لوحة المحرر بدلًا من الطرفية.

أي نسخة من Claude Code تستخدم

يعمل Claude Code في عدة أماكن. تقول Anthropic إن المحرك واحد في جميعها، لذا تعمل ملفات CLAUDE.md والإعدادات وخوادم MCP في كل مكان. المهم بالنسبة إلى Studio هو أين تجري الجلسة: خادم MCP من Roblox عملية محلية على حاسوبك، لذا يجب أن تكون الجلسة على حاسوبك أيضًا.

نسخ Claude Code وRoblox Studio
النسخةهل تصل إلى Studio؟ملاحظات
الطرفية (الأمر claude)نعمشغّلها في مجلد المشروع. وهي لازمة أيضًا لأوامر claude mcp أدناه.
إضافة VS Code أو Cursorنعمالمسار الوارد في دليل Roblox عن coding harness. تحتوي الإضافة على نسختها الخاصة من Claude Code، لكنها لا تضيف claude إلى PATH، فإذا احتجت إلى تلك الأوامر فثبّت نسخة الطرفية أيضًا.
تطبيق سطح المكتب، تبويب Code، مع اختيار Localنعميعمل على حاسوبك. تقول Anthropic إنه يحتاج إلى اشتراك مدفوع.
الجلسات السحابية (claude.ai/code أو Cloud في تطبيق سطح المكتب)لاتعمل على بنية سحابية، لا على حاسوبك، لذا لا تستطيع تشغيل خادم Studio المحلي.

الخطوة 1: ثبّت Claude Code وسجّل الدخول

توصي Anthropic بالتثبيت بأمر واحد في الطرفية. هذه هي الأوامر التي كانت في صفحة التثبيت لديها في 9 أكتوبر 2026؛ راجع الأوامر الحالية في صفحة التثبيت من Anthropic.

الطرفية · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. افتح نافذة طرفية جديدة ونفّذ claude --version. ظهور رقم النسخة يعني أن كل شيء نجح. إذا لم يُعثر على الأمر، فمجلد التثبيت ليس في PATH بعد، والحل موجود في صفحة Anthropic عن مشكلات التثبيت.
  2. انتقل إلى مجلد المشروع ونفّذ claude. عند أول تشغيل يفتح نافذة متصفح لتسجيل الدخول. إذا لم يُفتح المتصفح، فاضغط c لنسخ رابط الدخول.
  3. سجّل الدخول إلى حساب Claude الخاص بك. الدخول بخطة Pro أو Max يستخدم الحدود المضمّنة في خطتك.

على Windows توصي Anthropic بتثبيت Git for Windows حتى يستطيع Claude Code استخدام أداة Bash الخاصة به؛ ومن دونه ينفّذ Claude Code الأوامر في PowerShell. لهذا الإعداد ثبّت Claude Code في Windows نفسه، لا داخل WSL: إعداد Roblox لنظام Windows يشغّل cmd.exe بمسار %LOCALAPPDATA%، ولا يوثّق Roblox نظام WSL.

تفضّل لوحة داخل المحرر؟ في VS Code أو Cursor افتح Extensions (Ctrl+Shift+X أو Cmd+Shift+X على Mac)، وابحث عن Claude Code، وثبّته، وسجّل الدخول من لوحة Claude. هذا هو الإعداد الذي يستخدمه دليل Roblox عن coding harness.

الخطوة 2: اربط Claude Code بـ Studio

فعّل الخادم أولًا. في Studio افتح Assistant، واضغط … > Manage MCP Servers، وفعّل Enable Studio as MCP server. يشرح دليل Studio MCP هذه الخطوة بتفصيل أكبر. لا يوجد زر Assistant؟ راجع كيف تفتح لوحة Assistant.

Quick connect

  1. في اللوحة نفسها (Assistant Settings > MCP Servers) افتح قائمة Quick connect. فيها العملاء المدعومون المثبتون على حاسوبك.
  2. فعّل Claude Code. إذا لم يكن موجودًا، فثبّت Claude Code وأعد تشغيل Studio.
  3. أعد تشغيل Claude Code: أنهِ الجلسة ونفّذ claude مجددًا، أو ابدأ محادثة جديدة في الإضافة. تقول Roblox إن العميل يحتاج إلى إعادة تشغيل حتى يلتقط الإعداد الجديد.

لا تقول Roblox في أي ملف يكتب Claude Code إعداد quick connect ولا بأي اسم يسمّي الخادم. اكتب /mcp في Claude Code لترى الاسم. ستحتاج إليه لقواعد الأذونات في الخطوة 3.

تستخدم إضافة Claude Code في VS Code أو Cursor؟ فعّل Claude Code هنا أيضًا. يتضمن دليل Roblox عن coding harness برنامج Cursor أو Visual Studio Code، لكن Anthropic توثّق أن الإضافة تتشارك إعداد MCP مع نسخة الطرفية من Claude Code، ولا تقول إنها تقرأ إعدادات MCP الخاصة بالمحرر.

الإعداد اليدوي عبر ملف .mcp.json

إذا لم يعمل quick connect عندك، فأضف Studio بنفسك. يقرأ Claude Code خوادم MCP الخاصة بالمشروع من ملف اسمه .mcp.json في مجلد المشروع، بصيغة mcpServers نفسها التي يوثّقها Roblox، ويعتبر المدخل الذي لا يحتوي على type خادم stdio محليًا. لذلك يعمل إعداد Roblox كما هو. احفظ النسخة المناسبة لنظامك باسم .mcp.json في المجلد الذي تشغّل فيه claude:

.mcp.json · Windows (إعداد Roblox)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}
.mcp.json · macOS (إعداد Roblox)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

في المرة القادمة التي تشغّل فيها claude في هذا المجلد، سيطلب الموافقة على الخادم: تعرض Anthropic هذا الطلب لكل خادم يأتي من ملف .mcp.json. صمّمت Anthropic هذا الملف ليُرفع إلى المستودع ويتشاركه الفريق كله، لكن مسارات Windows وmacOS مختلفة. إذا كان فريقك يستخدم النظامين، فأبقِ الملف خارج المستودع، وليضف كل واحد Studio لنفسه.

على macOS يمكنك بدلًا من ذلك إضافة Studio بأمر واحد. يجعله --scope user متاحًا في كل مشروع على حاسوبك؛ ومن دونه يُحمَّل الخادم في المجلد الحالي فقط. ويفصل -- خيارات Claude Code الخاصة عن الأمر الذي يشغّل الخادم.

الطرفية · macOS
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

على Windows يكون مسار ملف JSON أسهل، لأن PowerShell وCMD يعالجان %LOCALAPPDATA% في سطر الأوامر بطريقتين مختلفتين.

تحقّق من الاتصال

  • في الطرفية يعرض claude mcp list كل خادم وحالته. ويعرض claude mcp get Roblox_Studio تفاصيل أكثر، منها سطر Issue: إذا لم يستطع الخادم الاتصال.
  • داخل Claude Code اكتب /mcp. بجانب اسم كل خادم متصل يظهر عدد الأدوات.
  • في Studio تعرض Assistant > … > Manage MCP Servers مؤشرًا أخضر بعدد العملاء المتصلين.

الخطوة 3: قرّر ما يمكن لـ Claude فعله دون أن يسأل

اضبط هذا قبل أن يلمس Claude مكانك. حسب صفحة Anthropic عن أوضاع الأذونات، بدءًا من Claude Code v2.1.283 تبدأ الجلسات التفاعلية في الطرفية وVS Code افتراضيًا في وضع auto حيثما كان متاحًا، وفي وضع auto يفحص مصنّف يعمل في الخلفية الإجراءات بدلًا منك. عندها قد يمر استدعاء MCP يعدّل سكربتًا أو ينفّذ Luau في Studio دون أي طلب.

هناك طريقتان لإبقاء كل تغيير بين يديك:

  • شغّل في وضع Manual. نفّذ claude --permission-mode default. في وضع Manual لا يُنفَّذ دون سؤال إلا القراءة. اضغط Shift+Tab أثناء الجلسة للتبديل بين الأوضاع.
  • أضف قواعد ask لأدوات Studio التي تغيّر شيئًا. تقول Anthropic إنه لا يوجد وضع يوافق تلقائيًا على أداة تنطبق عليها قاعدة ask صريحة، ولا حتى وضع bypass.
.claude/settings.json · مثال
{
  "permissions": {
    "allow": [
      "mcp__Roblox_Studio__list_roblox_studios",
      "mcp__Roblox_Studio__get_studio_state",
      "mcp__Roblox_Studio__search_game_tree",
      "mcp__Roblox_Studio__inspect_instance",
      "mcp__Roblox_Studio__script_read",
      "mcp__Roblox_Studio__script_search",
      "mcp__Roblox_Studio__script_grep",
      "mcp__Roblox_Studio__get_console_output"
    ],
    "ask": [
      "mcp__Roblox_Studio__multi_edit",
      "mcp__Roblox_Studio__execute_luau",
      "mcp__Roblox_Studio__start_stop_play",
      "mcp__Roblox_Studio__subagent",
      "mcp__Roblox_Studio__insert_asset",
      "mcp__Roblox_Studio__upload_image",
      "mcp__Roblox_Studio__generate_mesh",
      "mcp__Roblox_Studio__generate_material",
      "mcp__Roblox_Studio__generate_procedural_model"
    ]
  }
}

قواعد MCP بالشكل mcp__<server>__<tool>، مع اسم الخادم كما يعرفه Claude Code. استبدل Roblox_Studio بالاسم الذي يعرضه /mcp. قواعد allow في ملف المشروع .claude/settings.json لا تسري إلا بعد أن تقبل حوار الثقة بمجلد العمل لهذا المجلد. وللقواعد التي تخصك وحدك استخدم .claude/settings.local.json.

قائمة allow تغطي الأدوات التي تقرأ فقط: شجرة اللعبة، والخصائص، والسكربتات، وOutput، وقائمة نوافذ Studio المفتوحة. وقائمة ask تغطي الأدوات التي تغيّر المكان أو تنفّذ الكود أو تشغّل اختبارات اللعب أو تُدخل أصولًا خارجية أو ترسل صورًا إلى Roblox. والأدوات غير الموجودة في أي من القائمتين، مثل screen_capture وأدوات الإدخال، تخضع لوضع الأذونات لديك. القائمة الكاملة للأدوات مع وصف كل منها موجودة في دليل Studio MCP.

الخطوة 4: ابدأ بطلب يقرأ فقط

افتح المكان الذي تريد العمل عليه، وأغلق الأماكن التي لا تريدها. ثم أعطِ Claude طلبًا أول لا يستطيع تغيير أي شيء:

الطلب
Use the Roblox Studio MCP tools. Call list_roblox_studios and tell me which place you are connected to, then list what is in Workspace. Do not change anything.

في Baseplate جديدة يتوقع دليل Roblox عن coding harness أن يسرد الرد العناصر القياسية Camera وTerrain وBaseplate وSpawnLocation. وطلب list_roblox_studios أولًا عادة جيدة: عميل واحد يصل إلى كل نافذة Studio مفتوحة عندك، وكل استدعاء أداة يحدد النافذة المستهدفة عبر studio_id.

لأي شيء أكبر من سكربت واحد، اطلب خطة أولًا. في وضع plan (اضغط Shift+Tab أو ابدأ الطلب بـ /plan) يستكشف Claude ويقترح دون أن يعدّل ملفاتك. تصف Anthropic وضع plan من حيث تعديلات الملفات وأوامر الطرفية، لذا أبقِ قواعد ask لأدوات Studio أيضًا.

الخطوة 5: اعمل على السكربتات كملفات عبر Script Sync أو Rojo

بُني Claude Code حول الملفات في مجلد. يعدّلها بأدواته، ويحفظ Git سجلها، ويستطيع /rewind استعادتها. إذا وضعت السكربتات على القرص، يمكنك الاستفادة من كل ذلك، وتبقى أدوات MCP لأجزاء المكان التي ليست سكربتات، مثل واجهات GUI في StarterGui وRemoteEvent والقطع. يوثّق Roblox طريقتين لفعل ذلك.

Script Sync وRojo، حسب صفحتي Roblox عن Script Sync والأدوات الخارجية
Script SyncRojo
ما هوميزة في Studio تزامن السكربتات في المكان مع ملفات على القرص، في الاتجاهين.أداة خارجية: خادم على حاسوبك مع إضافة لـ Studio.
ماذا يزامنكائنات Script وLocalScript وModuleScript وFolder فقط. تُتجاهل الكائنات الأخرى في المجلد المتزامن.يستطيع إدارة المشروع كله كملفات، ويكون نظام ملفاتك هو مصدر الحقيقة.
الإعدادانقر بالزر الأيمن على خدمة أو مجلد في Explorer، واختر Sync to… وحدّد المجلد. يفعّله دليل Roblox عن coding harness أولًا في File > Beta Features.ثبّته عبر Rokit (rokit add rojo-rbx/rojo، ثم rokit install)، وأضف الإضافة بالأمر rojo plugin install، ونفّذ rojo serve واتصل من الإضافة.
Team Createيعمل معه. تجنّب أن يعدّل شخصان السكربت المتزامن نفسه في الوقت نفسه.تشير Roblox إلى أن الأدوات الخارجية كثيرًا ما لا تعمل مع أدوات التعاون المدمجة لديها.
نصيحة Robloxمناسب إذا أردت محررك الخاص والتحكم في النسخ للكود، وStudio لكل ما عدا ذلك.الخيار الأفضل إذا أردت وضع المشروع كله تحت التحكم في النسخ، لا الكود فقط.

اسم الملف نفسه قد يعني أشياء مختلفة

كلتا الأداتين تختار نوع السكربت من اسم الملف، واللواحق عندهما لا تتطابق. ملف .client هو LocalScript في Rojo، لكنه Script بسياق تشغيل Client في Script Sync. أخبر Claude أي أداة يستخدمها مشروعك؛ ومثال CLAUDE.md أدناه يفعل ذلك.

قواعد Script Sync من صفحة Roblox عن Script Sync (ملفات .luau). قواعد Rojo من صفحة Sync Details لـ Rojo v7، التي تسرد ملفات .lua
اسم الملف ينتهي بـينشئ Script Syncينشئ Rojo
.serverScript بسياق تشغيل ServerScript
.clientScript بسياق تشغيل ClientLocalScript
.localLocalScriptلا معنى خاص له (أي ملف .lua آخر هو ModuleScript)
دون لاحقةModuleScriptModuleScript
مجلد فيه ملف initسكربت له كائنات فرعية، يحدد نوعه اسم ملف initيصبح المجلد سكربتًا يصفه init.server.lua أو init.client.lua أو init.lua

إعداد Script Sync لـ Claude Code

  1. أنشئ مجلد مشروع فيه مجلد لكل خدمة تريد إبقاءها على القرص، مثل ServerScriptService وReplicatedStorage وStarterPlayerScripts، ونفّذ فيه git init.
  2. إذا لم يظهر Script Sync عندما تنقر بالزر الأيمن على خدمة، ففعّله في File > Beta Features، واضغط Save وأعد تشغيل Studio.
  3. في Explorer انقر بالزر الأيمن على ServerScriptService، واختر Script Sync > Sync to وحدّد مجلد المشروع في المستوى الأعلى، لا مجلدًا داخله. كرّر ذلك لبقية الخدمات.
  4. نفّذ claude في هذا المجلد. الآن يعدّل Claude ملفات .luau، ويلتقط Studio كل تغيير.
  5. اعمل commit قبل كل جلسة، حتى تكون لديك دائمًا نقطة نظيفة يمكن العودة إليها.
الطرفية، في مجلد المشروع
git add .
git commit -m "Before Claude session"

مع وجود وكيل تصبح قاعدتان في Script Sync أهم. لا تزامن السكربتات التي لها سمات (attributes) أو وسوم (tags): يتجاهلها Script Sync، وتحذّر Roblox من أن ذلك قد يؤدي إلى فقدان البيانات. وإذا تغيّرت الملفات وStudio مغلق، فعند إعادة فتح المكان يسألك Studio كيف تحل ذلك، ويسرد ما سيضيفه أو يغيّره أو يحذفه Keep Studio وKeep Disk. اقرأ هذه القائمة قبل أن تختار.

مع تفعيل Script Sync يصل تعديل الملف إلى Studio فور حفظه. قبول التعديل في Claude Code يعني قبوله في مكانك، لذا راجع قبل أن تقبل، خاصة في الأوضاع التي تقبل التعديلات تلقائيًا.

للإكمال التلقائي وأخطاء الأنواع في المحرر توصي Roblox بإضافة Luau Language Server مع إضافتها المرافقة لـ Studio. في VS Code تستطيع إضافة Claude Code قراءة لوحة Problems عبر أداة مدمجة، فيرى Claude التحذيرات نفسها التي تراها.

الخطوة 6: أعطِ Claude قواعدك الخاصة بـ Roblox في CLAUDE.md

كل جلسة في Claude Code تبدأ بسياق جديد. يُقرأ ملف CLAUDE.md في مجلد المشروع في بداية كل جلسة، لذا يجب أن تكون اتفاقياتك فيه. نفّذ /init ليكتب Claude مسودته، أو اكتبه بنفسك. تنصح Anthropic بإبقائه أقصر من 200 سطر، وبكتابة القواعد محددة بما يكفي ليمكن التحقق منها، وبتنفيذ /context للتأكد من أنه حُمِّل.

هذا المثال مكتوب لهذا الدليل، لمشروع يستخدم Script Sync. غيّر الأسماء لتناسب لعبتك واحذف ما لا تحتاجه.

CLAUDE.md · مثال لمشروع يستخدم Script Sync
# Roblox project rules (example: edit to fit your game)

## Project
- Roblox game "Wave Survival". The place open in Studio is named WaveSurvival.
- Scripts sync to Studio with Script Sync:
  - ServerScriptService/ holds server game logic
  - ReplicatedStorage/ holds ModuleScripts shared by server and client
  - StarterPlayerScripts/ holds client code
- File names set the script type (Script Sync rules):
  - name.server.luau = Script with Server run context
  - name.local.luau = LocalScript
  - name.luau = ModuleScript
  - Do not use name.client.luau unless I ask. In Script Sync it makes a Script with Client run context, not a LocalScript.
- Never add attributes or tags to synced scripts. Script Sync ignores them.

## Roblox Studio MCP
- Call list_roblox_studios first. Work only in the place named WaveSurvival.
- Edit synced scripts as files, not with multi_edit.
- Use the MCP tools only for what is not a synced script: GUIs in StarterGui, RemoteEvents, parts, attributes.
- Never use insert_asset, upload_image or the generate tools unless I ask in this session.
- Ask before deleting any instance you did not create in this session.

## Luau
- Use task.wait, task.spawn and task.delay. Never wait, spawn or delay.
- Get services with game:GetService.
- The server decides coins, health, inventory and rewards. A LocalScript only asks.
- Every OnServerEvent handler checks the type and size of each argument and limits how often each player can call it.
- Wrap DataStore and HttpService calls in pcall and handle the failure.
- Remove per-player table entries in Players.PlayerRemoving.
- Never put API keys, webhook URLs or passwords in scripts or in this repository.

## Before you say a task is done
- List every script and instance you changed.
- Read the Output with get_console_output and report any errors.
- Tell me what to playtest by hand.

بعض الأسطر موجودة بسبب طريقة عمل الأدوات. قواعد أسماء الملفات موجودة لأن .client.luau في Script Sync ليس LocalScript. وسطر list_roblox_studios موجود لأن الخادم يصل إلى كل نافذة مفتوحة. وسطر الأصول موجود لأن insert_asset يُدخل محتوى خارجيًا إلى المكان، وupload_image يرسل الصور إلى خادم أصول Roblox. وسطر wait يتبع مرجع API من Roblox، الذي يصنّف wait وspawn وdelay كدوال قديمة لصالح مكتبة task.

إذا كان في مشروعك ملف AGENTS.md لوكلاء برمجة آخرين، فيستطيع Claude Code قراءته كتعليمات للمشروع، لذا يمكنك إبقاء ملف واحد للاثنين. وتشرح صفحة Anthropic عن الذاكرة أي ملف يفوز عندما يوجد الاثنان.

كيف تبدو هذه القواعد في الكود

هذا سكربت خادم يتبع قواعد Luau أعلاه. كُتب يدويًا لهذا الدليل، ولم يولّده Claude. استخدمه مقياسًا عندما تراجع ما يسلّمه Claude. يطلب LocalScript الأداة عبر RequestTool:FireServer("Sword")، والخادم يتحقق من كل شيء.

Script في ServerScriptService باسم ToolRequests
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")

local COOLDOWN_SECONDS = 1
local MAX_NAME_LENGTH = 50
local toolsFolder = ServerStorage:WaitForChild("Tools")

-- يزامن Script Sync السكربتات والمجلدات فقط، لذا ينشئ الخادم الـ remote الخاص به بنفسه.
local function getRemote(name: string): RemoteEvent
	local existing = ReplicatedStorage:FindFirstChild(name)
	if existing and existing:IsA("RemoteEvent") then
		return existing
	end
	local remote = Instance.new("RemoteEvent")
	remote.Name = name
	remote.Parent = ReplicatedStorage
	return remote
end

local requestTool = getRemote("RequestTool")
local lastRequest: { [Player]: number } = {}

local function onRequestTool(player: Player, toolName: unknown)
	-- نتجاهل الطلب الذي وصل بعد خروج اللاعب.
	if player.Parent ~= Players then
		return
	end

	-- 1. نتحقق من الوسيط: العميل يستطيع إرسال أي شيء.
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. نحدّ من عدد المرات التي يستطيع فيها لاعب واحد الطلب.
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. القرار للخادم. أضف هنا فحص الملكية الخاص بك (gamepass، سجل الشراء).
	local template = toolsFolder:FindFirstChild(toolName)
	if not (template and template:IsA("Tool")) then
		return
	end
	local backpack = player:FindFirstChildOfClass("Backpack")
	local character = player.Character
	if not backpack or backpack:FindFirstChild(toolName) then
		return
	end
	if character and character:FindFirstChild(toolName) then
		return
	end

	template:Clone().Parent = backpack
end

requestTool.OnServerEvent:Connect(onRequestTool)

-- 4. تنظيف بيانات اللاعب.
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

على القرص مع Script Sync: ServerScriptService/ToolRequests.server.luau. ضع كائنات Tool في Folder باسم Tools داخل ServerStorage. وإلى أن تضيف فحص الملكية، يستطيع كل لاعب الحصول على أي أداة من هذا المجلد.

ابحث عن الأمور نفسها في أي معالج remote يكتبه Claude: يتحقق من نوع ما أرسله العميل وحجمه، ويحد من عدد المرات التي يستطيع فيها لاعب واحد استدعاءه، والقرار للخادم، ويُحذف سجل اللاعب عندما يخرج. يشرح دليل RemoteEvent لماذا يهم كل بند.

طريقة عمل آمنة: نقطة حفظ، مراجعة، اختبار لعب

  1. أنشئ نقطة حفظ في الجانبين. اعمل commit للملفات في Git واحفظ نسخة من المكان في Studio عبر File > Save to Roblox with Notes. يبيّن دليل Studio MCP كيف تستعيدها من Version History.
  2. اطلب خطة لأي شيء أكبر من سكربت واحد، واقرأها قبل أن توافق عليها.
  3. راجع الـ diff. للملفات اقرأ git diff أو عروض diff المدمجة في الإضافة قبل أن تقبل. وللتغييرات التي حدثت في Studio اقرأ السكربتات التي لمسها Claude، وافحص Explorer بحثًا عن كائنات ظهرت أو اختفت.
  4. اختبر بنفسك. يستطيع Claude تشغيل اختبار لعب وقراءة Output، لكنه يفحص فقط ما قرر فحصه بنفسه. العب الميزة كما سيلعبها اللاعب قبل أن تعمل commit أو تنشر.
  5. اعمل commit عندما يعمل كل شيء، مع رسالة تقول ما الذي تغيّر.

ما الذي يستطيع /rewind التراجع عنه وما الذي لا يستطيعه

يحفظ Claude Code نقطة حفظ قبل كل طلب، ويستعيد /rewind (أو الضغط على Esc مرتين) الملفات التي غيّرها Claude بأدوات تعديل الملفات الخاصة به. تسرد Anthropic ما لا يتتبعه، ومنه التغييرات التي تحدث بأوامر الطرفية. التغييرات التي تحدث في Studio عبر أدوات MCP ليست تعديلات ملفات، لذا لا تتوقع أن يتراجع عنها /rewind، ولا تقول صفحة MCP من Roblox هل تدخل في سجل التراجع في Studio. مع Script Sync يتزامن الملف الذي استعاده /rewind عائدًا إلى Studio، مثل أي تغيير آخر على القرص. ولكل ما عدا ذلك فطريق العودة هو النسخة المحفوظة.

أبقِ الأسرار والبيانات الحية بعيدًا عن المتناول

  • لا تلصق مفاتيح API أو مفاتيح Open Cloud أو روابط webhook أو كلمات المرور في الطلب أو في CLAUDE.md. كلاهما نص يقرؤه Claude، وCLAUDE.md يُرفع عادة إلى المستودع.
  • ولا تضعها داخل السكربتات أيضًا. لدى Roblox مخزن أسرار لكل لعبة: أنشئ الأسرار في Creator Dashboard واقرأها في سكربت الخادم عبر HttpService:GetSecret(). ولاختبارات اللعب المحلية أضف أسرارًا محلية في File > Experience Settings > Security.
  • أبقِ الإعدادات الشخصية في .claude/settings.local.json وCLAUDE.local.md، وهما مصممان للبقاء خارج Git. أضف CLAUDE.local.md إلى .gitignore بنفسك.
  • فعّل Enable Studio Access to API Services فقط في نسخة اختبار منفصلة من اللعبة. تحذّر Roblox من أن Studio يستخدم مخازن البيانات نفسها التي تستخدمها اللعبة الحية، لذا قد يكتب اختبار اللعب الذي يشغّله Claude هناك فوق بيانات لاعبين حقيقية.
  • اقرأ أي skill من جهة خارجية قبل تثبيته. في كتالوجات الـ skills توجد skills لـ Roblox خاصة بـ Claude Code، وتشير Anthropic إلى أن الـ skill يستطيع منح نفسه وصولًا واسعًا إلى الأدوات عبر الحقل allowed-tools.

كم يكلف Claude Code للعمل على Roblox

لا يوجد سعر موثّق لجانب Studio: خادم MCP جزء من Studio، ولا تذكر صفحة MCP من Roblox أي رسوم. التكلفة هي تكلفة Claude Code، وتقدّم Anthropic طريقتين للدفع (حتى 9 أكتوبر 2026):

  • اشتراك Claude. Claude Code مضمّن في Pro وMax وTeam وEnterprise، لكن ليس في Free. ويستهلك حد الاستخدام نفسه الذي يستهلكه Claude على الويب وسطح المكتب والهاتف. تُعاد الحدود على نافذة متحركة مدتها خمس ساعات، ولدى الخطط المدفوعة فوق ذلك حدود أسبوعية. عندما تصل إلى أحدها، يمكنك الانتظار، أو الانتقال إلى خطة أعلى، أو تفعيل أرصدة الاستخدام.
  • حساب Claude Console. تدفع مقابل استخدام API حسب حجم النص المعالَج. تقول صفحة Anthropic عن التكاليف إن الإنفاق يعتمد كثيرًا على اختيار النموذج وحجم قاعدة الكود وطريقة استخدامك.

الأسعار الحالية موجودة على claude.com/pricing. لا يكررها هذا الدليل لأنها تتغير. داخل Claude Code يعرض الأمر /usage للمشتركين مقاييس استخدام الخطة، ولمستخدمي API التكلفة التقريبية للجلسة.

ما الذي يجعل جلسة Roblox تستهلك أكثر

  • حجم السياق. يزداد الاستهلاك مع ما يوجد في سياق Claude. استخدم /clear بين المهام غير المترابطة.
  • نتائج الأدوات الكبيرة. التجول في شجرة اللعبة كلها في مكان كبير أو قراءة سكربتات طويلة كاملة يعيد نصًا كثيرًا. يحسب Claude Code النص بالوحدات التي يقيسه بها النموذج: ينبّه عندما تتجاوز نتيجة أداة MCP عشرة آلاف (10,000) من هذه الوحدات، ويحدّها افتراضيًا عند 25,000. اطلب بدلًا من ذلك مجلدًا واحدًا، أو حدًا للعمق، أو نطاق أسطر: كل من search_game_tree وscript_read يدعم ذلك.
  • اختيار النموذج. تقول Anthropic إن Sonnet يتعامل جيدًا مع معظم مهام البرمجة ويكلف أقل من Opus. بدّل عبر /model.

حل مشكلات Claude Code وStudio

قائمة التحقق الخاصة بـ Roblox قصيرة: أعد تشغيل Studio والعميل، وتأكد أن مسار الأمر موجود، وافحص JSON. هذه هي الحالات الخاصة بـ Claude Code تحديدًا.

Claude Code غير موجود في قائمة Quick connect

القائمة تعرض فقط العملاء المدعومين المثبتين على حاسوبك. ثبّت Claude Code، ثم أعد تشغيل Studio. إذا ثبّتّه وStudio مفتوح، فأعد تشغيل Studio أو Claude Code أو كليهما. ملف .mcp.json من الخطوة 2 يعمل دون quick connect.

الأمر /mcp لا يعرض خادم Roblox Studio

أعد تشغيل Claude Code بعد إضافة الخادم. ثم تحقّق أين أُضيف: الخادم المضاف دون --scope يُحمَّل فقط في المجلد الذي أضفته فيه، لذا شغّل claude من ذلك المجلد أو أضفه مجددًا مع --scope user. في VS Code ابدأ محادثة جديدة، لأن التغييرات تنطبق على المحادثات التي تبدأ بعدها.

الخادم يعرض Pending approval

جاء من ملف .mcp.json، ويسأل Claude Code قبل استخدام مثل هذه الخوادم. نفّذ claude في هذا المجلد، واقبل حوار الثقة بمجلد العمل، ووافق على الخادم. ويعيد claude mcp reset-project-choices ضبط القرارات السابقة.

الخادم يعرض Failed to connect

نفّذ claude mcp get Roblox_Studio واقرأ سطر Issue:. تأكد أن الملف موجود: %LOCALAPPDATA%\Roblox\mcp.bat على Windows، و/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP على macOS (غيّر المسار إذا كان Studio مثبتًا في مكان آخر). تأكد أن Enable Studio as MCP server ما زال مفعّلًا، ثم أعد تشغيل Studio وClaude Code.

الطرفية تقول إن claude غير معروف

بعد التثبيت افتح نافذة طرفية جديدة. إذا ظل الأمر غير موجود، فمجلد التثبيت ليس في PATH؛ والحل موجود في صفحة Anthropic عن مشكلات التثبيت. إضافة VS Code لا تضيف claude إلى PATH، لذا ثبّت نسخة الطرفية بشكل منفصل لأوامر هذا الدليل.

Claude غيّر المكان الخطأ

عند فتح عدة نوافذ Studio، يحدد كل استدعاء أداة هدفه عبر studio_id. اطلب من Claude استدعاء list_roblox_studios وسمِّ المكان المطلوب، وأغلق النوافذ التي لا تستخدمها، واستعد المكان الذي تغيّر من Version History.

Claude Code يخصم من مفتاح API الخاص بي لا من الخطة

بمجرد أن توافق عليه، يتقدّم متغير البيئة ANTHROPIC_API_KEY على الاشتراك. احذف المتغير (أو أوقف Use custom API key في /config)، وشغّل Claude Code من جديد، ونفّذ /status لتتحقق من الدخول النشط. إذا ظل حساب Console، فنفّذ /login واختر حساب Claude الخاص بك.

الجلسة السحابية لا ترى Studio

الجلسات السحابية تعمل على بنية Anthropic، لا على حاسوبك، لذا لا تصل إلى خادم Studio المحلي. استخدم الطرفية، أو إضافة المحرر، أو تطبيق سطح المكتب مع اختيار Local.

أو استخدم بدلًا من ذلك وكيلًا عبر إضافة: RoCode

يناسب Claude Code مع MCP من يرتاح للعمل في الطرفية أو محرر الكود. RoCode (RoCode.app) مسار مختلف: وكيل ذكاء اصطناعي مستقل لـ Roblox Studio بدردشة ويب على rocode.app وإضافة مجانية من Creator Store تنفّذ الخطوات في المكان المفتوح عندك. إنه ليس منتج MCP، ولا يستخدم خادم MCP في Studio، لذا لا سطر أوامر ولا ملف إعداد ولا خادم MCP لإعداده. تتصل الإضافة تلقائيًا إذا كان Studio مسجّلًا بحساب Roblox نفسه الذي تستخدمه في RoCode؛ وإلا فتربط الدردشة بالإضافة مرة واحدة بكود من 8 أحرف يظهر في لوحة الإضافة.

ما يجب معرفته قبل الانتقال. لا يستطيع RoCode ربط اشتراك Claude أو Claude Code. إنه يشغّل نماذج من جهات أخرى عبر OpenRouter، منها Claude Sonnet 5.5 على Pro وما فوق وClaude Opus 5.5 على Studio وما فوق، وتمنح خطة Starter المجانية رصيدًا واحدًا يوميًا على GPT-6 Luna. يعمل من وضع التحرير. مع الإضافة 3.9 أو أحدث، في وضع Build، يستطيع تشغيل اختبار لعب قصير وقراءة الأخطاء، ومع الإضافة 3.9.11 أو أحدث التحكم في شخصية اختبار للتحقق من أن اللعبة تعمل. ومع الإضافة 3.9.14 أو أحدث يلتقط أيضًا صورًا لما بناه في وضع التحرير، ويستطيع إصلاح ما يبدو خاطئًا. لا ينفّذ الكود مباشرة ولا يولّد المجسمات، بينما أدوات Studio MCP تستطيع الأمرين. يستطيع البحث عن نماذج مجانية في Creator Store حسب كلماتك (وتُحذف السكربتات التي بداخلها) أو إدراج نموذج أو decal أو mesh عبر معرّف الأصل، ويبتكر الديكور والمباني والأدوات من جديد لكل لعبة. ووضع Ask فيه يجيب عن الأسئلة حول مكانك بأدوات للقراءة فقط ولا يغيّر شيئًا. الحسابات لمن أعمارهم 13 عامًا فأكثر، ودون 18 عامًا بإذن أحد الوالدين أو الوصي.

ما تكتبه

أضف RemoteEvent حتى يستطيع اللاعبون طلب أداة من ServerStorage.Tools. تحقّق من كل شيء على الخادم.

ما يفعله RoCode
  • قد يستكشف المكان أولًا عبر Search Game وList Children ليجد مجلد Tools والسكربتات التي تمنح الأدوات بالفعل
  • يكتب سكربت الخادم عبر Create Script وقد يضيف RemoteEvent عبر Create Instance
  • يفحص ترجمة السكربت في Studio عبر Check Script قبل الإنهاء. هذا فحص ترجمة (compile)، وليس فحصًا للأنواع ولا اختبار لعب
  • يرسل التغييرات على دفعات، وكل دفعة نقطة تراجع في سجل Studio نفسه

مع الإضافة 3.9 أو أحدث يستطيع RoCode تشغيل اختبار لعب قصير وقراءة الأخطاء، ومع الإضافة 3.9.15 أو أحدث تستطيع شخصية الاختبار المشي وضغط المفاتيح والنقر على الأزرار في الشاشة، لكنه يفحص فقط ما قرر فحصه بنفسه، لذا اضغط Play بنفسك لتتحقق من النتيجة كلاعب. الطلب مثال كتبناه نحن؛ وفي الخطوات أسماء الأدوات الحقيقية. كيف تعمل الإضافة والاقتران. RoCode منتج مستقل لا يرتبط بشركة Roblox Corporation، ولا تعتمده ولا ترعاه.

الأسئلة الشائعة

هل يمكن استخدام Claude Desktop بدلًا من Claude Code؟

نعم. Claude Desktop موجود في قائمة Quick connect في لوحة Manage MCP Servers في Studio، لذا يتصل بمفتاح تبديل واحد، على Windows أو Mac. يستخدم أدوات Studio نفسها؛ ويضيف Claude Code ما يجيده وكيل الطرفية، مثل العمل على ملفات السكربتات وGit. خطوات الاثنين موجودة في دليل إعداد Studio MCP.

هل يستطيع Claude Code الاتصال بـ Roblox Studio؟

نعم. تذكر Roblox برنامج Claude Code كعميل quick connect لخادم MCP المدمج في Studio. فعّل Enable Studio as MCP server في Assistant > … > Manage MCP Servers، وفعّل Claude Code في قائمة Quick connect، وأعد تشغيل Claude Code. ويستطيع أيضًا العمل على سكربتاتك كملفات عبر Script Sync أو Rojo.

هل Claude Code مجاني للعمل مع Roblox Studio؟

لا يوجد سعر موثّق لخادم MCP في Studio، لكن Claude Code غير مضمّن في خطة Free من Anthropic (claude.com/pricing، تم التحقق في 9 أكتوبر 2026). تحتاج إلى خطة Claude مدفوعة، يتشارك فيها حدود استخدام خطتك، أو إلى حساب Claude Console بالدفع مقابل استخدام API.

هل أحتاج إلى إضافة Roblox أو طلبات HTTP لاستخدام Claude Code؟

لخادم MCP المدمج في Studio لا. خطوات الإعداد من Roblox هي تفعيل الخادم في Assistant وربط العميل؛ ولا توجد فيها إضافة للتثبيت ولا إعداد HTTP يجب تغييره. بعض الأدلة القديمة تصف خوادم MCP من المجتمع تعمل بطريقة مختلفة. أما Rojo، إذا اخترته للملفات، فيستخدم إضافته الخاصة لـ Studio.

هل يستطيع Claude Code اختبار لعبتي في Roblox؟

عبر أدوات Studio MCP نعم. start_stop_play يبدأ اختبار اللعب ويوقفه، وget_console_output يقرأ Output، وscreen_capture يلتقط منفذ العرض، وأدوات الإدخال تحرّك الشخصية وترسل المفاتيح والنقرات. تحقّق مما يبلّغ عنه، والعب اللعبة بنفسك قبل النشر.

أيهما أختار لـ Roblox Studio: Claude Code أم Codex؟

كلاهما في قائمة quick connect من Roblox ويصلان إلى أدوات Studio MCP نفسها، لذا فالفرق في النموذج والحساب والعميل المحيط به. لا تنشر Roblox مقارنات، ولم نجرِ اختبارات مقارنة بينهما. جرّب كلًا منهما على نسخة من مكانك بالقواعد المكتوبة نفسها، واحتفظ بالذي تحتاج تغييراته إلى إصلاحات أقل.

هل يعمل Claude Code مع Roblox Studio على Mac؟

نعم. يدعم Claude Code نظام macOS 13.0 أو أحدث، ويوثّق Roblox مسار الخادم على macOS، /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP، للعملاء الذين تُعدّهم يدويًا.

المصادر والقراءات

كيف فُحص الكود: كل سكربت في هذه الصفحة يجتاز الفاحص الصارم للأنواع في Luau مع تعريفات واجهة Roblox البرمجية (luau-lsp، ٢٠ نوفمبر ٢٠٢٦). فحص الأنواع يكشف الأخطاء في أسماء الواجهات البرمجية والأنواع الخاطئة، لا منطق اللعبة، فجرّب الكود في Studio قبل النشر.

جرّب RoCode على لعبتك أنت.

رصيد مجاني كل يوم ودون بطاقة. ثبّت الإضافة، وصف الميزة، وراجع ما يظهر في Studio.