---
site: "zyx.tw"
title: "我用環境目錄把設備名稱接到用途、連線與詳細筆記"
description: "名稱與連線放在規則，規格與位址留在按需讀取的筆記。"
url: "https://www.zyx.tw/map/machines/what-runs-where"
---

# 我用環境目錄把設備名稱接到用途、連線與詳細筆記

紀錄 017，經驗 L2，781 字，2 分鐘，v2.0.0，更新 2026-11-16

我把固定使用的設備登記成環境目錄，讓 Claude Code 能依名稱找到用途與連線方式。Claude Code 原本不知道我有哪些設備，也不知道專案放在哪裡。

目錄入口放在 CLAUDE.md，也就是新對話會載入的規則檔。我用 Minecraft 方塊替實體機器命名，隨身裝置用物品命名，虛擬機保留服務名稱。

## 同一個入口列出名稱、用途與連線

我的目錄把設備名稱、用途與連線方式放在一起。遠端連線使用 ssh，這是從一台電腦對另一台電腦下指令的工具。

我從筆電連到其他設備。spawner 的設備名稱也是連線名稱，因此可以直接交代「查詢 spawner 上有哪些虛擬機。」下圖示範名稱、用途與連線方式如何對應。

**例如：選擇設備名稱。 workbench**

名稱來源:
- Minecraft 的方塊：工作台

設備用途:
- 作為主力機的筆電

連線方式:
- Claude Code 直接在這台筆電執行

在筆電上與 Claude Code 對話。從筆電連到其他設備。

**例如：選擇設備名稱。 spawner**

名稱來源:
- Minecraft 的方塊：生怪磚

設備用途:
- 執行虛擬機的主機

連線方式:
- ssh spawner

連線名稱與設備名稱保持一致。

**例如：選擇設備名稱。 furnace**

名稱來源:
- Minecraft 的方塊：熔爐

設備用途:
- 配有顯示卡的桌機

連線方式:
- ssh furnace

需要顯示卡時，用設備名稱指定執行位置。例如：「到 furnace 執行。」

**例如：選擇設備名稱。 hopper**

名稱來源:
- Minecraft 的方塊：漏斗

設備用途:
- 路由器

連線方式:
- ssh hopper

路由器也依設備名稱連線。

**例如：選擇設備名稱。 sandbox**

名稱來源:
- 保留服務原本的名稱

設備用途:
- 編譯與測試用的虛擬機

連線方式:
- ssh sandbox

虛擬機保留服務名稱，不套用實體機器的命名方式。

- workbench: 作為主力機的筆電。Claude Code 直接在這台筆電執行。
- spawner: 執行虛擬機的主機。ssh spawner。
- furnace: 配有顯示卡的桌機。

## 從規則找到索引，再讀操作細節

記憶 是新對話會載入的筆記，索引則指向詳細資料。規則登記設備身分與連線，索引指路，詳細筆記記錄規格、位址與已知問題。

Claude Code 先載入規則與索引，操作設備時再讀對應的詳細筆記。

專案另有環境說明，記錄位置、測試資料庫、連接埠、登入方法與啟動方式，位置安排見 固定的位置。

我在規則裡要求動手前先讀專案規則或 README。從 家目錄，也就是個人使用者目錄，開啟對話時，不要假設專案的 CLAUDE.md 已載入。

下圖示範測試修改前，先查閱環境說明，取得程式位置與登入方法，再執行測試的順序。

**位置和登入方法從哪裡取得 沒有登記**

測試修改前:
- 需要摸索程式位置和登入方法

新對話需要重新找出環境的使用方式。

**位置和登入方法從哪裡取得 已經登記**

先讀環境說明:
- 查閱程式位置、登入方法和瀏覽器

依照說明找到環境，再執行測試。

## 代價是維護名稱與資料的一致性

設備改名時，要刪除舊連線名稱，並在 CLAUDE.md 保留新舊名稱對照。舊文件與 log，也就是程式執行時留下的紀錄，仍可能使用舊名稱。

改名時，也要檢查虛擬機軟體內部的節點名稱，以及監控服務登記的名稱。設備改名，不代表這些登記已經更新。

筆記也可能過時；截圖或 log 與記憶不同時，以現場證據為準。同類筆記則合併成總表，索引只保留總表入口。

## 用新對話檢查名稱是否指向正確設備

開啟新對話，用設備名稱交代任務，檢查 Claude Code 是否連到正確設備。

## 地圖

- 原理：[CLAUDE.md 依範圍串接規則，寫好後仍要用新任務確認落實](https://www.zyx.tw/map/basics/claude-md.md)
- 相關：[Claude Code 留在筆電，用 ssh 把完整指令送到遠端](https://www.zyx.tw/map/machines/one-claude-many-machines.md)
- 相關：[我把網路設定放進 Git，先改檔案再動設備](https://www.zyx.tw/map/machines/network-in-git.md)
- 回到：[機房](https://www.zyx.tw/map.md)
