מדריך · AI ב-Roblox Studio

איך מחברים את Claude Code ל-Roblox Studio

Claude Code הוא כלי סוכני לכתיבת קוד של Anthropic. Roblox מציינת אותו כלקוח quick connect לשרת ה-MCP המובנה ב-Studio, ולכן הוא יכול לקרוא את הפלייס שלכם, לערוך סקריפטים ולהריץ בדיקות משחק בחלון ה-Studio שפתוח אצלכם. הוא גם יכול לעבוד עם הסקריפטים שלכם כקבצים דרך Script Sync או Rojo. המדריך הזה עוסק בצד של Claude Code: מה צריך, איך מחברים אותו, הרשאות, CLAUDE.md עם כללים ל-Roblox, דרך עבודה בטוחה וכמה זה עולה. על הסוכן של OpenAI ראו את המדריך איך להשתמש ב-OpenAI Codex עם Roblox Studio (באנגלית); על Cursor, Claude Desktop ולקוחות אחרים ראו את המדריך להגדרת Studio MCP.

עודכן 20 בנובמבר 202618 דק׳ קריאהמאת:

בקצרה

התקינו את 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 זיכרון RAM, חיבור לאינטרנט ומיקום במדינה ש-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%, ואת WSL Roblox לא מתעדת.

מעדיפים חלונית בעורך? ב-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 תכננה את הקובץ הזה כך שיעשו לו commit וכל הצוות ישתף אותו, אבל הנתיבים ל-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 מכסה כלים שמשנים את הפלייס, מריצים קוד, מפעילים בדיקות משחק, מכניסים Assets חיצוניים או שולחים תמונות ל-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 ו-Parts. 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 או תגים: 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 קיימת כי השרת מגיע לכל חלון פתוח. השורה על Assets קיימת כי insert_asset מכניס לפלייס תוכן חיצוני, ו-upload_image שולח תמונות לשרת ה-Assets של 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. השרת מחליט. הוסיפו כאן את בדיקת הבעלות שלכם (Game Pass, רשומת קנייה).
	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. עד שתוסיפו בדיקת בעלות, כל שחקן יכול לקבל כל כלי מהתיקייה הזו.

חפשו את אותו הדבר בכל handler של 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 יבטל אותם, והעמוד של Roblox על MCP לא אומר אם הם נכנסים להיסטוריית הביטול של Studio. עם Script Sync, קובץ ש-/rewind שחזר מסתנכרן חזרה ל-Studio כמו כל שינוי אחר בדיסק. לכל השאר, הדרך חזרה היא הגרסה השמורה.

הרחיקו סודות ונתונים חיים

  • אל תדביקו מפתחות API, מפתחות Open Cloud, כתובות Webhook וסיסמאות בפרומפט או ב-CLAUDE.md. שניהם טקסט ש-Claude קורא, ו-CLAUDE.md בדרך כלל נכנס למאגר עם commit.
  • גם בסקריפטים אל תטמיעו אותם. ל-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, והעמוד של Roblox על MCP לא מזכיר תשלום. העלות היא העלות של 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) הוא דרך אחרת: סוכן AI עצמאי ל-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 נותנת קרדיט 1 ביום על GPT-6 Luna. הוא עובד ממצב עריכה. עם פלאגין 3.9 ומעלה, במצב Build, הוא יכול להריץ בדיקת משחק קצרה ולקרוא את השגיאות, ועם פלאגין 3.9.11 ומעלה לשלוט בדמות בדיקה כדי לבדוק שהמשחק עובד. עם פלאגין 3.9.14 ומעלה הוא גם מצלם את מה שבנה, במצב עריכה, ויכול לתקן מה שנראה לא נכון. הוא לא מריץ קוד ישירות ולא מייצר Meshes, וכלי ה-Studio MCP יודעים לעשות את שניהם. הוא יכול לחפש מודלים חינמיים ב-Creator Store לפי המילים שלכם (הסקריפטים שבתוכם נמחקים) או להכניס מודל, Decal או Mesh לפי Asset ID, ואת הקישוטים, הבניינים והאביזרים הוא ממציא מחדש לכל משחק. מצב Ask שלו עונה על שאלות על הפלייס שלכם עם כלים לקריאה בלבד ולא משנה כלום. החשבונות מיועדים לבני 13 ומעלה, ומתחת לגיל 18 באישור הורה או אפוטרופוס.

אתם כותבים

תוסיף RemoteEvent כדי ששחקנים יוכלו לבקש כלי מ-ServerStorage.Tools. תבדוק הכול בשרת.

RoCode עושה
  • יכול קודם לסרוק את הפלייס עם Search Game ו-List Children, כדי למצוא את תיקיית Tools ואת הסקריפטים שכבר מחלקים כלים
  • כותב סקריפט שרת עם Create Script ויכול להוסיף RemoteEvent עם Create Instance
  • בודק את הקומפילציה של הסקריפט ב-Studio עם Check Script לפני הסיום. זו בדיקת קומפילציה, לא בדיקת טיפוסים ולא בדיקת משחק
  • שולח את השינויים בקבוצות, וכל קבוצה היא נקודת ביטול בהיסטוריה של 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 מצלם את ה-Viewport, וכלי הקלט מזיזים את הדמות ושולחים מקשים ולחיצות. בדקו את מה שהוא מדווח, ושחקו במשחק בעצמכם לפני הפרסום.

מה לבחור ל-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 עם הגדרות ה-API של Roblox (luau-lsp, 20 בנובמבר 2026). בדיקת טיפוסים תופסת שגיאות בשמות API וטיפוסים שגויים, אבל לא שגיאות בלוגיקת המשחק, אז בדקו הכול ב-Studio לפני הפרסום.

נסו את RoCode במשחק שלכם.

קרדיטים חינמיים בכל יום, בלי כרטיס אשראי. התקינו את הפלאגין, תארו פיצ'ר ובדקו מה מופיע ב-Studio.