兩台電腦共享 Claude Code 記憶：完整設置指南

為什麼需要共享記憶

Thomas 的真實問題

Thomas 有一台台式機（主力開發機）和一台筆記本（外出或躺在沙發上用的）。兩台都裝了 Claude Code。問題是：

• 在台式機花了半天教 Claude Code 理解 YouTube API 的授權流程、Token 過期機制、上傳影片的正確姿勢
• 切到筆記本繼續開發，Claude Code 完全不記得，又要從頭開始解釋
• 筆記本上改了一些配置邏輯，回到台式機又不知道了

這不是 Claude Code 的 bug — 它的記憶檔案（MEMORY.md 以及 .claude/ 目錄下的設定）是存在本機的。兩台電腦的本機是獨立的，自然不會互通。

解決方案一句話

把記憶檔案放進一個 Git repo，兩台電腦都讀寫同一個 repo，用 git push / git pull 同步。就這麼簡單。

架構概覽：全局視角

在開始動手之前，先搞清楚整體架構。下面這張圖展示了兩台電腦如何透過 GitHub 共享 Claude Code 的記憶文件。

路徑對照表

兩台電腦的目錄結構不同，以下是對照：

核心原理

整個方案只有三個關鍵動作：

1. Clone — 筆記本從 GitHub clone 下那個存放記憶的 repo
2. Junction — 用 Windows Junction 讓 Claude Code 以為記憶目錄就在本地，實際指向 repo 目錄
3. Hook 自動同步 — 每次結束對話自動 git push，確保最新記憶上傳到 GitHub

第一步：Clone 共享 Repo

你的台式機上應該已經有一個 Git repo 包含了 Claude Code 的記憶文件。現在要做的是把它 clone 到筆記本。

在筆記本上執行 Clone

# 先選擇一個放 repo 的位置
cd C:\Users\abc25\repos

# Clone 記憶 repo（用你自己的 GitHub 帳號名稱替換）
git clone https://github.com/YOUR_USERNAME/downloads-config.git
PowerShell

Clone 完成後，你在筆記本上就有了和台式機一模一樣的記憶文件。

確認 Repo 是 Private

# 查看 repo 的可見性
gh repo view YOUR_USERNAME/downloads-config --json visibility

# 應該輸出：
# {
#   "visibility": "PRIVATE"
# }
PowerShell

gh repo edit YOUR_USERNAME/downloads-config --visibility private

驗證 Clone 成功

# 進入 repo 目錄
cd C:\Users\abc25\repos\downloads-config

# 列出文件，應該能看到 MEMORY.md 等記憶文件
ls

# 檢查 git remote 是否正確
git remote -v
# origin  https://github.com/YOUR_USERNAME/downloads-config.git (fetch)
# origin  https://github.com/YOUR_USERNAME/downloads-config.git (push)
PowerShell

第二步：建立 Junction（文件夾捷徑）

為什麼用 Junction 而不是 Symlink？

對我們的需求來說，Junction 完全夠用 — 我們只需要把一個本機目錄指向另一個本機目錄。不需要管理員權限是一大優勢。

建立 Junction

在筆記本上，打開 PowerShell：

# 確保目標路徑的上層目錄存在
# 假設 Claude Code 項目的 .claude 目錄在：
# C:\Users\abc25\.claude\projects\C--Users-abc25-Desktop\

# 如果 memory 目錄已存在，先備份再刪除
if (Test-Path "C:\Users\abc25\.claude\projects\C--Users-abc25-Desktop\memory") {
    Rename-Item "...\memory" "...\memory_backup"
}

# 建立 Junction：
# -Path 是 Claude Code 要讀取的位置（門 A）
# -Target 是檔案實際存放的位置（房間 B = repo 目錄）
New-Item -ItemType Junction `
    -Path   "C:\Users\abc25\.claude\projects\C--Users-abc25-Desktop\memory" `
    -Target "C:\Users\abc25\repos\downloads-config"
PowerShell

驗證 Junction 建立成功

# 方法一：查看目錄屬性
Get-Item "C:\Users\abc25\.claude\projects\C--Users-abc25-Desktop\memory" | Select-Object Name, Attributes, Target

# 應該看到：
# Name    : memory
# Attributes : Directory, ReparsePoint
# Target  : {C:\Users\abc25\repos\downloads-config}

# 方法二：直接列出內容，應該看到 repo 的文件
ls "C:\Users\abc25\.claude\projects\C--Users-abc25-Desktop\memory"
# 應該看到 MEMORY.md 等文件
PowerShell

第三步：設置自動同步 Hooks

什麼是 Claude Code Hooks？

Claude Code 支援在以下時機觸發自定義腳本：

設定 Stop Hook：自動推送記憶

編輯 Claude Code 的設定檔 settings.json（位於 ~/.claude/settings.json）：

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "cd D:\\Backup\\Downloads\\claude-sonnet-4-6\\memories && git add -A && git diff --cached --quiet || git commit -m \"auto-sync memory $(date +%Y-%m-%d_%H:%M)\" && git push origin main 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}
settings.json（台式機）

逐行解釋這條命令

筆記本的 settings.json

筆記本的設定幾乎一樣，只是路徑不同：

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "cd C:\\Users\\abc25\\repos\\downloads-config && git add -A && git diff --cached --quiet || git commit -m \"auto-sync memory $(date +%Y-%m-%d_%H:%M)\" && git push origin main 2>/dev/null || true"
          }
        ]
      }
    ]
  }
}
settings.json（筆記本）

第四步：路徑映射（解決盤符差異）

問題：兩台電腦的磁碟結構不同

Thomas 的台式機有多個磁碟：D:\、G:\、Z:\ — 但筆記本上完全沒有這些盤符。如果記憶文件裡寫著「設定檔在 D:\Backup\...」，筆記本上的 Claude Code 會一臉茫然。

路徑映射對照表

在記憶文件中寫明兩台電腦的路徑對應關係：

如何讓 Claude Code 知道自己在哪台機器？

最可靠的方式是用 hostname 判斷：

# 查看目前電腦名稱
hostname

# 台式機可能是：DESKTOP-ABC123
# 筆記本可能是：LAPTOP-XYZ789
PowerShell

在 MEMORY.md 中加入這段識別規則：

## 多機器識別

- hostname = DESKTOP-ABC123 → 台式機
  - 直接存取 D:\, G:\, Z:\ 磁碟
  - 所有本地資源可用

- hostname = LAPTOP-XYZ789 → 筆記本
  - 只有 C:\ 磁碟
  - D:\, G:\, Z:\ 資源需要透過台式機 WinRM 存取
  - 或者等回到台式機再處理
MEMORY.md

筆記本需要台式機資源時怎麼辦？

如果筆記本上的 Claude Code 需要存取只在台式機上的文件（如 G:\ 上的影片），有兩個選項：

1. WinRM 遠端存取 — 如果台式機開著，可以透過 PowerShell Remoting（WinRM）遠端讀取文件。這需要額外設置，適合進階用戶
2. 等回去處理 — 在 MEMORY.md 裡記下「待辦：回台式機後處理 G:\ 上的 xxx 文件」，回到台式機時 Claude Code 會看到這條記錄

處理 Merge Conflict

什麼情況會產生衝突？

當兩台電腦同時修改了同一個文件的同一部分，Git 不知道該保留哪個版本，就會產生 merge conflict。最常見的場景：

1. 台式機上 Claude Code 修改了 MEMORY.md 的「已知問題」區塊，push 了
2. 筆記本上（還沒 pull）也修改了 MEMORY.md 的同一個區塊
3. 筆記本嘗試 push — 被拒絕（因為遠端有更新）
4. 筆記本 git pull — 衝突產生！

衝突長什麼樣？

git pull 之後，打開 MEMORY.md 會看到：

## 已知問題

<<<<<<< HEAD
- YouTube API 上傳有時候會 timeout，需要重試機制
- Token 過期處理已經完成
=======
- YouTube API 上傳超時問題已解決（加了 retry）
- 需要加入 Google Photos API 支援
>>>>>>> origin/main
MEMORY.md (衝突狀態)

如何解決衝突

1. 打開衝突的文件，找到 <<<<<<< 和 >>>>>>> 標記
2. 手動合併兩邊的內容（通常兩邊都要保留，因為都是有用的記憶）
3. 刪除所有衝突標記（<<<<<<<、=======、>>>>>>>）
4. 儲存文件

合併後應該長這樣：

## 已知問題

- YouTube API 上傳超時問題已解決（加了 retry）
- Token 過期處理已經完成
- 需要加入 Google Photos API 支援
MEMORY.md (合併後)

完成合併

# 將修改後的文件加入暫存
git add MEMORY.md

# 如果是 merge 衝突（git pull 預設）
git commit -m "resolve merge conflict in MEMORY.md"

# 如果是 rebase 衝突（git pull --rebase）
git rebase --continue

# 推送到遠端
git push origin main
PowerShell

預防衝突

安全鐵律

記憶文件裡可能包含項目架構細節、文件路徑、部分代碼邏輯、API 使用模式。這些資訊如果公開，等於告訴全世界你的系統長什麼樣。

檢查你所有 Repo 的可見性

# 列出你所有 repo 及其可見性
gh repo list --json name,visibility --limit 100

# 輸出範例：
# [
#   {"name": "downloads-config", "visibility": "PRIVATE"},  ← 正確
#   {"name": "my-blog", "visibility": "PUBLIC"},            ← 看情況
#   {"name": "claude-memories", "visibility": "PUBLIC"}     ← 危險！
# ]
PowerShell

發現 Public 的記憶 Repo？立刻處理

# 立刻改為 Private
gh repo edit YOUR_USERNAME/claude-memories --visibility private

# 確認已改成功
gh repo view YOUR_USERNAME/claude-memories --json visibility
# {"visibility": "PRIVATE"}
PowerShell

機密資訊應該放哪？

驗證 Hook 推送的目標

# 在記憶 repo 目錄下執行
cd D:\Backup\Downloads\claude-sonnet-4-6\memories

# 查看 remote URL
git remote -v
# origin  https://github.com/YOUR_USERNAME/downloads-config.git

# 確認這個 repo 是 Private
gh repo view YOUR_USERNAME/downloads-config --json visibility
# {"visibility": "PRIVATE"}
PowerShell

FAQ 常見問題

# 拉取遠端更新並 rebase 你的本地 commit
git pull --rebase origin main

# 如果沒有衝突，直接 push
git push origin main

# 如果有衝突，解決後：
git add .
git rebase --continue
git push origin main