Skip to main content
The examples on this page were created using Claude Code. Other AI agents and models can follow the same prompts.
Claude Code places sets and props, animates cameras, and renders what a camera sees. By using your Spark account, Claude can only work in productions you can open.

Prerequisites

  • An AI agent installed on your computer and signed in, such as Claude Code in Claude Desktop or a terminal.
  • System requirements:
    • Mac: Apple silicon, macOS 15 or later
    • Windows: Windows 10 or 11, an x64 processor
  • A Spark production with at least one script. See Quickstart.
Important: you need a coding agent installed on your computer. This guide will not work in claude.ai, chatgpt.com or similar browser chats.

Set up

To connect your agent to Spark, follow these steps:
1

Open your agent

  • In Claude Desktop, click the Code tab. Under the prompt box, choose Local, then any folder for Claude to work in.
  • In a terminal, type claude, then press Enter. If it asks to trust the folder, choose yes.
2

Give your agent the setup prompt

The install takes a minute or two.
Setup prompt
If your agent asks permission to run the installer, allow it.
3

Sign in and start a new session

Your browser will open Spark. Sign in there. Never type your password into the chat.When your agent suggests, start a new session: click + New in Claude Desktop, or type /exit, then claude in a terminal.
4

Try your first prompt

In the new session, paste:
First prompt

What to ask for

  • Paste a scene’s link from the Spark web app, so Claude knows where to work.
  • Ask for a plan first. Each prompt below ends with “Show me your plan before you build it.”
  • Use Claude for jobs with many repeated steps. Big ones can take 20 minutes or more.
  • Make small changes, such as moving one object, by hand. That’s faster.

Dress a set

Set dressing prompt
Claude placed 32 props and added both cameras: A wide render of a courtyard dressed as a market, with two rows of stalls, barrels, crates and lanterns A render from the market aisle looking back at a stone city gate, with stalls and carts on both sides

Animate complex movement

Animation prompt
Each car in this shot has 121 keyframes:

Add camera moves

Camera move prompt
The crane shot: The follow camera:

What Claude can do

  • Place, move, scale and rotate objects in a 3D scene
  • Place assets from your production’s files or the Spark Library
  • Make simple USD stand-ins, such as props and characters, then upload them
  • Add cameras with real lenses, aim them and set focus
  • Animate objects and cameras with keyframes
  • Render a camera’s view, check the frame and fix its own mistakes
  • Render shot previews, then cut them into an edit with audio
  • Pose the parts of an asset
Ask Claude to undo any change, such as “remove the props you just added”. Undo leaves files behind: assets Claude placed or made stay in your production’s files.

What Claude can’t do

  • Create organizations, productions or scripts. Use the Spark web app.
  • Delete a scene. Use the Spark web app.
  • Change lighting. Every render uses the same studio light.
  • Record takes. Use the Spark iOS app.
  • Make new Gaussian splat locations. It uses the ones in your files and the Library.

Update Spark

Give your agent the setup prompt again, then start a new session. The installer updates Spark each time it runs.

Troubleshooting

  • Your agent asks you to run a command yourself. A safety check blocked the installer or the sign-in. Paste the whole setup prompt again, including the sentence that gives permission.
  • The ground or buildings look smeared. Library locations are sharp only near their middle. Ask Claude to move the action and camera closer to the middle. If the scene needs more room, ask it to scale the location up.

Quickstart

Make a production and a script for Claude to work in.

Asset Library

See the files Claude places and uploads.