Hands-on guide · Claude Code + Higgsfield

Build your cinematic site with AI — and you're the star

From zero to a portfolio site with real video of you — the camera orbits around you and you control it with your scroll. Built with Claude Code + Higgsfield MCP (Seedance 2.0 model). Every command here is verified against the official docs, and every cost figure was measured on a real generation — no guesswork.

1

Prerequisites — get these four ready before you start

  • A paid Claude account — Claude Code works with the Pro, Max or Team plans (the free plan isn't enough)
  • Claude Code installed — commands below
  • A Higgsfield account with credits — generation burns credits (see Step 7 for costs)
  • A clear headshot — we'll cover it in Step 3
Official install docs

Windows Paste into PowerShell (no Node.js needed):

irm https://claude.ai/install.ps1 | iex

Mac / Linux Paste into Terminal:

curl -fsSL https://claude.ai/install.sh | bash

npm Or via npm — only if you have Node.js 22 or newer (check with node -v):

npm install -g @anthropic-ai/claude-code

Once installed, open a Terminal in any folder and type:

claude

The first time, it opens your browser to sign in with your Claude account. When it says Login successful, press Enter — and you're done.

2

Connect Higgsfield MCP to Claude Code

MCP is the bridge that lets Claude generate videos directly from your Higgsfield account. Connecting takes 3 steps:

You'll need a Higgsfield account — create one here

1) Add the server — one command (the official URL from higgsfield.ai/mcp):

claude mcp add --transport http --scope user higgsfield https://mcp.higgsfield.ai/mcp

2) Sign in: start a session with claude, type /mcp, pick higgsfield, then Authenticate — your browser opens on a Higgsfield page; sign in and approve.

3) Confirm it's working:

claude mcp list

You should see higgsfield ✔ Connected. For the final check, ask Claude inside the session:

What's my Higgsfield balance?
If it comes back with a credit number — the connection is 100% working. If you see "Needs authentication", redo the sign-in step; if the tools don't show up, close the session and open a fresh one.
3

Your identity photo — the key to a consistent face

Seedance 2.0 keeps your face consistent across all the clips if you give it a clean identity reference photo. The quality of this photo = the quality of the result:

  • Sharp and clear — not blurry, not over-compressed
  • Front-facing — your whole face toward the camera
  • Chest up — not a close-up selfie, not a full-body shot
  • Simple lighting — no harsh shadows on your face
  • No sunglasses and nothing covering your features
  • And wear something close to what you want to wear in the video

Drop the photo in your project folder (name it something like my-photo.png), open claude in that same folder and ask:

Upload my-photo.png to Higgsfield and use it as the identity reference in every generation from now on.
The golden rule: same photo + the exact same wardrobe description, word for word, in all three clips = a consistent face and outfit in every scene.
4

Generate the three clips with Seedance 2.0

The shared settings — don't change them from clip to clip:

SettingValue
ModelSeedance 2.0
Modestd (1080p doesn't work with fast)
Resolution · Aspect1080p · 16:9
AudioNone (no audio)
Duration~8 seconds per clip
Identity + WardrobeYour photo + the same wardrobe description in every generation

Clip 1 — HERO ORBIT (the camera orbits 360° around you):

Generate with Seedance 2.0 (std, 1080p, 16:9, no audio, 8s), identity reference = my photo: A confident man in a [black t-shirt and dark overshirt] stands with arms crossed in an empty black-void studio. A soft rim light outlines him from one side. The camera performs one slow, smooth 360-degree orbit around him, completing exactly one full revolution. Cinematic, high contrast, shallow depth of field. No text anywhere in frame.

Clip 2 — THE BUILDER (sitting among holographic screens):

Same man, same wardrobe, same identity reference. Seedance 2.0 (std, 1080p, 16:9, no audio, 8s): He sits at a dark desk surrounded by floating translucent holographic screens showing abstract work — code, charts, UI mockups. All screen content is small, out of focus, non-readable. The screen glow reflects on his face. Slow cinematic push-in toward him. No readable text anywhere.

Clip 3 — THE CLOSER (walking toward the camera into a hero pose):

Same man, same wardrobe, same identity reference. Seedance 2.0 (std, 1080p, 16:9, no audio, 8s): He walks slowly toward the camera down a dark gallery corridor lined with glowing wall panels showing abstract wordless shapes. He stops in a confident hero pose facing the camera. Rim lighting, cinematic contrast, slow dolly. Zero text of any kind in frame.

When you're done, ask Claude to download the three clips into a clips/ folder inside your project.

Two warnings from experience: (1) Don't ask for any Arabic text inside the video — video models mangle Arabic letters; Arabic copy belongs on the site itself. (2) Sometimes Higgsfield suggests a ready-made preset instead of running your prompt — decline it and ask for the prompt to be run word for word.
5

Build the site — the master prompt

You've got the clips — now for the site. Copy the master prompt below, fill in the blanks between the [ ] brackets with your details (your name, numbers, services, projects, links), and paste it into a Claude Code session in the same project folder.

What happens next? Claude builds you:

  • Cinematic scroll — the orbit clip becomes a sequence of frames on a canvas that move with your scroll
  • Your name in huge display type, entering letter by letter
  • A stats strip that counts up (followers, projects, clients…)
  • Three pillars (your services) over Clip 2 + a work section over Clip 3
  • A finale with a big headline and two CTA buttons
  • Style: ink-black background + emerald + cream + subtle grain + smooth scrolling with Lenis
Build me an award-winning cinematic "3D scroll" PERSONAL PORTFOLIO website for me — [YOUR NAME]. Study the style of the Awwwards Site of the Year 2025 (Lando Norris): huge bold typography, cinematic scroll-driven sequences, and a central 3D element that rotates as you scroll. My version's central element is ME. VISUALS — Seedance 2.0 on the Higgsfield MCP (std mode, 1080p, 16:9, no audio, ~8s per clip). First upload my attached photo to Higgsfield and pass it as an identity reference on EVERY generation so my face is consistent. Keep my wardrobe identical throughout: [black t-shirt, dark overshirt]. Three clips: 1. HERO ORBIT — I stand confident, arms crossed, in a black-void studio with [emerald] rim lighting; the camera does one slow 360° orbit around me. 2. THE BUILDER — I sit at a dark desk surrounded by floating holographic screens showing my work; slow cinematic push-in. 3. THE CLOSER — I walk toward camera down a dark gallery lined with glowing screens, stopping in a hero pose. WEBSITE — scroll-scrub the hero orbit as a canvas frame sequence: "[YOUR NAME]" in massive display type tracks in letter-by-letter, subtitle "[what you do in one line]". Animated stats strip counting up on scroll: [your 3–5 best numbers — subscribers, clients, projects, revenue]. THREE PILLARS section over clip 2 revealing [your three main offers] one at a time. WORK section over clip 3 with cards for [your 3 best projects], each with a one-line pitch and hover motion. FINALE: "[your main CTA]" with two buttons, plus footer links to [your socials]. Ink-black background, [emerald] accent, cream typography, bold condensed display font, kinetic type, subtle grain, Lenis smooth scroll. Launch on localhost and verify the orbit scrub is buttery before telling me it's done.

Let Claude work — it can take several minutes and may ask you clarifying questions; answer them and let it carry on.

6

Run it and check it

Claude runs the site locally and gives you a link like http://localhost:4173. Open it and scroll slowly, then fast — what you want: the camera rotation follows your hand smoothly (buttery), with no jumps.

If the scroll stutters, paste this request (it fixes 90% of cases — tried and tested):

The orbit scrub is not smooth. Please: (1) preload all frames before enabling the scrub, (2) reduce frame width to ~1600px and JPEG quality to ~80%, (3) add lerp smoothing between the current and target frame, and (4) cap the canvas devicePixelRatio at 1.5.

Also check: open the site on your phone and watch the performance, and if your site has any Arabic text, make sure it renders with connected letters — if it's broken up, tell Claude: "Arabic text must be real HTML text, never split into separate letters".

7

Troubleshooting and the real cost

Common connection problems:

ProblemFix
✘ Failed to connectDouble-check the URL character by character, remove and re-add: claude mcp remove higgsfield
! Needs authenticationInside the session: /mcp → higgsfield → Authenticate
Tools not showing upClose the Claude session and open a fresh one
claude.ai connection is separateConnecting on claude.ai (Settings → Connectors) is not the same as connecting Claude Code — each one has its own connection

Cost — numbers measured on a real generation on 2026-08-15 (prices change — ask Claude "How much will this generation cost?" before you generate):

SettingPer clipAll three clips
1080p · std · 8s (recommended)72 credits216 credits
1080p · std · 6s54 credits162 credits
720p · std · 8s36 credits108 credits
Not enough credits? Generate at 6 seconds instead of 8 — you can barely tell the difference in the scroll (I personally used 6 seconds on my own site), or drop to 720p, or top up your credits on Higgsfield.
8

Final checklist + FAQ

  • Claude Code is installed and claude opens a session
  • claude mcp list shows higgsfield ✔ Connected
  • Asking for your balance returns a number
  • A clean reference photo is uploaded
  • 3 clips with the same face and outfit in the clips/ folder
  • The master prompt is filled in with your details and pasted
  • The site runs on localhost and the scroll is smooth
  • Any Arabic text renders with connected letters — and it's tested on mobile
Do I need to know how to code?
No. All you do is copy-paste commands and prompts — Claude writes all the code.
How long does it take?
Setup and connection ~15 minutes. Generating the clips takes a few minutes per clip. Building the site is a single session with Claude.
Why does my face look different in one of the clips?
Most likely the reference photo wasn't passed on that generation, or the wardrobe description changed. Regenerate with the same photo and the exact same wardrobe description.
Can I change the colors?
Of course — swap [emerald] and cream in the master prompt for your own colors. Keep it to two or three colors so the look stays clean.
How do I publish the site online afterwards?
Ask Claude: "Deploy the site to Netlify / GitHub Pages / AWS S3" — it walks you through it step by step.
Will the commands and prices stay the same?
The commands were verified against the official docs on 2026-08-16. If anything changes, your permanent references are code.claude.com/docs and higgsfield.ai/mcp.
✓ Copied