1. 같은 설명을 반복하고 있다면

Claude와 일을 하다 보면 같은 설명을 매번 다시 하게 되는 순간이 옵니다. "나는 제주에서 카페를 하고 있고, 우리 가게 색은 초록이고, 문구는 존댓말로, 가격은 절대 지어내지 마." 이 문장을 대화를 열 때마다 적고 있다면 방식을 바꿀 때입니다. Claude Desktop에는 이 설명을 한 번만 적어두는 자리가 두 곳 있습니다. 채팅과 Cowork의 프로젝트, 그리고 Code 탭의 CLAUDE.md입니다.

2. 프로젝트

2.1 프로젝트란?

프로젝트는 관련된 대화와 파일, 지침을 한데 묶어 두는 작업 공간입니다. 채팅 탭과 Cowork 탭의 사이드바에 있습니다. 프로젝트 안에서 새 대화를 열면 프로젝트에 적어둔 지침과 넣어둔 파일을 Claude가 이미 알고 있는 상태에서 시작합니다.

바이브 코딩에서 프로젝트가 유용한 순간은 만들기 전입니다. 무엇을 만들지 이야기하고, 자료를 모으고, 참고할 서비스를 분석하는 일은 채팅 탭에서 하는 편이 편합니다. 이런 대화가 여러 번 이어진다면 프로젝트로 묶어 두세요. 10장에서 한 문단 브리프를 쓰기 전에 생각을 정리하는 자리로도 씁니다.

2.2 프로젝트 만들기

사이드바에서 프로젝트를 클릭하고 새 프로젝트 버튼을 누릅니다.

이름과 목표를 입력합니다. 목표는 한 문장이면 됩니다. "제주 카페 홍보 페이지를 만들기 위한 기획과 자료 정리" 정도입니다.

프로젝트가 만들어지면 지침, 메모리, 컨텍스트를 관리하는 화면이 열립니다.

2.3 지침 적기

지침 영역의 + 버튼을 눌러 프로젝트 지침을 추가합니다. 매번 반복하던 그 설명을 여기에 적습니다.

나는 제주에서 '모모의 정원'이라는 카페를 운영하고 있어. 개발은 전혀 모르는 사람이야.
- 가게 색은 초록 계열, 분위기는 차분하게
- 문구는 존댓말로, 과장된 표현은 쓰지 마
- 가격, 영업시간, 주소는 내가 알려준 것만 쓰고 절대 지어내지 마
- 기술 용어가 나오면 한 문장으로 풀어서 설명해줘

좋은 지침과 나쁜 지침의 차이는 구체성입니다. "좋은 페이지를 만들어줘"는 지침이 아닙니다. "가격은 지어내지 마"는 지침입니다. 앞 절의 검토에서 자주 걸리는 것을 지침으로 올리면 됩니다.

2.4 폴더와 파일 넣기

컨텍스트 영역에 파일을 올리거나, 폴더 추가 버튼으로 내 컴퓨터의 폴더를 연결할 수 있습니다. 폴더를 연결하면 Cowork가 그 폴더 안에서 파일을 읽고 쓸 수 있게 됩니다.

무엇을 넣을지는 '이 프로젝트에서 매번 참고할 것'이 기준입니다. 로고, 메뉴판 사진, 지난 홍보물, 경쟁 카페 페이지 캡처처럼 만들 때마다 꺼내 볼 재료를 넣습니다. 반대로 한 번 쓰고 말 파일은 대화에 첨부하면 됩니다.

2.5 새 대화에서도 유지되는 맥락

프로젝트 안에서 새 대화를 열어 보세요. 지침을 다시 적지 않아도 Claude가 카페 이름과 규칙을 알고 답합니다. 프로젝트 화면에는 이전 대화와 만들어진 문서가 함께 보입니다.

프로젝트 제목 옆 메뉴를 열면 즐겨찾기, 세부사항 수정, 보관 항목이 있습니다. 지침은 언제든 고칠 수 있습니다. 결과가 자꾸 어긋나는 지점이 있다면 지침에 한 줄 더하는 것으로 해결될 때가 많습니다.

3. CLAUDE.md

3.1 Code 탭에는 프로젝트 메뉴가 없다

Code 탭의 사이드바에는 프로젝트 메뉴가 없습니다. Code 탭은 폴더 자체가 프로젝트이기 때문입니다. 대신 폴더 안에 CLAUDE.md라는 파일을 두면 Claude가 그 폴더에서 일할 때마다 이 파일을 먼저 읽습니다. 프로젝트 지침이 파일로 존재하는 셈입니다.

앞 절에서 /init으로 이 파일을 만들어보았습니다. Claude가 폴더를 살펴보고 프로젝트 구조를 정리해 만들어준 파일이었죠. 여기에 여러분의 규칙을 더하면 됩니다.

3.2 규칙 더하기

CLAUDE.md를 메모장으로 열고 아래처럼 한 부분을 추가합니다. 위치는 어디든 상관없지만 맨 아래에 두는 것이 찾기 편합니다.

## 이 프로젝트의 규칙

- 이 프로젝트를 유지보수하는 사람은 개발을 모르는 사람이다. 새 기술이나 도구를 도입하기 전에 반드시 먼저 물어볼 것
- 가격, 영업시간, 주소는 index.html에 적힌 것만 쓰고 절대 지어내지 말 것
- 파일을 새로 만들면 무슨 파일인지 한 줄로 설명할 것
- 작업이 끝나면 무엇을 바꿨는지 세 줄로 요약할 것

직접 고치는 것이 낯설다면 Code 탭에 시켜도 됩니다.

@CLAUDE.md 에 '이 프로젝트의 규칙' 절을 추가해줘. 규칙은 아래 네 가지야.
(위 네 줄)

3.3 프로젝트 지침과 CLAUDE.md의 차이

둘 다 쓰는 것이 자연스럽습니다. 채팅 탭의 프로젝트에서 기획을 정리하고, Code 탭의 폴더에 CLAUDE.md를 두고 만듭니다. 그리고 앞 절의 Skill은 이 둘과 달리 어느 프로젝트에서든 꺼내 쓰는 작업 매뉴얼입니다. 셋의 관계를 그림으로 그리면 아래와 같습니다.

4장에서 이 세 가지를 하네스라는 이름으로 다시 만납니다. 실수를 발견할 때마다 그 실수가 다시 일어나지 않도록 지침, 규칙, 절차 중 맞는 자리에 한 줄을 더하는 것이 이 책에서 말하는 하네스 만들기의 전부입니다.