📦Installing Sandbox Studio
A Windows guide for installing the Sandbox Studio desktop app, signing in with Sandbox, and completing first-launch onboarding. Confirm your machine meets the Creating requirements first. After Studio is running, install the AI coding assistant you chose and open the project folder so you can connect Sandbox Studio MCP. Download and Install Cursor is the worked example.
Download the installer
Download the installer from sandbox.game. Sign in with a Sandbox account — the download is available after you log in. Do not use a copy from an unverified website or file-sharing source.
The installer is a large file and may take a few minutes to download. Confirm the file identifies the product as Sandbox Studio.
Run the installer
Double-click the installer. Approve the Windows permission prompt only after checking the file name and source. The installer uses a one-click flow and displays Installing, please wait while the application is copied to the computer.

Set up in-editor AI assistants (without Cursor)
Cursor is optional. The editor has its own Assistant chat. You add providers and pick models here, then chat from the agent panel on the left.
Open the menu → App Settings → AI Settings. There are three tabs: Assistant, Models, and MCP. MCP connects an external agent such as Cursor — see Set up and use Sandbox Studio MCP. Use Assistant and Models for the in-editor chat.
Assistant tab — add a provider
Turn Enable AI Assistant on. Status should read Ready. If you turn this off, the in-editor chat stops. Sandbox Studio MCP on the MCP tab can still run.
Select Add Provider. Search if you need to. Open Not Set Up to see the catalogue (API Key or OAuth, depending on the provider). Configured lists providers you have already added.
Choose a provider, complete API key or OAuth, and enable it.
Connect and enable at least one provider to use the Assistant. If several are enabled, the one at the top of the list is preferred when Studio resets or chooses the default model.

Models tab — what appears in chat, and the default
Open the Models tab.
Use Open on the model list to pin or unpin models from the catalogue. Pinned models appear in the Assistant chat selector.
Use Last Selected Model — when this is on, a new chat starts with the model you used most recently instead of the default below.
Default Agent Model — the model new chats use when no model is chosen. Pick it from the dropdown. Reset returns that field to Studio's default.
Assist Actions Model — used for Fix with AI and other Assist Actions. Leave Use Default Agent Model checked to keep them in sync, or clear it and pick a different model.

Update Sandbox Studio
When an update is ready, Studio displays Restart to Update in the top bar. Save project changes, stop any running play session, then select the update control and allow Studio to restart.
Troubleshooting
Windows warns about the installer
The supplied file is not digitally signed. Stop and confirm that it came from sandbox.game.
Sandbox Studio is already running
Close Sandbox Studio, then select OK in the installer message. If the application does not close, exit it manually and restart the installer.
Environment Setup reports a problem
Use Re-check after changing Node.js or pnpm. Review the expanded Install Output, follow any administrator instructions, and use Try Again to repeat the last installation action.
Sign-in does not return to Studio
Complete authentication in the browser and reopen Studio if the application remains on the sign-in page.
What you’ve done
The Sandbox Studio desktop app is installed, you are signed in, and first-launch onboarding is complete. You can add more in-editor providers later under App Settings → AI Settings. Next, create a project. To use an external agent as well, open the project in that assistant. For Cursor, download and install Cursor and set up Sandbox Studio MCP.
Last updated
Was this helpful?







