快速开始
安装 Codex Skin 插件，核对 Paid Alpha 版本，再用真实六位 ID 应用第一套 Codex 主题
这份快速开始只追求一个结果：你请求的主题已经在当前 Codex 窗口完成可见验证。整个过程包括安装插件、核对已加载版本、复制已发布主题的 ID，以及执行一次主题应用事务。
开始前准备
你需要：
- 一台受支持的 macOS 或 Windows 电脑，并且已经可以打开 ChatGPT 桌面应用中的 Codex 界面
- 可以运行
codex plugin命令的终端 - 从主题图库或主题详情页复制的真实六位主题 ID
不要猜测主题 ID。这个编号会让图库、下载的主题包和最终验证指向同一套已发布主题。Free 与 Pro 都使用六位 ID。
匿名用户可以浏览图库，但 Free 和 Pro 主题包都需要经过授权的插件设备才能下载。第一次执行受保护操作时，系统可能会打开浏览器，让你登录并批准当前电脑。
安装插件
在终端中依次运行下面三条公开安装命令：
codex plugin marketplace add yuanjohn01-byte/codex-skin-plugin --ref main
codex plugin add codex-skin@codex-skin
codex plugin list --json第一条命令加入 Git-backed Marketplace 来源，第二条从该来源安装插件，最后一条核对结果。JSON 中应该恰好有一个 codex-skin@codex-skin 条目，并包含：
{
"installed": true,
"enabled": true
}Paid Alpha Helper 尚未采用商业 Apple Developer ID/notarization 或公开 Windows 代码签名，因此首次运行时可能看到 Gatekeeper 或 SmartScreen 提示。请保持系统保护开启，只使用固定 Bootstrap 选择的发布版本，不要执行来源不明的关闭保护命令。
不需要填写 Marketplace 表单、编辑 Codex 配置或删除缓存目录。如果命令失败，请保留原始报错，按照插件安装失败中的可逆步骤处理。
核对已加载版本
插件列表显示安装成功，不代表当前 Codex 任务已经加载了新 Skill。请完全退出 Codex，重新打开并新建任务，然后运行：
$codex-skin-version当前 Production Paid Alpha 应该显示：
- 插件版本
0.1.0-paid-alpha - Helper
.17与 Bootstrap.16 - Production origin
https://codexskin.ai - 发布渠道为 Production Paid Alpha GitHub prerelease，并非 stable/latest
插件详情里的旧版本副标题不能单独证明升级失败，应该以新任务中的 version Skill 为准。
复制真实六位主题 ID
打开主题图库，进入一套已经发布的主题并复制六位 ID。例如，Ember Dune 是一套已发布的 Free 主题，ID 为 100002，详情页是 /themes/100002。
Free 或 Pro 标签说明访问层级，不会改变 ID 格式，也不会改变主题包的校验流程。
在 Codex 任务中应用主题
在刚刚打开的新任务中，用正常语言给出准确 ID：
Codex Skin，请应用主题 100002不需要自己拼 Helper 命令，也不要提供下载链接或 CSS。插件会提取六位 ID，并调用固定的平台 wrapper。
一般应用或切换需要 20–60 秒。在 Codex 明确显示成功或失败前，不要在当前 Codex 窗口中点击、输入、导航或关闭窗口。如果操作自动打开了浏览器授权页或 Pricing 页面，可以在那个浏览器页面操作。不要再次提交 Apply 请求。
如果打开了浏览器授权页
在 Codex Skin 页面登录并批准页面中显示的当前电脑，然后回到同一个 Codex 任务。原事务会继续使用原来的主题 ID，不需要重新应用。
如果页面提示设备数量已满、授权被取消或请求过期，请进入故障排查查看对应步骤，不要改本地文件。
如果 Codex 请求确认一次重启
某些操作需要让 Codex 使用同一个 profile 关闭并重新打开一次。Codex Skin 会先让你明确回答 yes 或 no。回答 yes 只是同意经过验证的 Helper 继续当前事务，不代表主题已经应用成功。
Codex 重新打开后，新建或恢复一个任务并查看本地状态。如果 restart status 仍是 running，短暂等待后再次查看，最长不要超过 60 秒。只有 completed 且应用的 ID 与版本和本次请求一致，才能算成功。
确认当前窗口的可见结果
只有准确主题在当前 Codex renderer 完成可见验证，Apply 才算结束。下面这些中间状态都不够：
- 主题包已成为 desired 或已经下载
- 浏览器授权完成
- 已同意重启
- 命令仍在运行
- 之前某次 Apply 曾经成功
不需要重启时，成功结果会同时包含 ok: true、请求的 themePublicId、themeVersion 和 operationId。经过重启的路径则必须显示 restartStatus: completed，并且 ID 与版本一致。
Helper 会在有限事务结束后退出。完全关闭 Codex、重启电脑或之后发生 renderer reload，都会结束本次可见保证。下一次请通过 Codex Skin 重新应用，Paid Alpha 不会在后台自动修复或重复应用。
接下来可以做什么
常见问题
需要自己安装 Node 或 Go 吗？
不需要。面向用户的发布版本使用自包含 Helper，固定 wrapper 与 Bootstrap 会在需要时管理已经验证的外部副本。Node 和 Go 是公开仓库的开发工具，不是应用主题的前提。
完全关闭 Codex 后需要重新应用吗？
需要。完全退出 Codex、重启电脑或之后的 renderer reload 会结束可见保证。重新打开后，请再次让插件应用主题。最后一次验证记录可以帮助确认之前使用过哪一套主题，但它不能证明新 renderer 仍然保持该外观。