← 목록으로

파일 유형 한눈에 보기

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

파일 유형 비교 라이선스 가이드 용어 사전
📊 비교표
📄 파일 이름 끝, 점 뒤의 글자(확장자)가 그 파일의 종류입니다. .md, .json처럼요.
📖 Claude가 가장 잘 읽는 형식은 마크다운(.md)입니다. CLAUDE.md로 지시를 적는 이유가 여기에 있습니다.
🤖 .html·.py 같은 코드 파일은 Claude가 직접 만들어냅니다. 어떤 파일인지 알아보면 충분합니다.
한눈에 비교 AI가 읽는 2개 · AI가 만드는 6개
확장자 이름 핵심 역할 대표 용도 AI 처리
.md Markdown마크다운 문서 텍스트 서식 CLAUDE.md · README 📖 AI가 읽음
.json JSONJavaScript Object Notation 데이터 구조화 settings.json · package.json 📖 AI가 읽음
.html HTMLHyperText Markup Language 웹 페이지 뼈대 웹사이트·대시보드 🤖 AI가 생성
.css CSSCascading Style Sheets 스타일·디자인 색상·레이아웃·애니메이션 🤖 AI가 생성
.js JavaScript자바스크립트 동작·로직 인터랙션·API 연동 🤖 AI가 생성
.py Python파이썬 범용 프로그래밍 데이터 분석·자동화·AI 🤖 AI가 생성
.sh Shell Script셸 스크립트 터미널 명령 자동화 빌드·배포·파일 정리 🤖 AI가 생성
.ts TypeScript타입스크립트 타입 안전 JS React·Node.js 프로젝트 🤖 AI가 생성
📝 마크다운 · .md
1 📝 마크다운 파일 1종 · .md

마크다운은 Claude가 가장 잘 읽는 형식입니다. CLAUDE.md로 지시를 적는 것도 이 때문입니다. 이 페이지에서 가장 중요한 파일입니다.

.md Markdown 텍스트 서식

기호로 서식을 표현하는 순수 텍스트. AI가 가장 잘 이해하는 형식이며, CLAUDE.md도 이 형식입니다.

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

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

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

> 인용 블록
`CLAUDE.md`  ← 파일명 강조

이게 무슨 뜻이냐면 제목은 #, 목록은 -, 강조는 **로 표시합니다. 이 몇 가지 기호가 마크다운의 전부입니다.

AI가 마크다운을 선호하는 이유
형식 vs .docx / .pdf
.docx, .pdf는 이진 파일이라 AI가 바로 읽지 못하고, 별도의 변환 과정이 필요합니다.
.md는 순수 텍스트라 그대로 읽고 활용합니다.
효율 vs .html
.html은 태그가 많아 같은 내용에 토큰이 더 많이 소요됩니다.
.md는 기호가 최소화되어 더 많은 내용을 담을 수 있습니다.
표현 vs .json / .py
.json, .py는 데이터·코드 전용이라 "왜 이렇게 했는지"를 적기 어렵습니다.
.md는 자연어 문장으로 의도와 배경을 그대로 적을 수 있습니다.
🗂️ 설정·데이터 · .json · .ts
2 🗂️ 설정·데이터 파일 2종 · .json · .ts

Claude Code의 동작을 정하는 설정 파일입니다. settings.json으로 모델·권한·테마를 바꿉니다.

.json JSON 데이터·설정

데이터를 정해진 모양으로 저장하는 형식. settings.json, package.json이 대표적입니다.

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

이게 무슨 뜻이냐면 사용할 모델, 허용할 권한, 테마를 "이름": 값 짝으로 적습니다. settings.json을 열면 이런 모습입니다.

.ts TypeScript 읽기만 해도 OK

JavaScript에 타입 검사를 더한 언어. 직접 쓸 일은 거의 없고, 이름만 알아두면 됩니다.

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

function greet(user: User) {
  return `안녕, ${user.name}!`;
}

이게 무슨 뜻이냐면 이름은 글자, 나이는 숫자처럼 값의 종류를 미리 정해 실수를 막습니다.

🌐 웹 3총사 · .html · .css · .js
3 🌐 웹 3총사 파일 3종 · .html · .css · .js

Claude가 만든 웹 페이지는 세 파일이 한 팀입니다. 집에 비유하면 .html은 골조, .css는 인테리어, .js는 전기 배선입니다. 직접 고치기보다 어느 파일이 무슨 역할인지만 알면 됩니다.

.html HTML 골조 · 구조

웹 페이지의 골조. 보이는 모든 요소를 태그로 정의합니다.

<h1>안녕하세요</h1>
<p>단락 텍스트입니다</p>
<button id="btn">클릭</button>

이게 무슨 뜻이냐면 h1은 제목, p는 문단, button은 버튼. 화면에 둘 요소를 이름표처럼 적습니다.

.css CSS 인테리어 · 스타일

웹 페이지의 인테리어. 색상, 글꼴, 간격, 애니메이션을 정의합니다.

h1 {
  color: #D97757;
  font-size: 24px;
}
button:hover {
  background: #333;
}

이게 무슨 뜻이냐면 제목 글자를 주황색 24px로, 버튼에 마우스를 올리면 어둡게. 보이는 모양을 정합니다.

.js JavaScript 전기 · 동작

웹 페이지의 전기 배선. 클릭 처리, 데이터 계산, API 통신을 담당합니다.

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

// API에서 데이터 불러오기
const data = await fetch('/api/data')
  .then(r => r.json());

이게 무슨 뜻이냐면 버튼을 누르면 알림을 띄우고, 서버에서 데이터를 불러옵니다. 페이지가 반응하게 만듭니다.

⚙️ 스크립트 · .py · .sh
4 ⚙️ 스크립트 파일 2종 · .py · .sh

반복 작업을 자동화하면 대부분 .py 또는 .sh로 만들어집니다. Claude가 대신 써주니 무엇을 하는 파일인지만 알면 됩니다.

.py Python 범용 언어

데이터 분석, 자동화, AI에 강한 대표 언어. 문법이 간결합니다.

# 엑셀 파일 읽기
import pandas as pd

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

# 파일 목록 가져오기
import os
files = os.listdir('.')

이게 무슨 뜻이냐면 엑셀 파일을 읽어 표로 다루고, 폴더의 파일 목록을 가져옵니다. 데이터 작업에 강합니다.

.sh Shell Script 터미널 자동화

터미널 명령을 순서대로 자동 실행합니다. 빌드·배포·파일 정리에 씁니다.

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

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

echo "완료!"

이게 무슨 뜻이냐면 빌드하고, 오래된 파일을 지우고, 완료 메시지를 띄웁니다. 터미널 명령을 순서대로 묶습니다.

파일 유형 이해 완료!
이제 라이선스 가이드로 넘어가 배포 전 꼭 알아야 할 규칙을 익혀보세요.
라이선스 가이드 →