🪟
同模型，換新對話
Claude 換 Claude、Codex 換 Codex。離開太長的對話，保留真正有用的進度。
Why it matters
帶走工作狀態，不必搬走整段聊天
真正需要接手的通常是：目標、做到哪裡、重要決定、卡點與下一步。這些由固定程式寫成可讀的 Markdown，新對話不必重新吞完整段 context。
⇄
跨模型，自由交班
研究、寫作、實作或審查，可依實際表現與額度選模型。系統保存進度，不替你誇大誰一定擅長什麼。
☑
直接問未完成事項
說「我有哪些進度還沒做完的？」就能看到進行中、卡住與下一步，不必背檔名或編號。
Guided setup
第一次照著做，之後只要說人話
你不用到 GitHub 下載 ZIP，也不用自己搬檔。先建立安全的空資料夾，再把下面的短提示詞貼給 Claude Code 或 Codex；AI 會下載固定版本的安裝器、核對雜湊並執行。
第一次只用空白測試資料夾。不要拿含病歷、未去識別化個資、密碼、API key、憑證或其他敏感資料的資料夾測試。
1
在「文件」裡建立空白資料夾
不要直接把 Claude Code 或 Codex 開在「桌面」最外層、使用者家目錄，或整顆硬碟。照你的電腦一步一步做：
Windows
- 打開「檔案總管」。
- 左邊點「文件」。
- 在空白處按右鍵 →「新增」→「資料夾」。
- 命名為「AI進度接力測試」。
- 打開 Claude Code 或 Codex，選擇這個資料夾當專案。
macOS
- 打開 Finder。
- 左邊點「文件」或 Documents。
- 選「檔案」→「新增檔案夾」。
- 命名為「AI進度接力測試」。
- 打開 Claude Code 或 Codex，選擇這個資料夾當專案。
需要 Python 3.10 以上。不知道版本也沒關係：下一步的提示詞會請 AI 先檢查。若版本太舊或沒有安裝，AI 應先停下、不修改專案，再用白話帶你安裝新版 Python。
2
把這段貼給其中一個 AI
Claude Code 或 Codex 任選一邊貼一次。這不是要你手動下載：AI 會把安裝器放到系統暫存區，驗證正確後才在目前專案建立檔案。
請直接在目前開啟的專案安裝 Cross-AI Progress Bridge，不要只解說。把 https://raw.githubusercontent.com/Nouischen/cross-ai-progress-bridge/v1.0.0/bootstrap/install.py 下載到作業系統暫存資料夾（不要存進專案），先驗證 SHA-256 必須完全等於 9D5BD5DBDCD2436CD669C419B9731839B1B4E5E080E8C7BCA366915FC63CBA01；不符就停止，不得換來源。用 Python 3.10 或更新版本執行已驗證的 install.py，--target 指向目前專案的絕對路徑；若缺少合格的 Python，先停止、不要修改專案，並用白話教我從官方來源安裝。若回傳 INSTALL_NEEDS_CONSENT，只列出偵測名稱並問我；只有我明確同意後，才用同一檔案加上 --mode sidecar --accept-existing I_ACCEPT_SIDECAR 重跑。不要叫我手動下載、解壓或搬檔，也不要自行讀取、搬移或覆蓋舊進度；最後回報 INSTALL_OK 或錯誤。
若跳出權限確認，先確認範圍只有「目前測試資料夾」與「系統暫存資料夾」再允許。雜湊不符、位置不安全或安裝失敗時，請讓 AI 停下，不要叫它繞過檢查。
3
做一次真的接力測試
不需要任何狀態標章。直接測「能不能存、另一個新對話能不能讀」：
在剛才安裝的對話輸入
建立一筆叫「第一次接力測試」的任務，下一步是「到另一個新對話查看」，然後記錄進度。開一個全新對話；可用同一模型，也可換另一個模型。務必開啟同一個實體資料夾，再輸入
我有哪些進度還沒做完的？看到「第一次接力測試」後，輸入
繼續第一次接力測試確認它能讀到下一步，就完成了。以後換對話或換模型，只要兩邊開的是同一份實體專案資料夾，就能讀到同一批進度檔。
Everyday language
日常只要記住三句話
進度格式、檔名、備份與修訂版檢查交給本機程式。你不必直接操作 Markdown 檔。
記錄進度把目前工作的目標、完成項目、決定、卡點與下一步存起來。我有哪些進度還沒做完的？列出進行中與卡住的任務、最後更新時間和下一步。繼續上次進度只有一筆就直接接續；有多筆時先列出讓你選。繼續某任務直接用任務標題指定要接手的工作。
Compatibility
已有自己的系統？隔離共存，不強行整合
它的相容策略是「在旁邊加一個獨立插座」，不是搬家工具。發現既有規則或進度名稱時，安裝器先停下且不寫任何檔案，等你明確同意後才安裝自己的區域。
共存模式的觸發詞
原本的系統照舊使用；這套接力功能一律用 「接力：」開頭，例如「接力：我有哪些進度還沒做完的？」兩套規則比較不會搶同一句話。
1️⃣
偵測階段只看名稱先列出可能衝突的檔名或資料夾名；未同意前不讀內容，也不寫入。
2️⃣
不搬、不讀、不覆寫舊進度不遷移既有任務，不把舊資料轉格式，也不把兩套狀態硬湊在一起。
3️⃣
自己的檔案放在自己的區域新進度放在 AI_PROGRESS；若需在入口規則加上標記區塊，會先備份。
Local & auditable
資料留在專案裡，格式公開可讀
這個專案沒有後端、帳號、資料庫或遙測。安裝器與執行程式都在 GitHub 公開；任務內容只寫入你目前的本機專案資料夾。
系統會做的事
- 用純文字 Markdown 保存任務
- 固定版本網址＋SHA-256 核對安裝器
- 修改橋接器碰到的既有入口檔前先備份
- 用 revision 檢查降低過期內容覆寫
- 同一時間只讓一個 AI 寫同一筆任務
不要拿來存的內容
- 未去識別化病歷或病人資料
- 身分證號、電話等敏感個資
- 密碼、API key、憑證與私鑰
- 你不希望任何 AI 讀到的私密筆記
- 兩個 AI 同時編輯中的同一項工作
FAQ
先把幾個容易誤會的地方說清楚
一般 ChatGPT 或 claude.ai 網頁聊天框可以用嗎？
單純的網頁聊天通常不能直接讀寫同一個本機專案資料夾，因此不在這套工具的支援範圍。這套是給 Claude Code 與 Codex 這類能操作本機專案的工具使用。
為什麼需要 Python 3.10 以上？這還算「不用下載」嗎？
你不用手動下載、解壓或搬動這個 GitHub 專案；AI 會處理固定版本的安裝器。Python 3.10 以上是執行安裝器與日常橋接程式的必要環境。若版本太舊或沒有安裝，提示詞會要求 AI 先停下並帶你安裝新版 Python。
Git 專案可以用嗎？
可以，但 Claude Code 與 Codex 必須開啟同一個實體 checkout。若其中一邊使用另一個 worktree，即使專案名稱相同，也可能看不到同一份尚未提交的進度。第一次建議先在「文件」裡的空資料夾測成功。
為什麼兩邊一定要開同一個資料夾？
這套系統不靠雲端同步，而是讓兩個工具讀寫同一批本機檔案。資料夾不同，就像兩本不同的筆記本；它不會自動跨電腦或跨 checkout 傳送資料。
發現我原本的系統後，它會怎麼做？
第一次執行會只列出偵測到的名稱，回傳 INSTALL_NEEDS_CONSENT，且不寫入任何檔案。你同意後才建立隔離的橋接區域，日常指令改用「接力：」開頭；舊進度不會被讀取、遷移或覆寫。
它會自動判斷哪個模型比較擅長嗎？
不會。它只保存可接手的工作狀態，不替模型打分。你可以依任務、實際輸出、額度與自己的偏好決定何時切換。
可以讓 Claude Code 和 Codex 同時工作嗎？
請依序交班，不要讓兩邊同時修改同一筆任務。系統有修訂版檢查與備份降低覆寫風險，但不能把同時寫入變成零風險。
Claude Code × Codex × fresh sessions
Switch chats or models.
Switch chats or models.
Keep the progress.
Keep the handoff-ready work state in your project. A fresh chat in the same tool—or the other tool—can continue from the same local files.
No manual project download · Python 3.10+ required · No Obsidian · No account or telemetry
C
Claude Coderecords progress
Current taskACTIVE
✓Decision recorded
Next step preserved
Blocker made explicit
the same physical folder
G
Codexcontinues the work
Why it matters
Carry the useful state, not the whole chat
Goals, completed work, decisions, blockers, and next steps are written by a deterministic local program to readable Markdown. This works for a new chat in the same tool and for Claude Code ↔ Codex handoffs.
🪟
Same tool, fresh chat
Move from one Claude Code or Codex session to another without replaying the entire conversation.
⇄
Claude Code ↔ Codex
Choose each tool by its actual output, your task, preference, or remaining quota. The bridge does not invent model rankings.
☑
Ask what is unfinished
List active and blocked tasks, their latest update, and the next action in plain language.
Guided setup
Set it up once, then use plain language
You do not download a ZIP, unzip a repository, or move its files. Create a safe empty folder, then paste one short prompt into Claude Code or Codex. The AI downloads a pinned installer to the OS temporary directory, checks its hash, and runs it.
Use a new, empty test folder first.Do not test in a folder containing patient records, unredacted personal data, passwords, API keys, credentials, or other sensitive material.
1
Create an empty folder inside Documents
Windows
- Open File Explorer.
- Select Documents.
- Right-click → New → Folder.
- Name it “AI Progress Bridge Test”.
- Open this folder as the project in Claude Code or Codex.
macOS
- Open Finder.
- Select Documents.
- Choose File → New Folder.
- Name it “AI Progress Bridge Test”.
- Open this folder as the project in Claude Code or Codex.
Do not open the drive root, your home directory, or the Desktop root as the project.
Python 3.10 or newer is required.If you are unsure, the prompt below tells the AI to check first. If Python is missing or too old, the AI must stop without changing the project and guide you through installing a current version.
2
Paste this into either tool
Paste it once into Claude Code or Codex. The AI—not you—handles the download and integrity check.
Install Cross-AI Progress Bridge in the currently open project. First confirm that Python 3.10 or newer is available. If Python is missing or too old, stop, do not modify the project, and guide me through installing a current version in plain language. Download https://raw.githubusercontent.com/Nouischen/cross-ai-progress-bridge/v1.0.0/bootstrap/install.py to the operating system temporary directory and verify that its SHA-256 is exactly 9D5BD5DBDCD2436CD669C419B9731839B1B4E5E080E8C7BCA366915FC63CBA01. If it differs, stop and do not use another source. If the hash matches, run it with Python 3.10 or newer and point --target to the current project. If it returns INSTALL_NEEDS_CONSENT, list the detected names and ask whether I approve isolated sidecar mode; do not rerun without my explicit approval. Only after I approve, rerun with --mode sidecar --accept-existing I_ACCEPT_SIDECAR. Perform the installation instead of merely explaining it, then report the installed mode, everyday trigger phrase, and simple functional test.
If a permission dialog appears, confirm that it is limited to the current test folder and the OS temporary directory. Never ask the AI to bypass a hash mismatch, unsafe-location rejection, or installer error.
3
Test a real handoff
Test whether one session can save and another fresh session can read:
In the installing session, ask it to create a task named “First handoff test,” set the next step to “check it from another fresh session,” and record progress.
Start a fresh session in the same tool or the other tool. Open the exact same physical folder, then ask:
我有哪些進度還沒做完的？After “First handoff test” appears, ask:
繼續 First handoff testand confirm that it reads the saved next step.The everyday command surface is currently Traditional Chinese. No status badge is required for normal use.
Everyday language
Three phrases cover normal use
The local program handles file names, Markdown structure, backups, and revision checks.
記錄進度Record or update the current task.我有哪些進度還沒做完的？List active and blocked work with next steps.繼續上次進度Resume it when only one task is unfinished; if several remain, choose from a short list.繼續某任務Resume a task by its title.Compatibility
Isolated coexistence, not forced integration
If the installer sees names that suggest an existing instruction or progress system, it returns INSTALL_NEEDS_CONSENT and makes no changes. It installs its own sidecar area only after explicit approval.
The sidecar prefix
Your old progress records are left unread and unmodified. The installer first backs up, then appends a removable marked block to the Claude/Codex entry files. Bridge requests begin with 接力：, keeping the two command spaces separate.
1️⃣
Name-only detectionBefore consent it lists potentially relevant names; it does not read their contents or write files.
2️⃣
No migration, reading, or overwrite of old progressIt does not convert legacy tasks or pretend that two status systems are equivalent.
3️⃣
Its files stay in its own areaNew tasks live under AI_PROGRESS. Marked entry instructions are backed up before modification.
Local & auditable
Readable files in your project
There is no backend, account, database, or telemetry. The public GitHub repository supplies a pinned installer; task content remains in the currently open local project.
Designed for
- Plain Markdown task files
- Pinned installer URL and SHA-256 check
- Backups before bridge-owned entry changes
- Revision checks against stale writes
- One writer at a time
Do not store
- Unredacted patient or personal data
- Passwords, API keys, credentials, or private keys
- Notes you do not want either AI to read
- A task being edited by both tools at once
- Data requiring automatic cloud sync
FAQ
Important boundaries
Can ordinary ChatGPT or claude.ai web chats use it?
Not by themselves. This bridge requires tools that can read and write the same local project folder, such as Claude Code and Codex.
Does “no manual download” mean no prerequisite?
No. Python 3.10 or newer is required. The AI handles downloading and checking this project’s installer; if Python is missing or too old, it must stop before project changes and help you install a current version.
Can I use a Git repository?
Yes, only when both tools open the same physical checkout. Different worktrees may share a project name while containing different uncommitted files. Use a clean Documents folder for your first test.
Does sidecar mode merge my old tasks?
No. It deliberately does not read, migrate, or overwrite old progress. It creates an isolated task area and uses the 接力： prefix.
Can both tools edit at the same time?
Use sequential handoffs. Backups and revision checks reduce stale overwrites, but they do not make simultaneous editing risk-free.
Start a fresh chat without starting over.
Create a clean, non-sensitive folder inside Documents, let the AI install the pinned bridge, then retrieve the test task from another fresh session.