← 목록으로

파일 유형 한눈에 보기

.md부터 .py까지, Claude Code에서 자주 만나는 파일 8종 해설

용어 사전 46선 파일 유형 비교 스킬 라이브러리 컴포넌트 갤러리 UI 디자인 라이선스 가이드

Claude에게 "웹사이트 만들어줘"라고 했더니 .html, .css, .js 파일이 생겼습니다.
수정하려면 이게 뭔지 알아야 합니다. 아래 8가지 파일만 이해하면 Claude Code가 달리 보입니다.

📝 마크다운 · .md

CLAUDE.md를 처음 열었을 때 낯설게 느껴진다면 마크다운을 몰라서입니다. Claude Code에서 가장 자주, 가장 중요하게 쓰이는 파일입니다.

.md 마크다운 (Markdown) 텍스트 서식

특수 기호로 제목, 굵기, 목록을 표현하는 순수 텍스트 파일입니다. Claude를 포함한 모든 AI 모델이 가장 잘 이해하는 형식이며, Claude Code의 핵심 파일인 CLAUDE.md도 이 형식입니다.

# 제목 (H1)
## 소제목 (H2)

**굵게** / *기울임*

- 목록 항목 1
- 목록 항목 2

> 인용 블록
`CLAUDE.md`  ← 파일명 강조
CLAUDE.md README.md 문서 작성 GitHub

CLAUDE.md에 "항상 한국어로 답해줘", "커밋 전 테스트 실행해줘" 같은 규칙을 저장하면 Claude가 프로젝트 내내 기억합니다.

HTML 같은 Markup(마크업) 언어에서 이름을 따왔습니다. 복잡한 태그 없이 간단한 기호로 서식을 표시하자는 뜻으로, 2004년 John Gruber가 만들었습니다.

왜 AI가 마크다운을 선호할까? 다른 파일 유형과 비교
.md vs .docx / .pdf 순수 텍스트 vs 이진 파일
.docx, .pdf는 이진(binary) 형식입니다. AI가 직접 읽을 수 없고, 변환 도구를 거쳐야 합니다. 변환 과정에서 서식·레이아웃 정보가 노이즈로 섞입니다.
.md는 100% 순수 텍스트입니다. AI가 추가 도구 없이 파일을 그대로 읽고, 모든 내용을 온전히 컨텍스트로 활용합니다.
.md vs .html 내용 중심 vs 태그 오버헤드
.html은 내용보다 태그가 많습니다. <p><strong>안녕</strong></p>처럼 28자 중 내용은 2자뿐입니다. AI의 컨텍스트 창(토큰)을 태그가 낭비합니다.
.md는 **안녕**처럼 최소한의 기호만 사용합니다. 같은 토큰으로 훨씬 많은 내용을 담을 수 있어 AI가 더 넓은 맥락을 이해합니다.
.md vs .json 자연어 친화적 vs 데이터 구조 전용
.json은 데이터 구조에 최적화되어 있습니다. 자연어 문장을 담기 어렵고, "왜 이렇게 했는지"의 맥락·이유를 기록하기 불편합니다.
.md는 자연어와 구조를 동시에 표현합니다. 의도·배경·예외 상황을 자유롭게 서술할 수 있어 AI가 맥락을 깊이 이해합니다.
.md vs .py / .js 즉시 이해 vs 실행해야 의미 파악
.py, .js는 코드 실행 결과가 있어야 의도가 명확해집니다. AI가 코드를 읽어도 "무엇을 하려는 파일인지"를 추론해야 합니다.
.md는 읽는 것 자체가 이해입니다. 실행 없이도 목적·규칙·제약이 명확하게 전달되어 AI가 지시를 그대로 따릅니다.
🌐 웹 3총사 · HTML · CSS · JS

Claude가 만들어준 웹 페이지를 수정하려면 이 세 파일이 각자 뭘 담당하는지 알아야 합니다. 셋 중 하나만 잘못 건드려도 레이아웃이 무너집니다.

.html HTML 구조

웹 페이지의 뼈대를 만드는 파일입니다. 제목, 단락, 버튼 등 눈에 보이는 모든 요소를 태그로 정의합니다.

<h1>안녕하세요</h1>
<p>단락 텍스트입니다</p>
<button id="btn">클릭</button>
웹사이트 대시보드 랜딩 페이지

"버튼 추가해줘", "이미지 넣어줘"처럼 보이는 요소를 바꿀 때 Claude가 수정하는 파일이 바로 .html입니다.

풀네임은 HyperText Markup Language입니다. 링크(HyperText)로 연결되는 문서를 기호(Markup)로 구조화하는 언어라는 뜻입니다.

.css CSS 스타일

웹 페이지의 외모를 담당합니다. 색상, 글꼴, 크기, 간격, 애니메이션 등 모든 시각적 요소를 정의합니다.

h1 {
  color: #D97757;
  font-size: 24px;
}
button:hover {
  background: #333;
}
디자인 수정 반응형 애니메이션

풀네임은 Cascading Style Sheets입니다. 여러 스타일이 위에서 아래로 폭포(Cascade)처럼 흘러내리며 순서대로 적용된다는 의미입니다.

.js JavaScript 동작·로직

웹 페이지에 움직임과 논리를 추가합니다. 버튼 클릭 처리, 데이터 계산, API 통신 등 실제 동작을 담당하는 현대 웹 개발의 핵심 언어입니다.

// 버튼 클릭 이벤트
document.getElementById('btn')
  .addEventListener('click', () => {
    alert('클릭됨!');
  });

// API에서 데이터 불러오기
const data = await fetch('/api/data')
  .then(r => r.json());
인터랙션 API 연동 데이터 처리 자동화

"버튼 클릭 시 색상이 바뀌게 해줘"처럼 동작을 설명하면 Claude가 JavaScript 코드를 자동 작성합니다.

Java와는 전혀 무관한 언어입니다. 원래 이름은 Mocha였는데, 1995년 Netscape가 당시 인기였던 Java의 이름을 마케팅 목적으로 빌려 지금의 이름이 됐습니다.

⚙️ 스크립트 · .py · .sh

"매일 반복하는 이 작업, Claude가 자동화해줄 수 있어?" 이 질문에 대한 답은 대부분 .py 또는 .sh 파일로 나옵니다.

.py Python 범용 언어

데이터 분석, 자동화, AI 개발에 강한 가장 인기 있는 언어입니다. 문법이 간결해 비개발자도 배우기 쉽습니다.

# 엑셀 파일 읽기
import pandas as pd

df = pd.read_excel('data.xlsx')
print(df.head())

# 파일 목록 가져오기
import os
files = os.listdir('.')
데이터 분석 업무 자동화 AI/ML

"엑셀 파일에서 중복을 제거하고 요약해줘" 같은 업무 자동화를 Claude에게 바로 맡길 수 있습니다.

영국 코미디 그룹 Monty Python의 팬이었던 Guido van Rossum이 1991년에 만들었습니다. 뱀(python)과는 관계 없습니다.

.sh Shell Script 터미널 자동화

터미널 명령어를 순서대로 자동 실행하는 스크립트입니다. 반복되는 빌드, 배포, 파일 정리 작업을 한 번에 처리합니다.

#!/bin/bash
# 빌드 후 배포 자동화
echo "빌드 시작..."
npm run build

echo "오래된 파일 정리..."
rm -rf ./dist/old

echo "완료!"
빌드 자동화 배포 파일 관리

Claude Code의 hooks 기능을 이용하면 코드 저장 시 자동으로 쉘 스크립트를 실행할 수 있습니다.

Shell은 껍데기라는 뜻입니다. 운영체제의 핵심(kernel)을 감싸고 있어서 붙은 이름으로, 사용자 명령을 받아 OS에 전달하는 역할을 합니다.

🗂️ 설정·데이터 · .json · .ts

Claude Code를 처음 설정하거나 프로젝트를 시작할 때 반드시 마주칩니다. 건드리기 전에 역할을 알아두면 실수를 줄일 수 있습니다.

.json JSON 데이터·설정

데이터를 구조화해서 저장하는 형식입니다. Claude Code 설정 파일(settings.json), 프로젝트 패키지 정보(package.json)가 모두 JSON입니다.

// settings.json 예시
{
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Bash", "Edit"]
  },
  "theme": "dark"
}
settings.json package.json API 응답

settings.json을 잘못 수정하면 Claude Code가 실행되지 않을 수 있습니다. 수정 전 Claude에게 "이 항목이 무슨 역할인지 설명해줘"라고 먼저 물어보세요.

풀네임은 JavaScript Object Notation입니다. JavaScript의 객체 표기법을 그대로 빌려 만든 데이터 형식으로, 지금은 언어와 상관없이 모든 곳에서 씁니다.

.ts TypeScript 안전한 JavaScript

JavaScript에 타입 검사를 추가한 언어입니다. 코드 실행 전에 오류를 미리 잡아주므로 규모 있는 프로젝트에서 주로 사용됩니다.

// 타입을 미리 정의
interface User {
  name: string;
  age: number;
}

function greet(user: User) {
  return `안녕, ${user.name}!`;
}
React 앱 Node.js 서버 대규모 프로젝트

Claude Code가 TypeScript 프로젝트를 만들면 타입을 자동으로 추가해줍니다.

Type + JavaScript를 합친 이름입니다. 2012년 Microsoft가 JavaScript의 가장 큰 약점인 '타입 없음'을 보완하기 위해 만들었습니다.

이제 파일 유형이 눈에 들어오시나요?
어떤 파일이 무엇인지 알면 Claude와 대화할 때
더 정확하게 요청하고 더 좋은 결과를 받을 수 있습니다.
← 가이드 메인으로 돌아가기