Claude.md 파일 최적화

 

CLAUDE.md 파일의 역할

Claude Code는 세션 시작 시 자동으로 CLAUDE.md 파일을 읽어 컨텍스트에 포함시킵니다. 이를 통해 프로젝트의 핵심 정보를 Claude에게 영구적으로 "학습"시킬 수 있습니다.

핵심 최적화 전략

1. 계층적 구조 활용

Claude는 CLAUDE.md 파일을 계층적으로 읽습니다: 홈 디렉토리(~/.claude/CLAUDE.md) → 프로젝트 루트 → 개별 디렉토리 순으로, 가장 구체적인 설정이 우선합니다.

권장 구조:

  • ~/.claude/CLAUDE.md - 개인 코딩 스타일, 일반 규칙
  • 프로젝트 루트 CLAUDE.md - 프로젝트 아키텍처, 라이브러리, 규칙
  • 하위 디렉토리 - 모듈별 특수 규칙

2. 명확한 컨텍스트 제공

포함해야 할 핵심 내용:

  • 프로젝트 구조: 주요 디렉토리와 파일 역할
  • 기술 스택: 사용 중인 언어, 프레임워크, 라이브러리
  • 코딩 규칙: 네이밍, 포맷팅, 아키텍처 패턴
  • 명령어: 빌드, 테스트, 린트 등 주요 명령어
  • 금지 사항: 읽지 말아야 할 디렉토리, 피해야 할 패턴

3. 토큰 최적화

CLAUDE.md를 활용해 Claude가 읽을 수 있는 파일과 금지된 디렉토리를 명시하세요. 이렇게 하면 불필요한 코드로 인한 컨텍스트 소비를 방지할 수 있습니다.

## File Reading Guidelines
- Always check: src/, tests/, docs/
- Never read: node_modules/, .git/, build/, dist/
- For database queries, check schema.sql first

4. 구체적인 예시 포함

좋은 예시(✅)와 나쁜 예시(❌)를 포함하여 원하는 패턴을 명확히 하세요.

## Code Patterns
✅ Good: Reuse existing DAO functions
✅ Good: Always run type checks before committing

❌ Bad: Create redundant DAO functions
❌ Bad: Uncomment test blocks automatically

5. 반복적 개선

Claude가 실수할 때마다 CLAUDE.md를 업데이트하세요. 이는 AI 어시스턴트를 반복적으로 훈련시키는 것과 같습니다.

실전 예시

# CLAUDE.md

## Project Overview
Drug discovery pipeline using Python/PyTorch for molecular property prediction.

## Architecture
- `models/`: PyTorch neural network architectures
- `data/`: Dataset loaders and preprocessing
- `pipeline/`: Training and inference workflows
- `notebooks/`: Jupyter notebooks for analysis

## Key Commands
- Build: `python setup.py build`
- Test: `pytest tests/`
- Lint: `flake8 . && black --check .`
- Type check: `mypy src/`

## Coding Standards
- Always use type hints
- Document all functions with docstrings
- Follow PEP 8 style guide
- Never commit without running tests

## Dependencies
- PyTorch for deep learning
- RDKit for molecular featurization
- scikit-learn for ML utilities

## File Reading Rules
- Always read: requirements.txt, README.md, models/
- Check before editing: pipeline/, data/
- Never modify: .venv/, __pycache__/, *.egg-info/

## Common Tasks
When training models:
1. Load data from data/processed/
2. Use models/base.py as template
3. Log metrics to wandb
4. Save checkpoints to checkpoints/

## Specific Guidelines
- Timeout for large downloads: 300s
- Never uncomment test blocks unless explicitly asked
- Always validate molecular SMILES strings before processing

추가 팁

  1. Plan Mode 활용: 복잡한 작업은 Plan Mode(Shift+Tab 두 번)로 먼저 계획을 수립하세요.

  2. Custom Commands: .claude/commands/ 폴더에 자주 쓰는 워크플로우를 저장하여 슬래시 커맨드로 활용하세요.

  3. 세션 관리: 한 세션은 하나의 프로젝트나 기능에 집중시켜 컨텍스트를 관련성 있게 유지하세요.

  4. 정기적 업데이트: 프로젝트가 진화함에 따라 CLAUDE.md도 함께 업데이트하세요.

Claude Code를 효과적으로 사용하는 핵심은 명확한 컨텍스트 제공과 지속적인 가이드입니다. CLAUDE.md는 단순한 설정 파일이 아니라, Claude와 협업하기 위한 "온보딩 문서"로 생각하시면 됩니다.

댓글

댓글 쓰기

이 블로그의 인기 게시물

Claude AI의 생명과학 적용: 최신 자료 종합 리뷰

Claude AI의 생명과학 적용: 최신 자료 종합 리뷰 📌 개요 Anthropic은 2025년 10월 20일 "Claude for Life Sciences"를 공식 출시하며 생명과학 분야에 본격 진출했습니다. 이는 생명과학 연구 전 과정을 지원하는 특화된 AI 플랫폼으로, 약물 발견부터 규제 제출까지 과학적 발견 프로세스 전체를 가속화하는 것을 목표로 합니다. 1️⃣ Claude AI의 생명과학 적용 방법 1.1 기술적 성능 향상 Claude Sonnet 4.5는 Protocol QA 벤치마크에서 0.83점을 기록해 인간 기준선 0.79를 초과했으며, 이는 실험실 프로토콜 이해 능력이 인간 수준을 넘어섰음을 의미합니다. BixBench 평가에서도 생물정보학 작업에서 이전 모델 대비 상당한 개선을 보였습니다. 1.2 과학 도구 통합 (MCP Connectors) Claude for Life Sciences의 핵심은 Model Context Protocol (MCP) 기반 커넥터를 통한 실험실 도구와의 직접 통합입니다: 통합된 플랫폼: Benchling : 실험 노트북, 실험 기록에 대한 소스 링크 제공 PubMed : 수백만 개의 생물의학 연구 논문 접근 10x Genomics : 자연어로 단일 세포 및 공간 분석 수행 Scholar Gateway (Wiley) : 권위 있는 동료 검토 과학 콘텐츠 접근 Synapse.org : 공개/비공개 프로젝트에서 데이터 공유 및 분석 BioRender : 검증된 과학 그림, 아이콘, 템플릿 라이브러리 또한 Databricks와 Snowflake와도 연동되어 대규모 생물정보학 연구 분석과 자연어 쿼리를 통한 대용량 데이터셋 검색이 가능합니다. 1.3 Agent Skills 기능 Skills는 Claude가 특정 프로토콜과 절차를 일관되고 예측 가능하게 따를 수 있도록 하는 지침, 스크립트, 리소스를 포함한 폴더입니다. 첫 번째 공식 Skill: single-ce...
자세한 내용 보기

클로드 코드 빠른 시작

클로드 코드 빠른 시작 https://docs.anthropic.com/ko/docs/claude-code/quickstart 시작하기 전에 다음 사항을 확인하세요: 터미널 또는 명령 프롬프트가 열려 있음 (리눅스, 윈도우즈, 맥 모두 동일) 작업할 코드 프로젝트가 있음 Claude pro 또는 max 이상 계정 가입 Claude.ai  (권장) 또는  Anthropic Console  계정 1단계: Claude Code 설치 NPM 설치 Node.js 18 이상이 설치되어 있다면 : 없으면 링크로 가서 다운로드하고 설치 할 것 npm install -g @anthropic-ai/claude-code 네이티브 설치 (중요) 현재 베타 버전인 새로운 네이티브 설치가 가능함.  윈도우즈 power shell이나 command 창에서 실행 할 수 있음.  WSL에서 실행하는 것을 윈도우즈로 변환할 수 있음(경로 및 사용 프로그램 재설정 필요)  macOS, Linux, WSL: curl - fsSL https : / / claude . ai / install . sh | bash Windows PowerShell: irm https://claude . ai/install . ps1 | iex Windows CMD: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd 2단계: 계정에 로그인 Claude Code를 사용하려면 계정이 필요합니다.  claude  명령으로 대화형 세션을 시작할 때 로그인해야 합니다: claude # 처음 사용할 때 로그인하라는 메시지가 표시됩니다 / login # 프롬프트에 따라 계정으로 로그인하세요 다음 두 가지 계정 유형 중 하나로 로그인할 수 있습니다: Claude.ai  (구독 플랜 - 권장, pro나 max ...
자세한 내용 보기

Claude Code를 사용할 때 유용한 명령어와 팁

C laude Code를 사용할 때 가장   유용한 명령어와 팁 은 다음과 같습니다.[1][2][3][5] 필수 명령어 모음 /init : 프로젝트 설정 초기화, CLAUDE.md 파일 자동 생성.[5] /clear : 대화 내역 초기화, 성능 최적화와 컨텍스트 정리에 효과적.[3][1] /model : AI 모델 변경, Sonnet ↔ Opus 전환 지원.[2][5] /permissions : 파일/폴더 수정 권한 및 허가 자동화.[5] /claude-md : 프로젝트 메모리 파일 생성 및 컨텍스트 공유.[5] /status : 현재 상태(버전, 모델, 계정 등) 확인.[5] /cost : 토큰 사용량 확인, 비용 관리에 유용.[5] claude --continue 또는 claude -c : 이전 세션에서 중단한 작업을 재개.[7][3] claude --help 또는 /help : 사용 중인 환경의 명령어 및 키 바인딩 정보 확인.[10] /exit 또는 Ctrl + C 두번 : 세션 종료.[2][7] 작업 및 컨텍스트 관리 팁 @파일명 : 프롬프트에서 @ 뒤에 파일명을 입력하면 해당 파일을 참조 가능.[1][2] #태그: 작업 내역을 기록할 때 # 사용.[1] 클립보드 이미지 삽입 : Ctrl + V (스크린샷 등 이미지도 첨부 가능).[2][1] 줄바꿈 : Ctrl + J (또는 /terminal-setup으로 불편함 해결).[2] Shift + Tab : 작업 모드 변경(일반/자동수락/계획).[7][2] Esc 키 : 작업 중단 또는 이전 세션 내용 보기.[7][2] 위 화살표 : 이전 대화 내용 탐색.[1][2] 고급 사용 팁 대화 시작 전에는  항상 /clear  명령어 사용해서 불필요한 컨텍스트 제거.[3][1] 맥락이 충분한 자연어 요청 으로 더 똑똑한 답변 유도 (예: “로그인 기능 구현”이 아닌 “JWT 기반 로그인 API를 Express + MongoDB로 구현해줘”).[5] IDE(터미널, VSCode 등)에서 플...
자세한 내용 보기