Codex 报不在受信任 Git 目录(Not inside a trusted directory)怎么办:--skip-git-repo-check 与信任设置

运行 Codex CLI 或 codex exec 报 Not inside a trusted directory 怎么办?本文讲清原因、单次跳过参数 --skip-git-repo-check 与 config.toml 信任设置。

NNathaniel bigo··原创首发·AI 辅助撰写
11 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 Plus 账号

结论先说

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

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 "给这几个脚本补上参数说明注释"

使用该参数有两条明确边界:

  1. 只管本次进程:它只跳过当次启动时的仓库检查,不会修改全局 config.toml,下次不带参数启动仍会检查。
  2. 不改变沙箱与审批策略:放行后,命令执行与文件写入依然受你当前的 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

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 整理家庭装修预算明细、隐蔽工程验收清单与主材优缺点对比表实战

    第一次装修面对几十页施工报价单、密密麻麻的水电防水隐蔽项目与五花八门的主材参数,极易踩坑增项。本文梳理用 ChatGPT 审查装修报价漏项、生成带公式的预算明细表、定制工地隐蔽工程验收单与主材对比表的实战提示词。

    ChatGPT0
  2. 02

    用 ChatGPT 做费曼学习法读书共读:反向追问检验自己是否真读懂专业书籍与整理书单笔记

    读完一本专业硬书常感觉「合上书就忘」,直接让 AI 概括全书又容易产生懂了的错觉。本文介绍用 ChatGPT 结合 Study Mode 与费曼学习法做反向追问共读,通过通俗复述、挑刺盲区到沉淀书单卡片的完整流程与提示词。

    ChatGPT0
  3. 03

    用 ChatGPT 做外贸产品多语种目录、展会邀约与客户跟进节奏表(附脱敏与本地化提示词)

    做外贸展会与海外推广时,手工翻译十几款产品目录费时且容易留下一堆中式英文,展后客户跟进也常缺节奏。本文梳理用 ChatGPT 先脱敏建术语库、再批量产出多语种目录、展前邀约函与展后 21 天跟进节奏表的实战流程与提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写高质量技术专栏文章、开源项目 Release Notes 与版本更新日志实战

    让 AI 直接凭空写技术文章容易满篇空洞套话,直接甩 Git 记录写更新日志又常常漏掉破坏性变更。本文整理用 ChatGPT 结合真实代码片段、压测数据与 PR 摘要,高效产出深度技术专栏、GitHub Release Notes 与 CHANGELOG 的实战工作流。

    ChatGPT0
  5. 05

    用 ChatGPT 做产品用户访谈纪要编码、提炼高频痛点需求池与 RICE 优先级打分实战

    手头攒了十几份用户访谈逐字稿,手工贴便利贴归纳痛点耗时又容易带入主观偏见。本文分享用 ChatGPT 完成脱敏检查、逐份开放式编码、跨样本聚类高频痛点并搭建 RICE 优先级打分表的 5 步实战流,附可直接复制的三段核心提示词。

    ChatGPT0
  6. 06

    ChatGPT 网页版上传超过 10 个文件或回形针附件按钮变灰怎么办:打包合并与配额限制排查

    在 ChatGPT 网页版批量分析文档时,常遇到一次选超 10 个文件被拦截或输入框回形针按钮变灰。本文依据 OpenAI 文件上传与存储说明,梳理 6 类常见报错的分流排查法,提供 ZIP 打包、本地合并与 Projects 复用方案及可直接复制的解包提示词。

    ChatGPT0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~