GYMCODING

Claude Code × NotebookLM: 클로드 코드가 지난 작업을 찾게 만드는 법

Claude Code의 기본 기억과 Gemini Notebook의 차이부터 MCP 연결, 세션 기록 저장과 검색 검증까지 정확한 설정법을 단계별로 설명합니다.

이런 분을 위한 글입니다

  • Claude Code를 쓰지만 새 대화마다 프로젝트 배경을 다시 설명하는 분
  • 이전 결정과 다음 작업을 대화 밖에 안전하게 남기고 싶은 분

읽고 나면 이렇게 달라집니다

  • Claude Code에 Gemini Notebook을 MCP로 연결한다
  • 대화 끝에 핵심 맥락을 저장하는 스킬을 만든다
  • 새 대화에서 필요한 과거 기록만 검색하도록 설정한다

Claude Code가 새 대화에서 지난 작업을 이어가게 하려면 어떻게 해야 할까요?

가장 실용적인 방법은 대화의 핵심만 Gemini Notebook에 저장하고, 다음 대화에서 필요한 기록을 검색하게 만드는 것입니다. Claude 자체의 기억을 늘리는 기능은 아닙니다. Claude가 저장과 검색을 반복하도록 작업 흐름을 만드는 방법입니다.

이 글에서는 Claude Code에 Gemini Notebook을 연결하고 다음 흐름을 완성합니다.

  1. 대화를 마칠 때 “기억 저장”이라고 말합니다.
  2. Claude가 결정과 미완료 작업을 요약합니다.
  3. 사용자가 확인한 요약만 Gemini Notebook의 Claude Memory 노트북에 저장합니다.
  4. 새 대화에서 현재 질문과 관련된 기록만 검색합니다.

이 글에서 사용하는 서비스의 정식 명칭은 Gemini Notebook입니다. 2026년 7월까지는 NotebookLM이라는 이름을 사용했으며, 현재 공식 웹 주소는 notebook.google.com입니다. 설치 패키지와 MCP 서버 이름에는 이전 명칭인 notebooklm이 남아 있어 명령어에서는 그대로 사용합니다.

Claude Code에 이미 기억 기능이 있는데 왜 Gemini Notebook을 쓰나요?

Claude Code에는 이미 CLAUDE.md와 Auto memory가 있습니다. Gemini Notebook은 이 기능을 대체하는 것이 아니라 기기 밖에서 오래 보관하고 검색할 기록이 필요할 때 보완하는 장치입니다.

  • CLAUDE.md는 사람이 작성하는 프로젝트 규칙입니다. 프로젝트 루트의 파일은 매 세션 전체가 로드됩니다. Git에 커밋하면 팀원과 공유할 수 있습니다.
  • Auto memory는 Claude가 작업 중 발견한 패턴을 로컬에 남기는 기능입니다. 저장 위치는 ~/.claude/projects/<project>/memory/이며 다른 컴퓨터나 클라우드 세션으로 자동 동기화되지 않습니다.
  • Auto memory의 시작 파일인 MEMORY.md는 첫 200줄 또는 25KB 중 먼저 도달한 범위만 세션 시작 시 로드됩니다. 나머지 주제 파일은 필요할 때 읽습니다.
  • Gemini Notebook은 사용자가 승인한 세션 요약을 계정 기반 저장소에 쌓고, Claude Code가 MCP로 검색하도록 만듭니다.

즉, 항상 지켜야 할 규칙은 CLAUDE.md, Claude가 로컬에서 축적할 작업 습관은 Auto memory, 여러 세션에 걸쳐 검색할 결정과 작업 기록은 Gemini Notebook에 두는 방식이 적절합니다.

Claude Code의 두 번째 뇌는 어떻게 작동하나요?

Claude Code가 대화 전체를 영구적으로 암기하는 것은 아닙니다.

  • Claude Code는 현재 작업을 진행합니다.
  • MCP 서버는 Claude Code와 Gemini Notebook을 연결합니다.
  • 기억 저장 스킬은 무엇을 어떤 형식으로 남길지 정합니다.
  • CLAUDE.md는 과거 맥락이 필요할 때 먼저 검색하도록 안내합니다.

캐러셀에서 설명한 것처럼 핵심은 이것입니다.

클로드가 기억하는 것이 아니라, 기억을 찾아 쓰게 만드는 것입니다.

시작 전 준비물

  • Claude Code
  • 최신 LTS 버전의 Node.js와 npm
  • Chrome 또는 Chromium
  • Google 계정
  • 테스트용 프로젝트 폴더

터미널에서 먼저 설치 상태를 확인하세요.

claude --version
node --version
npm --version

세 명령이 모두 버전을 출력하면 다음 단계로 넘어갑니다.

이 글에서 사용하는 notebooklm-mcp-server는 Google이나 Anthropic이 운영하는 공식 연동이 아닙니다. 커뮤니티가 만든 비공식 도구이며, Google의 내부 동작을 이용하므로 서비스 변경에 따라 갑자기 작동하지 않을 수 있습니다. 먼저 테스트용 Google 계정과 테스트 노트북으로 확인하세요.

설치 과정 한눈에 보기

1단계. Claude Memory 노트북 만들기

브라우저에서 Gemini Notebook에 접속합니다. Google 계정으로 로그인한 뒤 새 노트북을 만들고 이름을 정확히 입력하세요.

Claude Memory

지금은 자료를 추가하지 않아도 됩니다.

이 글의 연결 방식은 로그인한 계정의 노트북 목록을 직접 조회합니다. 노트북을 공개로 공유하거나 ‘링크가 있는 모든 사용자’로 바꿀 필요가 없습니다.

2단계. Google 로그인 연결하기

터미널에서 아래 명령을 실행합니다.

npx -y notebooklm-mcp-server auth

브라우저 창이 열리면 1단계에서 사용한 Google 계정으로 직접 로그인합니다. 노트북 목록이 보이면 인증이 끝난 것입니다.

로그인 세션은 컴퓨터의 다음 경로에 저장됩니다.

~/.notebooklm-mcp/auth.json

이 파일에는 로그인 세션 정보가 들어 있으므로 다른 사람에게 보내거나 Git 저장소에 추가하면 안 됩니다.

Google 비밀번호, 쿠키, 인증 토큰을 Claude 대화창이나 설정 파일에 직접 붙여넣지 마세요. 로그인은 열린 브라우저에서 본인이 직접 완료합니다.

3단계. Claude Code에 MCP 서버 등록하기

터미널에 아래 명령을 붙여넣습니다.

claude mcp add notebooklm -- npx -y notebooklm-mcp-server start

등록 상태를 확인합니다.

claude mcp list

목록에서 notebooklm의 상태가 Connected인지 확인하세요. 더 자세한 연결 정보는 claude mcp get notebooklm으로 확인할 수 있습니다. 현재 실행 중인 Claude Code에 도구가 나타나지 않으면 Claude Code를 완전히 종료한 뒤 다시 실행하세요.

새 Claude Code 대화에서 다음 프롬프트로 실제 연결을 확인합니다.

notebooklm MCP의 notebook_list 도구를 사용해
내 노트북 목록을 보여줘.

확인할 것:
- "Claude Memory"라는 노트북이 있는지
- 해당 노트북의 ID가 무엇인지

노트북을 만들거나 삭제하거나 수정하지 말고 조회만 해줘.

목록에 Claude Memory가 나오면 연결이 끝났습니다.

4단계. “기억 저장” 스킬 만들기

연결만 해두면 Claude가 알아서 대화를 저장하지 않습니다. 저장 요청을 받았을 때 무엇을 남길지 정하는 스킬이 필요합니다.

프로젝트 안에 다음 파일을 만듭니다.

SKILL.md에 아래 내용을 붙여넣습니다.

---
name: memory-save
description: 현재 Claude Code 세션의 결정, 진행 상황, 미완료 작업을 Claude Memory 노트북에 저장합니다. "기억 저장", "오늘 내용 저장해줘", "wrap up" 같은 요청에 사용합니다.
---

# 대화 기억 저장

## 실행 순서

1. notebooklm MCP의 notebook_list를 호출한다.
2. 이름이 정확히 "Claude Memory"인 노트북을 찾는다.
3. 같은 이름이 여러 개면 임의로 선택하지 말고 사용자에게 확인한다.
4. 현재 대화를 아래 형식으로 요약한다.
5. 저장 전에 요약과 저장할 노트북 이름을 사용자에게 보여준다.
6. 사용자가 승인하면 notebook_add_text를 사용해 요약을 새 자료로 저장한다.
7. 저장 결과에서 새 자료의 제목 또는 ID를 확인한다.
8. notebook_query로 방금 저장한 주제를 질문해 검색되는지 확인한다.
9. 저장된 제목과 검색 확인 결과를 사용자에게 알려준다.

## 제목 형식

세션 YYYY-MM-DD — <한 줄 주제>

## 요약 형식

날짜:
주제:
이번 세션에서 한 일:
결정한 것:
아직 끝나지 않은 것:
다음에 할 것:
기억할 사실:

## 규칙

- 대화에서 확인된 사실만 적는다.
- 추측이나 각색은 넣지 않는다.
- 비밀번호, API 키, 토큰, 쿠키는 저장하지 않는다.
- 긴 코드 전체 대신 파일 경로와 변경 이유를 저장한다.
- 사용자의 승인 없이 Gemini Notebook을 변경하지 않는다.
- 저장이나 검색이 실패하면 성공했다고 말하지 않는다.

폴더와 파일을 직접 만들기 어렵다면 Claude Code에 다음 프롬프트를 입력하세요.

현재 프로젝트에 대화 기억 저장 스킬을 만들어줘.

파일 경로:
.claude/skills/memory-save/SKILL.md

스킬 요구사항:
- name은 memory-save로 설정한다.
- "기억 저장", "오늘 내용 저장해줘", "wrap up" 요청에 사용한다.
- notebooklm MCP의 notebook_list에서 이름이 정확히 "Claude Memory"인 노트북을 찾는다.
- 같은 이름의 노트북이 여러 개면 임의로 고르지 말고 나에게 확인한다.
- 현재 세션의 한 일, 결정, 미완료 작업, 다음 할 일, 기억할 사실을 요약한다.
- 저장 전에 요약과 대상 노트북을 나에게 보여주고 승인을 받는다.
- 승인 후 notebook_add_text로 새 자료를 저장한다.
- 제목은 "세션 YYYY-MM-DD — 한 줄 주제" 형식으로 만든다.
- 저장 후 notebook_query로 방금 저장한 내용이 검색되는지 확인한다.
- 비밀번호, API 키, 토큰, 쿠키는 저장하지 않는다.
- 실패하면 완료했다고 말하지 않는다.

기존 파일이 있다면 바로 덮어쓰지 말고 차이를 먼저 보여줘.
파일을 만든 뒤 최종 내용을 보여줘.

Claude Code는 프로젝트의 .claude/skills/<이름>/SKILL.md를 사용자 정의 스킬로 인식합니다. 새 .claude/skills 폴더를 현재 세션에서 처음 만들었다면 Claude Code를 다시 시작하는 편이 확실합니다.

5단계. 새 대화에서 기억부터 찾게 만들기

저장만 하고 검색하지 않으면 기록은 쌓이지만 실제 작업에는 쓰이지 않습니다.

프로젝트 루트의 CLAUDE.md 맨 위에 아래 내용을 추가하세요. 기존 내용이 있다면 삭제하지 않습니다.

# 기억 라우팅

- 과거 결정, 이전 작업, 프로젝트 배경이 현재 요청에 필요하면 사용자에게 다시 설명해 달라고 하기 전에 notebooklm MCP를 확인한다.
- notebook_list에서 이름이 정확히 "Claude Memory"인 노트북을 찾는다.
- 같은 이름이 여러 개면 임의로 선택하지 않고 사용자에게 확인한다.
- notebook_query로 현재 질문과 관련된 결정, 미완료 작업, 다음 할 일만 검색한다.
- 검색 결과를 현재 사실처럼 단정하기 전에 기록의 날짜와 현재 프로젝트 상태를 함께 확인한다.
- 기록에 없는 내용은 없다고 말하고 지어내지 않는다.
- 비밀번호, API 키, 토큰, 쿠키는 저장하거나 요청하지 않는다.

Claude Code에 수정을 맡기려면 아래 프롬프트를 사용하세요.

현재 프로젝트의 CLAUDE.md 맨 위에 "기억 라우팅" 규칙을 추가해줘.

규칙:
1. 과거 결정이나 프로젝트 배경이 필요하면 다시 묻기 전에 notebooklm MCP를 확인한다.
2. notebook_list에서 이름이 정확히 "Claude Memory"인 노트북을 찾는다.
3. 같은 이름이 여러 개면 임의로 고르지 않고 나에게 확인한다.
4. notebook_query로 현재 질문에 필요한 결정, 미완료 작업, 다음 할 일만 검색한다.
5. 검색된 기록의 날짜와 현재 프로젝트 상태를 함께 확인한다.
6. 기록에 없는 내용은 없다고 말하고 지어내지 않는다.
7. 비밀번호, API 키, 토큰, 쿠키는 저장하거나 요청하지 않는다.

기존 CLAUDE.md를 삭제하거나 덮어쓰지 말고 맨 위에 추가해줘.
수정하기 전에 변경될 내용을 보여주고, 수정 후에는 차이를 보여줘.

설치부터 검증까지 맡기는 복사형 프롬프트

한 단계씩 진행하는 것이 가장 안전합니다. 그래도 Claude Code에 점검과 파일 생성을 맡기고 싶다면 다음 프롬프트를 사용하세요.

역할:
Claude Code에 Gemini Notebook을 연결하고 저장·검색 환경을 구성하는 설치 담당자

환경:
- 운영체제: macOS
- 셸: zsh
- Gemini Notebook의 노트북 이름: Claude Memory
- MCP 서버 이름: notebooklm

목표:
Claude Code 대화의 핵심 내용을 Gemini Notebook의 Claude Memory 노트북에 저장하고 새 대화에서 검색해 사용한다.

중요:
Google 로그인은 터미널에서 "npx -y notebooklm-mcp-server auth"를 실행한 뒤
열리는 브라우저에서 내가 직접 완료한다.
로그인이 끝나기 전에는 다음 단계로 넘어가지 않는다.

작업 순서:
1. claude --version, node --version, npm --version을 확인한다.
2. claude mcp list로 notebooklm 서버 등록 여부를 확인한다.
3. 등록되지 않았다면 아래 명령을 실행한다.
   claude mcp add notebooklm -- npx -y notebooklm-mcp-server start
4. MCP 등록 후 Claude Code 재시작이 필요하면 여기서 멈추고 안내한다.
5. 재시작 후 notebook_list를 조회 전용으로 호출한다.
6. 이름이 정확히 "Claude Memory"인 노트북이 있는지 확인한다.
7. 같은 이름이 여러 개면 임의로 선택하지 말고 나에게 확인한다.
8. .claude/skills/memory-save/SKILL.md를 만든다.
9. CLAUDE.md 맨 위에 기억 검색 규칙을 추가한다.
10. 테스트용 요약을 저장하기 전에 내용과 대상 노트북을 보여주고 승인을 받는다.
11. 승인 후 notebook_add_text로 테스트 기록을 저장한다.
12. 저장 결과에서 새 자료의 제목 또는 ID를 확인한다.
13. notebook_query로 방금 저장한 내용을 다시 찾을 수 있는지 확인한다.

안전 규칙:
- Google 로그인은 내가 브라우저에서 직접 한다.
- 비밀번호, API 키, 토큰, 쿠키를 화면이나 파일에 기록하지 않는다.
- ~/.notebooklm-mcp/auth.json을 읽거나 출력하거나 Git에 추가하지 않는다.
- 기존 MCP 설정과 CLAUDE.md 내용을 삭제하거나 덮어쓰지 않는다.
- Gemini Notebook을 변경하기 전에는 내 확인을 받는다.
- 한 단계가 실패하면 다음 단계로 넘어가지 않는다.
- 확인하지 않은 작업을 완료했다고 말하지 않는다.

마지막 보고 형식:
- Claude Code, Node.js, npm 상태
- MCP 등록 상태
- Claude Memory 조회 결과
- 생성하거나 변경한 파일
- 저장 테스트 결과
- 검색 테스트 결과
- 남은 오류와 다음 조치

로그인은 Claude Code 대화 안에서 비밀번호를 전달하는 방식이 아닙니다. 먼저 터미널에서 npx -y notebooklm-mcp-server auth를 실행하고, 열린 브라우저에서 본인이 직접 로그인해야 합니다.

제대로 연결됐는지 검증하는 방법

설치는 명령이 끝났다고 완료되는 것이 아닙니다. 아래 다섯 가지가 모두 확인되어야 합니다.

1. MCP가 등록됐나요?

claude mcp list

notebooklm 서버가 목록에 보이고 상태가 Connected여야 합니다. 실패 상태라면 claude mcp get notebooklm으로 원인을 확인하세요.

2. Claude Memory가 조회되나요?

notebooklm MCP의 notebook_list를 사용해
"Claude Memory" 노트북의 이름과 ID만 보여줘.
조회 외의 변경은 하지 마.

3. 저장 전에 확인을 요청하나요?

작업을 짧게 진행한 뒤 다음과 같이 입력합니다.

기억 저장

Claude가 바로 저장하지 않고 먼저 요약과 대상 노트북을 보여줘야 합니다.

4. 새 자료가 실제로 만들어졌나요?

승인 후 Claude가 notebook_add_text 결과에서 새 자료의 제목 또는 ID를 확인해야 합니다. 브라우저에서 Claude Memory를 새로고침해 자료가 추가됐는지도 직접 확인하세요.

5. 새 대화에서 다시 찾을 수 있나요?

Claude Code를 종료하고 같은 프로젝트에서 새 대화를 연 뒤 질문합니다.

Claude Memory에서 가장 최근 세션의 결정과
다음에 할 일을 찾아서 알려줘.

검색된 기록의 날짜도 함께 말해줘.
기록이 없으면 없다고 말하고 추측하지 마.

저장한 내용과 날짜가 검색되면 전체 흐름이 작동하는 것입니다.

자주 묻는 질문

사용 전에 알아둘 한계와 보안 주의사항

1. 비공식 도구라서 언제든 바뀔 수 있습니다

이 MCP 서버는 Google의 공식 공개 API가 아니라 역공학한 내부 동작을 사용합니다. 오늘 작동해도 서비스가 바뀌면 인증이나 도구 호출이 실패할 수 있습니다.

따라서 “설치 명령이 실행됐다”가 아니라 노트북 조회, 저장, 재검색까지 직접 검증해야 합니다.

2. 로그인 세션 파일을 보호해야 합니다

~/.notebooklm-mcp/auth.json에는 로그인 세션 정보가 저장됩니다.

  • 파일 내용을 Claude에게 읽어 달라고 요청하지 않습니다.
  • 다른 사람과 공유하지 않습니다.
  • Git 저장소에 추가하지 않습니다.
  • 공용 컴퓨터에서는 사용하지 않습니다.
  • 가능하면 테스트용 또는 전용 Google 계정을 사용합니다.

3. 저장된 요약도 틀릴 수 있습니다

Claude가 대화를 잘못 요약하면 다음 세션에서도 잘못된 맥락을 가져올 수 있습니다. 그래서 저장 전 사용자 확인이 필요합니다.

검색된 과거 기록도 현재 코드나 문서보다 오래됐을 수 있습니다. 날짜와 현재 프로젝트 상태를 함께 확인하세요.

4. 사용량 제한은 바뀔 수 있습니다

2026년 9월 1일 기준 무료 계정은 노트북 하나에 자료를 최대 50개까지 넣을 수 있습니다.

다만 질문 한도는 바로 다음 날인 2026년 9월 2일부터 계산량 기반 방식으로 변경될 예정입니다. 질문의 복잡도, 사용 모델, 대화 길이 등에 따라 사용량이 달라지고, 일정 시간과 주간 단위로 한도가 갱신됩니다.

따라서 “무료 계정은 하루 질문 50회”라는 고정 숫자는 앞으로 정확하지 않을 수 있습니다. Google의 최신 사용량 안내를 확인하세요.

핵심 정리

Claude Code에 두 번째 뇌를 붙인다는 말은 Claude가 모든 대화를 영구적으로 암기한다는 뜻이 아닙니다.

  • Claude Code가 현재 작업을 진행합니다.
  • 기억 저장 스킬이 다음에도 필요한 맥락을 요약합니다.
  • 사용자가 확인한 내용만 Gemini Notebook의 Claude Memory 노트북에 저장합니다.
  • CLAUDE.md가 과거 기록이 필요할 때 먼저 검색하도록 안내합니다.
  • 검색된 기록의 날짜와 현재 프로젝트 상태를 함께 확인합니다.

처음에는 중요한 정보가 없는 테스트 프로젝트에서 기록 하나만 저장해보세요. 새 대화에서 그 기록을 다시 찾아오면 설정이 제대로 작동하는 것입니다.

짐코딩 뉴스레터
AI 개발·클로드 코드 실전 노하우를 이메일로 받아보세요. 도움 되는 글만.

구독하면 마케팅 정보 수신 및 개인정보처리방침에 따른 이메일 수집·이용에 동의하게 됩니다. 언제든 수신거부할 수 있어요.