結論先說
- 跨倉開發首選在主倉庫啟動並重復傳入
--add-dir。例如進入後端目錄後運行codex --add-dir ../shop-web --add-dir ../shared-types,即可在單次會話裏同時讀取並協同修改三個目錄。 - 不要為了省事直接掛載整個總工作目錄(如
~/workspace)。放開整個父目錄會把無關項目全暴露給沙箱且拖慢檢索,還容易觸發非 Git 倉庫校驗提示;只精確掛載本次聯調涉及的目錄最穩妥。 --add-dir的寫入權限仍受當前沙箱模式約束。配合--sandbox workspace-write時,掛載進來的目錄擁有受控寫權限且.git依然受保護;若只想讓 Codex 跨倉比對接口而不改動任何代碼,加上--sandbox read-only即可。- 每個子倉庫的
AGENTS.md與 Git 狀態彼此獨立。各倉在自己根目錄寫清構建與類型檢查命令,改完後務必分別檢查每個倉庫的git diff並按依賴順序獨立提交。 - 跨三倉聯合檢索與全量類型檢查會佔用較大上下文窗口。國內無外幣卡的用戶可在本站自助開通 ChatGPT Plus 或高配額的 ChatGPT Pro,團隊多人研發可了解 ChatGPT Business 團隊定製。

圖:本站根據 OpenAI Codex 官方文檔:Command line options 整理的示意圖
本文根據 OpenAI Codex 官方文檔《Command line options》《Sandboxing》《AGENTS.md》整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。
適用於誰
- 前端、後端和公共類型包拆在多個獨立 Git 倉庫裏,經常因為改一個接口字段要在多個窗口來回拷貝定義的開發者;
- 嘗試直接在整個父級大目錄啟動
codex,卻發現提示不在受信任倉庫內或索引過慢的人; - 希望在保證最小安全邊界的前提下,讓 Codex 一次完成跨倉契約對齊、聯調修改與各自單測校驗的工程師。
一、--add-dir 的核心機制與三種跨倉方式對比
預設情況下,Codex 把啟動時所在的當前目錄視為唯一工作區根目錄(沙箱邊界細節見 /guides/codex-permissions-sandbox)。當你的前後端和共享契約包平級存放時,直接打開父目錄容易遇到非 Git 倉庫信任警告(詳見 /guides/codex-not-inside-trusted-directory-skip-git-repo-check),而 --add-dir 正是為精確聲明多工作區而設計的:
| 啟動方式 | 典型命令 | 暴露範圍與安全邊界 | 檢索與維護體驗 |
|---|---|---|---|
| 預設單目錄 | codex | 僅當前倉庫可寫,看不到兄弟倉庫 | 隔離好,但跨倉字段需手工粘貼 |
精確 --add-dir(推薦) | codex --add-dir ../web --add-dir ../types | 僅主倉與指定掛載目錄納入工作區,各倉 .git 仍只讀 | 範圍精準,一次會話打通前後端聯調 |
| 從總父目錄啟動 | cd ~/projects && codex | 暴露全部無關倉庫,誤改風險大 | 易觸發非 Git 目錄校驗且噪音文件過多 |
常用命令寫法
假設本地目錄結構為 ~/work/shop-api、~/work/shop-web、~/work/shared-types:
bash
# 在後端倉庫作為主目錄啟動,同時掛載前端與共享類型目錄
cd ~/work/shop-api
codex --sandbox workspace-write \
--add-dir ../shop-web \
--add-dir ../shared-types
如果只想做一次只讀契約巡檢(例如檢查前端調用字段與後端最新 DTO 是否全部一致,不修改任何文件),可以直接配合非交互模式與只讀沙箱:
bash
codex exec --sandbox read-only \
--add-dir ../shop-web \
--add-dir ../shared-types \
"核對 shop-api 的訂單響應 DTO、shared-types 定義與 shop-web 頁面渲染字段,列出所有字段名或可空類型不一致的位置。"
二、前後端雙倉 + 共享類型目錄四步聯調實戰

圖:本站根據 OpenAI Codex 官方文檔:Sandboxing 整理的示意圖
把三個目錄掛進同一個會話後,最怕模型同時亂改導致編譯報錯纏成一團。本站建議按以下四步推進:
第一步:在各倉庫各自維護簡明 AGENTS.md
在 shared-types、shop-api、shop-web 根目錄分別放一份簡短 AGENTS.md(讀取優先級規則見 /guides/codex-agents-md-how-it-reads),只需寫明該倉庫的類型檢查、打包與測試命令(如 pnpm build、pytest -q、npm run typecheck),Codex 切目錄驗證時就不會猜錯腳本。
第二步:把固定聯調組合封裝為終端快捷函數
每天重複敲兩三個相對路徑很容易拼錯,本站建議寫入 ~/.zshrc 或 ~/.bashrc:
bash
codex-shop() {
(cd ~/work/shop-api && codex --sandbox workspace-write \
--add-dir ../shop-web \
--add-dir ../shared-types "$@")
}
如果希望把相關沙箱寫根策略長期寫入配置模板,也可結合個人或項目級 config.toml 管理(語法參考 /guides/codex-config-toml-complete-guide)。
第三步:提示詞裏明確「契約先行」的修改順序
發起聯調任務時,明確要求 Codex 嚴格按依賴上游到下游的順序分步改並分步驗收:
text
請給訂單詳情接口新增 estimatedDeliveryAt(ISO 字符串,可為空):
1. 先修改 ../shared-types 中的 OrderDetail 類型並運行構建;
2. 再修改當前 shop-api 倉庫的序列化邏輯與單測並跑通;
3. 最後修改 ../shop-web 的訂單詳情卡片展示與類型檢查;
若涉及只讀參考倉請明確提示,不要自動執行 git commit 或 git push。
第四步:分別核查各倉分支與差異後再依次提交
由於 --add-dir 掛載的是多個獨立 Git 倉庫,所有改動會分散落盤在各自工作樹裏。驗收完後務必對三個目錄分別檢查分支名與 git status / git diff,再按「共享包發佈或同步 -> 後端合入 -> 前端合入」的順序分別提 PR。
訂閱與帳號準備提示:跨倉聯調會同時讀取前後端接口代碼、類型定義與測試夾具,單次任務的上下文體積通常是單倉任務的二到三倍。若 Plus 檔在聯調密集期容易觸發限額,可在本站升級 ChatGPT Pro 充值 或選用 ChatGPT Pro 5x iOS 可覆蓋檔;新註冊帳號若遇到手機短訊驗證受阻,也可查看 Codex 註冊手機驗證服務。
三、跨倉掛載常見坑與避坑要點
- 切勿混改不相關分支:啟動前先確認三個倉庫都已切到對應需求分支且工作樹幹淨,否則 Codex 改完後很難把新舊改動從
git diff裏拆開。 - 只需要參考某倉庫文檔或 SDK 源碼時寫明「只讀參考」:當掛載進來的第三個目錄是底層公共庫、不打算本次修改時,在首條提示詞裏顯式約束「
../legacy-sdk僅作只讀參考,禁止修改」,避免模型順手去改公共依賴源碼。 - Windows 路徑含空格需加雙引號:在 PowerShell 中傳參類似
--add-dir "D:\work repos\shop-web",避免空格把單個路徑拆成無效參數。
常見問題
問:--add-dir 最多可以同時掛載多少個目錄?
答:命令行支持連續傳入多個 --add-dir,但本站建議單次聯調控制在 2 到 4 個強相關目錄內。掛載過多倉庫不僅增加誤改風險,也會讓檢索範圍變寬、消耗更多上下文配額。
問:掛進來的兄弟倉庫裏如果也有 AGENTS.md,會被正確識別嗎?
答:Codex 在讀取或修改某個目錄下的文件時,會結合對應路徑層級下的指引文件。不過為了萬無一失,涉及跨倉強約束(例如禁止修改某個共享目錄或要求特定驗證順序)時,最好仍在主會話提示詞裏重申一遍。
問:國內沒有外幣信用卡,或者研發團隊需要開增值稅發票報銷,怎麼開通適合多倉庫聯調的 Codex 訂閱?
答:可通過本站 AI 會員充值總覽 辦理 ChatGPT Plus 卡密自助兌換 或高配額 ChatGPT Pro,多人研發團隊可直接選擇 ChatGPT Business 團隊定製。支持支付寶、微信支付及 AlipayHK 付款,無需交出帳號密碼,可開具增值稅發票;實時價格以商品頁展示為準,售後遵循掉訂閱按剩餘天數折退、封號不在質保範圍的規則。
相關教學
- Codex 權限模式與沙箱機制詳解
- Codex 怎麼讀取 AGENTS.md 與層級優先級
- Codex config.toml 配置文件完全指南
- Codex 報 not inside a trusted directory 與 --skip-git-repo-check 處理
參考資料
- OpenAI Codex 官方文檔:Command line options — https://learn.chatgpt.com/docs/developer-commands
- OpenAI Codex 官方文檔:Sandboxing — https://learn.chatgpt.com/docs/sandboxing
- OpenAI Codex 官方文檔:AGENTS.md — https://learn.chatgpt.com/docs/agent-configuration/agents-md
0 條評論
還沒有評論,來搶沙發~