Tóm tắt
Cài Claude Code và đăng nhập bằng gói Claude trả phí hoặc tài khoản Claude Console. Trong Studio, mở Assistant, bấm … > Manage MCP Servers, bật Enable Studio as MCP server, rồi bật Claude Code trong danh sách Quick connect. Khởi động lại Claude Code, gõ /mcp để chắc chắn server Studio đã kết nối, và bắt đầu bằng một yêu cầu chỉ đọc.
- Claude Code không có trong gói Free của Anthropic. Nó có trong Pro, Max, Team và Enterprise, hoặc trả tiền theo mức dùng API qua tài khoản Claude Console (kiểm tra ngày 9 tháng 10 năm 2026).
- Hãy dùng phiên chạy cục bộ: terminal, tiện ích mở rộng cho VS Code hoặc Cursor, hoặc ứng dụng desktop với Local được chọn. Phiên trên đám mây không chạy trên máy tính của bạn và không với tới Studio.
- Từ v2.1.283, phiên trong terminal và VS Code mặc định bắt đầu ở chế độ auto nếu có, nên hãy thêm quy tắc ask cho các công cụ Studio làm thay đổi place. Lệnh
/rewindcủa Claude Code không hoàn tác thay đổi đã làm trong Studio, nên hãy lưu một phiên bản trước.
Trong trang này
Cần gì trước khi bắt đầu
| Cần | Chi tiết |
|---|---|
| Roblox Studio | Bản mới nhất, trên Windows hoặc macOS. MCP server có sẵn trong Studio, nên phía Roblox không cần cài thêm gì. |
| Máy tính hỗ trợ Claude Code | macOS 13.0 trở lên hoặc Windows 10 1809 trở lên, từ 4 GB RAM, có kết nối internet và ở một quốc gia mà Anthropic hỗ trợ. |
| Tài khoản Claude có kèm Claude Code | Gói Claude trả phí (Pro, Max, Team hoặc Enterprise) hoặc tài khoản Claude Console. Trang bảng giá của Anthropic ghi rằng Claude Code không có trong gói Free. |
| Độ tuổi | Consumer Terms của Anthropic (có hiệu lực từ ngày 8 tháng 10 năm 2025) ghi rằng bạn phải từ 18 tuổi trở lên, hoặc đủ độ tuổi tối thiểu để đồng ý ở quốc gia của bạn nếu độ tuổi đó cao hơn. |
| Tùy chọn | Git để lưu lịch sử script. Visual Studio Code 1.94.0 trở lên hoặc Cursor, nếu bạn muốn Claude Code trong một panel của trình soạn thảo thay vì trong terminal. |
Nên dùng Claude Code ở đâu
Claude Code chạy ở nhiều nơi. Anthropic viết rằng tất cả dùng chung một engine, nên CLAUDE.md, cài đặt và MCP server của bạn hoạt động ở mọi nơi. Với Studio, điều quan trọng là phiên chạy ở đâu: MCP server của Roblox là một tiến trình cục bộ trên máy tính của bạn, nên phiên cũng phải chạy trên máy tính của bạn.
| Cách dùng | Với tới Studio? | Ghi chú |
|---|---|---|
Terminal (lệnh claude) | Có | Chạy nó trong thư mục dự án. Bạn cũng cần nó cho các lệnh claude mcp bên dưới. |
| Tiện ích mở rộng cho VS Code hoặc Cursor | Có | Đây là cách trong hướng dẫn coding harness của Roblox. Tiện ích có bản Claude Code riêng nhưng không thêm claude vào PATH, nên nếu cần các lệnh đó, hãy cài cả bản cho terminal. |
| Ứng dụng desktop, tab Code, với Local được chọn | Có | Chạy trên máy tính của bạn. Anthropic ghi rằng cần gói đăng ký trả phí. |
| Phiên trên đám mây (claude.ai/code hoặc Cloud trong ứng dụng desktop) | Không | Chúng chạy trên hạ tầng đám mây chứ không phải trên máy tính của bạn, nên không thể khởi động server Studio cục bộ. |
Bước 1: cài Claude Code và đăng nhập
Anthropic khuyên cài bằng một lệnh trong terminal. Đây là các lệnh có trên trang cài đặt của họ ngày 9 tháng 10 năm 2026; lệnh mới nhất xem tại trang cài đặt của Anthropic.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- Mở một cửa sổ terminal mới và chạy
claude --version. Nếu thấy số phiên bản là đã cài xong. Nếu không tìm thấy lệnh, thư mục cài đặt chưa nằm trong PATH, và cách sửa có trên trang xử lý lỗi cài đặt của Anthropic. - Chuyển tới thư mục dự án và chạy
claude. Lần chạy đầu tiên, nó mở cửa sổ trình duyệt để đăng nhập. Nếu trình duyệt không mở, bấmcđể sao chép đường link đăng nhập. - Đăng nhập tài khoản Claude của bạn. Đăng nhập bằng Pro hoặc Max sẽ dùng hạn mức có trong gói của bạn.
Trên Windows, Anthropic khuyên cài Git for Windows để Claude Code dùng được công cụ Bash của nó; không có Git, Claude Code chạy lệnh trong PowerShell. Với cách thiết lập này, hãy cài Claude Code trực tiếp trên Windows, không cài trong WSL: cấu hình Roblox cho Windows chạy cmd.exe với đường dẫn %LOCALAPPDATA%, và Roblox không có tài liệu cho WSL.
Thích dùng panel trong trình soạn thảo hơn? Trong VS Code hoặc Cursor, mở Extensions (Ctrl+Shift+X, hoặc Cmd+Shift+X trên Mac), tìm Claude Code, cài đặt và đăng nhập từ panel Claude. Đây chính là cách thiết lập mà hướng dẫn coding harness của Roblox dùng.
Bước 2: kết nối Claude Code với Studio
Trước tiên hãy bật server. Trong Studio, mở Assistant, bấm … > Manage MCP Servers và bật Enable Studio as MCP server. Hướng dẫn Studio MCP giải thích bước này chi tiết hơn. Không thấy nút Assistant? Xem cách mở panel Assistant.
Quick connect
- Trong cùng panel đó (Assistant Settings > MCP Servers), mở danh sách Quick connect. Danh sách gồm các client được hỗ trợ đã cài trên máy tính của bạn.
- Bật Claude Code. Nếu không thấy, hãy cài Claude Code rồi khởi động lại Studio.
- Khởi động lại Claude Code: kết thúc phiên và chạy lại
claude, hoặc bắt đầu một cuộc trò chuyện mới trong tiện ích. Roblox ghi rằng client cần khởi động lại để nhận cấu hình mới.
Roblox không nói quick connect ghi vào file nào của Claude Code và đặt tên server là gì. Gõ /mcp trong Claude Code để xem tên. Bạn sẽ cần nó cho các quy tắc quyền ở bước 3.
Bạn dùng tiện ích Claude Code trong VS Code hoặc Cursor? Ở đây cũng bật Claude Code. Hướng dẫn coding harness của Roblox bật Cursor hoặc Visual Studio Code, nhưng Anthropic ghi rằng tiện ích dùng chung cấu hình MCP với bản Claude Code cho terminal, và không nói rằng nó đọc cài đặt MCP riêng của trình soạn thảo.
Cài đặt thủ công bằng file .mcp.json
Nếu quick connect không hoạt động với bạn, hãy tự thêm Studio. Claude Code đọc MCP server của dự án từ file tên .mcp.json trong thư mục dự án, cùng định dạng mcpServers mà Roblox mô tả, và coi một mục không có type là server stdio cục bộ. Vì vậy cấu hình của Roblox dùng được nguyên như vậy. Lưu bản cho hệ điều hành của bạn thành .mcp.json trong thư mục nơi bạn chạy claude:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
Lần tới khi bạn chạy claude trong thư mục này, nó sẽ yêu cầu chấp thuận server: Anthropic hiện yêu cầu này cho mọi server lấy từ file .mcp.json. Anthropic thiết kế file này để commit và chia sẻ cho cả nhóm, nhưng đường dẫn trên Windows và macOS khác nhau. Nếu nhóm bạn dùng cả hai hệ điều hành, hãy để file này ngoài repository, và để mỗi người tự thêm Studio cho mình.
Trên macOS, bạn cũng có thể thêm Studio bằng một lệnh. --scope user giúp nó dùng được trong mọi dự án trên máy tính của bạn; không có nó, server chỉ được tải trong thư mục hiện tại. -- tách các tham số riêng của Claude Code khỏi lệnh khởi động server.
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
Trên Windows, dùng file JSON đơn giản hơn, vì PowerShell và CMD xử lý %LOCALAPPDATA% trên dòng lệnh theo cách khác nhau.
Kiểm tra kết nối
- Trong terminal,
claude mcp listhiện mọi server và trạng thái của chúng.claude mcp get Roblox_Studiohiện nhiều hơn, kể cả dòngIssue:nếu server không kết nối được. - Bên trong Claude Code, gõ
/mcp. Server đã kết nối có số công cụ hiện cạnh tên. - Trong Studio, Assistant > … > Manage MCP Servers hiện chấm xanh kèm số client đã kết nối.
Bước 3: quyết định Claude được làm gì mà không cần hỏi
Hãy thiết lập phần này trước khi Claude đụng vào place của bạn. Theo trang của Anthropic về các chế độ quyền, từ Claude Code v2.1.283, phiên tương tác trong terminal và VS Code mặc định bắt đầu ở chế độ auto ở mọi nơi có chế độ này, và ở chế độ auto, một bộ phân loại chạy nền sẽ kiểm tra hành động thay bạn. Khi đó, một lệnh gọi MCP sửa script hoặc chạy Luau trong Studio có thể đi qua mà không hỏi.
Có hai cách để giữ quyền quyết định mọi thay đổi:
- Chạy ở chế độ Manual. Chạy
claude --permission-mode default. Ở chế độ Manual, chỉ việc đọc được làm mà không hỏi. Bấm Shift+Tab trong phiên để đổi chế độ. - Thêm quy tắc ask cho các công cụ Studio làm thay đổi. Anthropic viết rằng không chế độ nào tự động chấp thuận một công cụ khớp với quy tắc ask rõ ràng, kể cả chế độ 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"
]
}
}
Quy tắc MCP có dạng mcp__<server>__<tool>, với tên server đúng như Claude Code biết. Thay Roblox_Studio bằng tên mà /mcp hiện ra. Quy tắc allow trong file dự án .claude/settings.json chỉ có hiệu lực sau khi bạn chấp nhận hộp thoại tin cậy thư mục làm việc cho thư mục đó. Với các quy tắc chỉ dành cho bạn, hãy dùng .claude/settings.local.json.
Danh sách allow gồm các công cụ chỉ đọc: cây game, thuộc tính, script, Output và danh sách cửa sổ Studio đang mở. Danh sách ask gồm các công cụ thay đổi place, chạy code, chạy playtest, đưa asset bên ngoài vào hoặc gửi hình ảnh lên Roblox. Các công cụ không nằm trong danh sách nào, ví dụ screen_capture và các công cụ nhập liệu, tuân theo chế độ quyền của bạn. Danh sách đầy đủ các công cụ kèm mô tả từng cái có trong hướng dẫn Studio MCP.
Bước 4: bắt đầu bằng một yêu cầu chỉ đọc
Mở place bạn muốn làm việc và đóng những place bạn không muốn. Sau đó đưa cho Claude yêu cầu đầu tiên không thể thay đổi gì:
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.
Trên một Baseplate mới, hướng dẫn coding harness của Roblox mong câu trả lời liệt kê các object mặc định Camera, Terrain, Baseplate và SpawnLocation. Yêu cầu gọi list_roblox_studios trước là một thói quen tốt: một client với tới mọi cửa sổ Studio bạn đang mở, và mỗi lệnh gọi công cụ chỉ định cửa sổ đích qua studio_id.
Với mọi thứ lớn hơn một script, hãy yêu cầu kế hoạch trước. Ở chế độ plan (bấm Shift+Tab hoặc bắt đầu prompt bằng /plan), Claude tìm hiểu và đề xuất mà không sửa file của bạn. Anthropic mô tả chế độ plan dưới góc độ sửa file và lệnh shell, nên hãy giữ cả các quy tắc ask cho công cụ Studio.
Bước 5: làm việc với script dưới dạng file qua Script Sync hoặc Rojo
Claude Code được xây dựng quanh các file trong một thư mục. Nó sửa file bằng công cụ của mình, Git lưu lịch sử, còn /rewind có thể khôi phục chúng. Nếu đưa script ra ổ đĩa, bạn dùng được tất cả những thứ đó, còn công cụ MCP dành cho những phần của place không phải script, ví dụ GUI trong StarterGui, RemoteEvent và part. Roblox mô tả hai cách để làm việc này.
| Script Sync | Rojo | |
|---|---|---|
| Là gì | Tính năng của Studio đồng bộ script trong place với file trên ổ đĩa, theo cả hai chiều. | Công cụ bên thứ ba: một server trên máy tính của bạn cộng với một plugin cho Studio. |
| Đồng bộ gì | Chỉ các object Script, LocalScript, ModuleScript và Folder. Các object khác trong thư mục được đồng bộ sẽ bị bỏ qua. | Có thể quản lý toàn bộ dự án dưới dạng file, với hệ thống file của bạn là nguồn chuẩn. |
| Cài đặt | Bấm chuột phải vào một service hoặc thư mục trong Explorer, chọn Sync to… và chỉ định thư mục. Hướng dẫn coding harness của Roblox bật nó trước trong File > Beta Features. | Cài qua Rokit (rokit add rojo-rbx/rojo, rồi rokit install), thêm plugin bằng lệnh rojo plugin install, chạy rojo serve và kết nối từ plugin. |
| Team Create | Hoạt động cùng được. Tránh để hai người cùng lúc sửa cùng một script được đồng bộ. | Roblox lưu ý rằng công cụ bên thứ ba thường không hoạt động với các công cụ cộng tác có sẵn của Roblox. |
| Lời khuyên của Roblox | Phù hợp nếu bạn muốn dùng trình soạn thảo và quản lý phiên bản riêng cho code, còn Studio cho mọi thứ khác. | Lựa chọn tốt nhất nếu bạn muốn quản lý phiên bản cho cả dự án, không chỉ code. |
Cùng một tên file có thể mang nghĩa khác nhau
Cả hai công cụ chọn loại script theo tên file, và hậu tố của chúng không giống nhau. File .client là LocalScript trong Rojo, nhưng là Script với ngữ cảnh chạy Client trong Script Sync. Hãy nói cho Claude biết dự án của bạn dùng công cụ nào; ví dụ CLAUDE.md bên dưới làm việc đó.
| Tên file kết thúc bằng | Script Sync tạo | Rojo tạo |
|---|---|---|
.server | Script với ngữ cảnh chạy Server | Script |
.client | Script với ngữ cảnh chạy Client | LocalScript |
.local | LocalScript | Không có ý nghĩa đặc biệt (mọi file .lua khác là ModuleScript) |
| Không có hậu tố | ModuleScript | ModuleScript |
Thư mục có file init | Script có object con, loại script do tên file init quyết định | Thư mục trở thành script được mô tả bởi init.server.lua, init.client.lua hoặc init.lua |
Thiết lập Script Sync cho Claude Code
- Tạo thư mục dự án với một thư mục cho mỗi service bạn muốn đưa ra ổ đĩa, ví dụ
ServerScriptService,ReplicatedStoragevàStarterPlayerScripts, rồi chạygit inittrong đó. - Nếu Script Sync không xuất hiện khi bạn bấm chuột phải vào một service, hãy bật nó trong File > Beta Features, bấm Save và khởi động lại Studio.
- Trong Explorer, bấm chuột phải vào ServerScriptService, chọn Script Sync > Sync to và chỉ định thư mục dự án cấp cao nhất, không phải thư mục bên trong nó. Làm lại với các service còn lại.
- Chạy
claudetrong thư mục đó. Giờ Claude sửa các file.luau, còn Studio nhận mọi thay đổi. - Commit trước mỗi phiên để luôn có một điểm sạch để quay về.
git add .
git commit -m "Before Claude session"
Khi làm với agent, hai quy tắc của Script Sync trở nên quan trọng hơn. Đừng đồng bộ script có attribute hoặc tag: Script Sync bỏ qua chúng, và Roblox cảnh báo rằng việc này có thể làm mất dữ liệu. Còn nếu file thay đổi trong lúc Studio đóng, khi mở lại place, Studio sẽ hỏi cách giải quyết và liệt kê những gì Keep Studio và Keep Disk sẽ thêm, sửa hoặc xóa. Hãy đọc danh sách này trước khi chọn.
Khi bật Script Sync, chỉnh sửa trong file đi vào Studio ngay sau khi lưu. Chấp nhận một chỉnh sửa trong Claude Code nghĩa là chấp nhận nó vào place của bạn, nên hãy xem kỹ trước khi chấp nhận, nhất là ở các chế độ tự động chấp nhận chỉnh sửa.
Để có gợi ý code và lỗi kiểu trong trình soạn thảo, Roblox khuyên dùng tiện ích Luau Language Server cùng plugin đi kèm cho Studio. Trong VS Code, tiện ích Claude Code có thể đọc panel Problems qua một công cụ có sẵn, nên Claude thấy cùng những cảnh báo như bạn.
Bước 6: đưa cho Claude quy tắc Roblox của bạn trong CLAUDE.md
Mỗi phiên Claude Code bắt đầu với ngữ cảnh mới. File CLAUDE.md trong thư mục dự án được đọc ở đầu mỗi phiên, nên các quy ước của bạn nên nằm trong đó. Chạy /init để Claude viết bản nháp, hoặc tự viết. Anthropic khuyên giữ file dưới 200 dòng, viết quy tắc đủ cụ thể để kiểm tra được, và chạy /context để chắc chắn nó đã được tải.
Ví dụ này được viết cho hướng dẫn này, cho một dự án dùng Script Sync. Đổi tên cho hợp với game của bạn và bỏ những gì bạn không cần.
# 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.
Một số dòng có mặt là do cách các công cụ hoạt động. Quy tắc tên file có vì .client.luau trong Script Sync không phải LocalScript. Dòng về list_roblox_studios có vì server với tới mọi cửa sổ đang mở. Dòng về asset có vì insert_asset đưa nội dung bên ngoài vào place, còn upload_image gửi hình ảnh lên máy chủ asset của Roblox. Dòng về wait theo tài liệu tham khảo API của Roblox, nơi đánh dấu wait, spawn và delay là đã lỗi thời và nên dùng thư viện task.
Nếu dự án của bạn đã có AGENTS.md cho các agent viết code khác, Claude Code có thể đọc nó như chỉ dẫn của dự án, nên bạn có thể giữ một file cho cả hai. Trang của Anthropic về bộ nhớ giải thích file nào được ưu tiên khi có cả hai.
Các quy tắc này trông thế nào trong code
Đây là một script server tuân theo các quy tắc Luau ở trên. Nó được viết tay cho hướng dẫn này, không phải do Claude tạo ra. Hãy dùng nó làm thước đo khi xem lại những gì Claude đưa ra. LocalScript xin công cụ qua RequestTool:FireServer("Sword"), còn server kiểm tra mọi thứ.
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 chỉ đồng bộ script và thư mục, nên server tự tạo remote của mình.
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)
-- Bỏ qua yêu cầu đến sau khi người chơi đã thoát.
if player.Parent ~= Players then
return
end
-- 1. Kiểm tra tham số: client có thể gửi bất cứ thứ gì.
if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
return
end
-- 2. Giới hạn tần suất một người chơi được yêu cầu.
local now = os.clock()
local last = lastRequest[player]
if last ~= nil and now - last < COOLDOWN_SECONDS then
return
end
lastRequest[player] = now
-- 3. Server quyết định. Thêm bước kiểm tra quyền sở hữu của bạn vào đây (gamepass, bản ghi mua hàng).
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. Dọn dữ liệu của người chơi.
Players.PlayerRemoving:Connect(function(player: Player)
lastRequest[player] = nil
end)
Trên ổ đĩa với Script Sync: ServerScriptService/ToolRequests.server.luau. Đặt các object Tool vào một Folder tên Tools trong ServerStorage. Chừng nào bạn chưa thêm bước kiểm tra quyền sở hữu, mọi người chơi đều có thể nhận bất kỳ công cụ nào trong thư mục này.
Hãy tìm đúng những điều này trong mọi handler remote mà Claude viết: nó kiểm tra kiểu và kích thước của thứ client gửi, giới hạn tần suất một người chơi được gọi, server ra quyết định, và bản ghi của người chơi bị xóa khi họ thoát. Hướng dẫn RemoteEvent giải thích vì sao từng điểm quan trọng.
Cách làm việc an toàn: điểm lưu, xem lại, playtest
- Tạo điểm lưu ở cả hai phía. Commit file vào Git và lưu một phiên bản place trong Studio qua File > Save to Roblox with Notes. Hướng dẫn Studio MCP chỉ cách khôi phục nó từ Version History.
- Yêu cầu kế hoạch cho mọi thứ lớn hơn một script, và đọc nó trước khi chấp thuận.
- Xem diff. Với file, đọc
git diffhoặc diff có sẵn trong tiện ích trước khi chấp nhận. Với thay đổi làm trong Studio, đọc các script Claude đã đụng tới và xem Explorer để tìm object mới xuất hiện hoặc biến mất. - Tự kiểm tra. Claude có thể chạy playtest và đọc Output, nhưng nó chỉ kiểm tra những gì nó tự quyết định kiểm tra. Hãy chơi thử tính năng như một người chơi trước khi commit hoặc xuất bản.
- Commit khi mọi thứ đã chạy, kèm thông điệp ghi rõ cái gì thay đổi.
/rewind hoàn tác được gì và không được gì
Claude Code lưu một điểm khôi phục trước mỗi prompt, và /rewind (hoặc bấm Esc hai lần) khôi phục các file mà Claude đã sửa bằng công cụ sửa file của nó. Anthropic liệt kê những gì nó không theo dõi, trong đó có thay đổi do lệnh shell tạo ra. Thay đổi trong Studio qua công cụ MCP không phải chỉnh sửa file, nên đừng mong /rewind hoàn tác chúng, và trang MCP của Roblox không nói liệu chúng có vào lịch sử hoàn tác của Studio hay không. Với Script Sync, file được /rewind khôi phục sẽ đồng bộ ngược vào Studio như mọi thay đổi khác trên ổ đĩa. Với mọi thứ còn lại, đường quay về là phiên bản đã lưu.
Giữ bí mật và dữ liệu thật ngoài tầm với
- Đừng dán API key, key Open Cloud, URL webhook và mật khẩu vào prompt hay vào
CLAUDE.md. Cả hai đều là văn bản Claude đọc, vàCLAUDE.mdthường được commit vào repository. - Cũng đừng ghi cứng chúng trong script. Roblox có kho bí mật cho mỗi game: tạo bí mật trong Creator Dashboard và đọc chúng trong script server qua
HttpService:GetSecret(). Với playtest cục bộ, thêm bí mật cục bộ trong File > Experience Settings > Security. - Để cài đặt cá nhân trong
.claude/settings.local.jsonvàCLAUDE.local.md, hai file được thiết kế để nằm ngoài Git. Hãy tự thêmCLAUDE.local.mdvào.gitignore. - Chỉ bật Enable Studio Access to API Services trong một bản sao riêng của game để thử nghiệm. Roblox cảnh báo rằng Studio dùng chung kho dữ liệu với game đang chạy thật, nên một playtest Claude chạy ở đó có thể ghi đè dữ liệu thật của người chơi.
- Đọc skill của bên thứ ba trước khi cài. Các danh mục skill có skill Roblox cho Claude Code, và Anthropic lưu ý rằng một skill có thể tự cấp cho mình quyền truy cập rộng vào công cụ qua trường
allowed-tools.
Dùng Claude Code cho Roblox tốn bao nhiêu
Phía Studio không có giá được ghi trong tài liệu: MCP server là một phần của Studio, và trang MCP của Roblox không nhắc tới phí. Chi phí là chi phí của Claude Code, và Anthropic có hai cách trả tiền (tính tới ngày 9 tháng 10 năm 2026):
- Gói đăng ký Claude. Claude Code có trong Pro, Max, Team và Enterprise, nhưng không có trong Free. Nó dùng chung hạn mức với Claude trên web, desktop và di động. Hạn mức được đặt lại theo cửa sổ trượt năm giờ, và các gói trả phí còn có hạn mức theo tuần chồng lên trên. Khi chạm tới một trong số đó, bạn có thể chờ, nâng lên gói cao hơn hoặc bật credit sử dụng.
- Tài khoản Claude Console. Bạn trả tiền dùng API theo lượng văn bản được xử lý. Trang của Anthropic về chi phí nói rằng mức chi phụ thuộc nhiều vào lựa chọn mô hình, kích thước codebase và cách bạn dùng.
Giá hiện tại có trên claude.com/pricing. Hướng dẫn này không nhắc lại vì giá thay đổi. Bên trong Claude Code, lệnh /usage hiện cho người đăng ký các thanh mức dùng của gói, còn với người dùng API là chi phí ước tính của phiên.
Điều gì làm một phiên Roblox tốn nhiều hơn
- Kích thước ngữ cảnh. Mức dùng tăng theo những gì Claude có trong ngữ cảnh. Dùng
/cleargiữa các nhiệm vụ không liên quan. - Kết quả công cụ lớn. Duyệt toàn bộ cây game trong một place lớn hoặc đọc trọn các script dài sẽ trả về rất nhiều văn bản. Claude Code đếm văn bản theo đơn vị mà mô hình dùng để đo nó: nó cảnh báo khi kết quả của công cụ MCP vượt 10.000 đơn vị như vậy và mặc định giới hạn ở 25.000. Thay vào đó, hãy yêu cầu một thư mục, giới hạn độ sâu hoặc một khoảng dòng: cả
search_game_treevàscript_readđều hỗ trợ việc này. - Lựa chọn mô hình. Anthropic viết rằng Sonnet làm tốt phần lớn nhiệm vụ viết code và rẻ hơn Opus. Đổi mô hình bằng
/model.
Xử lý lỗi Claude Code và Studio
Danh sách kiểm tra của chính Roblox khá ngắn: khởi động lại Studio và client, kiểm tra đường dẫn lệnh có tồn tại, và kiểm tra JSON. Dưới đây là những trường hợp riêng của Claude Code.
Claude Code không có trong danh sách Quick connect
Danh sách chỉ hiện các client được hỗ trợ đã cài trên máy tính của bạn. Cài Claude Code rồi khởi động lại Studio. Nếu bạn cài nó khi Studio đang mở, hãy khởi động lại Studio, Claude Code hoặc cả hai. File .mcp.json ở bước 2 hoạt động mà không cần quick connect.
/mcp không hiện server Roblox Studio
Khởi động lại Claude Code sau khi thêm server. Sau đó kiểm tra nó đã được thêm vào đâu: server thêm mà không có --scope chỉ được tải trong thư mục nơi bạn thêm nó, nên hãy chạy claude từ thư mục đó hoặc thêm lại với --scope user. Trong VS Code, bắt đầu cuộc trò chuyện mới, vì thay đổi chỉ áp dụng cho các cuộc trò chuyện bắt đầu sau đó.
Server hiện Pending approval
Nó lấy từ file .mcp.json, và Claude Code hỏi trước khi dùng những server như vậy. Chạy claude trong thư mục đó, chấp nhận hộp thoại tin cậy thư mục làm việc và chấp thuận server. claude mcp reset-project-choices đặt lại các lựa chọn trước đó.
Server hiện Failed to connect
Chạy claude mcp get Roblox_Studio và đọc dòng Issue:. Kiểm tra file có tồn tại: %LOCALAPPDATA%\Roblox\mcp.bat trên Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP trên macOS (đổi đường dẫn nếu Studio được cài ở chỗ khác). Đảm bảo Enable Studio as MCP server vẫn đang bật, rồi khởi động lại Studio và Claude Code.
Terminal báo không nhận ra claude
Sau khi cài, hãy mở một cửa sổ terminal mới. Nếu vẫn không tìm thấy lệnh, thư mục cài đặt không nằm trong PATH; cách sửa có trên trang xử lý lỗi cài đặt của Anthropic. Tiện ích cho VS Code không thêm claude vào PATH, nên để dùng các lệnh trong hướng dẫn này, hãy cài riêng bản cho terminal.
Claude sửa nhầm place
Khi mở nhiều cửa sổ Studio, mỗi lệnh gọi công cụ chỉ định đích qua studio_id. Yêu cầu Claude gọi list_roblox_studios và nêu tên place cần dùng, đóng các cửa sổ bạn không dùng, và khôi phục place bị sửa từ Version History.
Claude Code trừ tiền từ API key của tôi chứ không phải từ gói
Một khi bạn đã chấp thuận, biến môi trường ANTHROPIC_API_KEY được ưu tiên hơn gói đăng ký. Xóa biến đó (hoặc tắt Use custom API key trong /config), khởi động lại Claude Code và chạy /status để xem cách đăng nhập nào đang hoạt động. Nếu vẫn là tài khoản Console, chạy /login và chọn tài khoản Claude của bạn.
Phiên trên đám mây không thấy Studio
Phiên trên đám mây chạy trên hạ tầng của Anthropic chứ không phải trên máy tính của bạn, nên không với tới server Studio cục bộ. Hãy dùng terminal, tiện ích cho trình soạn thảo hoặc ứng dụng desktop với Local được chọn.
Hoặc dùng một agent dạng plugin: RoCode
Claude Code với MCP hợp với những ai quen dùng terminal hoặc trình soạn thảo code. RoCode (RoCode.app) là một con đường khác: AI agent độc lập cho Roblox Studio với web chat tại rocode.app và plugin miễn phí từ Creator Store, plugin này thực hiện các bước trong place bạn đang mở. Đây không phải sản phẩm MCP và nó không dùng MCP server của Studio, nên không có dòng lệnh, file cấu hình hay MCP server nào cần thiết lập. Plugin tự kết nối nếu Studio đăng nhập cùng tài khoản Roblox bạn dùng trên RoCode; nếu không, bạn ghép nối chat với plugin một lần bằng mã 8 ký tự hiện trong bảng điều khiển của plugin.
Những điều nên biết trước khi chuyển. RoCode không thể kết nối gói đăng ký Claude hay Claude Code. Nó chạy các mô hình bên thứ ba qua OpenRouter, gồm Claude Sonnet 5.5 trên Pro trở lên và Claude Opus 5.5 trên Studio trở lên, còn gói Starter miễn phí cho 1 credit mỗi ngày trên GPT-6 Luna. Nó làm việc ở chế độ chỉnh sửa. Với plugin 3.9 trở lên, ở chế độ Build, nó có thể chạy một playtest ngắn và đọc lỗi, và với plugin 3.9.11 trở lên còn điều khiển nhân vật thử nghiệm để kiểm tra game có chạy không. Với plugin 3.9.14 trở lên, nó còn chụp ảnh những gì đã dựng ở chế độ chỉnh sửa và có thể sửa những chỗ trông không ổn. Nó không chạy code trực tiếp và không tạo mesh, còn các công cụ Studio MCP làm được cả hai. Nó có thể tìm model miễn phí trên Creator Store theo lời bạn mô tả (script bên trong bị gỡ bỏ) hoặc chèn model, decal hay mesh theo ID asset, và nó tự nghĩ ra đồ trang trí, nhà cửa và đạo cụ mới cho mỗi game. Chế độ Ask của nó trả lời câu hỏi về place của bạn bằng các công cụ chỉ đọc và không thay đổi gì. Tài khoản dành cho người từ 13 tuổi trở lên, và dưới 18 tuổi cần sự cho phép của cha mẹ hoặc người giám hộ.
Thêm một RemoteEvent để người chơi có thể xin một công cụ từ ServerStorage.Tools. Kiểm tra mọi thứ trên server.
- Có thể xem qua place trước bằng Search Game và List Children để tìm thư mục Tools và các script đang phát công cụ
- Viết script server bằng Create Script và có thể thêm RemoteEvent bằng Create Instance
- Kiểm tra biên dịch script trong Studio bằng Check Script trước khi kết thúc. Đây là kiểm tra biên dịch, không phải kiểm tra kiểu và không phải playtest
- Gửi thay đổi theo từng đợt, và mỗi đợt là một điểm hoàn tác trong lịch sử của chính Studio
Với plugin 3.9 trở lên, RoCode có thể chạy một playtest ngắn và đọc lỗi, và với plugin 3.9.15 trở lên, nhân vật thử nghiệm của nó biết đi, bấm phím và bấm nút trên màn hình, nhưng nó chỉ kiểm tra những gì nó tự quyết định kiểm tra, nên hãy tự bấm Play để kiểm tra kết quả như một người chơi. Prompt là ví dụ do chúng tôi viết; các bước dùng tên công cụ thật. Plugin và ghép nối hoạt động thế nào. RoCode là sản phẩm độc lập, không liên kết với Roblox Corporation và không được Roblox Corporation chứng nhận hay tài trợ.
Câu hỏi thường gặp
Có dùng Claude Desktop thay cho Claude Code được không?
Được. Claude Desktop có trong danh sách Quick connect ở panel Manage MCP Servers của Studio, nên nó kết nối chỉ bằng một công tắc, trên Windows hoặc Mac. Nó dùng cùng các công cụ Studio; Claude Code có thêm những gì một agent trong terminal làm tốt, ví dụ làm việc với file script và Git. Các bước cho cả hai có trong hướng dẫn cài đặt Studio MCP.
Claude Code có kết nối được với Roblox Studio không?
Có. Roblox liệt kê Claude Code là client quick connect cho MCP server có sẵn trong Studio. Bật Enable Studio as MCP server trong Assistant > … > Manage MCP Servers, bật Claude Code trong danh sách Quick connect và khởi động lại Claude Code. Nó cũng có thể làm việc với script của bạn dưới dạng file qua Script Sync hoặc Rojo.
Dùng Claude Code với Roblox Studio có miễn phí không?
MCP server của Studio không có giá được ghi trong tài liệu, nhưng Claude Code không có trong gói Free của Anthropic (claude.com/pricing, kiểm tra ngày 9 tháng 10 năm 2026). Bạn cần gói Claude trả phí, nơi nó dùng chung hạn mức của gói, hoặc tài khoản Claude Console trả tiền theo mức dùng API.
Có cần plugin Roblox hay HTTP request để dùng Claude Code không?
Với MCP server có sẵn trong Studio thì không. Các bước thiết lập của Roblox là bật server trong Assistant và kết nối client; không có plugin nào cần cài, cũng không có cài đặt HTTP nào cần đổi. Một số hướng dẫn cũ mô tả MCP server do cộng đồng làm, chúng hoạt động theo cách khác. Rojo, nếu bạn chọn nó cho file, dùng plugin Studio riêng của nó.
Claude Code có chạy thử được game Roblox của tôi không?
Qua các công cụ Studio MCP thì có. start_stop_play bắt đầu và dừng playtest, get_console_output đọc Output, screen_capture chụp viewport, còn các công cụ nhập liệu di chuyển nhân vật và gửi phím bấm và cú click. Hãy kiểm tra những gì nó báo cáo, và tự chơi game trước khi xuất bản.
Nên chọn gì cho Roblox Studio: Claude Code hay Codex?
Cả hai đều có trong danh sách quick connect của Roblox và với tới cùng các công cụ Studio MCP, nên khác biệt nằm ở mô hình, tài khoản và client bao quanh nó. Roblox không công bố so sánh, và chúng tôi cũng không chạy thử nghiệm so sánh chúng. Hãy thử từng cái trên một bản sao place của bạn với cùng bộ quy tắc viết sẵn, và giữ cái nào có thay đổi cần sửa ít hơn.
Claude Code có chạy với Roblox Studio trên Mac không?
Có. Claude Code hỗ trợ macOS 13.0 trở lên, và Roblox ghi rõ đường dẫn server cho macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, cho các client bạn tự cấu hình.
Nguồn và tài liệu đọc thêm
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (tiếng Anh). bật server, quick connect, cấu hình qua JSON và CLI, công cụ, nhiều cửa sổ Studio và xử lý lỗi
- Roblox Creator Docs: Build with a coding harness (tiếng Anh). Claude Code trong VS Code, Script Sync, MCP và Git cùng nhau
- Roblox Creator Docs: Script Sync (tiếng Anh). những gì được đồng bộ, quy tắc tên file, xung đột và language server
- Roblox Creator Docs: Third-party tools (tiếng Anh). Rojo với Rokit và quản lý phiên bản
- Roblox Creator Docs: Secrets stores (tiếng Anh). cách giữ API key ngoài script
- Roblox Creator Docs: Data stores (tiếng Anh). vì sao quyền truy cập API services của Studio chỉ nên bật trong bản sao thử nghiệm
- Rojo documentation (v7) (tiếng Anh). cài đặt và cách tên file trở thành object
- Claude Code Docs: Overview (tiếng Anh). mọi cách dùng chung một engine, và ứng dụng desktop cần gói đăng ký trả phí
- Claude Code Docs: Advanced setup (tiếng Anh). yêu cầu hệ thống và lệnh cài đặt
- Claude Code Docs: Authentication (tiếng Anh). đăng nhập và các loại tài khoản phù hợp
- Claude Code Docs: Connect Claude Code to tools via MCP (tiếng Anh). server stdio, .mcp.json, phạm vi và trạng thái server
- Claude Code Docs: Configure permissions (tiếng Anh). quy tắc allow, ask và deny, kể cả cho công cụ MCP
- Claude Code Docs: Choose a permission mode (tiếng Anh). chế độ auto khi khởi động, chế độ Manual và chế độ plan
- Claude Code Docs: How Claude remembers your project (tiếng Anh). CLAUDE.md, /init và AGENTS.md
- Claude Code Docs: Checkpointing (tiếng Anh). /rewind khôi phục gì và không theo dõi gì
- Claude Code Docs: Manage costs effectively (tiếng Anh). /usage, kích thước ngữ cảnh và lựa chọn mô hình
- Claude Code Docs: Use Claude Code in the cloud (tiếng Anh). vì sao phiên trên đám mây không chạy trên máy tính của bạn
- Claude Code Docs: Use Claude Code in VS Code (tiếng Anh). yêu cầu, ghi chú về PATH, cấu hình MCP dùng chung và panel Problems
- Claude Code Docs: Extend Claude with skills (tiếng Anh). trường allowed-tools của skill cấp những gì
- Claude pricing (tiếng Anh). gói nào có Claude Code và hạn mức sử dụng
- Claude Help Center: Use Claude Code with your Pro or Max plan (tiếng Anh). hạn mức dùng chung và cảnh báo về ANTHROPIC_API_KEY
- Anthropic: Consumer Terms of Service (tiếng Anh). độ tuổi tối thiểu
Cách kiểm tra code: mọi script trong trang này đều qua trình kiểm tra kiểu nghiêm ngặt (strict) của Luau với định nghĩa API của Roblox (luau-lsp, 20 tháng 11, 2026). Kiểm tra kiểu bắt được API gõ sai và kiểu dữ liệu sai, không bắt được lỗi logic của game, nên hãy thử trong Studio trước khi xuất bản.