结论先说
- 这条报错是 Codex 的目录安全守卫:默认要求工作目录位于受认可且已授信的 Git 仓库内,防止在家目录、系统盘或陌生文件夹里误改文件。
- 临时非 Git 目录单次运行,加
--skip-git-repo-check:例如codex exec --skip-git-repo-check "指令",仅对本次命令放行,不改变目录的永久信任状态。 - 长期开发的项目,优先
git init并设为受信任:交互模式首次打开目录时确认信任,或在~/.codex/config.toml的[projects."<绝对路径>"]下写trust_level = "trusted"。 - 信任状态决定
.codex/项目配置是否加载:未授信目录会跳过.codex/config.toml、项目本地钩子与规则。 - 不要在家目录或磁盘根目录直接跳过检查,先
cd进具体项目子目录或搭配--cd指定路径。 - Codex 额度升级与注册验证入口:Codex 配额随 ChatGPT 付费套餐提供,国内免境外卡自助开通可见本站 ChatGPT Plus 充值页 与重度开发首选的 ChatGPT Pro 充值页,新号卡在手机验证可查看 Codex 注册验证说明。

图:本站根据 Codex 官方文档:Command line options 与 Advanced Configuration 整理的示意图
本文根据 Codex 官方文档《Command line options》《Non-interactive mode》《Config basics》《Advanced Configuration》及官方仓库整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 OpenAI 官方网站。
适用于谁
- 在终端或 CI 脚本运行
codex、codex exec时遇到Not inside a trusted directory and --skip-git-repo-check was not specified.退出的人; - 想在没有初始化 Git 的临时文件夹或独立脚本目录里运行 Codex 的人;
- 发现仓库内
.codex/config.toml或项目钩子不生效,想核查目录信任设置的人。
一、为什么会触发这条报错
在命令行运行 codex 或非交互命令 codex exec 时看到下面这句提示并退出:
text
Not inside a trusted directory and --skip-git-repo-check was not specified.
常见触发原因有两类:
- 当前路径不是 Git 仓库:Codex 默认向上寻找
.git(或配置中的project_root_markers)识别项目边界,借助版本控制兜底文件改动。如果你在新建的空文件夹、下载目录,或者未带.git目录的构建容器里直接启动,就会触发拦截。 - 非交互模式下尚未完成目录授信:交互式运行
codex时可以弹窗询问你是否信任当前目录;而codex exec与 Codex SDK 属于无人值守执行,无法停下来等待确认,遇到非仓库或未授信目录就会立即终止。常用命令一览见 /guides/codex-cli-commands-cheatsheet。
二、单次放行:--skip-git-repo-check 参数用法
如果明确知道当前目录没有 .git(例如分析几份独立日志、整理临时脚本,或在一次性 CI 容器内跑检查),在命令里加上 --skip-git-repo-check 即可:
bash
# 非交互模式单次跳过 Git 仓库检查
codex exec --skip-git-repo-check "分析当前目录下的 build.log 报错原因"
# 搭配 --cd 限定目标子目录,避免在父目录误操作
codex exec --cd ./temp-scripts --skip-git-repo-check "给这几个脚本补上参数说明注释"
使用该参数有两条明确边界:
- 只管本次进程:它只跳过当次启动时的仓库检查,不会修改全局
config.toml,下次不带参数启动仍会检查。 - 不改变沙箱与审批策略:放行后,命令执行与文件写入依然受你当前的
sandbox_mode与approval_policy约束。
三、长期信任设置:git init 与 config.toml 的 trust_level

图:本站根据 Codex 官方文档:Advanced Configuration 整理的示意图
长期维护的代码目录,每次手敲跳过参数既繁琐又缺少版本回退保护。按官方说明有两种正规做法:
1. 初始化 Git 并交互授信
先在项目目录执行 git init 建立仓库,再运行一次交互式 codex(或在 ChatGPT 桌面 App、IDE 扩展里打开该文件夹),按界面提示选择信任(Trust)。桌面端遇到项目无法开始本地聊天的排查见 /guides/codex-cannot-use-project-for-local-chat。
2. 在用户级 config.toml 声明 trust_level
在远程服务器或固定构建机上,可打开用户主目录下的 ~/.codex/config.toml(Windows 位于用户目录下的 .codex/config.toml),在 projects 表中按绝对路径设置 trust_level:
toml
[projects."/Users/alice/work/my-app"]
trust_level = "trusted"
在 Windows 上填写盘符路径时,建议使用 TOML 单引号原始字符串包裹路径,防止反斜杠被当成转义字符导致解析失败。
另外,如果你想更改项目根目录的判定标识,官方高级配置提供了顶层键 project_root_markers(默认查找 .git;设为空数组 project_root_markers = [] 时直接把当前工作目录当作项目根,不再向上查找)。注意根级键必须写在所有 [表头] 之前,完整配置优先级见 /guides/codex-config-toml-complete-guide。
四、信任级别如何影响 .codex/ 配置与安全
官方配置文档把目录信任和配置加载做了严格绑定:
- 目录标为
trusted(受信任) 时,Codex 才会读取该仓库内的.codex/config.toml、项目本地钩子(Hooks)和本地规则; - 克隆外部陌生仓库审查代码、标为
untrusted(不受信任) 时,Codex 会跳过仓库里的.codex/层,防止外部仓库自带的配置执行非预期操作,同时你的用户级配置与AGENTS.md说明仍按规则生效(读取顺序见 /guides/codex-agents-md-how-it-reads)。
日常在本地与自动化脚本里高频运行 Codex 会消耗订阅配额,需要更高额度可查看本站 ChatGPT Plus 充值说明 或 ChatGPT Pro 充值说明。
常见问题
问:为什么把 trust_level = "trusted" 写进项目自己的 .codex/config.toml 里没反应?
答:目录在被信任之前,Codex 根本不会加载项目内部的 .codex/config.toml。信任配置必须写在用户主目录下的 ~/.codex/config.toml 里。
问:Windows 跨 WSL 网络路径打开项目也报检测不到 Git 怎么办?
答:官方 Windows 文档说明跨 WSL 网络挂载路径可能无法识别原生 Git。建议直接在 WSL 终端内安装运行 Linux 版 Codex CLI,或将项目放在原生磁盘路径。
问:加了 --skip-git-repo-check 后还能用 /diff 和工作树吗?
答:如果目录本身没有初始化 Git,依赖版本库记录的 /diff、/review --base 以及 Worktree 功能都无法使用。
问:跑 Codex 额度不够用,国内没有外币卡怎么快速升级 Plus 或 Pro?
答:可在本站用支付宝、微信支付或 AlipayHK 自助购买卡密兑换 ChatGPT Plus 或 ChatGPT Pro(已有未到期 Plus 直升可选 Pro 5x 可覆盖档),实时价格与售后边界(封号不在质保范围)以页面当天说明为准。
相关教程
参考资料
- Codex 官方文档:Command line options — https://learn.chatgpt.com/docs/developer-commands
- Codex 官方文档:Non-interactive mode — https://learn.chatgpt.com/docs/non-interactive-mode
- Codex 官方文档:Config basics — https://learn.chatgpt.com/docs/config-file/config-basic
- Codex 官方文档:Advanced Configuration — https://learn.chatgpt.com/docs/config-file/config-advanced
- openai/codex 官方仓库 — https://github.com/openai/codex
0 条评论
还没有评论,来抢沙发~