בקצרה
התקינו את 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, אז שמרו קודם גרסה.
בעמוד הזה
מה צריך לפני שמתחילים
| מה צריך | פרטים |
|---|---|
| Roblox Studio | הגרסה האחרונה, ב-Windows או ב-macOS. שרת ה-MCP מובנה ב-Studio, אז בצד של Roblox לא צריך להתקין שום דבר נוסף. |
| מחשב שתומך ב-Claude Code | macOS 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 הוא תהליך מקומי במחשב שלכם, ולכן גם הסשן צריך לרוץ במחשב שלכם.
| גרסה | מגיע ל-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.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- פתחו חלון טרמינל חדש והריצו
claude --version. מספר גרסה אומר שהכול הצליח. אם הפקודה לא נמצאה, תיקיית ההתקנה עוד לא ב-PATH, והפתרון נמצא בעמוד של Anthropic על בעיות התקנה. - עברו לתיקיית הפרויקט והריצו
claude. בהפעלה הראשונה הוא פותח חלון דפדפן לכניסה. אם הדפדפן לא נפתח, לחצו עלcכדי להעתיק את קישור הכניסה. - היכנסו לחשבון ה-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
- באותה חלונית (Assistant Settings > MCP Servers) פתחו את רשימת Quick connect. יש בה הלקוחות הנתמכים שמותקנים במחשב שלכם.
- הפעילו את Claude Code. אם הוא לא שם, התקינו את Claude Code והפעילו מחדש את Studio.
- הפעילו מחדש את 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:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"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 עצמו לבין הפקודה שמפעילה את השרת.
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.
{
"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 | |
|---|---|---|
| מה זה | פיצ׳ר של 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 יוצר | Rojo יוצר |
|---|---|---|
.server | Script עם הקשר ריצה Server | Script |
.client | Script עם הקשר ריצה Client | LocalScript |
.local | LocalScript | אין משמעות מיוחדת (כל קובץ .lua אחר הוא ModuleScript) |
| בלי סיומת | ModuleScript | ModuleScript |
תיקייה עם קובץ init | סקריפט עם אובייקטים ילדים, שהסוג שלו נקבע לפי שם קובץ ה-init | התיקייה הופכת לסקריפט שמתואר ב-init.server.lua, ב-init.client.lua או ב-init.lua |
הגדרת Script Sync ל-Claude Code
- צרו תיקיית פרויקט עם תיקייה אחת לכל שירות שאתם רוצים לשמור על הדיסק, למשל
ServerScriptService,ReplicatedStorageו-StarterPlayerScripts, והריצו בהgit init. - אם Script Sync לא מופיע כשאתם לוחצים בכפתור הימני על שירות, הפעילו אותו ב-File > Beta Features, לחצו על Save והפעילו מחדש את Studio.
- ב-Explorer לחצו בכפתור הימני על ServerScriptService, בחרו Script Sync > Sync to וציינו את תיקיית הפרויקט העליונה, לא תיקייה בתוכה. חזרו על זה לשאר השירותים.
- הריצו
claudeבתיקייה הזו. עכשיו Claude עורך קובצי.luau, ו-Studio קולט כל שינוי. - עשו 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. שנו את השמות למשחק שלכם והסירו את מה שלא צריך.
# 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"), והשרת בודק הכול.
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 מסביר למה כל סעיף חשוב.
דרך עבודה בטוחה: נקודת שמירה, בדיקה, בדיקת משחק
- צרו נקודת שמירה בשני הצדדים. עשו commit לקבצים ב-Git ושמרו גרסה של הפלייס ב-Studio דרך File > Save to Roblox with Notes. המדריך ל-Studio MCP מראה איך לשחזר אותה מ-Version History.
- בקשו תוכנית לכל דבר שגדול מסקריפט אחד, וקראו אותה לפני שאתם מאשרים.
- בדקו את ה-diff. לקבצים קראו את
git diffאו את ה-diff המובנה בתוסף לפני שאתם מאשרים. לשינויים שנעשו ב-Studio קראו את הסקריפטים ש-Claude נגע בהם, ובדקו ב-Explorer אובייקטים שהופיעו או נעלמו. - בדקו בעצמכם. Claude יכול להריץ בדיקת משחק ולקרוא את ה-Output, אבל הוא בודק רק את מה שהוא עצמו החליט לבדוק. שחקו בפיצ׳ר כמו ששחקן היה משחק, לפני commit או פרסום.
- עשו 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. תבדוק הכול בשרת.
- יכול קודם לסרוק את הפלייס עם 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, ללקוחות שמגדירים ידנית.
מקורות וקריאה נוספת
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (באנגלית). הפעלת השרת, quick connect, הגדרה דרך JSON ו-CLI, כלים, כמה חלונות Studio ופתרון בעיות
- Roblox Creator Docs: Build with a coding harness (באנגלית). Claude Code ב-VS Code, Script Sync, MCP ו-Git יחד
- Roblox Creator Docs: Script Sync (באנגלית). מה מסונכרן, כללי שמות קבצים, התנגשויות ו-language server
- Roblox Creator Docs: Third-party tools (באנגלית). Rojo עם Rokit וניהול גרסאות
- Roblox Creator Docs: Secrets stores (באנגלית). איך מרחיקים מפתחות API מהסקריפטים
- Roblox Creator Docs: Data stores (באנגלית). למה גישת Studio ל-API services נחוצה רק בעותק בדיקה
- Rojo documentation (v7) (באנגלית). התקנה ואיך שמות קבצים הופכים לאובייקטים
- Claude Code Docs: Overview (באנגלית). לכל הגרסאות אותו מנוע, ואפליקציית הדסקטופ צריכה מנוי בתשלום
- Claude Code Docs: Advanced setup (באנגלית). דרישות מערכת ופקודות התקנה
- Claude Code Docs: Authentication (באנגלית). כניסה וסוגי חשבון מתאימים
- Claude Code Docs: Connect Claude Code to tools via MCP (באנגלית). שרתי stdio, .mcp.json, תחומי פעולה וסטטוס השרת
- Claude Code Docs: Configure permissions (באנגלית). כללי allow, ask ו-deny, כולל כלי MCP
- Claude Code Docs: Choose a permission mode (באנגלית). מצב auto כמצב התחלתי, מצב Manual ומצב plan
- Claude Code Docs: How Claude remembers your project (באנגלית). CLAUDE.md, /init ו-AGENTS.md
- Claude Code Docs: Checkpointing (באנגלית). מה /rewind משחזר ומה הוא לא עוקב אחריו
- Claude Code Docs: Manage costs effectively (באנגלית). /usage, גודל ההקשר ובחירת המודל
- Claude Code Docs: Use Claude Code in the cloud (באנגלית). למה סשנים בענן לא רצים על המחשב שלכם
- Claude Code Docs: Use Claude Code in VS Code (באנגלית). דרישות, ההערה על PATH, הגדרות MCP משותפות וחלונית Problems
- Claude Code Docs: Extend Claude with skills (באנגלית). מה השדה allowed-tools נותן ל-skill
- Claude pricing (באנגלית). באילו תוכניות כלול Claude Code ומגבלות השימוש
- Claude Help Center: Use Claude Code with your Pro or Max plan (באנגלית). מגבלות משותפות והאזהרה על ANTHROPIC_API_KEY
- Anthropic: Consumer Terms of Service (באנגלית). גיל מינימלי
איך הקוד נבדק: כל סקריפט בעמוד הזה עובר את בודק הטיפוסים המחמיר של Luau עם הגדרות ה-API של Roblox (luau-lsp, 20 בנובמבר 2026). בדיקת טיפוסים תופסת שגיאות בשמות API וטיפוסים שגויים, אבל לא שגיאות בלוגיקת המשחק, אז בדקו הכול ב-Studio לפני הפרסום.