Пользовательская настройка бэкэнда claude-mem

Направьте фонового работника claude-mem на серверную часть, совместимую с TokenHub Anthropic, без изменения сеансов Claude Code.

Создать ключ API TokenHub

Что такое Клод-мем?

claude-mem — это система постоянной памяти, которая запускает фоновый рабочий процесс вместе с Claude Code и поддерживаемыми инструментами кодирования.

Это руководство по claude-mem записывает пользовательскую конечную точку, совместимую с Anthropic, в файл среды конкретного воркера, закрепляет точную модель в настройках и перезапускает воркера, чтобы конфигурация действительно загружалась. Рабочий считывает свою собственную среду и файлы настроек, поэтому изменение экспорта терминала или основной конфигурации кода Claude может не иметь никакого эффекта. Сохраните учетные данные шлюза в документированном рабочем файле, выберите модель, совместимую с Anthropic, перезапустите рабочий процесс и сравните журналы рабочих процессов с запросами TokenHub после следующего цикла обработки.

Поставщик claude claude-mem отправляет запросы через агента Claude SDK. Его официальный поток Custom Anthropic-Compatible Backends меняет только фонового работника наблюдения; это не меняет интерактивный сеанс Claude Code. Поместите эту конфигурацию в собственный каталог claude-mem вместо того, чтобы полагаться на экспорт оболочки.

Шаг 1: отредактируйте ~/.claude-mem/.env

Для шлюза TokenHub Anthropic-compatible, использующего токен носителя, добавьте:

ANTHROPIC_AUTH_TOKEN=YOUR_TOKENHUB_API_KEY
ANTHROPIC_BASE_URL=__API_BASE_URL__

Официальное руководство требует разрешений 0600 для этого файла и 0700 для его каталога; исполнитель также применяет эти разрешения при следующей записи. Агент Claude SDK считывает ANTHROPIC_BASE_URL напрямую, а claude-mem не анализирует и не перезаписывает его.

Не полагайтесь на ANTHROPIC_BASE_URL в текущем терминале. claude-mem создает изолированную рабочую среду, поэтому этот параметр должен существовать в ~/.claude-mem/.env, чтобы выжить при перезапуске. Вместо этого используйте ANTHROPIC_API_KEY только в том случае, если шлюз явно требует x-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 Claude Code, поэтому введите полный идентификатор модели Anthropic-compatible, принятый TokenHub.

Шаг 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 еще раз.
  • Ошибка аутентификации: используйте ANTHROPIC_AUTH_TOKEN для аутентификации носителя TokenHub; используйте ANTHROPIC_API_KEY только в случае явной необходимости.
  • Конечная точка TokenHub предоставляет только OpenAI Chat Completions: провайдер claude не может вызвать ее напрямую; поместите между ними адаптер антропного протокола, например LiteLLM.

Официальная ссылка

Как выбрать модель

НагрузкаВыбор моделиПочему подходит
Сложные задачиМодель рассуждений с инструментамиПодходит для планирования, многошаговых задач и длинного контекста.
Ежедневная работаСбалансированная модельБаланс качества, скорости и стоимости.
Сводки и лёгкие задачиБыстрая недорогая модельСнижает стоимость сводок и простых итераций.
Открыть модели TokenHub

Часто задаваемые вопросы по пользовательскому бэкэнду claude-mem

Изменит ли это мою сессию Claude Code?

Нет. claude-mem считывает свою собственную рабочую среду, поэтому переопределение изолировано от интерактивных сеансов Claude Code.

Зачем использовать ANTHROPIC_AUTH_TOKEN?

В руководстве по пользовательскому бэкэнду claude-mem отмечается, что учетные данные шлюза обычно используют ANTHROPIC_AUTH_TOKEN. Используйте формат учетных данных, который требуется для вашей конечной точки TokenHub.

Могу ли я использовать конечную точку модели только для OpenAI?

Не напрямую с провайдером клода. Сначала установите Anthropic-совместимый шлюз, такой как LiteLLM, перед восходящим каналом только для OpenAI.

Как проверить, что рабочий процесс claude-mem использует TokenHub?

Перезапустите рабочий процесс, дождитесь следующего цикла обработки наблюдения и сравните журнал рабочего процесса с запросом Anthropic Messages в журналах TokenHub.

Почему экспорт оболочки не обновил claude-mem?

Существующий фоновый рабочий процесс не может наследовать текущую оболочку. Сохраните значения в ~/.claude-mem/.env и перезапустите работника.

Источники

Эта настройка основана на TokenHub и официальной документации; последняя проверка: 2026-09-08。

Сравните настройку и совместимость моделей похожих инструментов.

LangChainOpenAI Compatible