返回首页

安装指南

如何安装 Codex 皮肤和桌面宠物——免费，无需注册。

最近更新: 2026-07-31

安装 Codex 皮肤

第 1 步：安装 Dream Skin

Dream Skin 是一个免费的开源工具，用于给 Codex 桌面端应用主题。

从 GitHub Releases 下载最新版本：

  • macOS — 下载 .dmg，打开后拖入应用程序文件夹
  • Windows — 下载 .exe 安装包，运行即可

安装完成后，macOS 菜单栏或 Windows 系统托盘会出现 Dream Skin 图标。

第一次使用？ 请确保已安装并打开过一次官方 Codex 桌面应用。

开发者安装（从源码）

克隆 仓库，然后：

  • macOS： 打开 macos/，双击 Install Codex Dream Skin.command
  • Windows： 运行 powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1

第 2 步：挑选主题

浏览 皮肤画廊，选择你喜欢的主题。

第 3 步：应用主题

方式 A — 一键换肤（推荐）

在皮肤详情页点击 「一键换肤」 按钮，Dream Skin 会自动打开并应用该主题。

需要 Dream Skin v1.5.5 或更高版本。应用会弹出确认对话框，验证主题完整性（SHA-256）后再应用。

方式 B — 导入主题 ZIP

  1. 在皮肤详情页点击 「下载 ZIP」
  2. 打开 Dream Skin（菜单栏 / 系统托盘）
  3. 点击 「导入主题…」 并选择下载的 ZIP 文件
  4. 主题会出现在 「已保存的主题」 列表中
  5. 选择该主题并点击 「应用」

注意：导入 ZIP 只会将主题加入你的主题库，不会自动替换当前主题。你需要手动选择并应用。

恢复原始外观

打开 Dream Skin 菜单，点击 「恢复」 即可随时回到默认 Codex 外观。

安全说明

  • Dream Skin 使用 Chrome DevTools Protocol (CDP)，仅绑定 127.0.0.1——无网络暴露
  • 不修改 .app、app.asar 或代码签名
  • 不改变 API Key 或模型供应商设置
  • 主题 ZIP 上限 32 MiB，CSS 经过安全验证，所有文件均经 SHA-256 校验
  • Codex 更新后，请先恢复再验证

安装 Codex 宠物

第 1 步：复制安装命令

在任意宠物详情页都可以找到现成的安装命令。或者使用以下模板：

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- <pet-id>

Windows (PowerShell)：

powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -UseB https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.ps1 | iex; Install-CodexPet <pet-id>"

将 <pet-id> 替换为宠物 ID，例如 firefly--lingxiaotian。

第 2 步：运行命令

打开终端（Windows 用 PowerShell），粘贴命令，按回车。

脚本会下载两个文件到 ~/.codex/pets/<pet-id>/（Windows 为 %USERPROFILE%\.codex\pets\<pet-id>\）：

  • pet.json — 元数据
  • spritesheet.webp — 动画帧

仅此而已。不会修改 Codex 应用、你的配置或任何其他文件。

第 3 步：激活宠物

  1. 完全退出并重新打开 Codex 桌面应用
  2. 进入 Settings → Pets
  3. 找到刚才安装的宠物
  4. 选择并启用

安装命令只是把文件放到磁盘上。Codex 通过扫描 pets 目录来发现新宠物，所以需要重启。

多只宠物共存

你可以安装任意数量的宠物——每只都有独立的文件夹。安装新宠物 不会 删除已有的宠物。在 Settings → Pets 中随时切换。

移除宠物

删除该宠物对应的文件夹：

  • macOS/Linux： rm -rf ~/.codex/pets/<pet-id>/
  • Windows： Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\pets\<pet-id>"

然后重启 Codex。不要 删除整个 ~/.codex/pets/ 目录——那会移除你所有的宠物。

隐私说明

安装脚本在成功安装后会发送一次匿名安装计数请求到宠物注册表。不收集任何个人数据。如需关闭：

AWESOME_CODEX_PET_NO_STATS=1 curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- <pet-id>

v1 与 v2 的区别

  • v1 — 标准动画集（待机、行走、挥手）
  • v2 — 扩展动画集，包含更多状态和更流畅的过渡

两个版本安装和激活方式完全相同，v2 只是动画帧更多。