CodexThemes
提交

使用文档

从创建、提交到搜索、安装、切换、恢复——agent 驱动的流程覆盖主题的完整生命周期。复制提示词发给你的 AI agent，它会通过 SKILL.md 里的官方 CodexThemes Skill 完成剩下的一切。

创建主题

用 codex-theme-creator Skill，把一张参考图或一段文字描述变成完整的 Codex 桌面主题。

  1. 打开你的 AI agent（Claude Code、Codex CLI，或任何能读取 URL 并执行命令的 agent）。
  2. 复制下方提示词，附上参考图，或把方括号里的描述换成你想要的氛围、配色和主题。
  3. agent 会从 SKILL.md 安装 codex-theme-creator，在 ~/.codexthemes/themes/<theme-id>/ 下生成主题源文件和预览图。
  4. 查看预览图。应用主题或重启 Codex 之前，agent 一定会先征求你的同意。
  5. 可分享的主题包会导出到 ~/.codexthemes/exports/<theme-id>.codex-theme，随时可以提交。
粘贴给你的 agent
Use $codex-theme-creator from https://codexthemes.ai/SKILL.md to create a Codex desktop theme from my attached reference image or this brief: [describe the mood, colors, and subject].

提交主题

用 codex-theme-submitter 把你导出的主题发布到 CodexThemes 主题库。

  1. 先在 codexthemes.ai/settings/apikeys 创建 API 密钥——agent 提交必须携带密钥。
  2. 把主题导出为 .codex-theme 包（创建 Skill 会自动完成）。
  3. 复制下方提示词。agent 会先 dry run 校验主题包，再通过 API 提交。
  4. 主题即刻发布，agent 会告诉你详情页链接。重复提交同一主题会原地更新。
粘贴给你的 agent
Use $codex-theme-submitter from https://codexthemes.ai/SKILL.md to submit my theme to codexthemes.ai.

更喜欢表单？也可以在 codexthemes.ai/submit 手动上传主题包。

搜索主题

用 codex-theme-finder Skill，按风格、题材、氛围搜索已发布的主题库。

  1. 复制下方提示词，把方括号里的关键词换成你想找的风格。
  2. agent 会调用主题库 API，展示最多 5 个候选，附预览图和详情页链接。
  3. 选一个——可安装的主题会交给安装器处理；纯展示的皮肤可以用创建 Skill 复刻。
粘贴给你的 agent
Use $codex-theme-finder from https://codexthemes.ai/SKILL.md to search codexthemes.ai for [style, subject, mood].

安装主题

用 codex-theme-installer 安装主题库里的任意 .codex-theme 包，再用 codex-theme-switcher 应用它。

  1. 记下主题 id——每个主题详情页都有（例如 shaolin-football）。
  2. 复制下方提示词，填入主题 id。
  3. agent 会下载主题包并解压到 ~/.codexthemes/themes/<theme-id>/。
  4. 切换器随即应用主题——能热切换就热切换，需要重启 Codex 时一定先问你。
粘贴给你的 agent
Use $codex-theme-installer from https://codexthemes.ai/SKILL.md to install the theme "[theme id]" from codexthemes.ai, then use $codex-theme-switcher to apply it.

以 .zip 压缩包发布的主题无法由 agent 安装——请登录后在主题详情页下载，手动安装。

切换主题

用 codex-theme-switcher Skill 应用、切换或重新应用任何已安装到本地的主题。

  1. 复制下方提示词，填入主题 id——切换器会列出 ~/.codexthemes/themes/ 下已安装的全部主题。
  2. Codex 开启调试端口时直接热切换；否则会先征得你的同意再重启 Codex。
  3. 它会用 status 命令对照真实 DOM 校验结果——主题真正生效之前，agent 不会说“完成”。
粘贴给你的 agent
Use $codex-theme-switcher from https://codexthemes.ai/SKILL.md to switch my Codex theme to [theme id], or to apply the theme I just created or installed.

恢复原生外观

主题只是会话级样式注入，不修改任何应用文件，所以恢复永远只需一步。三种方式，从快到稳。

  1. 最快、不用 agent：完全退出 Codex（Cmd+Q，不是关窗口）再打开，干净重启后必然是原生外观。
  2. 用 agent、不用重启：复制下方提示词——它会立即从所有打开的页面移除注入的样式和标记。
  3. 或者直接换主题：应用另一个主题 id 会直接热切换，无需先恢复。
粘贴给你的 agent
Use $codex-theme-switcher from https://codexthemes.ai/SKILL.md to restore my native Codex look.

如果恢复后旧主题又自己回来了，是残留会话在重复注入——让 agent 强制干净重启，或完全退出 Codex 再打开。