이 글을 마칠 때쯤이면, 여러분은 흩어져 있는 모든 Claude 프로젝트 파일들을 대체할 단 하나의 Notion 허브를 갖게 될 것입니다. 그리고 Claude는 이 허브를 읽고, 쓰고, 자동으로 동기화 상태를 유지할 것입니다. 여러분이 할 일은 단 하나의 프롬프트를 복사하고, 몇 가지 세부 정보를 채운 뒤, Claude에 붙여넣는 것뿐입니다.

아래에 두 가지 프롬프트가 있습니다. 하나는 새로운 프로젝트를 위한 것이고, 다른 하나는 기존 프로젝트를 마이그레이션(Migration)하기 위한 것입니다. 상황에 맞는 것을 선택하세요.

시작하기 전에

Claude Project가 필요합니다. 아래의 모든 과정은 일반적인 대화가 아닌 Claude Project 내부에서 이루어집니다. 아직 프로젝트가 없다면, 먼저 Claude 앱에서 새 프로젝트를 생성하세요. 생성될 개요(Overview) 파일은 프로젝트 파일로 추가되며, 이는 해당 프로젝트 내의 모든 대화에서 해당 파일이 컨텍스트(Context)로 자동 로드됨을 의미합니다. 프로젝트가 없다면 파일을 둘 곳이 없습니다.

Notion이 Claude에 연결되어 있어야 합니다. Claude 앱의 왼쪽 하단에서 본인의 이름을 클릭하고, Settings로 이동한 다음, Connectors를 클릭하고 Browse connectors를 클릭하세요. Notion을 찾아 연결합니다. (참고: Anthropic은 커넥터(Connectors)를 "Customize" 항목 아래로 이동시키고 있습니다. 만약 Connectors 탭이 보이지 않는다면 대신 그곳을 확인하세요.) 30초면 충분합니다. 이 설정이 없으면 Claude가 Notion을 읽거나 쓸 수 없으며, 이 모든 기능이 작동하지 않습니다.

템플릿 1: 새로운 프로젝트 시작하기

처음부터 새로운 Claude Project를 생성하고 첫날부터 Notion 아키텍처(Architecture)를 설정하고 싶다면 이 방법을 사용하세요.

1단계: 아래 프롬프트 상단의 "My project details" 섹션을 채우세요. 대괄호([ ]) 안에 있는 모든 내용은 여러분의 고유한 값으로 채워야 하며, 필요 없는 줄은 삭제하세요. 상단 섹션만 채우면 됩니다. 프롬프트의 나머지 부분은 이를 자동으로 참조합니다.

2단계: Claude 프로젝트에서 대화를 시작하고 전체 내용을 붙여넣으세요:

My project details:
- Project name: [프로젝트 이름]
- Content types: [예: 블로그 포스트, 튜토리얼, 가이드]
...

3단계: Claude가 Notion의 모든 것을 생성하고 여러분에게 OVERVIEW.md 파일을 제공할 것입니다.

4단계: OVERVIEW.md 파일을 다운로드하여 Claude 프로젝트의 프로젝트 파일로 추가하세요. 그러면 끝입니다.

개요 파일은 대략 다음과 같은 모습이어야 합니다:

# 프로젝트 이름 — 허브 (Hub)

모든 문서는 Notion에 있습니다. Claude는 그곳에서 직접 읽고 씁니다. 이 파일은 빠른 참조용 지도입니다.
...

템플릿 2: 기존 프로젝트 마이그레이션 (Migrating an existing project)

이미 Claude 프로젝트에 파일이 있고, 모든 것을 Notion으로 마이그레이션하고 싶은 경우 이 방법을 사용하세요.

1단계: 아래 프롬프트 상단의 "My project details" 섹션을 채우세요. 대괄호([]) 안의 모든 내용은 본인의 값으로 변경해야 하며, 필요 없는 줄은 삭제하세요. 상단 섹션만 채우면 됩니다. 나머지 프롬프트는 해당 섹션을 자동으로 참조합니다.

2단계: Claude 프로젝트에서 대화를 시작하고 전체 내용을 붙여넣으세요:

My project details:
- Project name: [프로젝트 이름]
- Content types: [예: 블로그 포스트, 튜토리얼, 가이드]
...

3단계: Claude가 모든 것을 Notion으로 마이그레이션하고 OVERVIEW.md 파일을 제공할 것입니다.

4단계: OVERVIEW.md 파일을 다운로드하여 Claude 프로젝트에 추가하세요:

• 프로젝트 설정(project settings)으로 이동합니다.
• OVERVIEW.md를 프로젝트 파일로 추가합니다.
• 다른 모든 프로젝트 파일은 삭제하세요 — 이제 Notion에 저장되어 있습니다.

5단계: 완료되었습니다. 해당 프로젝트의 모든 새로운 대화는 다음과 같이 작동합니다:

• 개요(링크, 규칙, 구조)를 즉시 로드합니다.
• 필요한 경우에만 Notion에서 전체 콘텐츠를 가져옵니다 (Fetch).
• 수정 사항을 Notion에 직접 작성합니다.

두 템플릿 공통 팁

• 주요 새 페이지를 추가할 때는 개요 파일을 업데이트하세요 (표에 행만 추가하면 됩니다).
• 데이터베이스 속성 (database properties)을 사용하여 상태를 추적하면 Claude가 필터링 및 검색을 할 수 있습니다.
• Claude가 특정 페이지를 참조해야 하는 경우, 채팅창에 Notion URL을 붙여넣기만 하면 됩니다 — Claude가 이를 가져옵니다.
• Notion에는 버전 기록 (version history)이 있습니다 — Claude가 잘못된 내용을 작성하면 이전 상태로 되돌릴 수 있습니다.

저는 Amazon과 The New York Times에서 근무했던 5년 이상의 경력을 가진 소프트웨어 엔지니어입니다. 이것은 이론적인 예측이 아니라 실제 프로덕션 작업에서 얻은 교훈입니다.