Codex 換電腦怎麼搬？專案、設定與對話的備份還原教學

本文目錄

Codex 換電腦，先備份專案成果與工作脈絡，再處理設定和登入。把一個 .codex 資料夾複製過去，不等於專案、對話、外部工具和執行環境都已恢復；真正的完成標準，是新電腦能開啟正確版本，並安全地接續工作。

這篇把搬家拆成四類資料、五個步驟與一個隔離還原練習。你不必先碰自己的登入憑證，也能用教學包理解：什麼叫檔案複製成功，什麼叫工作真的能繼續。

練習材料：下載搬家檢核表、合成專案與還原驗證程式。只使用教學檔，不會讀取你的 Codex 主資料夾、真實對話或登入資料。

Codex 搬家，到底要搬哪些東西？

先分清專案、設定、對話脈絡與憑證。它們的保存位置、敏感程度和還原方式不同，不適合直接打包成一個公開可分享的壓縮檔。

雲端專案、遠端主機和本機專案也不是同一種資料。先問自己：程式實際在哪裡執行，成果存在哪裡？如果答案是另一台主機，把這台電腦的設定搬走，並不會一併搬走遠端檔案或服務。

專案與 Codex 設定通常在哪裡？

專案位於你實際開啟的工作資料夾，不一定放在 Codex 的應用程式資料目錄。先從目前工作的檔案位置確認，不要看到 .codex 就以為所有程式和成果都在裡面。

依 官方進階設定文件，Codex 本機狀態使用 CODEX_HOME，預設為使用者目錄下的 .codex；若你或管理員曾指定其他位置，預設路徑就不是答案。Windows 與 WSL 也可能各自有不同的使用者環境，請確認實際啟動位置。

官方基本設定文件區分使用者層的 config.toml，以及專案內 .codex/config.toml 的設定。這說明設定可能不只一份；它沒有保證任何版本的應用程式狀態都能靠複製同名資料夾完整恢復。

怎麼做一份不含機密的盤點表？

記下每個專案的目前位置、執行環境、使用版本、重要成果，以及有沒有尚未保存或提交的變更。設定檔先只記路徑與用途；不要把內容直接貼進公開文件，因為裡面可能有外部服務資訊或憑證。

技能與插件也要記錄來源和版本。自己寫的技能原始檔值得保留；安裝快取通常需要依新環境重新安裝或驗證，不能把舊快取存在當成插件一定可用。

哪些東西不能直接跟專案一起分享？

登入權杖、API 金鑰、.env、客戶資料與私人對話，先分開處理。備份可以含有敏感資料，但那份備份就必須依敏感資料的標準保護，不能順手放到公開 Git 儲存庫或教學附件。

OpenAI 官方驗證文件說明，登入快取可能使用 auth.json 或作業系統的憑證儲存區，取決於設定。檔案型憑證應像密碼一樣保護。本篇採新機重新登入，不教你把真實 auth.json 貼給 AI 或上傳到雲端公共連結。

重新登入與重新授權外部服務是不同事項。你可能已登入 Codex，但某個外部工具仍需要重新連線；也可能專案讀得到，卻因公司權限政策無法執行特定動作。不要為了快速排除錯誤就放寬所有權限。

需要交接給別人時，做一份經確認可分享的副本：只放必要成果、依賴清單、設定範例與不含機密的交接紀錄。私人備份與公開作品應維持不同的檔案，不靠口頭提醒他人「某幾個檔案不要看」。

舊電腦上的備份，怎麼做才不漏掉成果？

先保存工作、停止正在寫入的相關任務，再建立備份。如果你要備份應用程式狀態，應先完整結束對應程式及相關寫入程序；不要讓使用中的資料庫一邊變動、一邊被當成一致快照複製。

專案若使用 Git，先檢查目前分支和未提交變更。只有推到遠端的版本，不包括未追蹤的新檔、被忽略的素材或只存在本機的分支。反過來，也不要為了搬家就把所有忽略檔強制提交，裡面可能包含金鑰與大型暫存。

1. 列出要保留的專案、規則與成果，確認每一個實際位置。
2. 把可重建的套件、快取與不可重建的來源分開，記下重建方式。
3. 建立日期化副本，存到經確認的獨立備份位置，不覆蓋唯一舊版。
4. 保留檔案清單與重要檔案的 SHA-256 雜湊，用來比較複製前後內容。
5. 另外寫交接紀錄，包含現況、版本、下一步與不能改動的限制。

若專案使用 Git worktree，先確認它依賴的共用 Git 資料位置。某些 worktree 內的 .git 是指向外部位置的文字檔，不是完整歷史資料庫；只搬工作目錄，可能留下指向舊電腦的路徑。本篇練習不是 worktree 搬家工具，正式操作前應另行盤點這項依賴。

新電腦上，應該按什麼順序還原？

先還原到新建的測試位置，保留舊電腦與原備份。不要一開始就覆蓋新機已使用的 Codex 資料夾，否則還沒驗證就把兩套狀態混在一起。

順序可以是：安裝所需應用程式與執行環境、放入專案副本、比對檔案、調整經確認的路徑、重新登入，最後做一個小型工作測試。一次只改一層，出錯時比較容易知道是檔案、設定、依賴還是權限問題。

路徑變了，就檢查設定、捷徑與腳本中的絕對路徑。套件不能執行，先確認版本和安裝步驟；不要直接把舊電腦所有套件資料夾蓋過去。公司管理的設定則應服從管理政策，不用私人設定繞過限制。

初次打開專案，可以先讓 Codex 做唯讀檢查：它找到哪些文件、辨識的工作目標是什麼、哪些依賴尚未確認。確認理解正確後，再選一份可丟棄的測試檔驗證編輯，避免第一個動作就是部署或大量改寫。

舊對話一定會跟著回來嗎？

不能保證。對話是否可見，受到本機、雲端、帳號、版本與儲存方式影響。官方文件列出的 history.jsonl 等本機狀態，不應被當成整個桌面應用程式對話與索引的完整還原規格。

因此，關鍵工作另留可讀的交接摘要。它不是取代完整對話備份，而是降低「即使歷史暫時打不開，就完全不能繼續」的風險。摘要中的檔案與版本要能核對，不能只寫一句「沿用前面的決定」。

目前目標：完成教學用文件，不修改正式系統。
已完成：draft.md 的第一版內容。
重要來源：README.md、AGENTS.md、參考文件。
目前版本：填入實際分支或版本；不適用則註明。
下一步：核對 draft.md 的來源與文字。
不可改動：不公開憑證、不部署、不覆寫原始材料。
未完成驗證：新機尚未執行測試。

對話文字即使完整保留，也不能代替磁碟上的最新檔案。有時對話提到的是舊版路徑，或修改尚未保存。以實際成果為準，再用對話與交接紀錄補足決策原因。

怎麼用練習包驗證「有備份，也還原得回來」？

下載包內有五份合成檔案，涵蓋專案說明、工作規則、文章草稿、設定範例和交接紀錄。驗證程式只讀取包內的 fixture，並在練習資料夾下建立新的測試副本，不搜尋使用者主目錄，不讀取真實對話，也不連線登入。

解壓縮到新的練習位置。若電腦已有 Node.js，可在該資料夾執行 node verify-restore.mjs。程式建立來源檔案的雜湊清單，複製為備份，再還原到另一個新目錄，逐檔比較內容。

它另外在獨立的錯誤情境副本中改動一份草稿，確認比較程序確實抓得到差異。正常還原應全數一致；改過的副本應回報一份不一致。這項反向檢查避免把永遠顯示成功的程式誤當驗證工具。

本篇實際驗證的是合成檔案的複製、還原與差異偵測。沒有搬動使用中的 Codex 資料，也沒有完成跨作業系統、跨版本或完整桌面對話還原測試。這些限制保留在檢核表，不能因為五份檔案一致就全部勾選通過。

怎樣才算搬家完成，而不是只複製完成？

至少分成三層驗收：檔案完整、工具可用、工作可接續。第一層看內容和雜湊；第二層看應用程式、依賴、登入及必要連線；第三層看你是否能依原有規則完成一個小任務。

確認後仍保留舊機與備份一段符合你需求的時間，再另行安排清除。本文不提供自動刪除舊資料的捷徑：完成時間、敏感資料處理和回復窗口應由資料擁有者決定。

Codex 備份還原常見問題

專案已經推到 GitHub，還需要備份嗎？

要先看遠端沒有什麼。未提交檔案、私人素材、未推送分支及本機工作脈絡可能不在遠端。先盤點，再決定補哪一份，不把機密強制加入 Git。

把 auth.json 搬過去比較快嗎？

它可能含敏感權杖，而且不一定是你目前的登入儲存方式。本篇優先採新機重新登入；不要把真實憑證貼進聊天或放進公開附件。

Windows 搬到 Mac 或 WSL 可以照抄嗎？

文件通常較容易攜帶，但路徑、腳本、依賴、權限和應用程式狀態要重新確認。本篇沒有實測這些跨環境組合，因此不保證完整恢復。

看到備份壓縮檔就能清掉舊機嗎？

先解開並做還原驗證，確認關鍵工作能繼續再決定。備份的價值在於能取回，不在於資料夾裡多了一個檔案。

參考資料與驗證範圍

核查日期：2026-09-09。OpenAI：基本設定；OpenAI：設定與狀態位置；OpenAI：登入驗證。分類、交接與隔離演練為本篇原創方法，不是官方完整搬家規格。