記憶資料存在哪裡？安全嗎？

預設託管在 Semantica Cloud（SOC 2 認證）；也可配置為自託管 Postgres + pgvector，資料完全不出本地網路，適合程式碼保密要求高的團隊。

Semantica Claude Code 2026：長期記憶怎麼配置？

Q: Semantica 和 CLAUDE.md 有什麼區別？

CLAUDE.md 是靜態的專案說明文件，每次 session 全量載入；Semantica 是動態記憶系統，根據查詢語義檢索最相關的記憶片段注入上下文，更省 token、更具個人化。

Q: Semantica 免費嗎？

Semantica 核心 SDK 開源免費；雲端託管的 Memory Store 有免費額度（約 10 萬條記憶/月），超出按量計費。自託管 Postgres/pgvector 方案可完全零成本。

Q: Claude Code 重啟後記憶會遺失嗎？

配置 Semantica 後不會遺失。記憶寫入 Memory Store（持久化資料庫），下次 session 啟動時透過 hooks 自動檢索並注入，與 session 生命週期解耦。

你是否曾遇過這樣的情況：和 Claude Code 一起調整了兩天的架構細節，關掉終端機再開，它又變回了對你的專案一無所知的「陌生 AI」。每次都要重新解釋目錄結構、技術選型、團隊規範……這不是模型的問題，而是上下文持久化從未被認真解決。

Semantica 是 2026 年專為 Claude Code 設計的長期記憶框架，解決的正是這個問題：讓 Claude Code 在多個 session 之間保持對程式碼庫的理解、專案偏好與使用者習慣。本文從「Semantica 是什麼」到「怎麼配置落地」，附踩坑記錄與 Cloud Mac 實踐，提供一個可直接照著做的完整指南。

3 層

短期 / 工作 / 長期記憶

pgvector

語義檢索引擎

跨 session

記憶不隨關機消失

一、Semantica 是什麼

Semantica 是一個為 AI 編碼助手設計的持久化記憶中介軟體，2026 年 Q1 開源後迅速在 Claude Code 社群獲得關注。它的核心思路是：不依賴模型原生的上下文視窗來「記住事情」，而是在模型之外維護一個結構化的記憶資料庫，每次 session 啟動時按語義相關性自動檢索並注入最有價值的記憶片段。

Semantica 由三個部分組成：

Memory Store：底層持久化儲存，預設支援 Postgres + pgvector（也可用 Qdrant、Weaviate）
Memory Manager：負責記憶的寫入、去重、合併與過期清理
Retrieval Engine：在每次 session 開始時語義檢索最相關的記憶，構建注入 prompt

二、Claude Code 的記憶困境

CLAUDE.md 是靜態的變通方案，有明顯限制：全量載入不區分相關性、靜態無法自動更新、無個人化、單節點無法分享。Semantica 按語義檢索、自動寫入、支援多使用者命名空間，以及透過共享 Memory Store 實現團隊記憶同步。

三、三層記憶模型

短期記憶：當前 session 的上下文視窗，由 Claude Code 原生管理。工作記憶：當前任務相關的臨時狀態，跨幾天的任務使用 task_context 表維護。長期記憶：持久化的專案知識與使用者偏好，包括程式碼庫知識、架構決策、使用者偏好、歷史 Bug 與任務進度。

四、與 Claude Code 整合

# 安裝 Semantica CLI
npm install -g @semantica/cli
cd /your/project
semantica init

推薦配置（Postgres + pgvector）：

docker run -d \
  --name semantica-db \
  -e POSTGRES_PASSWORD=yourpassword \
  -e POSTGRES_DB=semantica \
  -p 5432:5432 \
  pgvector/pgvector:pg16

在 ~/.claude/settings.json 中加入 hooks：

{
  "hooks": {
    "PreToolUse": [{"matcher": ".*","hooks": [{"type": "command","command": "semantica inject --session-id $CLAUDE_SESSION_ID"}]}],
    "Stop": [{"hooks": [{"type": "command","command": "semantica consolidate --session-id $CLAUDE_SESSION_ID --auto-extract"}]}]
  }
}

五、配置最佳實踐

為記憶加上標籤（tags），提升檢索精準度
不同專案使用獨立 namespace，避免污染
定期 compact 記憶，減少重複注入
重要架構決策手動 semantica add
調低 max_tokens（1500–2000），保護上下文

六、常見踩坑

踩坑一：hooks 路徑寫死導致跨機器失效

建議用 npx semantica 或把 semantica 加入 PATH。

踩坑二：向量維度不匹配

切換 embedding 模型時需執行 semantica migrate --reembed 重新生成向量。

踩坑三：similarity_threshold 設太低導致噪音注入

建議從 0.72 開始，根據實際效果微調。

踩坑四：consolidate 重複寫入

在 consolidate 命令加 --idempotent 參數自動去重。

七、與 Mem0、Zep 的比較

框架	設計定位	Claude Code 整合	自託管
Semantica	專為 AI 編碼助手設計	原生 hooks，零配置	Postgres / SQLite
Mem0	通用 AI 記憶層	需手動接入 SDK	支援（OSS）
Zep	對話歷史 + 事實提取	需手動接入 SDK	支援（OSS）

八、Cloud Mac 上的優勢

Vuncloud Cloud Mac 7×24 在線，Memory Store 節點持續運行；多節點共享同一 Postgres 實例，記憶自動同步；固定 IP 一次配置永久有效；1TB/2TB 附加儲存讓資料庫與系統碟解耦。

FAQ

Semantica 和 CLAUDE.md 有什麼區別？

CLAUDE.md 是靜態全量載入；Semantica 動態語義檢索，更省 token、更具個人化。兩者不衝突，可同時使用。

Semantica 免費嗎？

核心 SDK 開源免費；雲端託管有免費額度，自託管 Postgres/pgvector 完全零成本。

Claude Code 重啟後記憶會遺失嗎？

配置 Semantica 後不會遺失，記憶持久化到資料庫，下次 session 自動注入。

結語

Semantica 讓 Claude Code 真正做到跨 session 記憶：外置持久化資料庫、語義檢索替代全量載入、hooks 零侵入接入。建議從 Postgres + pgvector 開始，配合 Cloud Mac 節點實現最佳持久化效果。

框架版本與 API 以 Semantica 官方文件為準。最後更新：2026 年 8 月 11 日。