How to Make Your First Video in HyperFrames Studio: Connect Claude Code or Codex, Edit by Pointing, Export in 4K
Image: HeyGen (official HyperFrames documentation) — the "Create your first video" card in the HyperFrames Studio app, with Hook, Proof, Turn and Call to action slots
Most AI video tools hand you a finished clip and a regenerate button. If one word on screen is wrong, you start over. HeyGen's HyperFrames Studio, released on October 5 for Mac and Linux, takes a different route: a coding agent already on your computer, Claude Code or Codex, builds the video as an editable project, and then you and the agent work on the same timeline. You can circle a spot on the frame, pin a comment to a moment, or trim a clip yourself.
The idea behind it is HyperFrames, HeyGen's open-source framework in which an agent writes a video as HTML and renders it to MP4. Until now that mostly lived in terminals and agent skills. The Studio app wraps it in a desktop editor for people who don't want to write code. This guide walks through setup, your first video, editing and export, using HeyGen's own documentation for each step.
Before you start: what you need
- A Mac or a 64-bit Linux PC. HeyGen says Windows is coming but gave no date.
- A HeyGen account. The app asks you to sign in with it.
- An agent account. Claude Code needs a Claude account or an Anthropic Console account. Codex needs a ChatGPT account.
One point that is easy to miss: the docs say runs are billed to the plan of the account your agent is signed in with. In other words, the heavy lifting uses your Claude or ChatGPT usage, not a separate HyperFrames meter. If you would rather pay per use, you can change Bill runs to under Settings > Permissions and use an API key instead.
Step 1: Install the app
Go to hyperframes.dev/studio and pick your platform.
- Mac: open the disk image and double-click Install HyperFrames. The installer copies the app to Applications and runs a "Checking it is really from HeyGen" step, which can take a minute or two.
- Linux: you get a single file,
HyperFrames-x86_64.AppImage. In a terminal, runchmod +x HyperFrames-x86_64.AppImageand then./HyperFrames-x86_64.AppImage. The AppImage is the whole app, so you can keep it anywhere.
On first launch a short survey asks what you want to make and which agent you use. Every question is optional. After that, the first click prompts you to choose Continue with HeyGen; your browser opens, and you have two minutes to finish signing in before the app times out.
Step 2: Connect Claude Code or Codex
This is the step that decides whether the rest goes smoothly. The two agents are set up differently.
Claude Code is the easier path. The first time you send a request without an agent, a Connect Claude Code screen appears. Choose Install Claude Code, and the app runs Anthropic's official installer (about a minute). Then choose Sign in to Claude, finish in the browser, and come back. When the app shows "Claude Code is connected", it sends the request you started with.
Codex takes a few more steps, because the app does not install it for you. Open Settings > Agent, find Codex, copy the install command it shows, run it in a terminal, then run codex to sign in with your ChatGPT account. Back in the app, choose Check again until it says Ready.
If both are ready and you haven't picked one, the app uses Claude Code. You can switch from the agent picker in the chat header.
Step 3: Make your first video from the guided card
Home opens with a Create your first video card that builds a short launch video from four parts, each taken from a real launch video:
- Hook grabs attention in the first seconds.
- Proof shows the product doing its job.
- Turn flips from the problem to the answer.
- Call to action lands the brand and the ask.
Shuffle any slot until you like the mix, then type your website or describe an idea. A website is worth giving: the docs say it lets the agent pick up your fonts, colors and logo. Choose Use this cut. The chat then shows what the agent is doing, such as "Reading files" or "Editing files", and the video becomes playable when the run ends.
You don't have to use the card. From Home you can type any request in the prompt box and use @ to attach files, media or earlier projects.
Step 4: Edit by pointing instead of explaining
This is where HyperFrames Studio is genuinely different from prompt-only video tools. Under the picture there are three tools:
- Select (V): click an element, choose Prompt to edit (or press A), and describe the change.
- Draw (D): circle or mark a spot and say what should change. You can also draw across the timeline to say something like "tighten this part".
- Comment (C): pin a note to a spot at a specific moment.
These marks don't run one by one. Each becomes a row in Pending video edits, up to 10, and you send them together in one request, for example "Send 3 edits to Claude Code". That batching matters, because every agent run uses your plan's quota. Collect your notes from a full watch-through, then send once.
Small fixes are faster by hand. Hover a timeline clip to split or delete it, or open Quick edit for speed, volume and fade. Each agent run also has its own Undo button, alongside the usual Cmd+Z (Ctrl+Z on Linux).
Step 5: Export
Choose Export in the top bar. Quality is 1080p by default, with 4K offered when the project fits it. Formats are MP4, WebM and MOV, at 24, 30 or 60 frames per second. The file lands in your Downloads folder, named after the project with the date and time. Export is unavailable while the agent is still working, so wait for the run to finish.
Two settings worth checking
Agent access. Under Settings > Agent, Claude Code defaults to Full access, which the docs describe as able to install, use the internet and run anything, with no checks. The alternative, Auto, keeps it working in your project and blocks risky steps. If you are installing this on a work machine, I'd start on Auto and only switch when a blocked step actually stops a change.
Queue or Steer. By default, a message typed while the agent works waits its turn. Switching While Framey works, Send to Steer stops the run and restarts it with your new words, which is handy when you spot a wrong direction early.
My take
The interesting part isn't the video generation. It's that the output is a plain project folder, stored in a hidden .hyperframes-studio folder in your home directory, that the same agent, the web editor and the command-line tools can all open. That makes the first cut a draft you can keep improving, not a dead end. The trade-offs are real, though: every run draws on your Claude or ChatGPT usage, there is no Windows build yet, and HeyGen's own export guide reminds you to watch the file once before sending it. For product intros, explainers and short launch clips, it is one of the more practical agent-plus-human workflows I've seen this month.
Sources
- HeyGen, HyperFrames docs: Get the HyperFrames Studio app
- HeyGen, HyperFrames docs: Connect your agent
- HeyGen, HyperFrames docs: Make your first video
- HeyGen, HyperFrames docs: Change your video with the agent
- HeyGen, HyperFrames docs: Export your video
- HeyGen, HyperFrames docs: Updates and troubleshooting
- RuntimeWire: HeyGen's HyperFrames adds a shared timeline for AI-made video
댓글
댓글 쓰기