这份源码是一套跑在命令行下的 Codex CLI 配置文件部署脚本，思路是借助 Codex 官方支持的 model_instructions_file 配置项，把一份自定义指令文件自动挂到本地 .codex 配置里。仓库本身已声明后续完整版迁移到了 Codex-X 项目，这里保留的是早期 CLI 简洁版。
源码简介
Codex-5.5-codex-instruct-5.5 是一个单文件 Python 脚本，用于把自定义指令文件部署到 Codex CLI 的本地配置目录，并通过修改 config.toml 的 model_instructions_file 项让 Codex 在启动时加载这份指令。脚本支持自动扫描多平台 Codex 安装目录、部署前备份配置、预览模式等。仓库自带一份示例指令文件和交流群二维码，采用 MIT 协议开源。
适用场景
- 研究 Codex CLI 如何通过 model_instructions_file 加载自定义系统指令
- 本地搭建配置自动化部署脚本的参考实现
- 学习跨平台目录扫描、配置备份与 TOML 注入的基础写法
技术栈与运行环境
Python 3.8+（README 标注），纯标准库实现，无第三方依赖（os / sys / shutil / argparse / pathlib / datetime）。支持 Windows、macOS、Linux。需要本机已安装 Codex CLI 且存在 .codex/config.toml。无需 pip 安装任何包。
功能亮点
- 跨平台自动扫描 Codex 目录：覆盖 Windows（USERPROFILE、LOCALAPPDATA\OpenAI\Codex、C/D/E 盘 Users 目录）、macOS/Linux（HOME、/home、/root）下含 config.toml 的 .codex 目录
- 一键部署指令文件：将 MD 指令写入 .codex 根目录，并在 config.toml 中写入或更新 model_instructions_file = “./xxx.md”
- 部署前自动备份：每次修改前按时间戳备份 config.toml（.toml.bak_YYYYMMDD_HHMMSS），便于回滚
- 灵活命令行参数：支持外部指令文件（–file）、自定义文件名（–name）、预览模式（–dry-run）、手动指定目录（–codex-dir）
- 内置示例指令：仓库 examples/ 目录提供独立指令文件副本，脚本也内置同一份内容
安装与部署提示
本工具为本地脚本，无需安装依赖。运行前请确认本机已安装 Codex CLI 且存在 .codex/config.toml。基础用法：执行 python codex-instruct.py 进行自动部署；加上 --dry-run 先预览将要修改的内容而不落地。撤销部署：删除 config.toml 里的 model_instructions_file 行、删除 .codex 下生成的 md 文件、重启 Codex 即可。注意：脚本会直接改写本地配置文件，建议在虚拟环境或测试机上操作。
截图与演示说明
– codex-instruct.py：主脚本，运行后终端会依次输出扫描到的 Codex 目录、配置备份文件名、写入的 MD 路径与 model_instructions_file 配置结果 – config.toml 部署前后对比：可观察 model = 行下方新增的 model_instructions_file 项 – examples/gpt5.5-unrestricted.md：随仓库提供的指令文件示例 – assets/ 目录：含多张交流群二维码图片（ai-tech-group-*.png）
常见问题
- 运行需要安装什么依赖？ 仅需 Python 3.8 及以上，脚本全部使用标准库，不需要 pip 安装任何第三方包。
- 怎么恢复到修改前的状态？ 删除 config.toml 中 model_instructions_file 这一行，并删除 .codex 目录下脚本生成的 md 文件，重启 Codex 即可还原；脚本部署前已自动备份 config.toml，也可直接用备份文件覆盖回滚。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
补充说明：本仓库属于利用官方配置机制注入自定义指令的参考工具，其内置及示例指令内容为无限制模式提示词，仅建议用于本地研究配置加载机制、了解 Codex CLI 指令注入原理。大规模或违规使用可能违反模型服务方（OpenAI/Codex）的使用条款，请务必在合法授权与个人测试范围内使用，风险自负。脚本仅修改本机配置文件，不涉及网络劫持或二进制篡改（据 README 声明）。
下载说明
本源码包为 GitHub 公开仓库快照（MIT 协议）。项目开源地址：https://github.com/yynxxxxx/Codex-5.5-codex-instruct-5.5 。下载后请先阅读 README.md 与 examples/ 目录了解结构。
