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

本文目錄

Codex 換電腦，先盤點實際專案資料夾、CODEX_HOME/config.toml與專案.codex/config.toml設定，以及CODEX_HOME/sessions/和archived_sessions/對話紀錄。CODEX_HOME預設是~/.codex，專案檔案則在你選擇的工作資料夾。新機優先重新登入，憑證另行保護；找到對話紀錄不等於完整桌面歷史、外部工具與執行環境已恢復。狀態位置、對話紀錄位置、登入儲存方式。

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

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

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

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

搬家清單按資料角色分開，不按某個資料夾全選
資料	保存目的	新機檢查
專案檔案	程式、文件、圖片、尚未提交的修改	檔案與版本是否正確
規則與設定	AGENTS.md、相關設定、自己的技能來源	路徑、依賴與權限是否適用
對話與交接	決策、未完成項目、驗證紀錄	能否讀取，能否理解下一步
登入與連線憑證	維持受控的帳號存取	優先重新登入，另行安全處理

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

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

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

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

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

預設位置只供盤點；自訂環境與管理政策可能改變答案
資料	常見位置	搬家時確認
專案成果	你實際開啟的工作資料夾	程式、文件、未提交檔案與Git依賴
使用者設定	`$CODEX_HOME/config.toml`；預設`~/.codex/config.toml`	另有`$CODEX_HOME/名稱.config.toml`等profile；內容先檢查機密與舊路徑
專案設定	專案內`.codex/config.toml`與`AGENTS.md`	設定層與信任／管理要求分開核對
對話紀錄	`$CODEX_HOME/sessions/`、`$CODEX_HOME/archived_sessions/`	私人紀錄可能含工作資料；可讀檔案不是完整App還原規格
登入與其他狀態	依設定為`auth.json`或OS憑證庫；SQLite位置可能另設	憑證與不明狀態另行保護，不當成普通對話檔匯入

Windows常見預設根目錄是%USERPROFILE%\.codex；macOS／Linux為~/.codex。WSL應按該Linux使用者環境確認，不能假定與Windows共用同一份。CODEX_SQLITE_HOME可指定SQLite狀態位置，且sqlite_home設定優先；不是只找一個資料夾就一定找齊。設定層、環境變數。

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

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

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

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

整理判斷一：先按資料角色分流，再決定備份邊界。 CODEX_HOME同時可能含設定、對話、驗證與其他狀態，所以不能把整個目錄當成可分享的聊天資料包。auth.json含權杖；憑證也可能在OS儲存區。對用途尚未確認的狀態檔或資料庫，本篇不將它列為可直接跨機匯入的普通對話檔；先保護私密副本、確認版本與用途，再安排受控復原。狀態分類、驗證與憑證儲存。

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

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

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

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

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

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

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

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

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

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

Codex搬家流程：盤點專案、設定與對話位置，分離憑證與不明狀態，建立日期化備份，還原到獨立位置，再分別確認檔案一致、環境可用與一個小任務。對話紀錄位置不是完整App還原規格。 — Gwarket自製還原流程；每種檢查各自有能證明的範圍。

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

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

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

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

如果檔案已還原，卻卡在權限選項或執行限制，先依「Codex 權限模式無法使用的四層診斷」找出問題；確認環境可用後，再用「第一個 Codex 任務」選一個小範圍工作驗證。這只能確認受測任務能繼續，不代表所有舊流程都已恢復。

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

對話紀錄是否能直接接回介面，要按客戶端、帳號、版本和儲存方式確認。官方列出$CODEX_HOME/sessions/與archived_sessions/作為紀錄位置，但沒有把它們寫成任意兩台電腦間完整桌面狀態的通用匯入規格；history.jsonl也不能代替這份規格。保留重要決策的可讀交接摘要，讓紀錄暫時不可見時仍知道正確版本與下一步。官方紀錄位置、歷史與狀態說明。

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

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

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

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

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

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

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

合成練習用來示範檔案複製、還原與差異偵測：正常副本預期五檔一致，另改一份草稿的副本則應顯示差異。這項結果只能說明被比較的教學檔案，不能延伸成登入、跨系統相容或完整桌面對話已恢復。

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

整理判斷二：把位元組一致與工作可用分開驗收。 檔案雜湊回答「這份內容是否相同」，重新登入回答「此帳號現在能否驗證」，小任務回答「這條工作路徑能否繼續」；不能用其中一項代替另外兩項。若要保存SQLite等應用程式狀態，先停止相關寫入並保留原檔及旁檔，避免把變動中的資料庫當一致副本。官方狀態資料庫復原說明也要求先停用其他客戶端並從副本處理；其NFS專用遷移命令不屬於本篇一般搬家步驟。

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

不同檢查只能證明各自的範圍
檢查	能證明	不能證明
雜湊一致	被檢查檔案的位元組一致	所有依賴都已安裝
程式可以打開	應用程式可以啟動	對話、專案與設定全部正確
登入成功	該帳號驗證成功	所有外部服務都已授權
小任務可完成	受測工作路徑可用	所有舊工作流程都通過

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

Codex 備份還原常見問題

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

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

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

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

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

文件通常較容易攜帶，但Windows、macOS與WSL的路徑、腳本、依賴、權限和應用程式狀態仍須逐項確認。先用獨立位置核對必要工作，不以作業系統名稱相同或資料夾已複製作為完整恢復的證明。

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

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

下一步

權限模式無法使用的診斷：檔案已在新機，先分清管理要求與執行限制。
第一個Codex任務：用你能核對的小工作確認接續路徑。

資料來源與查證日期

資料來源與查證日期：2026-11-05。OpenAI：基本設定；設定與狀態；環境變數；登入驗證；對話紀錄位置；NFS狀態復原邊界。這些是當日動態文件，沒有單一完整桌面搬家保證；分類、圖解、交接與合成練習為本站方法。