저는 Claude Code가 어떤 폴더에서든 바로 동작한다는 점이 정말 마음에 듭니다. 터미널을 열고 프로젝트 폴더로 이동한 뒤 claude만 실행하면 됩니다.

이 방식이 좋은 이유는 다음과 같습니다:

• 기존 설정 그대로 사용할 수 있습니다. 파일을 옮기거나 구조를 바꿀 필요가 없습니다.
• 전체 컨텍스트에 접근할 수 있습니다. Claude는 프로젝트 안의 어떤 파일이든 읽을 수 있습니다.
• 여러 프로젝트를 쉽게 오갈 수 있습니다. 디렉터리만 바꾸면 다른 프로젝트로 전환됩니다.
• 터미널과 통합되어 동작합니다. 명령어를 실행하거나 git 상태를 확인하는 등의 작업을 할 수 있습니다.

프로젝트에서

AI 시대에는 문서화가 더욱 중요해집니다. 문서화가 잘 되어 있으면 Claude Code가 훨씬 더 정확하게 도와줄 수 있습니다. 문서화가 부실하면 Claude가 추측하거나 잘못된 가정을 하게 됩니다.

무엇을 문서화할까

프로젝트 목적. 어떤 문제를 해결하나요? 누구를 위한 프로젝트인가요? 성공의 기준은 무엇인가요?

아키텍처 결정. 왜 이 구조를 선택했나요? 어떤 대안을 고려했나요? 어떤 트레이드오프가 중요한가요?
예시: 이 프로젝트에서는 Go 대신 C#을 사용합니다. 함께 일하는 개발자 대부분이 Go를 모르기 때문입니다.

제약 조건. 기술적 한계, 성능 요구사항, 의존성, 브라우저 지원 범위, 플랫폼 제약 등입니다.

코드 패턴. 네이밍 컨벤션, 파일 구조, 컴포넌트 패턴, 스타일 가이드 등입니다.
/init을 사용하면 Claude가 대부분을 추론해 낼 수 있지만, 추론한 내용이 틀린 부분은 직접 확인하고 고치는 것이 가장 좋습니다.

어디에 문서화할까

README.md. 프로젝트 개요, 설정 방법, 주요 결정 사항을 담습니다.

CLAUDE.md. Claude Code를 위한 전용 설명서입니다. 프로젝트별 가이드를 담습니다.

팁: /memory를 이용해 Claude에게 메모리를 수정해 달라고 할 수 있습니다. 급할 때는 #을 사용하면 됩니다.

제 메모 환경

제 메모는 모두 로컬 폴더에 들어 있습니다, 그래서 해당 폴더에서 바로 iTerm을 열고 Claude에게 수정이나 정리 등을 부탁할 수 있습니다.

Claude의 메모리

/memory로 Claude의 메모리를 업데이트하면 어떤 메모리 파일을 수정할지 묻는 메시지가 나타납니다. 주요 차이점은 다음과 같습니다:

• Project memory – 프로젝트의 모든 사람과 공유됩니다. 바로 CLAUDE.md 파일입니다
• Project memory (local) – 개인용이며 현재 프로젝트에만 적용됩니다
• User memory – 개인용이며 현재 기기의 모든 프로젝트에 적용됩니다

Claude Code 활용법에 대해 더 알고 싶다면, 다음 영상 시리즈가 전체적인 내용을 잘 정리해 줍니다:

YouTube

Claude Code Tutorial #1 - Introduction & Setup

By Net Ninja