教程2026/07/17
如何在 Codex 桌面应用中导入自定义主题
一份带版本意识的清单:导入原生 Codex 主题、检查可读性,以及恢复之前的外观。

快速回答
打开 Codex 设置,进入“外观”,使用自定义主题导入控件,粘贴完整的 codex-theme-v1: 分享字符串,检查预览,然后应用。控件的确切名称可能因应用版本而异。
这些步骤于 2026 年 7 月 17 日在 macOS 上用 Codex App 26.707.72221 完成核验。
导入之前
确认你要导入的是原生主题,而不是外部 Skin 安装器。原生主题字符串是纯外观数据,它不应要求你运行 shell 命令、开启调试端口或下载可执行文件。
查看主题页上的来源、核验日期、已测试平台和 Codex 版本。记下你当前使用的内置主题名称,留好一个简单的回退点。
导入并验证
- 在主题目录中打开一个已发布的主题页。
- 在主题页使用复制主题按钮复制分享字符串。
- 在 Codex 中打开 Settings > Appearance(设置 > 外观)。
- 把完整的分享字符串粘贴到导入输入框。
- 不要删改前缀或 JSON 负载。
- 应用前检查浅色或深色变体。
应用之后,检查标题、正文、弱化标签、按钮、选中态、diff 新增、diff 删除、技能和围栏代码块。重启应用,确认主题被保留。
常见失败
字符串无效的错误通常意味着前缀或 JSON 被改动过。变体不匹配意味着分享字符串与当前浅色/深色导入目标不一致。代码主题不匹配意味着所引用的高亮系列在该应用版本中不可用。剪贴板失败时,可以选中返回的字符串手动复制来绕过。
如果结果无法阅读,立即选择一套内置 Codex 主题。原生外观改动不需要任何外部清理脚本。更多故障排查请阅读如何重置或移除主题。