Make an AI news video with Claude Code and HyperFrames
Make a 30-second AI news video with Claude Code and the free HyperFrames plugin, with narration, captions and an MP4 render, in under 25 minutes.

What you need
Step 1: Check your computer
3 minA missing FFmpeg is a common reason a render fails, so check for it first.
- Open a terminal and run the 2 commands below.
- Fix anything the report flags, then run it again.
Run thisnode --version npx hyperframes doctor
You should see a Node version of 22 or higher, and a report on the runtime, the browser and FFmpeg.
The report says FFmpeg is not found?
Install it:
brew install ffmpegon a Mac, orsudo apt install ffmpegon Ubuntu or Debian. Check it withffmpeg -version, then run the doctor again.Step 2: Install the HyperFrames plugin
2 minThe plugin teaches Claude Code how to build a video project that renders cleanly.
- Run the first 2 commands below to add the plugin to Claude Code.
- Make an empty folder for the video and start Claude Code inside it.
Run thisclaude plugin marketplace add heygen-com/hyperframes claude plugin install hyperframes@hyperframes mkdir ai-news-video && cd ai-news-video claude
You should see Claude Code open in the new folder, with
/hyperframes:hyperframeslisted when you type/hyperframes.Claude Code doesn't see the skill?
Start a new session, or run
/reload-pluginsin the one that's open.Using another agent, such as Codex? Run
npx skills add heygen-com/hyperframesand pick Core Skills. The skill is then called/hyperframes.Step 3: Ask for the news video
6 minOne clear brief sets the length, the scenes, the voice and the captions in a single pass.
- Paste the prompt below into Claude Code and fill in your 3 stories.
- Answer any question it asks about the look or the storyline.
- Wait while it builds the project and opens a preview in your browser.
Your promptUsing /hyperframes:hyperframes, make a 30-second AI news video in 16:9. Scenes: a title card that says "[SHOW NAME]", 3 story sections, and a 3-second outro. Stories: 1. [HEADLINE 1]: [2 FACTS] 2. [HEADLINE 2]: [2 FACTS] 3. [HEADLINE 3]: [2 FACTS] Add a calm, clear narration of the stories. Captions: 2 lines at most, key words in [BRAND COLOR]. Dark background. A quiet music bed under the voice. No sound effects.
You should see a new project in your folder, and the first version of the video playing in a browser preview.
The narration says things you didn't write?
Paste your exact script in quotes and say it's approved. When you give only points, Claude Code writes the words itself.
With no HeyGen account, the voice comes from Kokoro, a free model on your computer. For HeyGen voices, sign in with
npx hyperframes auth login.Step 4: Review it and ask for changes
8 minChanges are quick before the render, so fix timing, captions and colors now.
- Watch the preview once with sound, then once on mute.
- Tell Claude Code what to change, in the same chat. Try the prompt below.
- Read every caption. Names, product terms and numbers are where speech recognition slips.
- To reopen the preview later, run
npx hyperframes previewin the project folder.
Try thisAdd a lower third with the source's name at the start of each story. Keep the captions clear of it. Make the music quieter while the voice speaks.
You should see the preview with your changes in place, and captions that match the narration word for word.
One caption word is wrong?
Fix it by hand in the browser editor: click the word on the frame, or find it in the caption track under the preview.
Step 5: Render the MP4
4 minThe render plays the project frame by frame in a hidden browser, and FFmpeg encodes it into one file.
- Ask Claude Code to render the video, or run the command below in the project folder.
- For a quick test render while you still edit, add
--quality draft. - Open
final.mp4and watch it from start to finish.
Run thisnpx hyperframes render --output final.mp4
You should see
final.mp4in your project folder, at 1920 by 1080 and 30 frames a second unless you asked for something else.The render fails or looks different from the preview?
Run
npx hyperframes doctor,npx hyperframes lintandnpx hyperframes check. Paste the full output into Claude Code and ask it to fix the errors.Leave out
--outputand HyperFrames saves the file in arendersfolder.
You get
A 30-second AI news video as an MP4, with narration, captions and music, made from 1 prompt and a few edits
Try next
Did this guide work for you?
Thanks. It helps us fix the steps.


