跳到主要內容
Tinkers|自由人

生活走在前面,工作順手做完

加入自由人
研究與解法公開第 1 版

Codex 額度用完,Claude Code 怎麼接手?

Taker

Codex 額度用完,Claude Code 怎麼接手?

如果你使用 Coding Agent 開發工具,總有一天會碰到額度不足,或想換成另一個 Agent 繼續工作。

好消息是:你不需要把整段聊天紀錄重新講一次。 真正要交出去的是「專案目前長什麼樣子」和「接下來要做什麼」。

這篇用三個觀念——專案資料夾、Git、Handoff——讓你理解接力怎麼進行。就算從沒用過 Git,也能直接把下面的指令交給 Coding Agent,請它帶著你完成。

一眼看懂:三份交接資訊

Codex(正在開發)
      ↓
同一份專案資料夾(程式碼目前的樣子)
      +
Git(哪些修改已保存成版本,還有哪些沒提交)
      +
HANDOFF.md(目標、進度、測試、下一步)
      ↓
Claude Code(先檢查、向你報告,再接續開發)
名詞 白話意思 交接時的作用
專案資料夾 網站或 App 的程式碼與檔案所在之處 讓下一個 Agent 能讀到實際成果
Git 記錄程式碼變更歷史的工具 知道哪些改過、保存在哪個版本、哪些還沒提交
Commit Git 裡一次有意義的版本紀錄 保存已確認的修改,方便追溯
HANDOFF.md 交接說明文件 解釋目前目標、進度、未完成工作和測試

Git 不是 GitHub。Git 可以只在本機使用;GitHub 是放置及協作管理 Git 專案的線上服務。若兩個 Agent 在不同電腦或雲端環境,還需要確保它們能讀到同一份專案與交接資料。

Git 新手只需要先懂這件事

想像你的網站逐步完成:

commit 01   首頁完成 ✓
     ↓
commit 02   登入功能完成 ✓
     ↓
目前工作中   表單驗證尚未完成 …

你可以把 commit 當成「留下可追溯的版本紀錄」。但 尚未 commit 的修改也可能在專案資料夾中,所以不能看到 Git 就以為所有東西都已經保存。

不用急著背 git add、git commit 等指令。先請 Agent 用白話解釋目前 Git 狀態,讓它提議如何安全地保存,確認後再操作。

實際交接:三個時刻

第一次:先建立交接機制

使用下面的指令 A,請 Coding Agent 確認 Git、檢查敏感資料和工作狀態,規劃 HANDOFF.md。這一步先檢查,不要讓 Agent 直接改檔。

準備換人:請原 Agent 整理工作

在還能操作原 Agent 的時候,用指令 B產生或更新 HANDOFF.md,並確認程式修改怎麼保存。

若原 Agent 額度已用完也不要緊;下一個 Agent 仍能從現有程式碼與 Git 狀態盤點,只是可能需要更多時間重建意圖。

開始接力:下一個 Agent 先盤點再動手

開啟同一個專案,使用指令 C。讓它先報告現況、測試與下一步,經你確認才開始修改。

三段可直接複製的指令

指令 A|第一次建立交接機制

請協助我把這個專案設置成可以由不同 Coding Agent 接力開發的狀態。

先不要修改檔案或建立 commit。請先:
1. 確認目前所在的專案資料夾,以及是否已經初始化 Git。
2. 查看 git status、最近的 commit、尚未追蹤的檔案。
3. 檢查 .gitignore,避免把 .env、密碼、API keys 或其他敏感資料加入版本紀錄。
4. 說明現在有哪些完成、未完成與不確定的工作。
5. 提議建立或更新 HANDOFF.md,記錄目標、進度、測試、風險與下一步。

先給我一份白話檢查報告和預計操作清單,等我確認後再執行。

指令 B|交接前整理進度

請將目前專案交接給下一位 Coding Agent。

先檢查 Git 狀態、目前修改與測試結果,確認不會把敏感資料提交。
請整理或更新 HANDOFF.md,內容包含:
- 專案目標與目前正在解決的問題
- 已完成項目與相關 commit
- 尚未完成事項與下一步
- 已執行的測試、結果及尚未驗證的部分
- 操作環境、必要指令與可能的風險

如果有未完成的修改,不要擅自丟棄或覆寫。先列出差異,提出安全的保存或提交方式,待我確認後處理。
完成後告訴我下一位 Agent 應先讀哪些資料。

指令 C|請新的 Agent 接手

你現在要接手這個程式專案。請先不要修改程式碼。

請閱讀 HANDOFF.md(如果有)、檢查 Git 工作樹與最近的 commits,並自行了解專案結構。
請先回覆我:
1. 現在專案在做什麼,已經完成哪些部分?
2. 有沒有未提交的修改或衝突?
3. 目前有哪些測試結果,哪些還需要驗證?
4. 建議下一個小步驟是什麼?如何驗收?

如果沒有 HANDOFF.md,請根據現有程式碼、Git 與文件盤點,不要猜測前一位 Agent 的意圖。
等我確認後,再繼續開發。

最後檢查:不要只交一個文字檔

  • 下一個 Agent 可以取得同一份程式專案。
  • 已檢查 Git 工作樹,知道哪些修改還沒提交。
  • 沒有把密碼、API Key、.env 等機密加入 Git。
  • Handoff 有記錄目前目標、未完成項目與測試結果。
  • 下一個 Agent 先向你報告計畫,再繼續開發。

最值得記住的一句話:Git 交代「程式發生了什麼」,Handoff 交代「接下來要做什麼」。 有了這兩份線索,換 Agent 就不必從零開始。

自由人可在這裡討論與回饋。 登入