ilhae.ai

CHAPTER 11 / 11

부록 C. [추가] 본문 [추가] 항목의 상세

『claude-mem 사용법: Claude Code 장기 기억 설치 가이드』 · 김재우 · 2026년 11월 8일

npx claude-mem install은 npm 레지스트리에서 패키지를 받는 것 외에, Bun과 uv가 없으면 이것들도 외부에서 내려받아 설치합니다.

미리 읽기

[추가] 본문에 짧게 적은 보완 내용의 상세입니다. 모두 2026년 11월 8일 기준 claude-mem 공식 문서로 확인했습니다.

C-1. 사내 프록시·인증서 환경에서 설치하기

npx claude-mem install은 npm 레지스트리에서 패키지를 받는 것 외에, Bun과 uv가 없으면 이것들도 외부에서 내려받아 설치합니다.

  • 프록시는 HTTPS_PROXY / HTTP_PROXY 환경 변수로, SSL 검사용 사내 루트 인증서는 Node.js 표준 환경 변수 NODE_EXTRA_CA_CERTS로 지정한 뒤 그 셸에서 설치를 실행합니다.
  • Bun이나 uv 자동 설치가 실패하면 사내 미러나 승인된 경로로 먼저 설치해 PATH에 잡아 둔 뒤 npx claude-mem repair와 npx claude-mem doctor로 다시 확인합니다.
  • 외부 접속이 막힌 환경에서는 3장의 "Could not start the optional claude-mem sign-in"이 거의 항상 뜹니다. 계정 흐름을 쓰지 않을 거라면 --provider를 명시하고 CLAUDE_MEM_ONLINE_OPTIN=false도 설정해 두세요.

C-2. 실제 포트 확인과 뷰어 갱신 문제

curl -s http://127.0.0.1:$CLAUDE_MEM_WORKER_PORT/api/health | jq .port

공식 트러블슈팅 문서는 회사 방화벽이나 VPN이 뷰어의 실시간 갱신(SSE)을 막을 수 있다고 안내합니다. 뷰어는 열리는데 카드가 갱신되지 않으면 curl -N http://127.0.0.1:<포트>/stream으로 스트림이 오는지 확인하세요. 포트 충돌이 나면 lsof -i :<포트>로 점유 프로세스를 찾고, 필요하면 CLAUDE_MEM_WORKER_PORT를 다른 값으로 지정합니다.

이 장의 나머지 내용은 읽기 화면에서 이어서 볼 수 있어요.

이어서 읽기

이 장에서 다루는 것

  1. C-1. 사내 프록시·인증서 환경에서 설치하기
  2. C-2. 실제 포트 확인과 뷰어 갱신 문제
  3. C-3. 모드 체인과 동작 확인
  4. C-4. 보완: 자동 마스킹과 텔레메트리 일괄 차단
  5. C-5. Windows의 "bun" is not recognized 오류
  6. C-6. 기억 DB 백업과 복원

ilhae.ai 안내 도우미대기 중

글자를 치면 사이트 자료를 바로 찾아요. AI 대화는 하루 20번까지이고, 질문 앞부분은 서비스 개선을 위해 30일 보관해요. 개인정보는 적지 마세요.