claude-mem 自訂後端設置

將 claude-mem 後台工作執行緒路由到 TokenHub Anthropic 相容的後端,而無需更改 Claude 程式碼會話。

克勞德梅姆是什麼?

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/.envsettings.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。