Code Bestie Docs

Appearance

国内网络环境安装 Codex 与 HyperFrames ​

这篇文档适合国内网络环境不稳定、GitHub 或 npm 安装经常超时的用户。我们把安装脚本、HyperFrames starter kit 和校验文件放在 Gitee，优先用国内可访问链路完成准备工作。

WARNING

Codex 官方桌面安装包体积较大，第一阶段暂不放入 Gitee。本文会提供官方入口；如果后续 Gitee 附件容量允许，再补充 .dmg、.exe 或官方实际提供的安装包格式。

一、准备工作 ​

请先确认本机已经安装：

  • Node.js LTS 或更高版本
  • npm
  • macOS / Linux / WSL 需要 curl、unzip
  • Windows 需要 PowerShell 5 或更高版本

如果还没有 Node.js，请先看 Node.js 环境安装指南。

二、使用 Gitee 国内安装脚本 ​

macOS / Linux / WSL 执行：

bash
curl -fsSL https://gitee.com/baiyeye/codebestie-install-kit/raw/main/scripts/install-cn.sh | bash

Windows PowerShell 执行：

powershell
irm https://gitee.com/baiyeye/codebestie-install-kit/raw/main/scripts/install-cn.ps1 | iex

脚本会做这些事：

  1. 从 Gitee 读取资源清单。
  2. 下载 HyperFrames starter kit。
  3. 校验 SHA256。
  4. 解压到用户目录下的 .codebestie/hyperframes-kit。
  5. 把 npm registry 设置为 https://registry.npmmirror.com。
  6. 输出下一步操作命令。

TIP

脚本不会读取、保存或上传你的 Code Bestie API Key。API Key 仍然按 Codex 快速开始指南 写入本机 Codex 配置。

三、安装 Codex ​

如果你能访问官方页面，优先使用官方安装入口：

如果只使用 Codex CLI，也可以用 npm 国内镜像安装：

bash
npm config set registry https://registry.npmmirror.com
npm install -g @openai/codex@latest

验证：

bash
codex --version

四、进入 HyperFrames starter kit ​

安装脚本完成后，macOS / Linux / WSL 通常进入：

bash
cd ~/.codebestie/hyperframes-kit/codebestie-hyperframes-starter

Windows PowerShell 通常进入：

powershell
cd "$HOME\.codebestie\hyperframes-kit\codebestie-hyperframes-starter"

安装依赖并检查环境：

bash
npm install
npx hyperframes doctor
npx hyperframes lint

打开预览：

bash
npx hyperframes preview

渲染视频：

bash
npx hyperframes render --output codebestie-demo.mp4

五、用 Codex 修改视频 ​

进入 starter kit 目录后运行：

bash
codex

可以把下面这段提示词发给 Codex：

text
请使用这个 HyperFrames 项目，制作一个 10 秒的 Code Bestie 产品介绍视频。

要求：
1. 保持 16:9 画幅。
2. 用 HTML/CSS/JS 和 GSAP 动画完成，不要生成 SVG 插画。
3. 展示 4 个步骤：创建 API Key、配置 Codex、安装 HyperFrames、渲染视频。
4. 所有带 data-start 或 data-duration 的元素都要加 class="clip"。
5. 完成后运行 npx hyperframes lint 和 npx hyperframes snapshot。

更多视频工作流请继续看 Codex 接入 HyperFrames 教程。

六、校验下载资源 ​

Gitee 仓库地址：

text
https://gitee.com/baiyeye/codebestie-install-kit

资源清单：

text
https://gitee.com/baiyeye/codebestie-install-kit/raw/main/manifests/assets.json

SHA256 清单：

text
https://gitee.com/baiyeye/codebestie-install-kit/raw/main/manifests/sha256sums.txt

如果脚本提示 SHA256 校验失败，请不要继续解压或运行下载到的文件，重新执行脚本或联系客服。

常见问题 ​

Gitee 链接打不开 ​

请确认仓库是否公开。如果页面提示登录或没有权限，说明仓库还没有切换为公开状态。

npm install 仍然很慢 ​

先确认 npm registry：

bash
npm config get registry

如果不是 https://registry.npmmirror.com，重新执行：

bash
npm config set registry https://registry.npmmirror.com

Codex 安装包为什么没有放在 Gitee ​

Codex app 安装包可能超过 Gitee 普通 Release 附件限制。我们先把脚本、模板和 HyperFrames 资源放到 Gitee，Codex 安装包后续确认体积后再决定是否镜像。

Code Bestie 使用文档

Copyright © 2026 Code Bestie