AI 문서는 왜 필요한가..?
Anthropic에서 공식으로 소개하는 강의를 보면 CLAUDE.md는 아래와 같은 역할을 한다고 합니다.
(강의 출저: https://anthropic.skilljar.com/claude-code-in-action)
- Claude가 코드 베이스를 더 잘 이해하도록 돕고, 관련된 코드를 더 빨리 찾을 수 있도록한다.
- Claude에게 코드의 위치를 제공할 수 있는 일종의 네비게이션 역할을 한다.
문서의 레벨
Claude Code가 사용하는 CLAUDE.md 파일은 아래와 같이 여러 레벨에서 존재할 수 있습니다.
- 프로젝트 레벨: /init 명령어로 생성한 md 파일이다. 이 파일은 일반적으로 Github 같은 곳에 올려 다른 협업자와 공유한다.
- 로컬 레벨: 개인 로컬 환경에서만 다룰 md 파일이다.
- 머신 레벨: 개인 기기에서 모든 프로젝트에 대해 적용할 md 파일이다. (Global Rules)
문서를 업데이트 하는 방법
이러한 AI 컨텍스트 관리를 효과적으로 하기 위해선 문서를 지속적으로 업데이트해야 합니다. 그럴 때마다 매번 CLAUDE.md를 직접 수정하는 것은 생각보다 번거롭기에 Claude는 문서를 간편하게 업데이트 할 수 있는 명령어를 지원합니다.
사용자 지정 지침 추가하기
# 명령어를 사용하여 "메모리 모드"에 들어갈 수 있습니다.
CLAUDE.md 파일에 지침을 추가하여 Claude의 동작을 맞춤으로 설정할 수 있습니다. 예를 들어, Claude가 코드에 주석을 너무 많이 추가한다면 파일을 업데이트하여 이 문제를 해결할 수 있습니다.
메모리 모드에서 작성한 위와 같은 지침을 CLAUDE.md에 자동으로 병합해 줍니다.
@를 사용한 파일 참조
특정 파일을 Claude에게 보여주려면 @ 기호와 파일 경로를 입력하면 됩니다.
(ex) 로그인은 어떻게 작동하나요? @login.tsx
이렇게 하면 해당 파일이 자동으로 요청에 포함됩니다.
동일하게 CLAUDE.md 파일에서도 @로 파일을 참조할 수 있습니다.
Planning Mode와 Thinking Mode 비교
Planning Mode
복잡한 코드베이스에서 광범위한 탐색이 필요한 작업을 위한 모드입니다.
- 활성화 방법: Shift + Tab 두 번 누르기 (또는 자동 수정 모드에서 한 번)
- 기능: 프로젝트의 더 많은 파일을 읽고, 상세한 구현 계획을 생성하며, 진행 전 사용자의 승인을 기다립니다.
Thinking Mode
복잡한 문제에 대해 더 깊이 생각할 수 있는 다양한 수준의 사고 모드를 제공합니다.
- 종류:
- "Think" (기본 추론)
- "Think more" (확장 추론)
- "Think a lot" (포괄적 추론)
- "Think longer" (연장 시간 추론)
- "Ultrathink" (최대 추론 능력)
- 활성화 방법: 위 키워드를 포함해서 질문하기
- 작동 방식: 각 모드는 Claude에게 더 많은 토큰을 제공하여 더 깊은 분석이 가능하게 합니다.
시간이 없어서 이어서 작성하겠습니다..ㅠㅠ
남은 내용
- 유용한 명령어
- 클로드에서 MCP 활용
- 클로드에서의 훅
이렇게 입니다..! 돌아오는 주도 모두 파이팅입니다!