codex exec 默认希望在 Git 仓库中工作因为 Git 能提供文件边界、变更对比和恢复依据。在临时目录、解压后的源码包、CI 生成目录或一次性数据文件夹里运行时命令可能因为当前路径不是仓库而拒绝继续。--skip-git-repo-check 可以允许 Codex 在这种目录中执行但它只是跳过仓库前置检查不会自动创建版本保护也不会放宽沙箱和文件权限。是否使用它取决于目录是否可信、任务是否可恢复以及输出能否被验证。一、为什么 Codex 要检查 Git 仓库代码代理会读取和修改文件还可能运行测试、格式化与构建命令。Git 仓库提供了清晰的根目录和修改清单使操作者能通过状态和 diff 看出哪些内容发生变化。没有仓库时代理仍能处理文件但你失去了最方便的审计方式也更难区分原始文件和新生成内容。仓库检查还有一道信任提醒作用。随手在用户主目录、下载目录或包含密钥的运维目录运行代理影响范围可能远超预期。命令拒绝启动并不一定是障碍它可能在提醒你选错了工作位置。二、哪些场景适合跳过检查第一类是 CI 创建的全新临时目录里面只有本次任务明确生成的输入例如待分析的报告、代码片段或构建清单。目录生命周期短权限隔离清楚任务结束后整体删除。第二类是只读分析不要求修改源文件只让 Codex 总结一组受控文档或日志。第三类是尚未初始化 Git 的新项目原型。此时可以先让 Codex 生成基础结构但完成后应尽快初始化仓库并审查首个提交。第四类是工具解压出的源码快照来源可信且另有校验值处理结果会进入独立输出目录。这些场景的共同点是边界明确、输入可重建、失败后不依赖自动回滚。三、哪些场景不应该使用不要在个人主目录、共享盘根目录、生产配置目录或包含大量无关项目的上层目录使用该参数。也不要因为 Git 工作树脏乱就跳过检查这不会解决未提交修改只会让审计更加困难。若目标本来就是一个仓库却提示不在仓库中应先检查当前路径、挂载点、工作树和 .git 文件而不是绕过检查。处理不可信压缩包或外部提交内容时也要谨慎。跳过 Git 检查不代表输入安全目录中可能有诱导代理执行危险命令的说明文件、脚本或符号链接。应在隔离容器中处理并收紧网络与写权限。四、基本使用方法进入确定的临时工作目录运行 codex exec --skip-git-repo-check 任务说明。开始前列出目录路径和预期文件确认没有通过符号链接指向敏感位置。若任务需要输出创建专用结果目录并限制代理只修改该范围。命令参数是全局选项可与非交互任务的其他选项组合。组合越多越要记录最终命令和生效配置。不要把“跳过 Git 检查”与“绕过审批和沙箱”放在同一条默认脚本里前者只处理仓库前置条件后者会显著扩大执行权限风险完全不同。五、CI 中怎样建立替代保护没有 Git diff 时可以在运行前生成输入文件清单和哈希运行后再次扫描目录比较新增、删除和改变的文件。更简单的做法是把输入目录挂载为只读只给单独的输出目录写权限。任务结束后只上传输出不把工作目录原样传播到下一阶段。CI 还应设置时间、网络和进程限制。临时目录不等于沙箱脚本仍可能访问环境变量、网络服务或父目录。为运行账户提供最小权限敏感变量只注入真正需要的步骤并让日志遮盖密钥。如果大家想体验一线 AI 编程模型 codex 和 claude用它们在临时项目或 CI 中完成文件分析、代码修改、测试和审查可以参考以下教程文档进行接入配置接入配置好后即可使用。文档教程https://my.feishu.cn/wiki/NIgLwuuj1ibzJIkLGM0cgVNinzg六、临时目录中的规则文件问题Codex 会根据当前目录和配置发现项目指令。一个没有 Git 根的目录可能改变规则查找边界导致你以为会加载的 AGENTS.md 没有生效或者从上层目录继承了不希望的内容。运行前应明确检查生效指令不要依赖“和仓库里应该一样”的想象。自动化若要求固定行为可以把必要规则随作业输入一起提供并在日志中记录版本。不要从不受信任输入直接加载高权限操作指令。规则文件应指导任务不应成为扩大系统访问范围的凭证。七、提示不在 Git 仓库时的排查顺序先运行 Git 自身的仓库检测确认当前目录是否真的不属于工作树。若本应属于仓库检查 CI checkout 是否执行、子模块是否拉取、工作目录是否被脚本切换以及容器卷是否挂载到预期位置。路径中存在快捷方式或符号链接时记录解析后的真实路径。只有确认该任务有意在非仓库目录运行才加入 --skip-git-repo-check。把参数作为所有失败的通用修复会掩盖 checkout 失败、目录拼写错误和挂载缺失。流水线应对这些情况直接失败。八、运行后的验收方法首先检查文件范围是否只改变允许的目录。其次检查内容生成物是否完整是否夹带环境路径、令牌或调试信息。再次检查命令日志有无访问外部网络、安装未知依赖或启动后台进程。最后用独立工具验证结果例如解析 JSON、编译代码或运行测试。若任务会修改重要文件可以先复制到临时工作副本再运行 Codex。完成后由受控脚本把通过验证的文件移动到正式位置。不要让代理直接在唯一副本上操作后再祈祷结果正确。九、安全边界应该怎样写进流程团队可以明确规定只有受控临时目录允许使用该参数工作目录必须由流水线创建输入来源需要校验网络默认关闭输出必须进入指定路径运行后必须做文件清单对比。这样参数的使用是可审计例外而不是个人习惯。--skip-git-repo-check 适合解决“这里有意不是仓库”的情况不适合解决“我不知道自己在哪个目录”。跳过检查之后版本控制原本提供的可见性需要由目录隔离、哈希清单、只读挂载和结果验证补回来。能做到这一点它是实用的自动化选项做不到就先初始化仓库或换到更安全的工作副本。