Guide · IA dans Roblox Studio

Comment connecter Claude à Roblox Studio avec Claude Code

Claude Code est l'outil de code agentique d'Anthropic. Roblox le liste comme client Quick connect pour le serveur MCP intégré à Studio, donc il peut lire ton jeu, modifier des scripts et lancer des tests dans la fenêtre Studio que tu as ouverte. Il peut aussi travailler sur tes scripts sous forme de fichiers, avec Script Sync ou Rojo. Ce guide couvre le côté Claude Code : ce qu'il te faut, la connexion, les permissions, un CLAUDE.md avec des règles Roblox, une façon sûre de travailler, et ce que ça coûte. Pour l'agent d'OpenAI, vois comment utiliser OpenAI Codex avec Roblox Studio (en anglais) ; pour Cursor, Claude Desktop et les autres clients, vois le guide de configuration du MCP de Studio.

Mis à jour le 13 novembre 202625 min de lectureÉcrit par

En bref

Installe Claude Code et connecte-toi avec une offre Claude payante ou un compte Claude Console. Dans Studio, ouvre Assistant, clique sur … > Manage MCP Servers, active Enable Studio as MCP server, puis active Claude Code sous Quick connect. Redémarre Claude Code, tape /mcp pour vérifier que le serveur de Studio est connecté, et commence par une demande qui ne fait que lire.

  • Claude Code n'est pas dans l'offre Free d'Anthropic. Il est inclus dans Pro, Max, Team et Enterprise, ou facturé à l'usage, par unité de texte, via un compte Claude Console (vérifié le 9 octobre 2026).
  • Utilise une session locale : le terminal, l'extension VS Code ou Cursor, ou l'application de bureau avec Local sélectionné. Les sessions cloud tournent en dehors de ton ordinateur et ne peuvent pas atteindre Studio.
  • Depuis la v2.1.283, les sessions du terminal et de VS Code démarrent par défaut en mode auto là où il est disponible, donc ajoute des règles ask pour les outils de Studio qui modifient ton jeu. Le /rewind de Claude Code n'annule pas les changements faits dans Studio, donc sauvegarde d'abord une version.
Sur cette page
  1. Ce qu'il te faut
  2. 1. Installer et se connecter
  3. 2. Connecter à Studio
  4. 3. Permissions
  5. 4. Première demande
  6. 5. Script Sync ou Rojo
  7. 6. CLAUDE.md
  8. Travailler en sécurité
  9. Coûts
  10. Dépannage
  11. Option agent en plugin
  12. Questions fréquentes
  13. Sources et lectures

Ce qu'il te faut avant de commencer

Prérequis, d'après la documentation de Roblox et d'Anthropic, 9 octobre 2026
Il te fautDétails
Roblox StudioLa dernière version, sur Windows ou macOS. Le serveur MCP est intégré à Studio, donc il n'y a rien d'autre à installer côté Roblox.
Un ordinateur que Claude Code prend en chargemacOS 13.0 ou plus récent, ou Windows 10 1809 ou plus récent, avec 4 Go de RAM ou plus, une connexion internet, et un lieu situé dans un pays qu'Anthropic prend en charge.
Un compte Claude qui inclut Claude CodeUne offre Claude payante (Pro, Max, Team ou Enterprise) ou un compte Claude Console. La page des tarifs d'Anthropic indique que Claude Code n'est pas inclus dans l'offre Free.
ÂgeLes Consumer Terms d'Anthropic (en vigueur depuis le 8 octobre 2025) disent que tu dois avoir au moins 18 ans, ou l'âge minimum pour consentir là où tu vis s'il est plus élevé.
FacultatifGit, pour garder un historique de tes scripts. Visual Studio Code 1.94.0 ou plus récent, ou Cursor, si tu veux Claude Code dans un panneau d'éditeur plutôt que dans un terminal.

Quel Claude Code utiliser

Claude Code tourne à plusieurs endroits. Anthropic dit qu'ils partagent tous le même moteur, donc ton CLAUDE.md, tes réglages et tes serveurs MCP marchent partout. Ce qui compte pour Studio, c'est l'endroit où tourne la session : le serveur MCP de Roblox est un processus local sur ton ordinateur, donc la session doit être sur ton ordinateur aussi.

Les surfaces de Claude Code et Roblox Studio
SurfaceAtteint Studio ?Notes
Terminal (la commande claude)OuiLance-la dans ton dossier de projet. Il te la faut aussi pour les commandes claude mcp plus bas.
Extension VS Code ou CursorOuiLa voie du guide coding harness de Roblox. L'extension embarque sa propre copie de Claude Code mais n'ajoute pas claude à ton PATH, donc installe aussi la version terminal si tu veux ces commandes.
Application de bureau, onglet Code, avec Local sélectionnéOuiTourne sur ta machine. Anthropic dit qu'un abonnement payant est nécessaire.
Sessions cloud (claude.ai/code, ou Cloud dans l'application de bureau)NonElles tournent sur une infrastructure cloud et non sur ta machine, donc elles ne peuvent pas lancer le serveur local de Studio.

Étape 1 : installer Claude Code et se connecter

L'installation recommandée par Anthropic tient en une commande dans un terminal. Voici les commandes que donnait sa page d'installation le 9 octobre 2026 ; consulte la page d'installation d'Anthropic (en anglais) pour les commandes actuelles.

Terminal · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. Ouvre une nouvelle fenêtre de terminal et lance claude --version. Un numéro de version veut dire que ça a marché. Si la commande est introuvable, le dossier d'installation n'est pas encore dans ton PATH, et la page de dépannage de l'installation d'Anthropic donne la solution.
  2. Va dans ton dossier de projet et lance claude. Au premier lancement, il ouvre une fenêtre de navigateur pour la connexion. Si le navigateur ne s'ouvre pas, appuie sur c pour copier le lien de connexion.
  3. Connecte-toi avec ton compte Claude. Une connexion Pro ou Max utilise l'usage inclus dans ton offre.

Sur Windows, Anthropic recommande d'installer Git for Windows pour que Claude Code puisse utiliser son outil Bash ; sans lui, Claude Code exécute les commandes dans PowerShell. Pour cette configuration, installe Claude Code sur Windows lui-même plutôt que dans WSL : la configuration Windows de Roblox lance cmd.exe avec un chemin %LOCALAPPDATA%, et Roblox ne documente pas WSL.

Tu préfères un panneau d'éditeur ? Dans VS Code ou Cursor, ouvre Extensions (Ctrl+Shift+X, ou Cmd+Shift+X sur Mac), cherche Claude Code, installe-le et connecte-toi depuis le panneau Claude. C'est la configuration qu'utilise le guide coding harness de Roblox.

Étape 2 : connecter Claude Code à Studio

Active d'abord le serveur. Dans Studio, ouvre Assistant, clique sur … > Manage MCP Servers et active Enable Studio as MCP server. Le guide du MCP de Studio détaille cette étape. Pas de bouton Assistant ? Vois comment ouvrir le panneau Assistant.

Quick connect

  1. Dans le même panneau (Assistant Settings > MCP Servers), déplie le menu Quick connect. Il liste les clients pris en charge qui sont installés sur ton ordinateur.
  2. Active Claude Code. S'il manque, installe Claude Code et redémarre Studio.
  3. Redémarre Claude Code : termine la session et relance claude, ou démarre une nouvelle conversation dans l'extension. Roblox dit qu'un client a besoin d'un redémarrage pour prendre en compte une nouvelle configuration.

Roblox ne dit pas dans quel fichier de Claude Code Quick connect écrit, ni quel nom il donne au serveur. Tape /mcp dans Claude Code pour voir le nom. Tu en as besoin pour les règles de permission de l'étape 3.

Tu utilises l'extension Claude Code dans VS Code ou Cursor ? Active Claude Code ici aussi. Le guide coding harness de Roblox active Cursor ou Visual Studio Code, mais Anthropic documente que l'extension partage sa configuration MCP avec la version terminal de Claude Code, et ne dit pas qu'elle lit les réglages MCP de l'éditeur lui-même.

Configuration manuelle avec un fichier .mcp.json

Si Quick connect ne marche pas chez toi, ajoute Studio toi-même. Claude Code lit les serveurs MCP du projet dans un fichier nommé .mcp.json dans ton dossier de projet, dans le même format mcpServers que documente Roblox, et il traite une entrée sans type comme un serveur stdio local. La configuration de Roblox marche donc telle quelle. Enregistre celle de ton système sous le nom .mcp.json dans le dossier où tu lances claude :

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

La prochaine fois que tu lances claude dans ce dossier, il te demande d'approuver le serveur : Anthropic affiche cette demande pour chaque serveur qui vient d'un fichier .mcp.json. Anthropic a conçu ce fichier pour qu'il soit commité et partagé par une équipe, mais les chemins Windows et macOS sont différents. Si ton équipe utilise les deux, garde le fichier hors du dépôt et laisse chacun ajouter Studio pour lui-même.

Sur macOS, tu peux à la place ajouter Studio avec une seule commande. --scope user le rend disponible dans tous les projets de ton ordinateur ; sans cette option, le serveur ne se charge que dans le dossier courant. Le -- sépare les options de Claude Code de la commande qui lance le serveur.

Terminal · macOS
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Sur Windows, le fichier JSON est la voie la plus simple, parce que PowerShell et CMD ne traitent pas %LOCALAPPDATA% de la même façon sur une ligne de commande.

Vérifier la connexion

  • Dans un terminal, claude mcp list affiche chaque serveur et son état. claude mcp get Roblox_Studio en montre plus, y compris une ligne Issue: si le serveur n'a pas réussi à se connecter.
  • Dans Claude Code, tape /mcp. Les serveurs connectés affichent un nombre d'outils à côté de leur nom.
  • Dans Studio, Assistant > … > Manage MCP Servers affiche un indicateur vert avec le nombre de clients connectés.

Étape 3 : décider ce que Claude peut faire sans demander

Règle ça avant que Claude touche à ton jeu. D'après la page des modes de permission d'Anthropic, depuis Claude Code v2.1.283, les sessions interactives du terminal et de VS Code démarrent par défaut en mode auto chaque fois qu'il est disponible, et en mode auto c'est un classificateur en arrière-plan qui examine les actions à ta place. Un appel MCP qui modifie un script ou exécute du Luau dans Studio peut alors passer sans qu'on te demande rien.

Tu as deux façons de garder la main sur chaque changement :

  • Démarre en mode Manual. Lance claude --permission-mode default. En mode Manual, seules les lectures s'exécutent sans demander. Appuie sur Shift+Tab pendant une session pour passer d'un mode à l'autre.
  • Ajoute des règles ask pour les outils de Studio qui modifient des choses. Anthropic dit qu'aucun mode n'approuve automatiquement un outil visé par une règle ask explicite, pas même le mode bypass.
.claude/settings.json · exemple
{
  "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"
    ]
  }
}

Les règles MCP ont la forme mcp__<server>__<tool>, avec le nom du serveur tel que Claude Code le connaît. Remplace Roblox_Studio par le nom qu'affiche /mcp. Les règles allow du .claude/settings.json d'un projet ne s'appliquent qu'après que tu as accepté la fenêtre de confiance de l'espace de travail pour ce dossier. Pour des règles qui ne concernent que toi, utilise plutôt .claude/settings.local.json.

La liste allow couvre les outils qui ne font que lire : l'arborescence du jeu, les propriétés, les scripts, l'Output et la liste des fenêtres Studio ouvertes. La liste ask couvre les outils qui modifient ton jeu, exécutent du code, lancent des tests, amènent des assets extérieurs ou envoient des images à Roblox. Les outils qui ne sont dans aucune des deux listes, comme screen_capture et les outils d'entrées, suivent ton mode de permission. La liste complète des outils, avec ce que fait chacun, est dans le guide du MCP de Studio.

Étape 4 : commencer par une demande qui ne fait que lire

Ouvre le jeu sur lequel tu veux travailler et ferme tous les autres. Puis donne à Claude une première demande qui ne peut rien changer :

Prompt
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.

Sur une Baseplate neuve, le guide coding harness de Roblox s'attend à ce que la réponse liste les objets par défaut Camera, Terrain, Baseplate et SpawnLocation. Demander d'abord list_roblox_studios est une bonne habitude : un seul client peut atteindre toutes les fenêtres Studio que tu as ouvertes, et chaque appel d'outil désigne sa fenêtre cible avec un studio_id.

Pour tout ce qui dépasse un seul script, demande d'abord un plan. En plan mode (appuie sur Shift+Tab, ou commence un prompt par /plan), Claude fait ses recherches et propose sans modifier tes fichiers. Anthropic décrit le plan mode en termes de modifications de fichiers et de commandes shell, donc garde aussi tes règles ask pour les outils de Studio.

Étape 5 : travailler sur les scripts comme des fichiers avec Script Sync ou Rojo

Claude Code est construit autour de fichiers dans un dossier. Il les modifie avec ses propres outils, Git garde leur historique, et /rewind peut les restaurer. Mettre tes scripts sur le disque te permet d'utiliser tout ça, et laisse les outils MCP pour les parties d'un jeu qui ne sont pas des scripts, comme les GUI dans StarterGui, les RemoteEvents et les parts. Roblox documente deux façons de le faire.

Script Sync et Rojo, d'après les pages Script Sync et outils tiers de Roblox
Script SyncRojo
Ce que c'estUne fonction de Studio qui synchronise les scripts de ton jeu avec des fichiers sur le disque, dans les deux sens.Un outil tiers : un serveur sur ton ordinateur plus un plugin Studio.
Ce qu'il synchroniseUniquement les instances Script, LocalScript, ModuleScript et Folder. Les autres instances d'un dossier synchronisé sont ignorées.Peut gérer tout le projet sous forme de fichiers, avec ton système de fichiers comme source de vérité.
ConfigurationFais un clic droit sur un service ou un dossier dans l'Explorer, choisis Sync to… et sélectionne un dossier. Le guide coding harness de Roblox l'active d'abord sous File > Beta Features.Installe-le avec Rokit (rokit add rojo-rbx/rojo, puis rokit install), ajoute le plugin avec rojo plugin install, lance rojo serve et connecte-toi depuis le plugin.
Team CreateMarche avec. Évite que deux personnes modifient le même script synchronisé en même temps.Roblox note que les outils tiers ne marchent souvent pas avec ses outils de collaboration intégrés.
Le conseil de RobloxConvient bien si tu veux ton propre éditeur et un contrôle de version pour le code, et Studio pour tout le reste.Un meilleur choix si tu veux tout ton projet, pas seulement le code, sous contrôle de version.

Le même nom de fichier peut vouloir dire des choses différentes

Les deux outils choisissent le type de script d'après le nom du fichier, et les suffixes ne correspondent pas. Un fichier .client est un LocalScript dans Rojo mais un Script avec un run context Client dans Script Sync. Dis à Claude quel outil ton projet utilise ; l'exemple de CLAUDE.md plus bas le fait.

Règles de Script Sync d'après la page Script Sync de Roblox (fichiers .luau). Règles de Rojo d'après la page Sync Details de Rojo v7, qui liste des fichiers .lua
Le nom du fichier finit parScript Sync créeRojo crée
.serverScript avec un run context ServerScript
.clientScript avec un run context ClientLocalScript
.localLocalScriptPas de sens particulier (tout autre fichier .lua est un ModuleScript)
Pas de suffixeModuleScriptModuleScript
Un dossier avec un fichier initUn script avec des enfants, dont le type est fixé par le nom du fichier initLe dossier devient le script que décrit init.server.lua, init.client.lua ou init.lua

Configurer Script Sync pour Claude Code

  1. Crée un dossier de projet avec un dossier pour chaque service que tu veux sur le disque, par exemple ServerScriptService, ReplicatedStorage et StarterPlayerScripts, et lance git init dedans.
  2. Si Script Sync n'apparaît pas quand tu fais un clic droit sur un service, active-le sous File > Beta Features, clique sur Save et redémarre Studio.
  3. Dans l'Explorer, fais un clic droit sur ServerScriptService, choisis Script Sync > Sync to, et sélectionne le dossier de projet de premier niveau, pas un dossier à l'intérieur. Répète pour les autres services.
  4. Lance claude dans ce dossier. Claude modifie maintenant des fichiers .luau, et Studio récupère chaque changement.
  5. Fais un commit avant chaque session, pour avoir toujours un point propre auquel revenir.
Terminal, dans ton dossier de projet
git add .
git commit -m "Before Claude session"

Deux règles de Script Sync comptent encore plus avec un agent. Ne synchronise pas de scripts qui ont des attributs ou des tags : Script Sync les ignore, et Roblox prévient que ça peut entraîner une perte de données. Et si des fichiers changent pendant que Studio est fermé, Studio te demande comment résoudre ça quand tu rouvres le jeu, en listant ce que Keep Studio et Keep Disk ajouteraient, modifieraient ou supprimeraient. Lis cette liste avant de choisir.

Avec Script Sync activé, une modification de fichier arrive dans Studio dès qu'elle est enregistrée. Accepter une modification dans Claude Code, c'est l'accepter dans ton jeu, donc relis avant d'accepter, surtout dans les modes qui acceptent les modifications automatiquement.

Pour l'autocomplétion et les erreurs de types dans ton éditeur, Roblox recommande l'extension Luau Language Server avec son plugin Studio compagnon. Dans VS Code, l'extension Claude Code peut lire le panneau Problems grâce à un outil intégré, donc Claude voit les mêmes avertissements que toi.

Étape 6 : donner tes règles Roblox à Claude dans CLAUDE.md

Chaque session Claude Code démarre avec un contexte neuf. Un fichier CLAUDE.md dans ton dossier de projet est lu au début de chaque session, c'est donc là que vont tes conventions. Lance /init pour que Claude en rédige un, ou écris-le toi-même. Le conseil d'Anthropic est de le garder sous les 200 lignes, d'écrire des règles assez précises pour être vérifiées, et de lancer /context pour confirmer qu'il a été chargé.

Cet exemple a été écrit pour ce guide, pour un projet qui utilise Script Sync. Change les noms pour qu'ils correspondent à ton jeu et coupe ce dont tu n'as pas besoin.

CLAUDE.md · exemple pour un projet 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.

Certaines lignes sont là à cause de la façon dont les outils marchent. Les règles de noms de fichiers existent parce que .client.luau n'est pas un LocalScript dans Script Sync. La ligne list_roblox_studios existe parce que le serveur peut atteindre toutes les fenêtres ouvertes. La ligne sur les assets existe parce que insert_asset amène du contenu extérieur dans ton jeu et que upload_image envoie des images au serveur d'assets de Roblox. La ligne wait suit la référence d'API de Roblox, qui marque wait, spawn et delay comme dépréciés au profit de la bibliothèque task.

Si ton projet a déjà un AGENTS.md pour d'autres agents de code, Claude Code peut le lire comme instructions de projet, donc tu peux garder un seul fichier pour les deux. La page sur la mémoire d'Anthropic explique quel fichier l'emporte quand les deux existent.

Ce que ces règles donnent dans le code

Voici un script serveur qui suit les règles Luau ci-dessus. Il a été écrit à la main pour ce guide, pas généré par Claude. Sers-t'en comme étalon quand tu relis ce que Claude te rend. Un LocalScript demande un outil avec RequestTool:FireServer("Sword"), et le serveur vérifie tout.

Script dans ServerScriptService nommé 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 ne synchronise que les scripts et les dossiers, donc le serveur crée son propre 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)
	-- Ignore une demande qui arrive après le départ du joueur.
	if player.Parent ~= Players then
		return
	end

	-- 1. Vérifie l'argument : un client peut envoyer n'importe quoi.
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. Limite la fréquence des demandes d'un même joueur.
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. Le serveur décide. Ajoute ici ta propre vérification de possession (un game pass, un achat enregistré).
	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. Nettoyage par joueur.
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

Sur le disque avec Script Sync : ServerScriptService/ToolRequests.server.luau. Mets tes objets Tool dans un Folder nommé Tools dans ServerStorage. Tant que tu n'as pas ajouté de vérification de possession, chaque joueur peut obtenir tous les outils de ce dossier.

Cherche les mêmes choses dans tout gestionnaire de remote qu'écrit Claude : il vérifie le type et la taille de ce que le client a envoyé, il limite la fréquence à laquelle un joueur peut l'appeler, c'est le serveur qui décide, et il retire l'entrée du joueur quand il part. Le guide des RemoteEvents explique pourquoi chacune compte.

Une façon sûre de travailler : point de sauvegarde, relecture, test

  1. Fais un point de sauvegarde des deux côtés. Fais un commit de tes fichiers dans Git, et sauvegarde une version du jeu dans Studio avec File > Save to Roblox with Notes. Le guide du MCP de Studio montre comment en restaurer une depuis Version History.
  2. Demande un plan pour tout ce qui dépasse un seul script, et lis-le avant de l'approuver.
  3. Relis le diff. Pour les fichiers, lis git diff ou les diffs en ligne de l'extension avant d'accepter. Pour les changements faits dans Studio, lis les scripts que Claude a touchés et regarde dans l'Explorer si des objets sont apparus ou ont disparu.
  4. Teste toi-même. Claude peut lancer un test et lire l'Output, mais il ne vérifie que ce qu'il a choisi de vérifier. Joue la fonction comme le ferait un joueur avant de faire un commit ou de publier.
  5. Fais un commit une fois que ça marche, avec un message qui dit ce qui a changé.

Ce que /rewind peut annuler, et ce qu'il ne peut pas

Claude Code enregistre un point de sauvegarde avant chaque prompt, et /rewind (ou Esc deux fois) restaure les fichiers que Claude a modifiés avec ses outils d'édition de fichiers. Anthropic liste ce qu'il ne suit pas, dont les changements faits par des commandes shell. Les changements faits dans Studio via les outils MCP ne sont pas des modifications de fichiers, donc ne compte pas sur /rewind pour les annuler, et la page MCP de Roblox ne dit pas s'ils arrivent dans l'historique d'annulation de Studio. Avec Script Sync, un fichier que /rewind restaure se resynchronise dans Studio comme n'importe quel autre changement sur le disque. Pour tout le reste, ta version sauvegardée est le moyen de revenir en arrière.

Garde les secrets et les données en ligne hors de portée

  • Ne colle pas de clés API, de clés Open Cloud, d'URL de webhook ni de mots de passe dans un prompt ou dans CLAUDE.md. Les deux sont du texte que Claude lit, et CLAUDE.md est en général commité dans ton dépôt.
  • Ne les écris pas en dur dans les scripts non plus. Roblox a un secrets store pour chaque jeu : crée des secrets dans le Creator Dashboard et lis-les dans un script serveur avec HttpService:GetSecret(). Pour les tests en local, ajoute des secrets locaux sous File > Experience Settings > Security.
  • Garde tes réglages personnels dans .claude/settings.local.json et CLAUDE.local.md, qui sont faits pour rester hors de Git. Ajoute toi-même CLAUDE.local.md à .gitignore.
  • N'active Enable Studio Access to API Services que dans une copie de test séparée de ton jeu. Roblox prévient que Studio utilise les mêmes data stores que le jeu en ligne, donc un test que Claude y lance pourrait écraser de vraies données de joueurs.
  • Lis une skill tierce avant de l'installer. Des annuaires de skills listent des skills Roblox pour Claude Code, et Anthropic note qu'une skill peut s'accorder elle-même un large accès aux outils par son champ allowed-tools.

Ce que coûte Claude Code pour travailler sur Roblox

Le côté Studio n'a pas de prix documenté : le serveur MCP fait partie de Studio, et la page MCP de Roblox ne mentionne aucuns frais. Le coût est celui de Claude Code, et Anthropic propose deux façons de payer (au 9 octobre 2026) :

  • Un abonnement Claude. Claude Code est inclus dans Pro, Max, Team et Enterprise, pas dans Free. Il puise dans le même usage que Claude sur le web, sur ordinateur et sur mobile. Les limites se réinitialisent sur une fenêtre glissante de cinq heures, et les offres payantes ont des limites hebdomadaires en plus. Quand tu en atteins une, tu peux attendre, passer à une offre supérieure ou activer des crédits d'usage.
  • Un compte Claude Console. Tu paies l'utilisation de l'API à l'unité de texte. La page des coûts d'Anthropic dit que la dépense varie beaucoup selon le choix du modèle, la taille du code et ta façon de l'utiliser.

Les prix actuels sont sur claude.com/pricing. Ce guide ne les répète pas parce qu'ils changent. Dans Claude Code, /usage affiche des barres d'usage de l'offre pour les abonnés et un coût de session estimé pour les utilisateurs de l'API.

Ce qui fait consommer plus à une session Roblox

  • La taille du contexte. La consommation d'unités de texte augmente avec ce que Claude a en contexte. Utilise /clear entre des tâches sans rapport.
  • Les gros résultats d'outils. Parcourir toute l'arborescence d'un gros jeu ou lire de longs scripts en entier renvoie beaucoup de texte. Claude Code prévient quand le résultat d'un outil MCP dépasse 10 000 unités de texte et le limite à 25 000 par défaut. Demande plutôt un seul dossier, une limite de profondeur ou une plage de lignes : search_game_tree et script_read le permettent tous les deux.
  • Le choix du modèle. Anthropic dit que Sonnet gère bien la plupart des tâches de code et coûte moins cher qu'Opus. Change avec /model.

Dépannage de Claude Code et Studio

La liste de vérification de Roblox est courte : redémarrer Studio et le client, vérifier que le chemin de la commande existe, et vérifier le JSON. Voici les cas propres à Claude Code.

Claude Code n'est pas dans la liste Quick connect

La liste ne montre que les clients pris en charge qui sont installés sur ton ordinateur. Installe Claude Code, puis redémarre Studio. Si tu l'as installé pendant que Studio était ouvert, redémarre Studio, Claude Code, ou les deux. Le fichier .mcp.json de l'étape 2 marche sans Quick connect.

/mcp n'affiche pas le serveur Roblox Studio

Redémarre Claude Code après avoir ajouté le serveur. Vérifie ensuite où il a été ajouté : un serveur ajouté sans --scope ne se charge que dans le dossier où tu l'as ajouté, donc lance claude depuis ce dossier ou ajoute-le à nouveau avec --scope user. Dans VS Code, démarre une nouvelle conversation, parce que les changements s'appliquent aux conversations démarrées après.

Le serveur indique Pending approval

Il vient d'un fichier .mcp.json, et Claude Code demande avant de les utiliser. Lance claude dans ce dossier, accepte la fenêtre de confiance de l'espace de travail et approuve le serveur. claude mcp reset-project-choices efface les choix précédents.

Le serveur affiche Failed to connect

Lance claude mcp get Roblox_Studio et lis la ligne Issue:. Vérifie que le fichier existe : %LOCALAPPDATA%\Roblox\mcp.bat sur Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP sur macOS (change le chemin si Studio est installé ailleurs). Assure-toi que Enable Studio as MCP server est toujours activé, puis redémarre Studio et Claude Code.

Le terminal dit que claude n'est pas reconnu

Ouvre une nouvelle fenêtre de terminal après l'installation. S'il est toujours introuvable, le dossier d'installation n'est pas dans ton PATH ; la page de dépannage de l'installation d'Anthropic donne la solution. L'extension VS Code n'ajoute pas claude à ton PATH, donc installe la version terminal à part pour les commandes de ce guide.

Claude a modifié le mauvais jeu

Avec plusieurs fenêtres Studio ouvertes, chaque appel d'outil désigne sa cible avec un studio_id. Demande à Claude d'appeler list_roblox_studios et nomme le jeu que tu veux, ferme les fenêtres que tu n'utilises pas, et restaure le jeu modifié depuis Version History.

Claude Code facture ma clé API au lieu de mon offre

Une fois que tu l'as approuvée, une variable d'environnement ANTHROPIC_API_KEY prend le pas sur ton abonnement. Supprime la variable (ou désactive Use custom API key dans /config), relance Claude Code, et lance /status pour vérifier quelle connexion est active. Si c'est toujours un compte Console, lance /login et choisis ton compte Claude.

Une session cloud ne voit pas Studio

Les sessions cloud tournent sur l'infrastructure d'Anthropic, pas sur ton ordinateur, donc elles ne peuvent pas atteindre le serveur local de Studio. Utilise le terminal, l'extension de l'éditeur, ou l'application de bureau avec Local sélectionné.

Ou utilise plutôt un agent en plugin : RoCode

Claude Code avec le MCP convient aux gens à l'aise dans un terminal ou un éditeur de code. RoCode (RoCode.app) est une autre voie : un agent IA indépendant pour Roblox Studio, avec un chat web sur rocode.app et un plugin gratuit du Creator Store qui exécute les étapes dans le jeu que tu as ouvert. Ce n'est pas un produit MCP et il n'utilise pas le serveur MCP de Studio, donc il n'y a ni ligne de commande, ni fichier de configuration, ni serveur MCP à configurer. Le plugin se connecte tout seul quand Studio est connecté au même compte Roblox que celui que tu utilises sur RoCode ; sinon, tu appaires le chat et le plugin une fois avec le code de 8 caractères affiché dans le panneau du plugin.

Ce qu'il faut savoir avant de changer. RoCode ne peut pas connecter un abonnement Claude ou Claude Code. Il fait tourner des modèles tiers via OpenRouter, dont Claude Sonnet 5.5 dès Pro et Claude Opus 5.5 dès Studio, et l'offre Starter gratuite donne 1 crédit par jour sur GPT-6 Luna. Il travaille depuis le mode édition. Avec le plugin 3.9 ou plus récent, en mode Build, il peut lancer un court test et lire les erreurs, et avec le plugin 3.9.11 ou plus récent contrôler un personnage de test pour vérifier que le jeu marche. Avec le plugin 3.9.14 ou plus récent, il prend aussi des captures de ce qu'il a construit, en mode édition, et peut corriger ce qui semble raté. Il n'exécute pas de code directement et ne génère pas de meshes, deux choses que les outils MCP de Studio savent faire. Il peut chercher dans le Creator Store avec tes mots des modèles gratuits (sans leurs scripts) ou insérer un modèle, un decal ou un mesh par son ID d'asset, et il conçoit des décors, des bâtiments et des accessoires nouveaux pour chaque jeu. Son mode Ask répond aux questions sur ton jeu avec des outils en lecture seule et ne change rien. Les comptes sont réservés aux 13 ans et plus, avec l'autorisation d'un parent ou d'un tuteur avant 18 ans.

Tu écris

Ajoute un RemoteEvent pour que les joueurs puissent demander un outil de ServerStorage.Tools. Vérifie tout côté serveur.

RoCode fait
  • Peut d'abord parcourir le jeu avec Search Game et List Children, pour trouver le dossier Tools et les scripts qui distribuent déjà des outils
  • Écrit le script serveur avec Create Script, et peut ajouter le RemoteEvent avec Create Instance
  • Vérifie dans Studio que le script compile avec Check Script avant de terminer. C'est une vérification de compilation, pas une vérification de types ni un test en jeu
  • Envoie ses modifications par lots, et chaque lot est un point d'annulation dans l'historique de Studio

Avec le plugin 3.9 ou plus récent, RoCode peut lancer un court test et lire les erreurs, et avec le plugin 3.9.15 ou plus récent son personnage de test peut marcher, appuyer sur des touches et cliquer sur les boutons à l'écran, mais il ne vérifie que ce qu'il a choisi de tester, donc appuie toi-même sur Play pour tester le résultat comme un joueur. Le prompt est un exemple écrit par nous ; les étapes utilisent les vrais noms d'outils. Comment marchent le plugin et l'appairage. RoCode est un produit indépendant, ni affilié à Roblox Corporation, ni approuvé, ni sponsorisé par elle.

Questions fréquentes

Puis-je utiliser Claude Desktop au lieu de Claude Code ?

Oui. Claude Desktop est dans la liste Quick connect du panneau Manage MCP Servers de Studio, donc il se connecte avec un seul interrupteur, sur Windows ou sur Mac. Il utilise les mêmes outils de Studio ; Claude Code ajoute ce qu'un agent en terminal fait bien, comme travailler sur des fichiers de scripts et avec Git. Les étapes pour les deux sont dans le guide de configuration du MCP de Studio.

Claude Code peut-il se connecter à Roblox Studio ?

Oui. Roblox liste Claude Code comme client Quick connect pour le serveur MCP intégré à Studio. Active Enable Studio as MCP server sous Assistant > … > Manage MCP Servers, active Claude Code sous Quick connect, et redémarre Claude Code. Il peut aussi travailler sur tes scripts sous forme de fichiers, avec Script Sync ou Rojo.

Claude Code est-il gratuit avec Roblox Studio ?

Le serveur MCP de Studio n'a pas de prix documenté, mais Claude Code ne fait pas partie de l'offre Free d'Anthropic (claude.com/pricing, vérifié le 9 octobre 2026). Il te faut une offre Claude payante, où il partage les limites d'usage de ton offre, ou un compte Claude Console facturé pour l'utilisation de l'API.

Faut-il un plugin Roblox ou les requêtes HTTP pour utiliser Claude Code ?

Pas pour le serveur MCP intégré à Studio. Les étapes de configuration de Roblox consistent à activer le serveur dans Assistant et à connecter le client ; elles ne comprennent ni plugin à installer ni réglage HTTP à changer. Certains guides plus anciens décrivent des serveurs MCP communautaires qui marchent autrement. Rojo, si tu le choisis pour les fichiers, utilise bien son propre plugin Studio.

Claude Code peut-il tester mon jeu Roblox ?

Avec les outils MCP de Studio, oui. start_stop_play lance et arrête un test, get_console_output lit l'Output, screen_capture capture la vue, et les outils d'entrées déplacent le personnage et envoient des touches et des clics. Vérifie ce qu'il rapporte, et joue toi-même au jeu avant de publier.

Faut-il utiliser Claude Code ou Codex avec Roblox Studio ?

Les deux sont dans la liste Quick connect de Roblox et atteignent les mêmes outils MCP de Studio, donc la différence tient au modèle, au compte et au client autour. Roblox ne publie aucune comparaison et nous ne les avons pas mesurés l'un contre l'autre. Essaie chacun sur une copie de ton jeu avec les mêmes règles écrites, et garde celui dont les changements demandent le moins de corrections.

Claude Code marche-t-il avec Roblox Studio sur Mac ?

Oui. Claude Code prend en charge macOS 13.0 ou plus récent, et Roblox documente un chemin de serveur pour macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, pour les clients que tu configures à la main.

Sources et lectures

Comment le code a été vérifié : chaque script de cette page passe le vérificateur de types strict de Luau avec les définitions de l'API Roblox (luau-lsp, 13 novembre 2026). Une vérification de types repère les API mal écrites et les mauvais types, pas la logique du jeu : teste dans Studio avant de publier.

Essaie RoCode sur ton propre jeu.

Des crédits gratuits chaque jour, sans carte. Installe le plugin, décris la fonctionnalité et vérifie ce qui arrive dans Studio.