現在很多人同時在用 Claude Code 和 Codex。同業問我：「我本來用 Claude Code，今天開始用 Codex，指定同一個資料夾會不會衝突？還是分開兩個資料夾好？」
我的答案是同一個資料夾。分開兩個資料夾，你累積的習慣、流程、資料就分家了：這邊改過的東西那邊看不到，換一個模型接手就錯亂，你還得多一個動作幫它們互相同步，那是多此一舉。
再來是額度。一邊的額度快用完，要換另一邊接著做，兩邊就得看到同一份東西，而且接手的那個要知道做到哪了。另一位同業問的正是這個：「額度用完換另一個模型接手，它怎麼知道進度？每次都要寫交接手冊嗎？」
最後是互踩。兩個 AI 同時做事，會改到同一份檔案，也會互相看不見對方做過什麼。我自己就撞過：8 月 8 日晚上 Codex 跑完一輪稽核，一個多小時後 Claude 又派了一個工兵做同一件事，兩邊都沒做錯，就是互相看不見，那一次重工是真的花掉的額度。所以要有規矩：先登記再做、同一份檔案同一時間只有一個人寫、做完的結果回到原本那個對話。這頁要裝的東西，就是把這三條規矩做成一個小程式。
這些「沒有」是完整版才有的東西。完整版綁死在作者自己的環境裡搬不出去，這裡放的是照同一套方法重寫的最小版。
會用這個的人，電腦上一定已經有 Claude Code 或 Codex。所以最簡單的裝法不是你打指令，是叫它裝。做完一步就打勾，勾勾會記在你的瀏覽器裡。
例如在「文件」底下新建一個叫 我的AI工作區 的資料夾。已經有在用的專案資料夾就直接用那個，不用另外開。
做完會看到：一個空的（或你原本那個）資料夾。之後裝好的東西、佇列、紀錄全部都在這個資料夾裡，不會跑到別的地方。
桌面 App 用「開啟資料夾」選第 0 步那個資料夾。用終端機的人先 cd 進那個資料夾，再打 claude 或 codex。
做完會看到：AI 的對話框，而且它顯示的工作目錄就是那個資料夾。位置不對就先關掉重開，因為佇列會裝在它當下站的那個資料夾。
請先檢查這台電腦有沒有 Python 3.10 以上，沒有就用白話告訴我怎麼裝，裝好再繼續。然後把 https://github.com/Nouischen/one-folder-two-agents 複製到一個暫存位置，讀它的 BUILD_SPEC.md，把 aiq.py 複製進我現在這個專案資料夾，照 BUILD_SPEC.md 第 7 節跑驗收 T1 到 T7，全部通過後用白話告訴我怎麼用。改我的 hook 設定之前先問我。不要碰這個資料夾以外的檔案。整句照貼就好，一個字都不用改。
接下來會發生的事：它先檢查 Python，然後下載程式、讀施工圖、把 aiq.py 放進你的資料夾、跑七項驗收。中間如果它問你「可不可以執行這個指令」，按允許。整個過程大約十分鐘。
三個徵象同時出現就是裝好了：
aiq.py 和一個 .aiq 資料夾（Mac 的 Finder 預設看不到點開頭的資料夾，按 Cmd+Shift+. 就會顯示）它的回報大概長這樣：
建了什麼：aiq.py 放在你的專案資料夾，資料都在 .aiq 裡。以後在這個資料夾的對話裡說「把某件事排進佇列，只准改哪些檔」「跑佇列」「現在跑到哪」就好。 驗收結果：T1 通過、T2 通過、T3 通過、T4 通過、T5 通過、T6 通過、T7 通過。 做不到的：暫存區寫入、整波盤點、另一引擎審查、儀表板、多台電腦。 hook 還沒接。要不要我幫你把「結果自動出現在下一句對話」接上？改之前我會先備份。
想看它真的動一次？回它「跑 T8」。那會真的派一件小任務給引擎做（在資料夾裡建一個 hello.txt），會用掉一點點額度。
它問「要不要接 hook」的時候，回它這句：
好，先備份再改它會先把要加的內容印給你看，備份原本的設定檔，然後改 Claude Code 的 settings.json 或 Codex 的 hooks.json。
做完會看到：之後你在同一個資料夾開的任何 Claude Code 或 Codex 對話，每說一句話，還沒讀過的佇列結果就會自己出現在 AI 的脈絡裡，它會主動轉述給你。
~/.claude/settings.json 的 hooks.UserPromptSubmit 加一個 command hook，指令是 python <aiq.py 的絕對路徑> hook，timeout 10 秒。已經有其他 hook 就附加在後面，不會覆蓋。改之前先把原檔複製一份 settings.json.bak-<日期>。~/.codex/hooks.json 的 UserPromptSubmit 加同樣的指令。hook 指令永遠正常結束、任何錯誤都吞掉：資料庫壞了、檔案不在、權限不對，都安靜退出，絕對不會弄壞你的對話。python 這個名字有時是一層殼，不是真正跑程式的那個；hook 裡寫 Python 的完整路徑比較穩，AI 會處理。裝好之後，在同一個資料夾的對話裡就講人話，不用記指令。三句：
把〈某件事〉排進佇列，只准改〈哪些檔〉例如：「把 README 的安裝段改寫成小白步驟排進佇列，只准改 README.md」。AI 會幫你登記，順便把「只准改哪些檔」寫進宣告。
跑佇列它會搶一件交給引擎做。想一口氣做到佇列空為止，就說「跑佇列，做到空為止」。
現在跑到哪它會列出每一件的狀態：排隊中、進行中、完成、失敗、等決定。
結果會自己出現在下一句對話裡（第 4 步接了 hook 才會）。沒接 hook 也能用，只是要自己問「現在跑到哪」。
任務要跑指令或測試時：預設只放行「改專案內的檔案」，引擎連跑一個測試都會被擋。這種任務叫 AI 用 --allow-all 跑，那會跳過引擎的所有權限確認，只在你信得過這件任務時用。
這件任務需要跑指令或測試，跑佇列時加 --allow-all想指定模型時：不指定就用各 CLI 自己的預設模型。要指定就叫 AI 用 --model。
跑佇列時用 --model 指定〈模型名稱〉五種最常見的卡法。每一種都附一句可以直接貼給 AI 的話。
電腦上沒有 Python 3.10 以上。不是你的錯，叫它教你裝。
請檢查這台電腦有沒有 Python 3.10 以上，沒有就用白話一步一步教我裝；裝好之後再把 aiq.py 的驗收 T1 到 T7 跑一次給我看。引擎沒裝，或裝了但系統的 PATH 找不到它。
請確認這台電腦上 claude 和 codex 這兩個指令找不找得到（PATH 裡有沒有）。找不到的話，用白話告訴我是沒裝還是路徑沒設，以及要怎麼修。三種常見原因：引擎結束但沒寫結果檔；改到宣告範圍外的檔案；Codex 說設定檔裡的模型需要新版 CLI 而秒退。真正的原因寫在 .aiq/tasks/<任務id>/engine.log，叫 AI 去讀。
有任務變成 needs_decision。請讀 .aiq/tasks/那件任務的id/engine.log，用白話告訴我原因。如果是 Codex 說模型需要新版 CLI，就用 --model 指定一個目前能跑的模型，把那件任務 requeue 之後再跑一次。「引擎有沒有改到不該改的檔」這層檢查靠 git。不是 git repo 就只剩 prompt 裡的範圍宣告，還是能用，只是少一層保護。
請確認這個專案資料夾是不是 git repo。不是的話先 git init，並把 .aiq/ 加進 .gitignore，這樣越界改動的檢查才會生效。佇列先進先出，會先做最早登記、還沒做完的那件。前面測試留下來的先收掉，再跑你要的。
先列出佇列裡所有還沒做完的任務。前面測試留下來、我不需要的，幫我標成完成或失敗收掉，剩下我真的要做的再跑。一樣在那個資料夾的對話裡跟 AI 說一句：
請幫我移除佇列：先備份，然後刪掉這個資料夾裡的 aiq.py 和 .aiq 資料夾，再把 Claude Code 的 settings.json（或 Codex 的 hooks.json）裡呼叫 aiq.py hook 的那一段拿掉。改設定檔之前先備份一份。沒接過 hook 的人，它只會刪那兩樣東西。你專案裡其他檔案不會被動到。
這頁裝的是最小版：一個檔案，兩成的效果，夠一個人在同一台電腦上讓兩個 AI 不互踩。它是怎麼設計的、完整版多了什麼、踩過哪些雷，都寫在 GitHub 的設計筆記裡。