現在很多人同時在用 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 會處理。先講清楚什麼時候用得到。如果你從頭到尾只開一個 AI、一個對話,那你不需要這個東西,直接叫它做就好。它是為了「同一個資料夾會有第二個人動手」而存在的:另一個 AI、另一個對話,或是你等一下換過去的那一邊。
裝好之後不用記指令,也不用背暗號。你正常交辦,AI 讀得到安裝時留下的說明,自己知道要走這份共用清單。三個真的會用到的時刻:
你講你要什麼,加一句「這個你排進去做」。它會先把「會動到哪幾個檔」登記起來把那幾個檔佔住,然後自己動手做。
report.md 第一段太囉唆了,幫我改短一點,這個你排進去做佔住之後才是重點。你同時在另一邊(Codex,或另一個對話)做別的事,那邊動手前會先看一眼這份清單,發現這幾個檔有人佔著就不會碰。這是我實測過的原話,我請一個全新的 Codex 去改同一個檔,它回:
report.md 已有另一邊排隊中的同一項修改,我先不碰,避免兩邊互相覆寫。你要我等那邊完成,還是改做其他事?
檔案完全沒被動到。要動哪些檔不用你想,AI 看完你的要求和資料夾自己判斷,登記完會告訴你一聲。你有特別在意的才補一句「只能動這個檔」。
Claude 快沒額度時,你先把還沒做的交辦下去,然後在同一個資料夾開 Codex,講這句:
我 Claude 額度快用完了,這邊還有什麼沒做完的嗎?有的話你接著做它會自己看到清單上還有什麼、用它自己的額度接著做,不用你重講一次背景。做到一半被中斷的,會從上次記錄的進度接下去,不從頭來。反過來從 Codex 換回 Claude 也一樣。這段我也實測過:Codex 收到這句話之後自己找到沒做完的那件、做完、記錄完成,全程一次額度。
隔天或換個對話回來,直接問就好。
還有什麼沒做完的?它會列出每一件的狀態:排隊中、進行中、完成、失敗、等你決定。接了 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 的設計筆記裡。