claude-mem カスタム バックエンドのセットアップ

claude-mem の claude プロバイダーは、クロード エージェント SDK を通じてリクエストを送信します。公式の Custom Anthropic-Compatibility Backends フローでは、バックグラウンド観測ワーカーのみが変更されます。インタラクティブなクロード コード セッションは変更されません。シェルのエクスポートに依存するのではなく、この構成を claude-mem の独自のディレクトリに置きます。

ステップ 1: ~/.claude-mem/.env を編集する

ベアラー トークンを使用する TokenHub Anthropic-compatible ゲートウェイの場合、次を追加します。

ANTHROPIC_AUTH_TOKEN=YOUR_TOKENHUB_API_KEY
ANTHROPIC_BASE_URL=__API_BASE_URL__

公式ガイドでは、このファイルに対する 0600 権限と、そのディレクトリに対する 0700 権限が必要です。ワーカーは、次回の書き込み時にそれらのアクセス許可を強制します。クロード エージェント 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 はエイリアスを変換せず、クロード コードの 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 のパブリック エンドポイントにサイレントにフォールバックしません。

分離されたワーカー構成のトラブルシューティングを行う

• クロード コードは TokenHub を使用しますが、claude-mem は使用しません。これらは別の設定です。 ~/.claude-mem/.env と settings.json を検査します。
• 編集後も古い URL が残ります: worker:restart を実行します。端末を再度開くだけでは十分ではありません。
• モデルが存在しません: CLAUDE_MEM_MODEL にはエイリアス変換がないため、TokenHub モデル ID を再度コピーします。
• 認証エラー: TokenHub ベアラー認証には ANTHROPIC_AUTH_TOKEN を使用してください。明示的に必要な場合にのみ、ANTHROPIC_API_KEY を使用してください。
• TokenHub エンドポイントは OpenAI Chat Completions のみを公開します。claude プロバイダーはそれを直接呼び出すことはできません。 LiteLLM などの Anthropic プロトコル アダプターを間に配置します。

公式リファレンス

• claude-mem: カスタム Anthropic 互換バックエンド