本机环境

MkBoard环境安装

按官方入口安装本地 Agent、Node.js、FFmpeg 和 HyperFrames，让 MkBoard 桌面端可以完成分镜和本机视频草稿工作。

下载桌面端

简介

MkBoard 的本机环境主要分成两部分：

  • 本地 Agent：Codex CLI 和 Claude Code 二选一，用来读取当前脚本、分镜表和项目素材。
  • 视频渲染：基于 HyperFrames，本机需要 Node.js 22+ 和 FFmpeg。

MkBoard 不保存 Codex、Claude Code 或 HyperFrames 的账号凭据，只复用你本机已经完成的 CLI 登录态。安装和使用说明见下文。

官方来源

工具官方地址MkBoard 用途
Codex CLIOpenAI Codex CLI / openai/codex GitHub本地 Agent
Claude CodeClaude Code 安装 / Claude Code 认证本地 Agent
Node.jsNode.js 下载HyperFrames 运行环境
FFmpegFFmpeg Download / Homebrew ffmpegHyperFrames 视频编码
HyperFramesHyperFrames Quickstart / heygen-com/hyperframes GitHubHTML 视频渲染

安装方式

下面只保留官方入口和 MkBoard 的验证方式。具体安装步骤请以官方文档为准。

Codex CLI

Codex CLI 可以作为 MkBoard 的本地 Agent。安装和登录请参考 OpenAI Codex CLI 和 openai/codex GitHub。

codex login status

MkBoard 会用 codex login status 判断本机 Codex 登录状态。如果浏览器登录失败，可按官方说明使用 device auth。

Claude Code

Claude Code 也可以作为 MkBoard 的本地 Agent。安装和认证请参考 Claude Code 安装 和 Claude Code 认证。

claude auth status --json

MkBoard 会用 claude auth status --json 判断本机 Claude Code 登录状态。登录后建议重新打开终端，再回到 MkBoard 点击“重新扫描”。

Node.js 22+

HyperFrames 需要 Node.js 22 或更高版本。安装请参考 Node.js 下载。

node --version

如果低于 v22，请升级后重新打开终端。

FFmpeg

FFmpeg 必须能在系统终端直接执行。安装请参考 FFmpeg Download，macOS 使用 Homebrew 时也可以参考 Homebrew ffmpeg 公式页。

ffmpeg -version

如果 MkBoard 仍然显示未找到 FFmpeg，重启 MkBoard 后再点“重新扫描”。

HyperFrames CLI

HyperFrames 用于本机渲染 HTML 视频项目。安装和使用请参考 HyperFrames Quickstart 和 heygen-com/hyperframes GitHub。

MkBoard 会优先使用本机 hyperframes 命令；如果没有全局安装，会通过官方建议的 npx 方式拉取并运行 HyperFrames。

npx hyperframes doctor

只检测到 npx 不代表渲染环境完整，Node.js 和 FFmpeg 也需要通过。

遇到问题

如果安装或检测遇到问题，可以加入飞书交流群。我们会在群里更新最新安装说明和常见处理方式。

MkBoard 飞书交流群二维码