Claude에게 "웹사이트 만들어줘"라고 했더니 .html, .css, .js 파일이 생겼습니다.
수정하려면 이게 뭔지 알아야 합니다. 아래 8가지 파일만 이해하면 Claude Code가 달리 보입니다.
CLAUDE.md를 처음 열었을 때 낯설게 느껴진다면 마크다운을 몰라서입니다. Claude Code에서 가장 자주, 가장 중요하게 쓰이는 파일입니다.
특수 기호로 제목, 굵기, 목록을 표현하는 순수 텍스트 파일입니다. Claude를 포함한 모든 AI 모델이 가장 잘 이해하는 형식이며, Claude Code의 핵심 파일인 CLAUDE.md도 이 형식입니다.
# 제목 (H1) ## 소제목 (H2) **굵게** / *기울임* - 목록 항목 1 - 목록 항목 2 > 인용 블록 `CLAUDE.md` ← 파일명 강조
CLAUDE.md에 "항상 한국어로 답해줘", "커밋 전 테스트 실행해줘" 같은 규칙을 저장하면 Claude가 프로젝트 내내 기억합니다.
HTML 같은 Markup(마크업) 언어에서 이름을 따왔습니다. 복잡한 태그 없이 간단한 기호로 서식을 표시하자는 뜻으로, 2004년 John Gruber가 만들었습니다.
<p><strong>안녕</strong></p>처럼 28자 중 내용은 2자뿐입니다. AI의 컨텍스트 창(토큰)을 태그가 낭비합니다.**안녕**처럼 최소한의 기호만 사용합니다. 같은 토큰으로 훨씬 많은 내용을 담을 수 있어 AI가 더 넓은 맥락을 이해합니다.Claude가 만들어준 웹 페이지를 수정하려면 이 세 파일이 각자 뭘 담당하는지 알아야 합니다. 셋 중 하나만 잘못 건드려도 레이아웃이 무너집니다.
웹 페이지의 뼈대를 만드는 파일입니다. 제목, 단락, 버튼 등 눈에 보이는 모든 요소를 태그로 정의합니다.
<h1>안녕하세요</h1> <p>단락 텍스트입니다</p> <button id="btn">클릭</button>
"버튼 추가해줘", "이미지 넣어줘"처럼 보이는 요소를 바꿀 때 Claude가 수정하는 파일이 바로 .html입니다.
풀네임은 HyperText Markup Language입니다. 링크(HyperText)로 연결되는 문서를 기호(Markup)로 구조화하는 언어라는 뜻입니다.
웹 페이지의 외모를 담당합니다. 색상, 글꼴, 크기, 간격, 애니메이션 등 모든 시각적 요소를 정의합니다.
h1 { color: #D97757; font-size: 24px; } button:hover { background: #333; }
풀네임은 Cascading Style Sheets입니다. 여러 스타일이 위에서 아래로 폭포(Cascade)처럼 흘러내리며 순서대로 적용된다는 의미입니다.
웹 페이지에 움직임과 논리를 추가합니다. 버튼 클릭 처리, 데이터 계산, API 통신 등 실제 동작을 담당하는 현대 웹 개발의 핵심 언어입니다.
// 버튼 클릭 이벤트 document.getElementById('btn') .addEventListener('click', () => { alert('클릭됨!'); }); // API에서 데이터 불러오기 const data = await fetch('/api/data') .then(r => r.json());
"버튼 클릭 시 색상이 바뀌게 해줘"처럼 동작을 설명하면 Claude가 JavaScript 코드를 자동 작성합니다.
Java와는 전혀 무관한 언어입니다. 원래 이름은 Mocha였는데, 1995년 Netscape가 당시 인기였던 Java의 이름을 마케팅 목적으로 빌려 지금의 이름이 됐습니다.
"매일 반복하는 이 작업, Claude가 자동화해줄 수 있어?" 이 질문에 대한 답은 대부분 .py 또는 .sh 파일로 나옵니다.
데이터 분석, 자동화, AI 개발에 강한 가장 인기 있는 언어입니다. 문법이 간결해 비개발자도 배우기 쉽습니다.
# 엑셀 파일 읽기 import pandas as pd df = pd.read_excel('data.xlsx') print(df.head()) # 파일 목록 가져오기 import os files = os.listdir('.')
"엑셀 파일에서 중복을 제거하고 요약해줘" 같은 업무 자동화를 Claude에게 바로 맡길 수 있습니다.
영국 코미디 그룹 Monty Python의 팬이었던 Guido van Rossum이 1991년에 만들었습니다. 뱀(python)과는 관계 없습니다.
터미널 명령어를 순서대로 자동 실행하는 스크립트입니다. 반복되는 빌드, 배포, 파일 정리 작업을 한 번에 처리합니다.
#!/bin/bash # 빌드 후 배포 자동화 echo "빌드 시작..." npm run build echo "오래된 파일 정리..." rm -rf ./dist/old echo "완료!"
Claude Code의 hooks 기능을 이용하면 코드 저장 시 자동으로 쉘 스크립트를 실행할 수 있습니다.
Shell은 껍데기라는 뜻입니다. 운영체제의 핵심(kernel)을 감싸고 있어서 붙은 이름으로, 사용자 명령을 받아 OS에 전달하는 역할을 합니다.
Claude Code를 처음 설정하거나 프로젝트를 시작할 때 반드시 마주칩니다. 건드리기 전에 역할을 알아두면 실수를 줄일 수 있습니다.
데이터를 구조화해서 저장하는 형식입니다. Claude Code 설정 파일(settings.json), 프로젝트 패키지 정보(package.json)가 모두 JSON입니다.
// settings.json 예시 { "model": "claude-sonnet-4-6", "permissions": { "allow": ["Bash", "Edit"] }, "theme": "dark" }
settings.json을 잘못 수정하면 Claude Code가 실행되지 않을 수 있습니다. 수정 전 Claude에게 "이 항목이 무슨 역할인지 설명해줘"라고 먼저 물어보세요.
풀네임은 JavaScript Object Notation입니다. JavaScript의 객체 표기법을 그대로 빌려 만든 데이터 형식으로, 지금은 언어와 상관없이 모든 곳에서 씁니다.
JavaScript에 타입 검사를 추가한 언어입니다. 코드 실행 전에 오류를 미리 잡아주므로 규모 있는 프로젝트에서 주로 사용됩니다.
// 타입을 미리 정의 interface User { name: string; age: number; } function greet(user: User) { return `안녕, ${user.name}!`; }
Claude Code가 TypeScript 프로젝트를 만들면 타입을 자동으로 추가해줍니다.
Type + JavaScript를 합친 이름입니다. 2012년 Microsoft가 JavaScript의 가장 큰 약점인 '타입 없음'을 보완하기 위해 만들었습니다.