安全可控的 Codex 指令文件安装助手：告别手动修改，一键配置本地 AI 行为规则

你是否曾想让 Codex CLI 更“懂你”——比如默认用中文回答、严格遵循 Markdown 格式、或自动添加版权说明？但又担心直接编辑配置文件出错、覆盖原始设置，甚至误触敏感路径？codex-keysmith 正是为此而生：它不是黑盒插件，也不是危险补丁，而是一个轻量、透明、以安全为第一原则的本地指令文件安装工具。它帮你把精心编写的 model_instructions_file（模型指令 Markdown 文件）精准、可逆、可审计地注入 Codex CLI 的本地配置中，全程不碰二进制、不改网络、不读取任何密钥——只做你明确授权的事。

核心功能

• 预览优先，写入需确认：默认仅模拟安装过程，清晰列出将被修改的配置文件路径与变更内容，绝不静默写入
• 自动备份，一键回滚：每次实际写入前，自动为原配置文件生成带时间戳的备份（如 config.json.bak_20240520_1432），误操作也能快速还原
• 纯配置级操作：仅修改 Codex CLI 的 JSON 配置文件中的 model_instructions_file 字段，指向你的本地 Markdown 指令文件，零侵入、零依赖
• 指令文件即 Markdown：支持任意标准 Markdown 格式编写 AI 行为指南（如角色设定、输出规范、禁用词汇等），无需学习新语法
• 兼容主流智能体环境：已在 Codex CLI、Claude Code、Cursor Agent 等本地智能编程助手环境中验证可用，适配本地开发工作流
• MIT 开源，代码透明可审：全部逻辑仅 200 行 Python，无隐藏调用、无远程通信，可完整阅读、自行调试、放心部署

适合哪些人用

如果你是以下任一角色，codex-keysmith 就是为你准备的“配置安全员”：

• AI 编程提效者：常在本地使用 Codex/Cursor/Claude Code 写代码，希望统一设定“生成代码必须带类型注解”“文档注释用中文”等规则
• 团队规范推行者：需要为开发团队快速部署一致的 AI 协作规范（如 API 文档模板、安全编码提示），避免每人手动配置出错
• 隐私敏感型用户：拒绝任何可能上传 token、窃取 cookie 或联网回传的“增强插件”，只信任完全离线、行为可见的工具
• 配置管理新手：对 JSON 配置结构不熟悉，担心手改 config.json 导致 CLI 崩溃，需要一个防错、有备份、步骤清晰的引导式工具

快速上手

只需三步，安全启用你的自定义指令：

1. 安装：打开终端，运行 pip install codex-keysmith（需 Python 3.8+）
2. 准备指令文件：新建一个 my-instructions.md，用 Markdown 写清楚你希望 AI 遵守的规则（例如：## 角色设定\n你是一名资深 Python 工程师，所有代码必须兼容 Python 3.10+）
3. 安全安装：执行 keysmith install ./my-instructions.md —— 它会先显示详细预览；确认无误后，追加 --yes 参数（即 keysmith install ./my-instructions.md --yes）才真正写入，并自动备份原配置

后续如需更换指令，重复执行即可；如需恢复默认，删除配置中的 model_instructions_file 字段或还原备份文件即可。

项目信息

编程语言：Python｜GitHub Star 数：406｜开源协议：MIT｜GitHub 项目地址

它不承诺让 AI “更聪明”，但能确保你对 AI 的每一次定制，都清晰、可控、可撤销——这才是真正值得信赖的本地 AI 协作基石。