---
site: "zyx.tw"
title: "Claude Code 留在筆電，用 ssh 把完整指令送到遠端"
description: "每次遠端指令都要完整，共用 ssh 連線不會保留執行環境。"
url: "https://www.zyx.tw/map/machines/one-claude-many-machines"
---

# Claude Code 留在筆電，用 ssh 把完整指令送到遠端

紀錄 016，深讀 L2，901 字，2 分鐘，v2.0.0，更新 2026-11-16

Claude Code 留在筆電，透過 ssh 把完整指令送到適合的機器。 ssh 能從本機向遠端機器下指令，因此對話可以留在筆電，編譯與測試交給其他機器。只要筆電能連線，就不必在每台機器上安裝 Claude Code。

## 先讓機器名稱對應到連線設定

準備遠端主機後，先在筆電的 ~/.ssh/config 設定短名字。下面的 Host build 對應 build.internal.example，交代工作時就使用相同的 build。

這份設定同時指定私鑰與連線共用方式。最後一行示範如何在遠端進入專案，再執行測試。

```
# ~/.ssh/config
Host build
  HostName build.internal.example
  IdentityFile ~/.ssh/id_ed25519
  ControlMaster auto                # share one connection
  ControlPath ~/.ssh/cm-%r@%h:%p
  ControlPersist 10m                # keep it open after use

# each command is one call, with no shell kept between calls
ssh build "cd project && make test"
```

ControlMaster auto 設定連線共用，後續指令便不必重新建立連線。下圖拆開這份設定，呈現機器名稱、私鑰與共用連線的對應位置。

新增機器時，替新機器設定對應的 ssh 名稱。名稱如何配合設備用途與連線資訊，可接著讀 機器的名字。

```text
# ~/.ssh/config
Host build
  HostName build.internal.example
  IdentityFile ~/.ssh/id_ed25519
  ControlMaster auto                # share one connection
  ControlPath ~/.ssh/cm-%r@%h:%p
  ControlPersist 10m                # keep it open after use

# each command is one call, with no shell kept between calls
ssh build "cd project && make test"
```

Figure: An ssh configuration that names a machine, points at a private key and shares one connection between calls, followed by one remote command.

1. Name: 短名字對應到機器的完整名稱。
2. Key: 指定登入用的私鑰。私鑰不會傳到遠端。
3. Share: 第 1 次連線後保持開啟。後續指令共用這條連線，不必重新登入。
4. Run: 指令寫在引號裡，在遠端執行後回傳輸出。

## 登入時，私鑰留在筆電

ssh 使用一對金鑰：私鑰留在筆電，公鑰放在遠端。登入時，筆電用私鑰簽章，遠端用公鑰驗證。

範例中的 IdentityFile 指向筆電上的私鑰檔案。公鑰可以公開，因為公鑰只能驗證簽章，不能單獨用來登入。

## 每次呼叫都要帶齊遠端執行條件

agent 每次透過 ssh 送出遠端指令，都是一次獨立呼叫。每次 ssh 都會開啟新的 shell，也就是執行指令的環境；前一次切換的目錄與環境變數不會保留。

所以範例把 cd project 與 make test 放在同一次呼叫中。遠端先進入 project，再執行測試，這次測試需要的目錄條件就在同一條指令裡。

## 把工作分配寫進筆電上的規則

CLAUDE.md 是 Claude Code 每次新對話開始時載入的規則檔。把檔案留在筆電，並寫明哪些工作要在遠端執行，筆電上的 Claude Code 就能讀取這些要求。

例如，可以指定 sandbox 作為預設開發環境。編輯與 git 操作留在筆電，編譯、測試與伺服器交給遠端；各類工作的分配方式見 筆電只編輯。

若另外派出做事的 agent，也就是 子 agent，派工指示同樣要寫明執行位置。子 agent 不一定會遵守 CLAUDE.md，不能只依靠規則檔傳達這項要求。

工作分配也要保留機器條件：只有 Mac 能完成的編譯留在筆電，需要顯示卡的運算交給有顯示卡的桌機。下圖示範筆電、遠端開發環境與有顯示卡桌機各自承接的工作。

**指令在哪裡執行 筆電**

適合的工作:
- 編輯檔案
- git 操作
- 只有 Mac 能完成的編譯

移到遠端的工作:
- 編譯和測試
- 持續執行的服務

重的工作移到遠端，減少對筆電的影響。

**指令在哪裡執行 遠端開發環境**

適合的工作:
- 編譯和測試
- 開發用的伺服器
- Claude Code 的瀏覽器

連線方式:
- 例如，用 ssh sandbox 執行指令。

把這類工作放到固定的開發環境。

**指令在哪裡執行 有顯示卡的桌機**

適合的工作:
- 需要顯示卡的運算
- 背景瀏覽器截不到的頁面

連線方式:
- 例如，用 ssh furnace 執行指令。

Windows 機器也可以透過 ssh 連線。

## 怎麼確認指令真的在遠端執行

設定完成後，交付編譯任務，檢查指令是否真的在遠端執行。

若遺失私鑰，則到遠端刪除對應的公鑰。

## 來源

- [ssh\_config(5)](https://man.openbsd.org/ssh_config), OpenBSD manual pages
- [ssh(1)](https://man.openbsd.org/ssh), OpenBSD manual pages
- [RFC 4252: The Secure Shell (SSH) Authentication Protocol](https://www.rfc-editor.org/rfc/rfc4252), IETF

## 地圖

- 原理：[我把工作的執行位置寫成分工表，讓 Claude Code 依表選機器](https://www.zyx.tw/map/machines/one-job-per-machine.md)
- 相關：[我從家目錄啟動 Claude Code，讓跨專案工作在同一個範圍內、共用同一份記憶](https://www.zyx.tw/map/basics/start-from-home.md)
- 相關：[私有網路由協調伺服器管金鑰與規則，資料在機器之間傳送](https://www.zyx.tw/map/machines/private-network.md)
- 相關：[我用環境目錄把設備名稱接到用途、連線與詳細筆記](https://www.zyx.tw/map/machines/what-runs-where.md)
- 回到：[機房](https://www.zyx.tw/map.md)
