Skip to content

LearnTutorials

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.

By Recaply EditorsIntermediate23 min5 stepsUpdated

A hand holds a short strip of blank film frames beside a small megaphone with sound lines curling out

What you need

  1. Step 1: Check your computer

    3 min

    A missing FFmpeg is a common reason a render fails, so check for it first.

    1. Open a terminal and run the 2 commands below.
    2. Fix anything the report flags, then run it again.
    Run this
    node --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 ffmpeg on a Mac, or sudo apt install ffmpeg on Ubuntu or Debian. Check it with ffmpeg -version, then run the doctor again.

  2. Step 2: Install the HyperFrames plugin

    2 min

    The plugin teaches Claude Code how to build a video project that renders cleanly.

    1. Run the first 2 commands below to add the plugin to Claude Code.
    2. Make an empty folder for the video and start Claude Code inside it.
    Run this
    claude 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:hyperframes listed when you type /hyperframes.

    Claude Code doesn't see the skill?

    Start a new session, or run /reload-plugins in the one that's open.

    Using another agent, such as Codex? Run npx skills add heygen-com/hyperframes and pick Core Skills. The skill is then called /hyperframes.

  3. Step 3: Ask for the news video

    6 min

    One clear brief sets the length, the scenes, the voice and the captions in a single pass.

    1. Paste the prompt below into Claude Code and fill in your 3 stories.
    2. Answer any question it asks about the look or the storyline.
    3. Wait while it builds the project and opens a preview in your browser.
    Your prompt
    Using /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.

  4. Step 4: Review it and ask for changes

    8 min

    Changes are quick before the render, so fix timing, captions and colors now.

    1. Watch the preview once with sound, then once on mute.
    2. Tell Claude Code what to change, in the same chat. Try the prompt below.
    3. Read every caption. Names, product terms and numbers are where speech recognition slips.
    4. To reopen the preview later, run npx hyperframes preview in the project folder.
    Try this
    Add 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.

  5. Step 5: Render the MP4

    4 min

    The render plays the project frame by frame in a hidden browser, and FFmpeg encodes it into one file.

    1. Ask Claude Code to render the video, or run the command below in the project folder.
    2. For a quick test render while you still edit, add --quality draft.
    3. Open final.mp4 and watch it from start to finish.
    Run this
    npx hyperframes render --output final.mp4

    You should see final.mp4 in 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 lint and npx hyperframes check. Paste the full output into Claude Code and ask it to fix the errors.

    Leave out --output and HyperFrames saves the file in a renders folder.

You get

A 30-second AI news video as an MP4, with narration, captions and music, made from 1 prompt and a few edits

Did this guide work for you?

Sources