OpenClaude 的 session 與背景工作：續跑、分支對話、不要誤抄另一套憑證

OpenClaude 的 session 到底是什麼：一輪對話會留下哪些東西

你在終端機敲下一行需求，畫面開始跳動，中間穿插「正在讀取檔案」「要不要執行這條指令」，收尾時吐出改了哪些行的差異。從按下 Enter 到這一輪結束，就是 OpenClaude 的一個 session（工作階段），可以把它想成「一次完整的工作紀錄」，而不是裝在電腦裡長跑的服務。

一輪對話的四個動作，你在畫面上會看到什麼

OpenClaude 是跑在終端機裡的 coding agent（會自己動手改程式的 AI 助手，專案在 GitHub 上）。它的核心是一條固定循環：你給提示，模型挑工具，工具動手做，結果串流回畫面。拆成四步就是：

• 你下提示：例如「把這個函式改成非同步」，這行字是一輪的起點。
• 模型挑工具：先決定要讀哪些檔案、要不要搜關鍵字。內建工具有執行指令、讀寫檔案、grep、glob。
• 工具真的動作：真的開檔、真的跑指令。這一步會動到硬碟，所以敏感動作會先停下來問你同不同意。
• 串流 diff：改動即時以差異形式印出，你能邊看邊決定要不要喊停。

回頭查得到的紀錄：改了什麼、花多少

一輪跑完後，留下三種可以回頭看的紀錄。

• /diff：改過哪些檔案、每一行怎麼變，想反悔先看這個。
• /rewind：把對話與檔案狀態倒回前面某個時間點。
• /cost：這一段用掉多少，走雲端模型時特別有感。

它也支援非互動的 --print 與背景執行 --bg，背景工作用 ps、logs、kill 管理。它其實是你本機開出來的子行程，不是常駐服務，終端機關掉就沒了；官方的 attach 目前只能接回日誌。

為什麼這些紀錄不會寫進 Claude Code 的資料夾

OpenClaude 的設定與紀錄預設放在自己的家目錄 ~/.openclaude，不去讀 Claude Code 的 ~/.claude。這個切開是刻意的：兩邊憑證與設定格式不同，整包複製過去很容易把金鑰裝錯家。要搬家，只搬你自己為 OpenClaude 寫的設定與技能檔就好。

還有一個容易誤會的細節：部分環境變數名稱沿用舊專案，例如接 OpenAI 後端時仍叫 CLAUDE_CODE_USE_OPENAI=1，看到這串不代表你在跑 Claude Code。

導入前值得先想清楚的是，session 裡最有價值的內容，其實是被讀進去的程式碼與 diff。走本機模型時，它留在你自己的機器；走雲端或第三方閘道時，會經過對方的伺服器。這條界線先跟團隊講明白，比事後補救容易得多。

續跑與分支對話：/diff、/rewind 與非互動 –print 怎麼分工

續跑是在同一個對話接下一句；/diff 列出這輪動過的檔案；/rewind 退回某一步換方向再問，也就是分支對話；--print 跑完就結束。混著用最容易出車禍：走偏五輪還在同一對話補救，錯誤推理留在上下文越修越歪；或它說「我改好了」就直接進版控，後來才發現不相干的檔案也被動過。

先看它動了什麼：/diff 配上續跑

/diff 的價值在驗收：下完任務先看 diff，再決定要不要進版控。續跑讓它記得讀過的檔案與結論，不必重新解釋專案背景，但脈絡越長越容易把走錯的假設一起帶進來。同一個任務可以續跑，任務換了就不要硬續。

走錯路時：/rewind 是分支對話的實際操作

/rewind 退回某一步，從分岔點換問法甚至換模型重跑，走不通的推理被拿掉，上下文乾淨，答案通常也跟著回來。對話層交給 /rewind，檔案還原交給 git：先 /diff 看檔案被動到哪裡，該還原的用版控還原，再 /rewind 換條路重問。

非互動的 --print 把指令與任務一起丟進去，跑完輸出結果就結束，適合寫進腳本、排程或自動化流程。背景模式在本機是子行程，不是常駐服務，電腦關了就沒了。

台灣團隊落地順序：先用本機 Ollama 把這三件事跑熟，再考慮接雲端金鑰。續跑與分支對話會把程式碼與 diff 帶進上下文，本機模型留在自己機器，雲端或第三方閘道會經過對方伺服器；預設推薦的閘道之一是合作廠商的雲端服務，資料敏感的客戶記得切回自架端點。

• 任務沒換就續跑，任務換了就重開或 /rewind。
• 每次下完任務先 /diff，再決定要不要進版控。
• 檔案還原交給 git，對話還原交給 /rewind。
• 要它自己跑完一遍用 --print，別把背景模式當常駐服務。

背景工作實戰：--bg 開一條本機子行程，ps／logs／kill 收尾

十幾分鐘的任務，整包 repo 掃關聯、跑完測試、對幾十個檔案做同樣修法，OpenClaude 在本機開一條子行程（child process，作業系統裡獨立的執行單位）接手，終端機當場還你。它不是服務：沒有常駐程序、開機自動啟動、斷線重連；關掉終端機或重開機，子行程就消失，做到一半的停在那裡。

四個動作，對應四種心情

• --bg 丟出去。任務加上它，工作轉背景。
• ps 看它還活著嗎。列出背景工作、編號與狀態。
• logs 看它做到哪。讀出工具呼叫與改了哪些檔，這是你唯一的窗戶。
• kill 收掉。依編號終止。

attach 官方目前只接到 logs，還沒做到完整重接終端畫面（可對照官方指令文件）。白話說：能「看」它，不能「接手打字」。需要人中途點頭的權限確認，丟到背景只會卡住。

哪些適合丟背景，哪些丟了難收尾

• 適合：唯讀掃描與整理。全 repo 找函式被誰用到、整理相依清單、補註解，跑完看 diff。
• 適合：測試與建置重跑。丟背景跑，你同時讀下一段程式。
• 不適合：需要中途核准。刪檔、覆寫、對外發請求會跳權限閘門，沒人按就停住。
• 不適合：需要邊看邊改方向的探索，想立刻喊停、換說法，背景做不到。
• 不適合：資料敏感任務又走第三方閘道，容易忘記它正把內容送到哪。

收尾：kill 之後、或跑完之後，回 repo 用 git status 與 /diff 確認它動了什麼。背景工作不會幫你進版控，也不會備份。

輔導台灣客戶時，我們要求先在本機模型跑一輪，再放行雲端金鑰。背景任務要事後翻 logs 才看得懂，一開始就拿公司雲端金鑰跑，等於送出一堆沒人盯著的請求，追帳與追資料邊界都麻煩。先在本機端點確認 logs 讀得懂、kill 收得乾淨，再接正式環境。

替代方案有限公司觀點：台灣團隊先顧資料邊界，再談手感

客戶最常問三件事：程式碼會不會出國、能不能不綁死一家雲、同事已會的終端機指令能不能留著。先決定資料可以去哪，再決定工具順不順手，順序反了後面很難補。

先把資料邊界畫出來，再挑模型

OpenClaude 是終端機裡的寫程式助理，官方說法是「一套工作流，後面換模型」，可接超過 40 種後端，含 OpenAI、Gemini、Grok，也含本機的 Ollama 與 LM Studio（來源：openclaude.gitlawb.com 文件，2026-09）。操作習慣不用換，模型可以換成本機跑的那一顆。

建議順序反過來：先用本機 Ollama 把讀 repo、改檔、看 diff 走完，確認流程順、logs 看得懂，再決定要不要接既有雲端金鑰。本機模型不把程式碼送出機器邊界；接上雲端金鑰後，每段程式碼都變成對外請求，事後追資料流向麻煩很多。

手感可以留，憑證與授權要看清楚

它刻意做成接近 Claude Code 的手感，斜線指令、工具呼叫、串流 diff 都很像，官方寫明是從 Claude Code 程式碼改出來再接多後端（來源：GitHub README，2026-09）。設定目錄預設是自己的家目錄，不讀另一套設定，也不要整包複製舊工具的憑證。

授權欄為 NOASSERTION，LICENSE 自寫底層衍生程式仍屬 Anthropic 著作權、未取得授權散布專有原始碼（來源：Gitlawb/openclaude LICENSE，2026-09），這是我們不建議當正式產線預設的主因。GitHub API 於 2026-09-06 量到約 3 萬 2 千顆星、9 千多個 fork，fork 數相對星數偏高，品質落差可能不小。

我們的落地建議

實際要試分三段：一，找一台不進版控的乾淨測試機，用本機模型跑真實但不重要的 repo，讓同事走一次工具迴圈與 diff 流程。二，把資料邊界寫成一張規則：哪些 repo 可以碰、哪些雲端金鑰不准放、預設走哪個端點。三，才評估要不要接既有雲端金鑰或企業端點。

同事不用重學指令，導入成本低。但台灣客戶的程式碼常有客戶名單、未申請專利的做法、合約商業邏輯，離開自己的機器就很難收回。先顧資料邊界、再談手感，省下訓練時間，賠上的是很難跟客戶解釋的信任。本文只轉述授權、不做法律結論，採用前請法務與資安一起看過。

設定與憑證別互抄：~/.openclaude 與 ~/.claude 是兩個抽屜

已經在用 Claude Code 的人，第一個反射動作常是把 ~/.claude 整個複製改名。這件事不要做。官方 README 的設定搬遷那節寫得很白：OpenClaude 設定目錄預設是 ~/.openclaude，而且不會去讀 Claude Code 的 ~/.claude。把 home 想成辦公桌的兩個抽屜，兩套工具各開一個，裡面長得像，但不是同一份，也不會互相流通。

搬錯的代價不只是「設定沒生效」。~/.claude 放著綁在 Anthropic 帳號上的登入憑證，複製到另一邊不會讓 OpenClaude 突然能用，只是多一個地方要記得清掉。

兩個抽屜裡各自放什麼

~/.openclaude 是 OpenClaude 自己的家，~/.claude 是 Claude Code 的家；同樣叫 settings、同樣叫 skills，歸屬不同。

OpenClaude 要接的是你自己選的後端，可能是筆電上的 Ollama，也可能是公司原本在用的雲端端點，金鑰是你在 /provider 存進 ~/.openclaude 的，跟 Anthropic 的登入狀態無關。

從 Claude Code 搬過來，只帶自己寫的東西

能帶的是你自己寫的 settings 與 skills，那是你的 know-how；凡是登入、token、憑證這類「證明你是誰」的檔案，一律不要帶。

• 可以帶：自己寫的 settings、自己維護的 skills。
• 不要帶：Anthropic 的登入憑證與帳號相關檔案。
• 搬完之後：用 /doctor 檢查一次，確認它讀到的是 ~/.openclaude 而不是別的地方。

還有個容易搞混的點：OpenClaude 有些環境變數捷徑沿用舊專案的名字，切到 OpenAI 相容後端時變數仍叫 CLAUDE_CODE_USE_OPENAI=1。名字裡有 CLAUDE_CODE 不代表它在動你 Claude Code 的設定，讀寫的還是 ~/.openclaude 這個抽屜。

台灣中小團隊常見的狀況是，「兩套東西長得像」比模型選得好不好更容易出事：IT 看到兩個目錄直覺就是同步，一旦同步，之後要查金鑰從哪裡來就得翻半天；公司接標案或客戶合約時，金鑰歸屬講不出來很難看。LICENSE 也寫明底層衍生程式仍屬 Anthropic 著作權、本專案沒有取得散布原作專有原始碼的授權（我們只轉述，不做法律判斷），落地結論很簡單：兩邊的設定與憑證不要混著放。

常見問題 FAQ

Q：我以前裝過 Claude Code，那把它的設定檔跟登入憑證整包複製到 OpenClaude 就好了吧？
不行，這是最容易踩的坑。OpenClaude 的設定目錄預設是自己的 ~/.openclaude，不會去讀 Claude Code 的 ~/.claude，兩邊是切開的。遷移時只複製你自己為 OpenClaude 寫的 settings 或 skills，千萬不要把 Claude Code 的 auth 憑證複製過去。另外提醒一下，它有些環境變數捷徑還沿用舊專案的名字（例如 CLAUDE_CODE_USE_OPENAI=1），所以不要看到變數名稱就以為是在設定 Claude Code，兩家其實不一樣。

Q：用 --bg 丟到背景跑之後，我可以把終端機關掉、它會自己一直在後面跑嗎？
不行，背景工作是「本機的子行程」，不是常駐的 daemon 服務。你可以用 ps 看目前有哪些在跑、用 logs 追它的輸出、用 kill 把它停掉。目前 attach 只能帶你去看 logs，要完整重新接回那個終端畫面還沒做，所以別把它想成關掉視窗也會默默幫你顧著的服務。

Q：跑到一半發現方向錯了，或是想看看它到底改了哪些東西，有指令可以處理嗎？
有。/diff 可以看它改了什麼，/rewind 可以退回前面的狀態，/cost 則讓你知道目前為止花了多少。如果是不想一直盯著畫面、要讓任務在背景繼續，就用 --bg 那組指令搭配 ps、logs 來追蹤，有狀況再用 kill 收掉。

📩 有任何問題或需要協助，歡迎聯絡我們：[email protected]