結論先說
- 這條報錯是 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 條評論
還沒有評論,來搶沙發~