30초 만에 CLAUDE.md 생성하기 (Interactive Script)

Source: Dev.to

What It Does

claude-md-generator.sh 은 프로젝트에 대한 8가지 질문을 하고 CLAUDE.md 파일을 생성하는 Bash 스크립트입니다. 파일에는 다음 내용이 포함됩니다:

• 프로젝트 개요 및 기술 스택
• 코드 스타일 및 테스트 명령
• 언어별 규칙 (7가지 프리셋: Python, JavaScript/TypeScript, Go, Rust, Java, Shell, 기타)

선택적 안전 모듈

• 위험 명령 보호 (rm -rf, git reset --hard 등)
• 외부 액션 게이트 (git push, API 호출 전에 승인 필요)
• 오류 추적 규칙

Try It

Interactive mode

8가지 질문에 대화식으로 답하세요:

curl -sLO https://gist.githubusercontent.com/yurukusa/9e710dece35d673dd71e678dfa55eaa3/raw/claude-md-generator.sh
bash claude-md-generator.sh

Defaults mode

프롬프트 없이 합리적인 기본값으로 파일을 생성합니다:

bash claude-md-generator.sh --defaults

Custom output path

bash claude-md-generator.sh --defaults --output ./my-project/CLAUDE.md

What the Output Looks Like

기본값으로 스크립트를 실행하면 8개의 섹션이 포함된 파일이 생성됩니다. 아래는 축약된 예시입니다:

# CLAUDE.md — My Project

## Project Overview
...

## Tech Stack & Language Rules
- Language: Python
- Run `python -m py_compile` after editing .py files
...

## Dangerous Command Protection
NEVER run these commands without explicit user approval:
- `rm -rf`
- `git reset --hard`
...

## External Action Safety
Before any external action (git push, API calls, posting):
1. State what you're about to do
2. Wait for approval
...

각 섹션은 조건부이며, 안전 기능에 “아니오”라고 답하면 해당 섹션이 생략되어 필요한 내용만 포함됩니다.

Why This Exists

CLAUDE.md 없이 Claude Code를 자동으로 실행하면 다음과 같은 문제가 발생할 수 있습니다:

• “임시” 디렉터리라고 생각하고 rm -rf를 실수로 실행
• GitHub에 승인되지 않은 푸시
• 린팅 규칙 위반 및 스타일 드리프트
• 세션이 재시작될 때 컨텍스트 손실

잘 작성된 CLAUDE.md는 이러한 문제를 모두 방지합니다. 이 스크립트는 수개월간의 시행착오에서 얻은 교훈을 담고 있습니다.

Get the Script

• Standalone Gist: claude-md-generator.sh
• Part of a larger toolkit: claude-code-ops-starter – 네 개의 무료 안전 훅, 제너레이터, CLAUDE.md 템플릿 포함

Bash 외에 다른 의존성이 없으며, 네트워크 호출도 없습니다. MIT 라이선스이며, 스크립트 실행은 약 30초 정도 걸리고 안전 규칙은 모든 Claude Code 세션에 걸쳐 지속됩니다.