Hướng dẫn dùng Reelcrew

Reelcrew là đoàn làm phim cho Claude Code và Codex: bạn nói video mình cần, agent đạo diễn, Reelcrew làm phần việc tay chân ngay trên máy của bạn.

Bắt đầu

Cài Reelcrew. Trên Mac hoặc Linux, trong Terminal: curl -fsSL https://reelcrew.io/install.sh | sh. Linux: Ubuntu 20.04, 22.04, 24.04 và Debian 12, 13 (máy để bàn, máy chủ hoặc WSL2, tài khoản thường hay root); Fedora, RHEL, Rocky, Alma 8 và 9, Amazon Linux 2023 chạy được khi bạn chạy các lệnh dnf mà reelcrew doctor in ra; Alpine và các bản glibc cũ hơn 2.28 không cài được. Trên Windows, trong PowerShell: irm https://reelcrew.io/install.ps1 | iex. Hoặc nhờ Claude Code hay Codex cài giúp (mục Cài đặt có đoạn để dán).
Trả lời vài câu hỏi thiết lập. Chọn giọng đọc, dịch vụ ảnh, nhạc. Bỏ qua câu nào cũng được, làm lại lúc nào cũng được.
Khởi động lại Claude Code hoặc Codex để nó nhận các skill mới.
Nói video bạn cần. Ví dụ: “Làm video giải thích vì sao bầu trời màu xanh”. Agent chọn skill phù hợp và làm từ đầu đến file MP4.

Không nhớ lệnh nào? Gõ /reelcrew trong Claude Code hoặc $reelcrew trong Codex, hoặc hỏi thẳng: “Reelcrew làm được những video gì?”, “máy tôi còn thiếu gì?”. Agent đọc hướng dẫn của Reelcrew và làm giúp bạn.

Chọn loại video

Mỗi loại video là một skill. Bạn không cần gọi tên skill: cứ mô tả video, agent tự chọn. Các câu mẫu dưới đây để bạn hình dung.

Gói Starter, Pro

Bản tin ảnh dọc (tin nóng)

Video dọc 40–55 giây kiểu bản tin ảnh cho Reels, TikTok, Shorts: ảnh báo chí, tiêu đề cố định, phụ đề karaoke, giọng đọc tin.

“Làm video tin nóng dọc về vụ … (dán link bài báo)”
“Dựng bản tin ảnh 45 giây về …, watermark @kenhcuatoi”

Gói Starter, Pro

Clip giải thích điện ảnh

Clip khoảng 30 giây giải thích một hiện tượng khoa học, hình minh hoạ điện ảnh, hiệu ứng khớp từng chữ.

“Làm clip 30 giây giải thích vì sao không gấp đôi tờ giấy quá 7 lần”
“Clip dọc giải thích sấm sét hình thành thế nào”

Gói Starter, Pro

Chữ và hiệu ứng chuyển động

Hiệu ứng chuyển động cho video có người nói: thẻ chữ, chữ nằm sau người, glitch, chia đôi màn hình.

“Thêm thẻ chữ và chữ sau lưng người nói cho video này (đường dẫn file)”
“Làm đoạn mở đầu có glitch cho clip …”

Gói Starter, Pro

Bài giảng hoạt hình

Biến một bài giảng hay buổi nói chuyện thành video hoạt hình vẽ tay 3–4 phút, phụ đề, thumbnail.

“Biến video YouTube này thành bài giảng hoạt hình tiếng Việt: (link)”
“Làm video giải thích vì sao bầu trời màu xanh, có phụ đề”

Gói Starter, Pro

Giải thích bài báo khoa học

Đi qua một bài báo khoa học (PDF, arXiv) từng phần, 3–5 phút, biểu đồ hiện dần theo lời đọc.

“Làm video giải thích bài báo này: https://arxiv.org/abs/1706.03762”
“Tóm tắt file PDF này thành video 4 phút”

Gói Starter, Pro

Giải thích bài báo kiểu 3Blue1Brown

Giải thích một bài báo khoa học theo phong cách 3Blue1Brown: nền đen, công thức toán, hình vẽ dần theo lời đọc quanh một công thức xương sống, 4–6 phút.

“Làm video giải thích paper này kiểu 3b1b: https://arxiv.org/abs/1706.03762”
“Giải thích file PDF này theo phong cách Manim”

Gói Starter, Pro

Phim tranh khắc biên tập

Phim 2,5–3 phút về triết học, lịch sử hay một ý tưởng, kiểu bản khắc biên tập: tranh khắc sepia có camera lia, thẻ chân dung, dấu mộc, gạch đỏ, phụ đề karaoke.

“Làm video kiểu tranh khắc về ngụ ngôn hang động của Plato”
“Dựng phim bản khắc về thí nghiệm con mèo của Schrödinger”

Gói Pro

Tư liệu cắt dán giấy

Phim tư liệu kiểu cắt dán giấy (như Vox): ảnh bán sắc, nhãn giấy xé, dây đỏ, con dấu, 40 giây đến vài phút.

“Làm video cắt dán giấy về lịch sử phiến đá Rosetta”
“Dựng video kiểu Vox từ bài báo này (link)”

Gói Pro

Phim tư liệu

Phim tư liệu 8–10 phút về lịch sử hay công nghệ: ảnh có giấy phép, trang báo cũ, thẻ ngày tháng, đồ hoạ giải thích.

“Làm phim tư liệu về Internet đến Việt Nam như thế nào”
“Phóng sự 8 phút về lịch sử chiếc iPhone”

Gói Pro

Video vị trí bất động sản

Video dọc giới thiệu bất động sản: ảnh dự án rồi bản đồ thật, đường đi tới trường, chợ, metro kèm số phút.

“Làm video vị trí cho căn hộ ở … (địa chỉ), kèm 5 ảnh này”
“Video căn hộ cạnh ga metro …, đi bộ bao nhiêu phút”

Gói Pro

Nhà máy isometric giải thích hệ thống

Video 16:9 khoảng 70 giây giải thích kiến trúc một hệ thống hay quy trình theo kiểu bản vẽ isometric: băng chuyền 6 trạm chạy theo nhịp nhạc, bàn định tuyến, chồng kết quả, hai act trước/sau. Mặc định chỉ có nhạc, có thể thêm lời đọc.

“Làm video nhà máy isometric giải thích hệ thống AI agent định tuyến ticket”
“Dựng video kiểu decision factory cho quy trình duyệt hồ sơ vay, trước và sau khi tự động hoá”

Gói Pro

Video giải thích ngắn theo ngách

Video dọc 60–90 giây giải thích một chủ đề trong một ngách (du lịch, luật, trade, tiếng Anh, lịch sử, mẹo văn phòng, AI cho doanh nghiệp, tài chính cá nhân, nấu ăn…): mascot dẫn chuyện, widget riêng của ngách (bảng chi phí, bản đồ lộ trình, nến giá, văn bản luật…), lời đọc và phụ đề hoặc chỉ có nhạc.

“Làm video giải thích ngắn: đi Đà Lạt 48 giờ hết bao nhiêu tiền”
“Làm video luật mới dễ hiểu về nghị định … cho người bán hàng online”

Gói Pro

Video motion theo nhịp nhạc

Video motion graphics cắt theo nhịp nhạc, câu chốt rơi đúng điểm drop, chữ hiện đúng từ được đọc, phụ đề karaoke: 10 phong cách (launch sản phẩm kiểu keynote, comic hay sổ tay vẽ chì; một khái niệm trên sơ đồ; một ý tưởng bằng chấm trắng biến hình; nghịch lý khoa học; nông sản từ ảnh của shop; ra mắt website; demo sản phẩm từ bản quay màn hình; showreel cá nhân từ website, chỉ có nhạc), dọc, ngang hoặc vuông.

“Làm video launch tính năng mới kiểu keynote từ changelog này”
“Làm video nông sản từ ảnh và clip của shop”
“Làm showreel giới thiệu bản thân từ website của tôi”

Gói Pro

Meme động người que lặp vòng

Meme động vuông lặp khoảng 8 giây: một ảnh nền tạo bằng AI, nhân vật người que mặt hoạt hình tự vẽ (chạy, vẫy, ngủ), tiền bay, chữ z, camera đẩy chậm, tiêu đề, nhạc lặp và watermark của bạn; không dùng AI tạo video.

“Làm meme động người que về cuộc đua giữa các app giao đồ ăn”
“Làm lại meme này bằng nhân vật của mình (link)”

Gói Pro

Video mascot 3D cho thương hiệu

Mascot 3D của thương hiệu, dựng lại bằng code từ ảnh của khách hoặc từ file GLB: bảng nhân vật để duyệt, promo 16:9 hoặc 9:16 có lời đọc, thẻ UI 3D và logo khớp đúng cú drop, video hai mascot tám chuyện bên ly trà đá, và hero loop liền mạch cho landing page kèm trang mẫu.

“Làm video mascot 3D cho thương hiệu của tôi từ mấy tấm ảnh này”
“Cho hai mascot ngồi trà đá tám chuyện, khung dọc 9:16”
“Làm hero video có mascot cho landing page”

Gói Pro

Video luyện nghe tiếng Anh

Video dọc 15–80 giây luyện nghe tiếng Anh cho người Việt từ một bài học ngắn: đọc truyện từng câu song ngữ có khung chạy theo từng từ, đoạn văn tô màu từ vựng kèm nghĩa, hoặc trò đoán từ (đọc nghĩa tiếng Việt, đếm ngược, hiện đáp án và phiên âm). Giọng Kokoro (tiếng Anh) và VieNeu (tiếng Việt) miễn phí trên máy.

“Làm video luyện nghe tiếng Anh A2 kể chuyện một ngày đi chợ, 10 câu”
“Làm video đoán từ tiếng Anh chủ đề nhà bếp, 5 từ”

Gói Pro

Video vẽ tay bảng trắng

Video vẽ tay bảng trắng 16:9 hoặc 9:16 từ phụ đề SRT, một file giọng đọc hoặc một kịch bản: mỗi cảnh 25–35 giây là một bức tranh nét vẽ trên nền giấy, bàn tay vẽ từng vùng theo thứ tự câu chuyện rồi tô màu, kèm giọng đọc, nhạc nền, tiếng bút chì và phụ đề nếu muốn; bạn duyệt từng bước trước khi làm tiếp.

“Làm video vẽ tay bảng trắng từ file phụ đề này”
“Biến kịch bản này thành video bàn tay vẽ minh hoạ, khổ dọc”

Gói Pro

Giải thích bằng cỗ máy isometric

Giải thích một ý tưởng kỹ thuật bằng một cỗ máy thật vẽ isometric (nhiều chi tiết nhỏ chính xác, đổ bóng bốn tông, thẻ có số đọc trực tiếp, tuỳ chọn WebGL và 3D), thành video có lời đọc (tiếng Việt hoặc tiếng Anh, phụ đề karaoke, tiếng máy, −14 LUFS) hoặc chỉ có nhạc, 16:9 hoặc 9:16, cùng trang HTML tương tác và tờ in PDF A4 hoặc Letter; tìm trong thư viện cộng đồng trước và ghi nguồn khi dùng lại.

“Giải thích cơ chế này bằng một cỗ máy isometric, làm video có lời đọc”
“Làm hình cỗ máy tương tác cho bài blog này và in một tờ poster A4”

Gói Pro

Cắt highlight video nói chuyện

Cắt một buổi nói chuyện dài (podcast, livestream) thành video highlight dưới 5 phút, bỏ từ thừa, khung dọc theo khuôn mặt; thêm kiểu collage giấy (người nói thành sticker, chữ bật theo lời) và video faceless từ kịch bản.

“Cắt video podcast này thành highlight 3 phút, khung dọc”
“Làm short 60 giây từ buổi livestream (file)”
“Làm video collage người nói trên nền giấy từ clip này”
“Làm video faceless collage từ kịch bản này”

Thiết lập đoàn phim

Mỗi phần việc chọn một dịch vụ. Không có gì tốn tiền nếu bạn không chọn: dịch vụ trả phí dùng key của bạn và bạn trả thẳng cho họ. Chạy reelcrew setup để được hỏi từng bước, hoặc nhờ agent.

Giọng đọc tiếng Việt	VieNeu: miễn phí, chạy ngay trên máy (cần cài VieNeu-TTS). ElevenLabs: tự nhiên nhất, trả phí. Soniox: rẻ hơn, trả phí. OpenRouter: một key cho giọng đọc của nhiều hãng (giọng Việt của Microsoft) và cả hình ảnh, trả phí theo ký tự.	elevenlabs.io · soniox.com · openrouter.ai
Phiên âm (lời thoại thành chữ)	ElevenLabs: dùng chung key với giọng đọc, có thời gian từng chữ. Soniox: tính theo phút, cũng có thời gian từng chữ.	elevenlabs.io · console.soniox.com
Hình ảnh	Codex: dùng gói ChatGPT của bạn qua Codex CLI, không cần key. Gemini: trả phí theo ảnh. OpenRouter: cùng key với giọng đọc, nhiều mẫu tạo ảnh, trả phí theo ảnh.	aistudio.google.com/apikey · openrouter.ai
Nhạc và tiếng động	ElevenLabs: tạo từ mô tả, trả phí. Tiếng động còn có bộ âm thanh mẫu miễn phí.	elevenlabs.io
Tách người, chuyển động	HyperFrames: miễn phí, tải một lần.

ElevenLabs: đã có tài khoản thì lấy key ở đây; chưa có thì đăng ký mới.

Key không bao giờ dán vào khung chat. Nhập trong cửa sổ Terminal (Mac hoặc Linux) hoặc PowerShell (Windows): reelcrew keys set elevenlabs, chữ gõ vào được ẩn. Key chỉ lưu trên máy bạn.

Làm và chỉnh video

Mỗi video nằm trong một thư mục dự án: kịch bản, giọng đọc, nhạc, ảnh và file MP4. Muốn đổi gì, nói với agent:

“Sửa câu thứ 3 thành …”, “câu 5 đọc sai tên riêng”, “đổi sang giọng nữ”: agent sửa kịch bản và đọc lại đúng những câu đó.
“Nhạc vui hơn”, “bỏ tiếng động ở giây 12”: agent làm lại nhạc hoặc phần trộn âm, không dựng lại cả video.
“Xuất bản nhẹ hơn để gửi Zalo”, “to tiếng hơn cho YouTube”, “làm thêm thumbnail khác”: agent xuất lại từ dự án cũ.

Muốn một thay đổi dùng cho mọi video sau (ví dụ màu kênh, thẻ kết thúc riêng), nhờ agent dùng reelcrew skill edit: bản sửa của bạn được giữ riêng và không mất khi cập nhật Reelcrew.

Tài khoản và máy

Reelcrew chạy trên máy đã đăng nhập tài khoản có gói Starter hoặc Pro: đăng nhập một lần bằng reelcrew login (xác nhận trên trình duyệt), các skill trong gói tự tải về.

Mỗi tài khoản dùng trên 1 máy, Mac hay Windows đều được. Mỗi chỗ máy đổi sang máy khác được 3 lần trong 30 ngày. Đăng nhập lại hay tạo key mới (Rotate) trên cùng máy, và máy cloud của Cloud Agent, không tính là đổi máy. Đổi máy: chạy reelcrew license deactivate ở máy cũ, hoặc nhả máy trên trang tài khoản, rồi đăng nhập ở máy mới.

Reelcrew tự cập nhật nền và dùng bản mới từ lần chạy sau. Cập nhật ngay: reelcrew update. Bản mới có vấn đề: reelcrew update --rollback.

Gỡ Reelcrew

Không cần đăng nhập để gỡ. Nhờ agent, hoặc tự chạy trong Terminal (Mac hoặc Linux) hay PowerShell (Windows):

reelcrew self uninstall: xem trước những gì sẽ gỡ (chương trình, các skill Reelcrew trong Claude Code và Codex, plugin Reelcrew Studio trong Claude). Thêm --yes để gỡ; thêm --all để xoá luôn API key, đăng nhập, thư viện và các gói. Skill riêng bạn tự lưu được giữ lại, trừ khi dùng --all.
Khởi động lại Claude Code, Claude Desktop hoặc Codex.
Máy đang dùng bản cũ mà lệnh trên báo cần đăng nhập: chạy reelcrew update trước (không cần đăng nhập), rồi gỡ lại.

Muốn dùng trên máy khác thay vì gỡ hẳn: chạy reelcrew license deactivate trước để nhả chỗ của máy này.

Lệnh reelcrew không chạy được nữa thì gỡ tay:

Mac: chương trình và dữ liệu	`rm -rf ~/.reelcrew`
Mac: dòng PATH	`xoá dòng có .reelcrew/bin trong ~/.zshrc (hoặc ~/.bash_profile)`
Linux: chương trình và dữ liệu	`rm -rf ~/.reelcrew`
Linux: dòng PATH và lối tắt	`xoá dòng có .reelcrew/bin (và dòng # reelcrew ngay trên) trong ~/.profile (hoặc ~/.bash_profile), ~/.bashrc, ~/.zprofile, ~/.zshrc; xoá ~/.local/bin/reelcrew và ~/.local/bin/rc nếu chúng trỏ tới ~/.reelcrew/bin/reelcrew`
Windows: chương trình và dữ liệu	`Remove-Item -Recurse -Force $env:USERPROFILE\.reelcrew`
Windows: PATH	`gỡ %USERPROFILE%\.reelcrew\bin khỏi biến Path của user (Settings › Environment Variables)`
Skill Reelcrew trong Claude Code và Codex	`xoá các thư mục reelcrew-* và reelcrew trong ~/.claude/skills (Claude Code) và ~/.agents/skills (Codex)`
Plugin Reelcrew Studio	`claude plugin uninstall reelcrew@reelcrew-local, rồi claude plugin marketplace remove reelcrew-local`

Khi gặp lỗi

reelcrew doctor báo ✗ ở một mục	Dòng đó ghi luôn lệnh để thêm phần còn thiếu. Hoặc chạy reelcrew setup để được hỏi từng bước.
Key bị từ chối hoặc chưa có key	Chạy reelcrew keys set <tên> trong Terminal/PowerShell và dán lại key. reelcrew keys test kiểm tra tất cả key.
Không thấy skill trong Claude Code hoặc Codex	Khởi động lại agent (Claude Code hoặc Codex). Vẫn không thấy: chạy reelcrew setup rồi khởi động lại lần nữa.
Skill trả phí báo chưa có bản quyền	reelcrew whoami xem máy đã đăng nhập đúng tài khoản chưa, rồi reelcrew license sync.
Máy báo không tìm thấy lệnh reelcrew	Mở một cửa sổ Terminal/PowerShell mới sau khi cài. Vẫn không được: chạy lại lệnh cài.
Bản mới có lỗi	reelcrew update --rollback quay về bản trước ngay lập tức.
Không rõ lỗi gì	Dán nguyên thông báo lỗi cho agent: lỗi của Reelcrew luôn có mã và gợi ý cách sửa.

Các lệnh hay dùng

Bạn hiếm khi cần gõ lệnh: agent chạy thay bạn. Các lệnh dưới đây chạy trong Terminal (Mac hoặc Linux) hoặc PowerShell (Windows); rc là tên ngắn của reelcrew.

`reelcrew setup`	Chuẩn bị máy: cài skill, tải công cụ, hỏi bạn chọn giọng đọc, ảnh, nhạc
`reelcrew doctor`	Kiểm tra máy còn thiếu gì
`reelcrew keys set <tên>`	Nhập API key (gõ ẩn): elevenlabs, soniox, gemini, openrouter…
`reelcrew login`	Đăng nhập máy vào tài khoản; các gói đã mua tự tải về
`reelcrew whoami`	Máy đang đăng nhập tài khoản nào, có những gói nào
`reelcrew ls`	Danh sách skill trên máy
`reelcrew check <video>`	Kiểm tra video trước khi đăng: hình đen, đứng hình, âm lượng, khoảng lặng, kích thước
`reelcrew studio claude-plugin`	Tạo plugin Reelcrew cho Claude: Reelcrew Studio (xem video, ghim góp ý) hiện ngay trong Claude Desktop; in lệnh cài plugin
`reelcrew update`	Cập nhật Reelcrew và các gói; --rollback để quay lại
`reelcrew license deactivate`	Nhả chỗ của máy này để dùng trên máy khác
`reelcrew self uninstall`	Gỡ Reelcrew khỏi máy, không cần đăng nhập (xem trước, thêm --yes để gỡ; xem mục Gỡ Reelcrew)