1. 出差在外家里 Claude Code Agent 斷了怎么辦人在高鐵上手機(jī)彈出一條告警家里那臺(tái) Mac mini 上的 Claude Code Agent 已經(jīng) 20 分鐘沒有新輸出。你手里只有一部手機(jī)日志全在家里那臺(tái)機(jī)器的終端里。等晚上回到酒店再處理最好的排錯(cuò)現(xiàn)場(chǎng)早就沒了——進(jìn)程可能已經(jīng)退出滾動(dòng)緩沖區(qū)里的報(bào)錯(cuò)也刷沒了。這個(gè)場(chǎng)景我遇到過不止一次。遠(yuǎn)程運(yùn)維 Claude Code Agent 的核心訴求其實(shí)不是「遠(yuǎn)程桌面」而是保住終端現(xiàn)場(chǎng)。你需要的是手機(jī)能安全地連回家里那臺(tái)機(jī)器看到一個(gè)還在運(yùn)行的會(huì)話翻到斷點(diǎn)前的日志然后決定是繼續(xù)跑還是重啟。圍繞這個(gè)目標(biāo)我用三個(gè)工具搭了一條最小可用鏈路Tailscale 負(fù)責(zé)組網(wǎng)SSH 負(fù)責(zé)進(jìn)入tmux 負(fù)責(zé)?；?。三者各管一段不重疊也不需要公網(wǎng) IP更不用額外買一臺(tái) VPS 做跳板。先說清楚這套方案適合誰(shuí)家里有一臺(tái)長(zhǎng)期開機(jī)、跑 Claude Code 或類似 Agent 的機(jī)器Mac mini、NUC、舊筆記本都行你經(jīng)常出差或在外需要臨時(shí)查看和恢復(fù)任務(wù)你愿意花 20 分鐘做一次配置之后每次救場(chǎng)只要 1 分鐘。如果你只是偶爾用一下、機(jī)器隨時(shí)關(guān)機(jī)那這套方案的價(jià)值不大。為什么不用 Claude Code 自帶的遠(yuǎn)程能力我試過/rc在多數(shù)網(wǎng)絡(luò)下能用但救急時(shí)最怕的不是功能少而是連到一半斷掉。所以我準(zhǔn)備了一條更通用的路徑手機(jī) SSH 客戶端 → Tailscale 加密網(wǎng)絡(luò) → 家里的 Mac → tmux 持久會(huì)話 → Claude Code 與日志。這條鏈路不依賴某個(gè)產(chǎn)品的遠(yuǎn)程功能只要 SSH 能通就能救。Tailscale 在這里的作用是讓手機(jī)和 Mac 像在同一個(gè)私有網(wǎng)絡(luò)里。它會(huì)優(yōu)先嘗試設(shè)備間直連網(wǎng)絡(luò)條件不允許時(shí)也可能走 DERP 中繼但全程是端到端加密的。所以準(zhǔn)確說法是「優(yōu)先點(diǎn)對(duì)點(diǎn)、全程加密」而不是「絕對(duì)不經(jīng)過任何中繼」。這一點(diǎn)在排查連接慢的時(shí)候很關(guān)鍵后面會(huì)講。三個(gè)工具的分工可以這樣理解Tailscale 讓手機(jī)和 Mac 處于同一個(gè)私有網(wǎng)絡(luò)不把 SSH 端口暴露到公網(wǎng)SSH 讓你從手機(jī)進(jìn)入 Mac 的終端tmux 讓任務(wù)和會(huì)話留在 Mac 上手機(jī)斷線后依然繼續(xù)運(yùn)行。其中 tmux 是整套方案的關(guān)鍵——手機(jī)只是一個(gè)窗口真正的會(huì)話一直在 Mac 上。你切換 Wi-Fi、關(guān)掉 App、甚至短時(shí)斷網(wǎng)排查任務(wù)都不會(huì)跟著消失。配置之前安全邊界必須先說清楚。遠(yuǎn)程 SSH 很方便也意味著手機(jī)一旦丟失風(fēng)險(xiǎn)會(huì)放大。我的做法是優(yōu)先使用 SSH 密鑰不把 Mac 登錄密碼寫進(jìn)任何腳本、提示詞或聊天記錄只允許自己的 Tailscale 設(shè)備訪問絕不把 22 端口暴露到公網(wǎng)手機(jī)設(shè)置系統(tǒng)鎖和生物識(shí)別SSH 私鑰放在受保護(hù)的鑰匙庫(kù)限制可登錄用戶確認(rèn)密鑰登錄可用后再關(guān)閉密碼認(rèn)證對(duì)能操作生產(chǎn)環(huán)境的 Agent 再加一層人工確認(rèn)不讓遠(yuǎn)程連接等于無(wú)限權(quán)限。密碼應(yīng)該由本人交互輸入或者干脆改用密鑰認(rèn)證不要交給 AI 去「幫你配」。2. TaoToken 統(tǒng)一 Key 通道的前置準(zhǔn)備Agent 能遠(yuǎn)程連上了下一個(gè)問題是Claude Code 本身怎么穩(wěn)定地拿到模型能力。如果你在家里那臺(tái)機(jī)器上用的是某個(gè)臨時(shí) Key或者每個(gè)項(xiàng)目各配一份出差時(shí)想換通道就得改一堆文件非常麻煩。我的做法是把 Claude Code 的 Base URL 統(tǒng)一指向 TaoToken 的 API 通道用一把 Key 管所有調(diào)用。TaoToken 在這里扮演的是統(tǒng)一入口官網(wǎng)是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。它的價(jià)值在于你不需要在每臺(tái)機(jī)器、每個(gè)項(xiàng)目里維護(hù)不同的供應(yīng)商配置只要把 Base URL 和 Key 寫對(duì)Claude Code 就能通過同一條通道請(qǐng)求模型。對(duì)遠(yuǎn)程運(yùn)維來說這一點(diǎn)很重要——你在手機(jī)上改配置時(shí)只需要確認(rèn)一個(gè)地址和一把 Key而不是翻五個(gè)文件。前置準(zhǔn)備分三塊。第一塊是賬號(hào)與 Key登錄 TaoToken 控制臺(tái)在 API Keys 頁(yè)面創(chuàng)建一把 Key。建議按用途命名比如home-agent方便以后區(qū)分和吊銷。創(chuàng)建后立刻復(fù)制保存頁(yè)面通常只顯示一次。控制臺(tái)地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite API Keys 頁(yè)面是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 。第二塊是確認(rèn)模型 ID。Claude Code 走的是 Anthropic 兼容協(xié)議你需要知道當(dāng)前可用的模型標(biāo)識(shí)?？梢栽谀Ｐ蛯?duì)話頁(yè)面先手動(dòng)發(fā)一條消息驗(yàn)證通道是否正常地址是 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 。如果對(duì)話能正常返回說明 Key 和通道都沒問題再去配 Claude Code 就少一層變量。第三塊是網(wǎng)絡(luò)與機(jī)器狀態(tài)。家里那臺(tái) Mac 要確認(rèn)三件事Tailscale 已登錄且在線、遠(yuǎn)程登錄已開啟、tmux 已安裝。這三件事在上一節(jié)已經(jīng)講過這里再?gòu)?qiáng)調(diào)一次順序——先保證 SSH 能進(jìn)再改 Claude Code 配置。否則你改完配置發(fā)現(xiàn)連不上機(jī)器會(huì)分不清是網(wǎng)絡(luò)問題還是配置問題。關(guān)于 Key 的管理我踩過的坑是早期把 Key 直接寫進(jìn)了 shell 的~/.zshrc結(jié)果換機(jī)器時(shí)忘了同步Claude Code 一直報(bào) 401。后來改成用環(huán)境變量文件單獨(dú)管理并且在家里那臺(tái)機(jī)器上只保留一份。這樣遠(yuǎn)程 SSH 進(jìn)去后source一下就能用也不會(huì)污染其他項(xiàng)目。如果你打算長(zhǎng)期跑 Agent而不是臨時(shí)救場(chǎng)可以考慮 Coding Plan地址是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 。它更適合持續(xù)性的編碼和 Agent 任務(wù)Key 和通道的管理也更集中。臨時(shí)救場(chǎng)用按量 Key 就夠了長(zhǎng)期跑再上 Plan這是我自己的選擇邏輯。還有一點(diǎn)Claude Code 的配置改動(dòng)建議在 tmux 會(huì)話里做而不是新開一個(gè) SSH 窗口。原因很簡(jiǎn)單——你改配置、重啟 Claude Code、觀察輸出這一串動(dòng)作都在同一個(gè)會(huì)話里手機(jī)斷線也不會(huì)丟現(xiàn)場(chǎng)。這正是 tmux 的價(jià)值所在。3. 可復(fù)制的 Tailscale、SSH、tmux 與 settings 配置這一節(jié)給可直接復(fù)制的配置。分四部分Tailscale 子網(wǎng)與設(shè)備、SSH 免密、tmux 會(huì)話、Claude Code 的 settings 片段。每一步都說明改哪個(gè)文件、寫什么內(nèi)容、怎么驗(yàn)證。先說 Tailscale。家里 Mac 和手機(jī)都安裝 Tailscale 并登錄同一個(gè) tailnet。Mac 端記下它的 Tailscale 地址通常是100.x.x.x也可以啟用 MagicDNS 用設(shè)備名訪問。如果你希望手機(jī)能訪問家里其他設(shè)備比如路由器管理頁(yè)可以在 Mac 上開啟子網(wǎng)路由# macOS 上開啟 IP 轉(zhuǎn)發(fā)臨時(shí)重啟失效 sudo sysctl -w net.inet.ip.forwarding1 # 宣告子網(wǎng)路由例如家里網(wǎng)段是 192.168.1.0/24 tailscale up --advertise-routes192.168.1.0/24然后在 Tailscale 管理后臺(tái)批準(zhǔn)這條路由。注意子網(wǎng)路由不是必須的如果你只需要 SSH 到 Mac 本身跳過這步即可。開啟后手機(jī)就能通過 tailnet 訪問家里網(wǎng)段的其他設(shè)備排查路由器、NAS 時(shí)有用。接著是 SSH 免密。在手機(jī) SSH 客戶端里生成一對(duì)密鑰Termius 等客戶端都支持把公鑰內(nèi)容追加到 Mac 的~/.ssh/authorized_keys# 在 Mac 上執(zhí)行確保目錄權(quán)限正確 mkdir -p ~/.ssh chmod 700 ~/.ssh touch ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys # 把手機(jī)客戶端的公鑰粘貼進(jìn)來示例替換成你自己的公鑰 echo ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAI... your-phone ~/.ssh/authorized_keysMac 端開啟遠(yuǎn)程登錄系統(tǒng)設(shè)置 → 通用 → 共享 → 遠(yuǎn)程登錄只勾選需要的用戶。確認(rèn)手機(jī)能用密鑰登錄后再考慮關(guān)閉密碼認(rèn)證。第一次連接時(shí)認(rèn)真核對(duì)主機(jī)指紋不要看到提示就直接點(diǎn)接受。tmux 部分。Mac 上安裝brew install tmux創(chuàng)建持久會(huì)話并啟動(dòng) Claude Code# 創(chuàng)建名為 lobster 的會(huì)話 tmux new -s lobster # 在會(huì)話內(nèi)啟動(dòng) Claude Code claude手機(jī)斷線后重新連接# 查看現(xiàn)有會(huì)話 tmux ls # 恢復(fù)指定會(huì)話 tmux attach -t lobster如果會(huì)話被意外關(guān)閉可以查看是否有殘留tmux ls 2/dev/null || echo no session最后是 Claude Code 的 settings 片段。Claude Code 讀取的配置文件通常在~/.claude/settings.json把 Base URL 和 Key 指向 TaoToken{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密鑰, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }如果你用的是項(xiàng)目級(jí)配置可以放在項(xiàng)目根目錄的.claude/settings.json內(nèi)容結(jié)構(gòu)相同。注意三點(diǎn)Base URL 用https://taotoken.net/api不要多加路徑Key 用你在控制臺(tái)創(chuàng)建的那把Model ID 用當(dāng)前可用的標(biāo)識(shí)不確定就先去模型對(duì)話頁(yè)面確認(rèn)。改完配置后在 tmux 會(huì)話里重啟 Claude Code讓它重新讀取 settings。如果你同時(shí)用 Codex 或 Cline它們的配置位置不同但三件套是一樣的Base URL、Key、Model ID。比如 Codex 的auth.json里同樣要寫全這三項(xiàng)缺一個(gè)都會(huì)報(bào)錯(cuò)。4. 驗(yàn)證請(qǐng)求與遠(yuǎn)程恢復(fù)的完整動(dòng)作配置寫完不算完必須驗(yàn)證。驗(yàn)證分兩層先驗(yàn)證 TaoToken 通道本身能通再驗(yàn)證 Claude Code 能通過這條通道正常請(qǐng)求。第一層用 curl 直接打 TaoToken 的 API。這一步在 Mac 上執(zhí)行確認(rèn) Key 和網(wǎng)絡(luò)都沒問題curl -sS https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密鑰 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: ping}] }如果返回里有content字段和正常的文本說明通道通了。如果返回 401說明 Key 不對(duì)或沒帶上如果返回模型不存在說明 Model ID 寫錯(cuò)了。這一步能把「網(wǎng)絡(luò)問題」和「配置問題」分開非常關(guān)鍵。第二層在 tmux 會(huì)話里啟動(dòng) Claude Code發(fā)一條簡(jiǎn)單指令比如「列出當(dāng)前目錄文件」。觀察它是否能正常返回。如果 Claude Code 報(bào)reading choices之類的解析錯(cuò)誤通常是返回體格式不符合預(yù)期先回到第一層確認(rèn) curl 是否正常。遠(yuǎn)程恢復(fù)的完整動(dòng)作我按順序列一遍。手機(jī)上打開 Tailscale確認(rèn)已連接狀態(tài)顯示 Connected。打開 SSH 客戶端用密鑰登錄 Mac。執(zhí)行tmux attach -t lobster恢復(fù)現(xiàn)場(chǎng)。先看日志和進(jìn)程狀態(tài)不要急著重啟# 查看 Claude Code 相關(guān)進(jìn)程 ps aux | grep -i claude # 查看最近的輸出如果 Agent 有寫日志文件 tail -n 100 ~/agent.log確認(rèn)問題后再?zèng)Q定是繼續(xù)跑還是重啟。如果是 Key 過期或配置被改改完 settings 后重啟 Claude Code。修復(fù)后驗(yàn)證服務(wù)、告警和關(guān)鍵任務(wù)是否恢復(fù)。整個(gè)過程都在 tmux 會(huì)話里完成手機(jī)斷線也不影響。這里有個(gè)實(shí)用技巧在 tmux 里開兩個(gè)窗格一個(gè)跑 Claude Code一個(gè)跑tail -f看日志。這樣你能同時(shí)看到 Agent 的輸出和日志的變化排查效率高很多。窗格操作是Ctrlb然后%垂直分屏Ctrlb然后方向鍵切換。驗(yàn)證成功后建議把這次恢復(fù)過程記一筆什么原因斷的、改了什么、怎么驗(yàn)證的。下次再遇到類似問題直接翻記錄比重新排查快得多。5. 常見報(bào)錯(cuò)排查401、local proxy failed 與 OAuth遠(yuǎn)程救場(chǎng)時(shí)最容易卡在幾個(gè)固定報(bào)錯(cuò)上。這一節(jié)按真實(shí)報(bào)錯(cuò)對(duì)照排查每個(gè)都給出定位方法和修復(fù)動(dòng)作。401 Unauthorized。這是最常見的。表現(xiàn)是 Claude Code 或 curl 返回 401提示認(rèn)證失敗。原因通常有三個(gè)Key 寫錯(cuò)或過期、Key 沒帶上、Base URL 指向了錯(cuò)誤的地址。排查順序先用第 4 節(jié)的 curl 命令單獨(dú)測(cè) Key確認(rèn) Key 本身有效再檢查settings.json里ANTHROPIC_AUTH_TOKEN是否和 curl 用的一致最后確認(rèn)ANTHROPIC_BASE_URL是https://taotoken.net/api沒有多余斜杠或路徑。如果 curl 通但 Claude Code 報(bào) 401多半是 Claude Code 沒讀到 settings檢查文件路徑和 JSON 格式。local proxy failed。這個(gè)報(bào)錯(cuò)通常出現(xiàn)在你本地配了代理但代理沒起來或端口不對(duì)。表現(xiàn)是 Claude Code 啟動(dòng)時(shí)報(bào)連接本地代理失敗。排查檢查環(huán)境變量里是否有HTTP_PROXY、HTTPS_PROXY指向了一個(gè)不存在的本地端口如果有先 unset 掉再試。注意這里說的是本地開發(fā)環(huán)境的代理配置不是網(wǎng)絡(luò)層面的方案兩者不要混。修復(fù)動(dòng)作# 查看當(dāng)前代理相關(guān)環(huán)境變量 env | grep -i proxy # 臨時(shí)清除當(dāng)前 shell 有效 unset HTTP_PROXY HTTPS_PROXY ALL_PROXYreading choices 解析錯(cuò)誤。表現(xiàn)是 Claude Code 收到返回后解析失敗提示讀取 choices 出錯(cuò)。這通常說明返回體不是預(yù)期的 Anthropic 格式可能是 Base URL 指到了 OpenAI 兼容端點(diǎn)或者 Model ID 不被支持。排查確認(rèn) Base URL 是https://taotoken.net/apiModel ID 是 Anthropic 系列標(biāo)識(shí)用 curl 看返回體的結(jié)構(gòu)正常應(yīng)該有content數(shù)組。如果返回體是choices結(jié)構(gòu)說明端點(diǎn)用錯(cuò)了。OAuth 相關(guān)報(bào)錯(cuò)。如果你之前用 Claude Code 的登錄流程做過 OAuth 授權(quán)切換 Base URL 后可能殘留舊的憑證導(dǎo)致沖突。表現(xiàn)是啟動(dòng)時(shí)提示 OAuth 失敗或憑證無(wú)效。排查檢查~/.claude/下是否有舊的憑證文件必要時(shí)清理后重新用 Key 認(rèn)證。注意這里說的是清理本地殘留憑證不是繞過任何認(rèn)證機(jī)制。連接超時(shí)或 Tailscale 不通。表現(xiàn)是 SSH 連不上 Mac。排查順序手機(jī) Tailscale 是否 ConnectedMac 的 Tailscale 是否在線Mac 是否休眠。如果 Mac 休眠了SSH 自然連不上。臨時(shí)可以用caffeinate -i防止休眠但這不是長(zhǎng)期方案。長(zhǎng)期運(yùn)行需要配置電源策略和開機(jī)自啟。tmux 會(huì)話找不到。表現(xiàn)是tmux attach -t lobster提示 session not found。原因可能是 Mac 重啟過或者會(huì)話被手動(dòng)關(guān)閉。先用tmux ls看有沒有其他會(huì)話如果沒有說明會(huì)話確實(shí)沒了只能重新創(chuàng)建并啟動(dòng) Claude Code。這也是為什么長(zhǎng)期任務(wù)建議配合開機(jī)自啟和健康檢查。排查時(shí)的一個(gè)原則先分層再定位。網(wǎng)絡(luò)層Tailscale 通不通、接入層SSH 能不能進(jìn)、應(yīng)用層Claude Code 能不能請(qǐng)求、配置層Key 和 Base URL 對(duì)不對(duì)一層一層往下查不要一上來就改配置。多數(shù)問題在分層后一眼就能看出在哪一層。6. 把遠(yuǎn)程救場(chǎng)變成日常習(xí)慣這套方案跑順之后我把它變成了日常習(xí)慣而不是等出事才用。具體做法有幾個(gè)。第一家里那臺(tái) Mac 上的 Claude Code 永遠(yuǎn)跑在 tmux 會(huì)話里會(huì)話名固定比如lobster。這樣無(wú)論我在哪只要 SSH 進(jìn)去tmux attach -t lobster就能看到現(xiàn)場(chǎng)。會(huì)話名固定還有個(gè)好處手機(jī) SSH 客戶端的快捷命令里存一條一鍵恢復(fù)。第二Key 和 Base URL 只維護(hù)一份。所有項(xiàng)目共用同一個(gè)~/.claude/settings.json需要區(qū)分時(shí)用項(xiàng)目級(jí)配置覆蓋。這樣換 Key 只改一個(gè)地方不會(huì)出現(xiàn)某個(gè)項(xiàng)目還在用舊 Key 的情況。第三定期驗(yàn)證通道。不用等到出事每周用 curl 打一次 API確認(rèn) Key 有效、通道正常。這個(gè)動(dòng)作 10 秒完成但能避免關(guān)鍵時(shí)刻掉鏈子。第四接受這套方案的邊界。如果 Mac 關(guān)機(jī)、系統(tǒng)卡死、路由器斷網(wǎng)或者 Tailscale 本身沒啟動(dòng)手機(jī) SSH 也救不了。要覆蓋這些情況需要智能插座、帶外管理、備用網(wǎng)絡(luò)或自動(dòng)拉起機(jī)制。遠(yuǎn)程 SSH 是救場(chǎng)工具不是完整的高可用方案。想清楚這一點(diǎn)你就不會(huì)對(duì)它有不切實(shí)際的期待。如果你還在用臨時(shí) Key、每個(gè)項(xiàng)目各配一份建議趁這次整理一下把 Base URL 統(tǒng)一到 TaoToken 的通道上。接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite API Keys 在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_campaignrewrite 。先把 curl 驗(yàn)證跑通再改 Claude Code 配置順序不要反。最后說一個(gè)我自己的習(xí)慣每次遠(yuǎn)程救場(chǎng)后把「斷的原因、改的動(dòng)作、驗(yàn)證的結(jié)果」三行記在備忘錄里。攢上幾次你會(huì)發(fā)現(xiàn)大部分故障就那幾類排查越來越快。技術(shù)真正好用的時(shí)候是讓人少趕一次路少丟一次排錯(cuò)現(xiàn)場(chǎng)。人在外面手機(jī)能安全地回到家里的終端這就夠了。