clude-mem 사용자 정의 백엔드 설정

claude-mem의 claude 공급자는 Claude 에이전트 SDK를 통해 요청을 보냅니다. 공식 Custom Anthropic-Compatible Backends 흐름은 배경 관찰 작업자만 변경합니다. 대화형 Claude Code 세션은 변경되지 않습니다. 쉘 내보내기에 의존하는 대신 이 구성을 claude-mem의 자체 디렉토리에 넣으십시오.

1단계: ~/.claude-mem/.env 편집

Bearer 토큰을 사용하는 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에 존재해야 합니다. 게이트웨이가 Bearer 인증 대신 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를 다시 복사하세요.
• 인증 오류: TokenHub Bearer 인증을 위해 ANTHROPIC_AUTH_TOKEN를 사용하세요. 명시적으로 필요한 경우에만 ANTHROPIC_API_KEY를 사용하세요.
• TokenHub 엔드포인트는 OpenAI Chat Completions만 노출합니다. claude 공급자는 이를 직접 호출할 수 없습니다. LiteLLM과 같은 Anthropic 프로토콜 어댑터를 사이에 배치합니다.

공식 참고자료

• claude-mem: 사용자 정의 인류 호환 백엔드