Codex CLI 越狱

Codex CLI 允许用户通过修改配置文件 config.toml 中的 model_instructions_file 字段，加载自定义的 Markdown 文件作为模型的初始系统指令（System Prompt）。这一机制旨在为开发者提供更高的灵活性，使其能够根据特定项目需求调整模型的行为模式、输出格式或工具调用逻辑。

技术原理

在 Codex CLI 的 Rust 源码（profile_toml.rs）中，model_instructions_file 被定义为 Option<AbsolutePathBuf> 类型。其工作逻辑如下：

• 替换机制：当该字段被设置时，CLI 会读取指定路径的文件内容，并直接替换模型默认的内置基础指令（base_instructions/default.md），而非进行追加。
• 优先级：自定义文件的优先级高于默认配置，模型将从启动伊始即遵循该文件中定义的框架运行。

与 AGENTS.md 的区别

配置步骤

1. 创建指令文件：
   在本地创建一个用于存放自定义指令的目录及文件。

   mkdir -p ~/.codex/prompts
   # 编辑你的自定义指令文件，例如 codex-custom.md
   

2. 修改配置文件：
   在 ~/.codex/config.toml 中添加或修改以下字段：

   model = "gpt-5.5"
   model_instructions_file = "/home/yourname/.codex/prompts/codex-custom.md"
   

3. 启动应用：
   运行 codex 命令，CLI 将加载新的配置并应用自定义指令。

注意事项

• 指令完整性：由于是替换操作，自定义文件中需要包含模型正常运行所需的所有基础约束和格式要求，否则可能导致模型行为异常。
• 安全性考量：修改底层系统指令可能会影响模型的安全对齐表现。建议仅在受控的开发环境中使用，并充分测试自定义指令对模型输出的影响。
• 路径准确性：确保 model_instructions_file 指向的是绝对路径，且当前用户具有读取该文件的权限。

通过合理利用 model_instructions_file，开发者可以构建更符合特定工作流需求的 Codex 交互环境，提升 AI 辅助编程的效率与精准度。