Гайд · ШІ в 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 листопада 2026 р.20 хв читанняАвтор:

Коротко

Встановіть 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 ГБ оперативної пам'яті, підключення до інтернету й перебування в країні, яку підтримує 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 задумав цей файл так, щоб його комітили й ним ділилася вся команда, але шляхи для 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. Робіть коміт перед кожною сесією, щоб завжди була чиста точка, до якої можна повернутися.
Термінал, у теці проєкту
git add .
git commit -m "Before Claude session"

Два правила Script Sync з агентом стають важливішими. Не синхронізуйте скрипти, які мають атрибути або теги: 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. Вирішує сервер. Додайте сюди свою перевірку володіння (геймпас, запис про покупку).
	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. Зробіть контрольну точку з обох боків. Закомітьте файли в Git і збережіть версію плейсу в Studio через File > Save to Roblox with Notes. Гайд зі Studio MCP показує, як відновити її з Version History.
  2. Просіть план для всього, що більше за один скрипт, і читайте його, перш ніж схвалити.
  3. Перевіряйте diff. Для файлів читайте git diff або вбудовані diff у розширенні, перш ніж прийняти. Для змін, зроблених у Studio, читайте скрипти, яких торкався Claude, і перевіряйте Explorer на об'єкти, що з'явилися або зникли.
  4. Тестуйте самі. Claude може запустити плейтест і прочитати Output, але він перевіряє лише те, що сам вирішив перевірити. Зіграйте у функцію так, як зіграв би гравець, перш ніж комітити або публікувати.
  5. Робіть коміт, коли все працює, з повідомленням про те, що змінилося.

Що /rewind може скасувати, а що ні

Claude Code зберігає контрольну точку перед кожним промптом, а /rewind (або двічі Esc) відновлює файли, які Claude змінив своїми інструментами редагування файлів. Anthropic перелічує, чого він не відстежує, зокрема зміни, зроблені командами оболонки. Зміни, зроблені в Studio через інструменти MCP, це не редагування файлів, тому не чекайте, що /rewind їх скасує, а сторінка MCP від Roblox не каже, чи потрапляють вони в історію скасування Studio. Зі Script Sync файл, який відновив /rewind, синхронізується назад у Studio, як будь-яка інша зміна на диску. Для всього іншого шлях назад це збережена версія.

Тримайте секрети й живі дані поза досяжністю

  • Не вставляйте API-ключі, ключі Open Cloud, URL вебхуків і паролі в промпт або в 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 дає 1 кредит на день на GPT-6 Luna. Він працює з режиму редагування. З плагіном 3.9 або новішим, у режимі Build, він може запустити короткий плейтест і прочитати помилки, а з плагіном 3.9.11 або новішим керувати тестовим персонажем, щоб перевірити, що гра працює. З плагіном 3.9.14 або новішим він ще робить знімки того, що збудував, у режимі редагування, і може виправити те, що виглядає неправильно. Він не виконує код напряму й не генерує меші, а інструменти Studio MCP уміють і те, і те. Він може шукати безкоштовні моделі в Creator Store за вашими словами (скрипти всередині видаляються) або вставити модель, декаль чи меш за 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 знімає в'юпорт, а інструменти введення рухають персонажа й надсилають клавіші та кліки. Перевіряйте те, про що він звітує, і зіграйте в гру самі перед публікацією.

Що вибрати для 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 API (luau-lsp, 20 листопада 2026 р.). Перевірка типів ловить помилки в назвах API та неправильні типи, але не помилки ігрової логіки, тому протестуйте все в Studio перед публікацією.

Спробуйте RoCode у своїй грі.

Безкоштовні кредити щодня, без картки. Встановіть плагін, опишіть функцію та перевірте, що з'явилося в Studio.