跳转到主要内容
全部文章
教程2026/07/17

如何创建自定义 Codex 主题

在不牺牲可读性的前提下,为界面底色、文字色、强调色、语义色、字体和代码高亮设计一套协调的 Codex 配色。

五个协调的色块组成一套主题系统

快速回答

从内置的浅色或深色外观出发,然后一次定义一个角色:界面底色、前景文字色、强调色、对比度、代码主题、界面字体、代码字体和语义色。分享前预览每一种状态。

Codex App 官方文档记录了基础主题、强调色、背景、前景、界面字体、代码字体和分享等控制项。本流程已在 macOS 的版本 26.707.72221 上完成核验。

构建基于角色的配色

不要先挑五个好看的颜色再随意分配,要从角色开始。

  • 界面底色是主画布。
  • 文字色是主要前景。
  • 强调色标识操作和选中状态。
  • diff 新增和 diff 删除需要可区分的语义含义。
  • 技能色应当易于辨认,但不与主强调色竞争。

在你的视觉研究中可以为面板使用第二个相近的底色,但请记住:原生分享负载只存储主底色,许多界面状态由对比度派生。

导出前先测试

检查长段落、细小的元信息、禁用控件、键盘焦点、代码块、行内代码、新增、删除和选中行。既要测试繁忙的任务界面,也要测试空白的首页。一套在五条色带里看起来很优雅的配色,当弱化文本落在派生的面板色上时,仍可能翻车。

记录主题名称、支持的变体、Codex 版本、平台、创建日期、来源和许可证。保留一套已知可用的内置主题作为恢复路径。

主题稳定后,通过 Codex 导出,而不是手工拼凑一种没有文档的格式。发布前,请阅读如何安全地分享主题、安全政策和许可说明。