哈喽,大家好,我是阿星👋🏻。
最近我给官方 Codex 做了几套皮肤,效果就像 QQ 皮肤:
不改变功能,只改变界面。
如果你和我一样是胡彦斌的粉丝,就可以直接换成胡彦斌主题👌




目前项目
已经开源:
https://github.com/seeyouintokyo/codexskin
workbuddy的员工还闲着干啥,赶紧去做皮肤呀,我都愿意买!!!


codexskin 为官方 Codex Desktop 加载可切换皮肤。它不会安装另一套 Codex,也不会修改、复制或重新打包官方 APP。
当前支持 macOS,包含深海蓝、玫瑰粉和奶油淡黄三套主题。
(一开始我们只改了颜色,结果只是底色变了。后来补上页面识别、图片加载和自动重新应用,完整主题才稳定显示)
效果:



工作原理
其实这个项目主要就是对CDP的应用,所谓CDP全称ChromeDevToolsProtocol(Chrome开发者工具协议)。它是一套让代码远程操控Chrome的低层协议——Playwright、Puppeteer这些测试工具底层都靠它。原理如下⬇️
- 1.查找 Bundle ID 为 com.openai.codex 的官方应用。
- 2.校验应用、Team ID、代码签名和内置 Node.js。
- 3.直接启动官方可执行文件,并将 CDP 绑定到 127.0.0.1。
- 4.确认监听端口属于 Codex 进程,只接受 app:// Codex Shell 目标。
- 5.注入主题,并在页面重载、路由变化和 DOM 重建后重新同步。
恢复脚本会停止注入器,并清理样式节点、主题变量、首页标记和装饰层。官方应用文件始终不被修改。
安装与启动
# 安装皮肤脚本,并在桌面创建 4 个 .command 快捷方式
./scripts/install-macos-skin.sh
# 重新打开官方 Codex 主 APP,并加载当前主题
~/.codex/codex-deep-terminal/scripts/start-macos-skin.sh --restart-existing
# 检查当前皮肤是否正常
~/.codex/codex-deep-terminal/scripts/verify-macos-skin.sh
第一次开启皮肤时,也可以双击桌面的 Codex Deep Terminal.command。它只是脚本快捷方式,会重新打开官方 Codex 主 APP 并加载皮肤。
主题选择
双击桌面的 Codex Deep Terminal - Theme.command,或执行:
# 切换为深海蓝
~/.codex/codex-deep-terminal/scripts/switch-theme-macos.sh blue
# 切换为玫瑰粉
~/.codex/codex-deep-terminal/scripts/switch-theme-macos.sh pink
# 切换为奶油淡黄
~/.codex/codex-deep-terminal/scripts/switch-theme-macos.sh yellow
恢复官方界面
双击桌面的 Codex Deep Terminal - Restore.command,或执行:
# 停止注入器,并移除当前会话中的全部皮肤内容
~/.codex/codex-deep-terminal/scripts/restore-macos-skin.sh
项目结构
scripts/ 安装、启动、注入、验证与恢复
skin/ 公共 CSS、Hero 图片与主题清单
tests/ 安全边界和运行时契约
themes/ Codex 官方主题分享字符串
index.html 和 styles.css 提供匿名效果预览,不参与 Codex 运行时注入。
测试
# 运行运行时契约和安全边界测试
node --test tests/runtime.test.mjs
# 校验 Codex 官方主题分享字符串
node scripts/validate-themes.mjs themes/deep-terminal-dark.txt themes/deep-terminal-light.txt
总结起来一张图就是👇

以上就是 codexskin 的安装、切换和恢复方法。
你也可以按照这个原理写一个哦,很简单,把这篇文章发给codex即可。
我是阿星
更多AI应用
我们下期再见👋🏻