克勞德梅姆是什麼?
claude-mem 是一個持久記憶體系統,它與 Claude Code 和支援的編碼工具一起運行後台工作程序。
此 claude-mem 指南將自訂的 Anthropic 相容端點寫入特定於工作程序的環境文件,在設定中固定確切的模型,然後重新啟動工作程序,以便實際載入配置。工作執行緒讀取自己的環境和設定文件,因此更改終端匯出或主 Claude Code 配置可能不會產生任何效果。將網關憑證保留在記錄的工作程序檔案中,選擇與 Anthropic 相容的模型,重新啟動工作程序,並在下一個處理週期後將工作程序日誌與 TokenHub 請求進行比較。
claude-mem 的 claude 提供者透過 Claude 代理 SDK 發送請求。其官方自訂人類相容後端流程僅更改後台觀察工作人員;它不會更改互動式 Claude Code 會話。把這個配置放在claude-mem自己的目錄下,而不是依賴shell導出。
步驟1:編輯~/.claude-mem/.env
對於使用承載令牌的 TokenHub Anthropic-compatible 網關,新增:
ANTHROPIC_AUTH_TOKEN=YOUR_TOKENHUB_API_KEY
ANTHROPIC_BASE_URL=__API_BASE_URL__官方指南要求該檔案具有 0600 權限,對其目錄需要 0700 權限;工作執行緒還在下一次寫入時強制執行這些權限。 Claude Agent SDK 直接讀取 ANTHROPIC_BASE_URL,而 claude-mem 不會對其進行解析或重寫。
不要依賴目前終端機中的ANTHROPIC_BASE_URL。 claude-mem 建構了一個隔離的工作環境,因此該設定必須存在於 ~/.claude-mem/.env 中才能在重新啟動後繼續存在。只有當網關明確要求 x-api-key 而不是承載身份驗證時,才使用 ANTHROPIC_API_KEY。
第 2 步:將工作模型固定在 settings.json 中
編輯~/.claude-mem/settings.json:
{
"CLAUDE_MEM_PROVIDER": "claude",
"CLAUDE_MEM_MODEL": "YOUR_TOKENHUB_ANTHROPIC_MODEL_ID"
}CLAUDE_MEM_MODEL 不變地傳遞給 SDK。 claude-mem不會翻譯別名,也不會讀取Claude Code的ANTHROPIC_DEFAULT_HAIKU_MODEL,因此輸入TokenHub接受的完整Anthropic-compatible模型ID。
步驟 3:使用官方命令重新啟動並檢查日誌
npm run worker:restart
npm run worker:logs等待下一次觀察沖洗。成功運行首先記錄 SDK Starting SDK query,然後記錄 Response received。網關故障寫入 worker-error.log;claude-mem 不會默默地回退到 Anthropic 的公共端點。
排除隔離工作配置的故障
- Claude Code 使用 TokenHub 但 claude-mem 不使用:這些是單獨的設定;檢查
~/.claude-mem/.env和settings.json。 - 舊的 URL 編輯後仍然保留:運行
worker:restart;重新開啟終端是不夠的。 - 型號不存在:
CLAUDE_MEM_MODEL沒有別名翻譯,因此再次複製TokenHub型號ID。 - 認證錯誤:使用
ANTHROPIC_AUTH_TOKEN進行TokenHub Bearer認證;僅在明確需要時才使用ANTHROPIC_API_KEY。 - TokenHub端點僅公開OpenAI Chat Completions:
claude提供者無法直接呼叫它;在兩者之間放置一個 Anthropic 協定適配器,例如 LiteLLM。
官方參考
如何選擇推薦模型?
claude-mem 自訂後端常見問題解答
這會改變我的 Claude Code 會話嗎?
不會。 claude-mem 會讀取自己的工作環境,因此覆蓋與互動式 Claude 程式碼會話隔離。
為什麼要使用 ANTHROPIC_AUTH_TOKEN?
claude-mem 自訂後端指南指出,網關憑證通常使用 ANTHROPIC_AUTH_TOKEN。使用您的 TokenHub 端點所需的憑證格式。
我可以使用僅限 OpenAI 的模型端點嗎?
不直接與克勞德提供者聯繫。首先將一個與 Anthropic 相容的網關(例如 LiteLLM)放在僅限 OpenAI 的上游前面。
如何驗證 claude-mem 工作執行緒是否使用 TokenHub?
重新啟動工作器,等待下一個觀察處理週期,並將工作器日誌與 TokenHub 日誌中的 Anthropic Messages 請求進行比較。
為什麼 shell 導出沒有更新 claude-mem?
現有的後台工作人員可能不會繼承目前的 shell。保留 ~/.claude-mem/.env 中的值並重新啟動工作程序。
參考資料
本頁設定依據 TokenHub 教學與官方資料,最後驗證日期為 2026-09-08。