繁體中文 · English
Claude Code 記憶的跨裝置同步、整理與復原。
記憶存在你自己的 GitHub 私人 repo，公司、家裡、筆電打開同一個專案，Claude 都記得你教過的事。
記憶越用越多，重複、過時、放錯專案的內容也越積越多。現在在管理介面選好範圍，把一行指令貼給 Claude Code：Claude 讀過範圍內的記憶，提出整理建議和修改後的內容，你在網頁上逐項看差異、做決定，Claude 才照你的決定動手。
| 在哪裡 | 做什麼 | |
|---|---|---|
| 1 | 管理介面「記憶整理」 | 選範圍（全域、單機、專案、核心準則或全部），寫下補充說明，複製指令 |
| 2 | Claude Code | 貼上 /engram:tidy …：Claude 讀過記憶、提出建議，給你一個回到管理介面的網址。這一步不改任何記憶 |
| 3 | 管理介面 | 每一項看建議、理由與修改前後的差異，選「採用建議／維持原狀／封存／依備註調整」，自動儲存 |
| 4 | Claude Code | 貼上 /engram:tidy-apply …：先備份，採用的項目照你看過的內容執行，選了「依備註調整」的交給 Claude 處理；結果回到同一頁，每一項都能單獨復原 |
詳見使用說明。
1.2.0 親眼看見 Claude 讀了哪些記憶 Claude Code 旁的記憶面板即時列出這次對話載入與讀取的記憶，標出 Claude 看到的是全文、標題還是摘要。輸入 /engram-memories 開關，使用說明
|
1.1.0 英文介面與英文文件 管理介面可以切換 English，收件匣卡片、錯誤訊息等常駐程式傳來的文字也有英文；另有英文版 README、AI 安裝手冊與使用說明，English README |
更早的版本見更新紀錄。
Claude Code 會自動記下你的習慣、專案慣例與踩過的坑。但這些記憶只存在一台電腦的一個資料夾裡：
| 你遇到的狀況 | 結果 |
|---|---|
| 在公司教過 Claude 的事，回家開同一個專案 | 全部要重教一次 |
| 專案資料夾搬家、改名，或用了字數相同的中文名稱 | 記憶消失，或和別的專案混在一起 |
| 用了幾個月，記憶越來越多 | 重複、過時、放錯專案的內容沒人整理；索引超過 200 行，後面的 Claude 根本讀不到 |
Engram 把記憶變成跟著你走、跟著專案走、隨時能復原的資產。
| 功能 | 你得到什麼 | |
|---|---|---|
 |
親眼看見 Claude 讀了什麼 | Claude Code 旁的記憶面板即時列出這次對話載入與讀取的記憶，每一列標出全文、標題或摘要，一眼看出回答根據什麼。 |
 |
多台電腦自動同步 | 背景自動同步（預設每 10 分鐘）。開 Claude Code 不用等網路，離線照常記憶，恢復連線後自動補上。 |
 |
專案用 ID 認，不用路徑認 | 資料夾搬家、改名，或在另一台電腦 clone 同一個 git repo，都認得是同一個專案。 |
 |
三種範圍各歸其位 | 個人偏好放「全域」，每個專案都看得到；安裝路徑、網路設定放「單機」，不會跑到別台電腦。 |
 |
什麼都能復原 | 每個變更都有歷史。匯入前先在複本上完整演練，套用後隨時一鍵還原；原始記憶檔一律保留。 |
 |
衝突不吵你 | 兩台改了不同段落就自動合併；改到同一段才請你並排比對，Claude 永遠不會讀到衝突標記。 |
 |
金鑰不外流 | 偵測到疑似密碼、權杖、連線字串的記憶，只留在本機、不會推送，並在收件匣提醒你遮蔽。 |
 |
交給 Claude 整理 | 在管理介面選範圍，Claude 分析後提出建議與修改後的內容；你在網頁逐項看差異、做決定，Claude 才動手，每一項都能復原。收件匣也能交給 /engram:inbox 處理。 |
 |
看得見的管理介面 | 總覽、記憶庫、收件匣、專案、裝置與同步，一個介面全部看清楚；支援深色模式，可安裝成桌面應用程式。 |
- Engram 不修改 Claude Code，只使用官方提供的機制：記憶資料夾、
CLAUDE.md匯入、hooks，以及外掛畫面（記憶面板）。 - 記憶庫是一個 git repo，放在
%USERPROFILE%\.engram\vault，同步到你自己帳號底下的私人 repo。Engram 沒有伺服器，不蒐集任何資料。 - 日常運作不呼叫 AI：健康檢查用規則判斷，金鑰遮蔽在本機完成。
需要：Windows 11、已登入的 Claude Code（官方安裝程式版本）、一個 GitHub 帳號。Node.js、Git、GitHub CLI 缺少的話會自動補齊。
打開 Claude Code，把下面這段話整段貼上：
請幫我安裝 Engram（Claude Code 記憶同步工具）。
安裝手冊：https://raw.githubusercontent.com/Sen-CaPoo/engram/main/AI%20%E5%B9%AB%E4%BD%A0%E5%BF%AB%E9%80%9F%E5%AE%89%E8%A3%9D.md
請先完整讀完手冊再開始，照步驟進行；任何會改動電腦的步驟，都先用白話跟我說明並取得我的同意。
Claude 會檢查環境、補齊工具、列出安裝計畫給你確認，再完成安裝與驗證。你只需要在登入 GitHub 時點幾下瀏覽器。詳見 AI 幫你快速安裝.md。
- 下載 Engram：點右上角 Code → Download ZIP 並解壓縮，或執行
git clone https://github.com/Sen-CaPoo/engram.git。 - 雙擊資料夾裡的
setup.cmd。它會補齊工具、帶你登入 GitHub、列出安裝計畫，等你輸入y同意後才安裝。 - 安裝完成後瀏覽器會開啟管理介面，到「匯入既有記憶」把舊記憶收進來。
完整步驟與畫面說明見 快速開始。
步驟完全一樣。Engram 會發現你 GitHub 上已經有 engram-vault，自動接上並下載第一台的記憶。
安裝後請保留 Engram 資料夾，之後更新版本會用到。更新只要兩步：取得新版程式（
git pull，或下載新的 ZIP 覆蓋原資料夾），再執行engram update。
什麼都不用做。 Claude 照平常記憶事情，Engram 在背景處理其餘的事：
- 對話開始：Claude 知道自己在哪台電腦、哪個專案，也知道全域與單機記憶要寫到哪裡。
- 對話結束：整理索引、檢查有沒有疑似金鑰，存進記憶庫。
- 每 10 分鐘（預設）：和其他電腦交換變更。
- 每天一次：健康檢查，有需要你決定的事就放進收件匣。
想主動整理時，在 Claude Code 裡輸入：
| 指令 | 用途 |
|---|---|
/engram:inbox |
讓 Claude 逐張讀過收件匣，說明判斷依據與建議；你同意後才執行。加上「自動」直接處理有把握的項目 |
/engram:tidy |
深度整理全域、單機、一個專案、核心準則或全部記憶：Claude 提出建議，你在管理介面「記憶整理」逐項決定（指令可以在那一頁產生） |
/engram:tidy-apply |
照你在記憶整理頁的決定執行，結果回到同一頁 |
/engram:save |
把這次對話值得長期記住的事存成記憶 |
/engram:recall |
從其他專案、其他電腦的記憶找出相關經驗，只讀不寫 |
/engram-memories |
開關記憶面板，看這次對話載入與讀取了哪些記憶（也可以點底部的「◆ 憶跡」） |
 收件匣：每張卡片都有一鍵處理，或「交給 Claude」 |
 記憶庫：搜尋、編輯、改變範圍、查看歷史 |
 匯入既有記憶：先在複本演練，通過才能套用 |
 深色模式：跟隨系統設定 |
- 你的資料只在兩個地方：你的電腦，以及你自己 GitHub 帳號底下的私人 repo。對話紀錄（transcript）不會同步。
- 不呼叫 AI：只有兩種情況會用到你的 Claude 額度：Claude Code 改版時的相容性探測（只用合成資料，可在介面關閉），以及你主動輸入
/engram:開頭的指令時。記憶面板只在本機讀取，不會用到額度。 - 金鑰保護：疑似金鑰的記憶不會推送；交給 Claude 整理前，偵測到的金鑰會先在本機遮蔽。
- 可完整移除：安裝前列出所有會改動的位置，每一項都記錄下來；
engram uninstall依紀錄逐項還原，預設保留你的記憶庫。 - 公司資料：如果公司不允許把工作資料放在個人 GitHub，可以改用公司組織底下的私人 repo，或只在單機使用。
詳見 SECURITY.md。
要付費嗎？ 不用。Engram 以 MIT 授權免費提供。
支援 macOS 或 Linux 嗎？ 目前只支援 Windows 11（背景同步使用 Windows 工作排程器）。
公司網路擋住 GitHub 怎麼辦？ 記憶照常存在本機，回到能連 GitHub 的網路後自動補同步。
不想用了怎麼辦？ 執行 engram uninstall，電腦會還原到安裝前，記憶庫預設保留。
更多問題見 常見問題。
| 文件 | 給誰看 |
|---|---|
| AI 幫你快速安裝.md | 想讓 Claude 代為安裝的人（也是給 AI 照做的手冊） |
| 快速開始 | 想自己一步步安裝的人 |
| 使用說明 | 完整功能：收件匣、衝突、資料夾撞名、暫停與移除、指令速查 |
| 常見問題 | 常見疑問與疑難排解 |
| 更新紀錄 | 每個版本的變更 |
Engram（記憶痕跡）是神經科學用語，指一段記憶在大腦裡留下的實體痕跡；中文名「憶跡」取其意。Logo 是一筆寫成的 e：連續的軌跡代表記憶，環形代表同步，開口處的紅點代表「現在，這台電腦」。
MIT © 2026 Sen-CaPoo
Claude 與 Claude Code 是 Anthropic 的商標。Engram 是獨立開發的第三方工具，與 Anthropic 沒有隸屬或合作關係。