처음 배우는 사람도, 개념을 다시 잡고 싶은 사람도
내가 만든 코드는 어떻게
사람들 손에 닿을까?
내 컴퓨터에서 쓴 코드 한 줄이 웹사이트로, 스토어의 앱으로, 설치 프로그램으로 다른 사람에게 닿기까지, 그 사이에 있는 언어, 사람, 도구, 주소, 서버, 출시 과정을 순서대로 따라가 봐요. 프로그래밍을 막 시작했다면 처음부터, 이미 일하고 있다면 필요한 장만 골라 읽어도 돼요. 장의 순서는 실제로 서비스가 만들어지는 순서와 같아요.
- 점선 밑줄 본문에서 이렇게 표시된 말은 용어 사전에 있어요.
누르면 뜻이 떠요. - (Full Name) 줄임말의 원래 이름이에요.
처음 나올 때 붙였어요. - 쉽게 말하면 생활 속 비유예요.
- 실무에서는 실제 프로젝트에서 많이 쓰는 방식이에요.
- 주의 많은 사람이 자주 하는 실수예요.
- 이 장의 핵심 장마다 끝에 있는 요약이에요.
- 판교 사투리 IT 회사에서 영어 단어를 섞어 쓰는 말투를 부르는 별명이에요.
현업에서 자주 듣는 말과 그 뜻을 함께 적었어요.
큰 그림주소창에 주소를 치면 무슨 일이 생길까?
웹사이트는 결국 “부탁하면 답해 주는” 구조예요. 부탁하는 쪽을 클라이언트라고 하고, 보통은 여러분의 브라우저(크롬, 사파리 같은 인터넷 창)예요. 답해 주는 쪽은 서버라고 해요. 어딘가에서 24시간 켜져 있는 컴퓨터예요.
아래 단계를 하나씩 눌러 보세요. 이 교과서의 장들이 이 여정의 한 부분씩을 맡아서 설명해요.
손님(브라우저)이 가게 이름(도메인)을 말해요. 그럼 전화번호부(DNS)에서 가게의 진짜 주소(IP 주소)를 찾아 찾아가요. 입구의 안내 데스크(웹서버)가 손님을 맞고, 주방(백엔드)은 창고(데이터베이스)에서 재료를 꺼내 요리(웹페이지)를 만들어 내보내요. 이 비유는 교과서 끝까지 계속 써요.
무엇을 만드느냐에 따라 길이 세 갈래로 나뉘어요
위의 식당 비유는 웹사이트 이야기예요. 하지만 개발의 결과물이 꼭 웹사이트인 건 아니에요. 휴대폰 앱일 수도 있고, 컴퓨터에 설치해서 쓰는 프로그램일 수도 있어요. 만드는 과정(언어 고르기, 역할 나누기, Git으로 함께 일하기)은 거의 같고, 사용자에게 전달하는 마지막 길이 달라요.
| 웹 서비스 | 휴대폰 앱 | 설치형 프로그램 | |
|---|---|---|---|
| 예 | 쇼핑몰, 블로그, 예약 사이트 | 메신저, 은행 앱, 모바일 게임 | 문서 편집기, 사진 편집 프로그램, VS Code |
| 어디서 돌아가나 | 서버에서 돌고, 사용자는 브라우저로 접속해요 | 사용자 휴대폰에 설치돼서 돌아가요 | 사용자 컴퓨터(Windows, macOS, Linux)에 설치돼서 돌아가요 |
| 사용자에게 가는 길 | 서버에 배포하면 바로 모두에게 닿아요 | App Store, Google Play의 심사를 통과해야 해요 | 설치 파일을 내려받게 하거나 스토어에 올려요 |
| 업데이트 | 서버만 바꾸면 다음 접속부터 모두 새 버전이에요 | 사용자가 업데이트해야 바뀌어요. 옛 버전이 오래 남아요 | 자동 업데이트를 만들어 두지 않으면 옛 버전이 오래 남아요 |
| 이 교과서에서 | 05~07장, 09장 | 08장 | 08장 |
로그인, 채팅, 결제처럼 여러 사람의 데이터를 나누는 기능은 앱이든 프로그램이든 결국 서버의 API를 불러요. 그래서 앱만 만드는 팀도 서버 이야기(05~07장)를 알아 두면 훨씬 덜 헤매요.
서비스가 만들어지는 흐름과 이 교과서의 지도
서비스 하나가 만들어져서 사용자에게 닿고 운영되기까지를 순서대로 놓으면 이렇게 돼요. 어떤 일이 어느 장과 연결되는지 먼저 훑어보세요.
| 단계 | 하는 일 | 필요한 지식 | 장 |
|---|---|---|---|
| 시작 | 어떤 언어와 도구로 만들지 정해요 | 언어, 런타임, 프레임워크 | 01 |
| 시작 | 누가 무엇을 맡을지 나눠요 | 직군, 퍼블리싱, 일의 순서 | 02 |
| 준비 | 내 컴퓨터에 개발 도구를 깔고 프로젝트를 켜 봐요 | 터미널, 설치, localhost | 03 |
| 매일 | 코드를 고치고 기록하고 다른 사람의 작업과 합쳐요 | Git, 브랜치, PR | 04 |
| 공개 준비 | 사이트 주소를 정하고 연결해요 | IP, 도메인, DNS 레코드 | 05 |
| 공개 준비 | 서버에 사이트 자리를 만들어요 | 웹서버, vhost | 06 |
| 공개 | 만든 것을 서버에 올리고 지켜봐요 | 배포, PM2, Docker, CI/CD | 07 |
| 출시 | 휴대폰 앱은 스토어 심사를 거쳐, 설치형 프로그램은 설치 파일로 사용자에게 보내요 | 버전, 코드 서명, 심사, 업데이트 | 08 |
| 실전 | 만든 앱을 손으로 직접 배포해 보고(09), AI와 함께 아이디어부터 배포까지 해 봐요(10) | 지금까지 전부 | 09 · 10 |
- 웹은 클라이언트(부탁하는 쪽)와 서버(답하는 쪽)의 대화예요.
- 이름(도메인) → 숫자 주소(IP) → 서버 → 안내 데스크(웹서버) → 앱 → 응답, 이 길을 기억하세요.
언어의 종류여러 언어가 역할을 나눠 맡아요
웹사이트 하나를 만드는 데 왜 언어가 여러 개 필요할까?
컴퓨터에게 일을 시키려면 컴퓨터가 알아듣는 말이 필요해요. 이걸 프로그래밍 언어라고 해요. 웹에서는 한 언어가 모든 걸 하지 않고, 일하는 장소에 따라 쓰는 언어가 달라요.
프론트엔드: 브라우저가 알아듣는 세 언어
브라우저가 직접 알아듣는 언어는 딱 세 가지예요. 집 짓기에 비유하면 쉬워요.
뼈대와 벽
HTML(HyperText Markup Language)은 “여기는 제목, 여기는 사진, 여기는 버튼”처럼 무엇이 어디에 있는지 정해요. 계산이나 판단은 못 해서 프로그래밍 언어가 아니라 마크업 언어(표시하는 언어)라고 불러요.
인테리어
CSS(Cascading Style Sheets)는 색깔, 글자 크기, 위치, 움직임처럼 어떻게 보일지 정해요. 같은 HTML도 CSS에 따라 완전히 다른 모습이 돼요.
전기와 스위치
JavaScript(줄여서 JS)는 버튼을 누르면 메뉴가 열리는 것처럼 동작을 맡아요. 계산하고 판단할 수 있는 진짜 프로그래밍 언어예요. 이름은 비슷해도 Java와는 다른 언어예요.
<!-- HTML: 버튼이 하나 있어요 -->
<button id="hello">눌러 보세요</button>
<!-- CSS: 버튼을 파랗고 둥글게 꾸며요 -->
<style>
#hello { background: blue; color: white; border-radius: 8px; }
</style>
<!-- JavaScript: 누르면 인사해요 -->
<script>
document.getElementById("hello").onclick = () => {
document.body.append("안녕하세요!");
};
</script>이 내용을 index.html로 저장하고 브라우저로 열면 바로 동작해요. 서버 없이도 돼요.
TypeScript는 JavaScript에 “이 값은 숫자, 이 값은 글자” 같은 타입 규칙을 더한 언어예요. 숫자 자리에 글자를 넣는 실수를 코드를 실행하기 전에 미리 잡아 줘서 현업에서 많이 써요. 브라우저는 TypeScript를 모르기 때문에, 화면에 쓰려면 JavaScript로 바꾸는 과정(빌드)을 거쳐요.
코드는 어디서 돌아갈까: 엔진과 런타임
코드는 사람이 읽을 수 있게 쓴 “할 일 목록”일 뿐이라, 그 자체로는 아무것도 하지 않아요. 누군가 코드를 읽고 실제로 실행해 줘야 해요. 이 일을 하는 프로그램을 엔진이라고 해요.
| 엔진 | 실행하는 언어 | 들어 있는 곳 |
|---|---|---|
| V8 | JavaScript | 크롬 브라우저, Node.js |
| JavaScriptCore | JavaScript | 사파리 브라우저 |
| Hermes | JavaScript | React Native로 만든 휴대폰 앱 |
| Zend Engine | PHP | 웹서버 뒤에서 PHP를 실행하는 PHP-FPM |
| JVM | Java, Kotlin | Java 서버 (Tomcat, Spring Boot) |
| CPython | Python | Python 프로그램 |
그런데 엔진은 계산과 판단만 할 줄 알아요. 화면에 버튼을 그리거나 컴퓨터의 파일을 여는 방법은 엔진이 놓인 장소가 제공해요. 이렇게 엔진에 그 장소의 도구를 더한, 코드가 실제로 돌아가는 환경을 런타임이라고 해요.
| 런타임 | 엔진 | 할 수 있는 것 | 못 하는 것 |
|---|---|---|---|
| 브라우저 | V8, JavaScriptCore 등 | 화면 요소 다루기, 클릭·입력 받기 | 내 컴퓨터 파일 마음대로 읽기 |
| Node.js | V8 | 파일 읽고 쓰기, 서버 열기, 데이터베이스 연결 | 화면 그리기 (화면이 없음) |
| React Native 앱 | Hermes | 휴대폰 화면 부품, 카메라·위치 같은 기능 | 웹페이지(HTML) 다루기 |
document.title = "Hello";
// ✓ 탭 제목이 바뀜
require("fs");
// ✗ require is not defined (파일 도구가 없음)document.title = "Hello";
// ✗ document is not defined (화면이 없음)
require("fs");
// ✓ 파일 도구를 불러옴코드는 악보, 엔진은 악보를 읽고 연주하는 연주자, 런타임은 연주자가 서 있는 공연장이에요. 같은 연주자라도 공연장에 따라 쓸 수 있는 악기와 조명이 달라요. 그래서 같은 JavaScript도 브라우저에서는 화면을, Node.js에서는 파일과 서버를 다룰 수 있어요.
Java처럼 실행하기 전에 코드를 미리 실행용 형태로 바꿔 두는 언어도 있어요. 이 과정을 컴파일이라고 해요. Java는 javac가 코드를 JVM 전용 중간 코드로 바꿔 두고, JVM이 그걸 실행해요. 미리 바꿔 두는 동안 오타 같은 실수를 잡아 주고, 실행도 빨라져요.
백엔드: 서버에서 돌아가는 언어
서버 쪽은 고를 수 있는 언어가 많아요. 로그인 확인, 글 저장, 결제처럼 손님 눈에 안 보이는 곳에서 일하는 코드예요. 어떤 언어를 쓰든 하는 일은 비슷하니, 언어 이름에 겁먹지 않아도 돼요.
원래 JavaScript는 브라우저 안에서만 돌았어요. 그런데 Node.js라는 프로그램 덕분에 서버에서도 돌 수 있게 됐어요. 그래서 요즘은 프론트와 백엔드를 모두 JavaScript로 만드는 프로젝트도 많아요.
| 언어 | 한 줄 설명 | 대표 프레임워크 | 많이 쓰는 곳 |
|---|---|---|---|
| JavaScript · TypeScript Node.js에서 실행 | 프론트와 같은 언어라 한 사람이 양쪽을 다루기 쉬워요 | Express, NestJS, Next.js | 스타트업, 실시간 채팅 |
| Java · Kotlin | 규칙이 엄격하고 튼튼해서 큰 시스템에 강해요 | Spring Boot | 국내 대기업, 은행, 공공기관 |
| Python | 문법이 쉽고 인공지능·데이터 분석 도구가 많아요 | Django, FastAPI | AI 서비스, 데이터 팀 |
| PHP (PHP: Hypertext Preprocessor) | 오래됐고 값싼 서버가 많아요. 아파치와 잘 맞아요 | Laravel, WordPress | 쇼핑몰, 회사 홈페이지, 블로그 |
| Go | 빠르고 가벼워요. 파일 하나로 실행돼요 | 기본 기능만으로 충분한 편 | 서버 관리 도구, 접속이 많은 서비스 |
| C# | 마이크로소프트가 만든 언어예요 | ASP.NET Core | 회사 내부 시스템, 게임 서버 |
앱과 설치형 프로그램을 만드는 언어
휴대폰과 컴퓨터의 운영체제(OS)는 저마다 “공식 언어”와 개발 도구 모음(SDK)을 내놓아요. 그 공식 길로 만든 앱을 네이티브 앱이라고 해요. 반대로, 코드 하나로 여러 OS용 앱을 한꺼번에 만드는 방식을 크로스 플랫폼이라고 해요.
| 만들 것 | 네이티브 (공식 길) | 크로스 플랫폼 (코드 하나로 여러 OS) |
|---|---|---|
| iOS 앱 iPhone, iPad | Swift (화면은 SwiftUI) | React Native (JavaScript), Flutter (Dart) |
| Android 앱 | Kotlin (화면은 Jetpack Compose) | React Native, Flutter (iOS와 같은 코드로) |
| Windows 프로그램 | C# (.NET, WinUI · WPF) | Electron, Tauri (웹 기술로 화면), Flutter |
| macOS 프로그램 | Swift (SwiftUI · AppKit) | Electron, Tauri, Flutter |
| 게임 | C++ 등 기기별 언어 | Unity (C#), Unreal Engine (C++), Godot |
Electron은 브라우저 엔진과 Node.js를 프로그램 안에 통째로 넣어서, HTML·CSS·JavaScript로 설치형 프로그램을 만들게 해 줘요. VS Code, Slack, Discord의 컴퓨터용 앱이 Electron으로 만들어졌어요. 대신 프로그램이 무거워지기 쉬워요. Tauri는 OS에 이미 있는 웹 화면 부품을 빌려 써서 훨씬 가벼워요.
네이티브는 OS의 새 기능을 가장 먼저, 가장 매끄럽게 쓸 수 있지만 iOS와 Android를 따로 만들어야 해요. 크로스 플랫폼은 한 팀이 두 앱을 함께 만들 수 있어 빠르지만, 카메라나 결제 같은 기기 기능에서 결국 네이티브 코드가 조금 필요할 때가 있어요. 실제로는 팀 인원과 이미 아는 언어를 보고 고르는 경우가 많아요.
데이터와 설정을 적는 글자 형식
| 이름 | 어디에 쓰나 | 생김새 |
|---|---|---|
| SQL (Structured Query Language) | 데이터베이스에게 “이런 데이터 꺼내 줘”라고 묻는 언어예요. MySQL, PostgreSQL 같은 데이터베이스에서 써요 | SELECT title FROM posts WHERE id = 1;posts 표에서 id가 1인 글의 제목을 줘 |
| JSON (JavaScript Object Notation) | 프론트와 백엔드가 데이터를 주고받을 때 쓰는 형식이에요. “이름: 값” 짝으로 적어요 | {"title": "첫 글", "likes": 3} |
| YAML (YAML Ain't Markup Language) | 설정 파일에 써요. 띄어쓰기(들여쓰기)가 틀리면 동작하지 않아요 | port: 3000 |
| Shell · Bash | 터미널에 치는 명령어예요. 반복되는 서버 작업을 자동으로 하게 만들 때 써요 | cd /var/www && ls |
| Markdown | 설명 문서(README)를 쓰는 간단한 서식이에요 | # 제목 |
언어 · 라이브러리 · 프레임워크는 어떻게 다를까?
말 그 자체
한국어의 단어와 문법 같은 거예요. 예: JavaScript, Python
골라 쓰는 공구
남이 만들어 둔 코드 묶음이에요. 필요할 때 내가 꺼내 써요. 예: React
이미 지은 건물 뼈대
실행 순서가 정해진 틀이에요. 나는 정해진 자리에 내 코드를 채우고, 틀이 알맞은 때에 그걸 실행해요. 예: Spring, Django, Next.js
- 과외 선생님 = 라이브러리. 내가 원하는 날, 원하는 과목으로 불러요. 언제 부를지는 내가 정해요.
- 학교 = 프레임워크. 시간표와 종소리는 학교가 정해요. 선생님은 “3교시 수학” 수업 내용만 준비하면, 종이 울릴 때 학교가 그 수업을 시작시켜요.
코드에서는 “그 기능을 부르는 줄을 내가 썼나?”로 구별해요. 이 기준은 어느 언어에서나 통해요.
import { format } from "date-fns";
const today = format(new Date(), "yyyy-MM-dd");
// ↑ 부르는 줄을 내가 씀
console.log(today);// 파일 위치: app/about/page.js
export default function About() {
return <h1>About us</h1>;
}
// About()을 부르는 줄은 없음// app/Config/Routes.php
$routes->get('about', 'About::index');
// app/Controllers/About.php
class About extends BaseController {
public function index() {
return view('about');
}
}@GetMapping("/about")
public String about() {
return "About us";
}
// about()을 부르는 줄은 없음왼쪽 위처럼 format(…)을 부르는 줄을 내가 직접 쓰면 라이브러리를 쓰는 중이에요. 나머지 셋은 함수를 부르는 줄이 내 코드 어디에도 없어요. 정해진 자리에 두거나(Next.js의 app/about/page.js), 주소를 적어 두거나(CodeIgniter의 Routes.php), 이름표를 붙여 두면(Spring의 @GetMapping), 누군가 /about 주소로 올 때 프레임워크가 알아서 실행해요. @로 시작하는 이런 이름표를 어노테이션이라고 해요.
PHP의 date(), Java의 java.time처럼 언어에 처음부터 들어 있는 도구는 표준 라이브러리라고 해요. 그리고 WordPress는 프레임워크가 아니라, 설치하면 바로 사이트가 되는 완성된 프로그램(CMS)이에요.
정적 사이트와 동적 사이트
나중에 배포 방법을 고를 때 꼭 필요한 구분이에요.
정적(Static) 사이트
미리 만들어 둔 파일을 그대로 보내 줘요. 인쇄된 전단지처럼 누가 와도 내용이 같아요. 회사 소개 페이지나 설명서 사이트가 그래요. 서버에 프로그램이 돌 필요가 없어서 싸고 빨라요.
동적(Dynamic) 사이트
부탁이 올 때마다 서버 프로그램이 그 자리에서 페이지를 만들어요. 주문받고 요리하는 식당처럼, 로그인한 사람마다 다른 화면이 나와요. 쇼핑몰이나 SNS가 그래요. 서버에서 앱이 항상 켜져 있어야 해요.
화면은 누가 그릴까: 렌더링
“좋아요 버튼과 그 옆에 숫자 3” 같은 화면 설계를 실제로 눈에 보이는 화면으로 그리는 일을 렌더링이라고 해요. 설계가 같아도 그리는 방법은 장소마다 달라요.
웹 (브라우저)
HTML과 CSS로 그려요. 브라우저가 이걸 읽고 화면의 점(픽셀)으로 바꿔요.
휴대폰 앱
iOS·Android가 원래 가진 화면 부품(네이티브 부품)으로 그려요. HTML은 쓰지 않아요.
웹에서는 화면을 어디에서 완성하느냐도 고를 수 있어요.
| 방식 | 무슨 뜻 | 식당으로 치면 |
|---|---|---|
| 브라우저에서 렌더링 | 서버는 재료(데이터와 코드)만 보내고, 사용자의 브라우저가 화면을 완성해요 | 밀키트를 받아 손님이 테이블에서 조립 |
| 서버에서 렌더링 | 서버가 HTML까지 다 만들어서 보내요. 첫 화면이 빨리 뜨고, 검색 엔진도 내용을 잘 읽어요 | 주방에서 완성된 요리를 내보냄 |
정적 사이트는 미리 만들어 둔 HTML을 보내니 렌더링이 미리 끝나 있는 셈이에요. 동적 사이트는 이 두 방식 중 하나, 또는 둘을 섞어서 그려요.
실제 프로젝트에서는 언어 하나보다 그 프로젝트가 쓰는 조합을 먼저 확인하세요. 이 조합을 기술 스택이라고 해요. 예를 들면 “React(프론트) + Spring Boot(백엔드) + MySQL(데이터베이스)”처럼요. 프로젝트 폴더의 README.md나 package.json을 보면 대부분 알 수 있어요.
React, React Native, Node.js, Next.js는 어디에 놓일까
이름이 비슷해서 자주 헷갈리는 넷이에요. 위에서 본 엔진, 런타임, 렌더링, 라이브러리, 프레임워크로 보면 각자의 자리가 분명해져요.
Node.js
JavaScript를 내 컴퓨터와 서버에서 돌리는 실행 환경이에요. 화면은 만들지 않아요. npm install, npm run dev 같은 개발 도구도 Node.js 위에서 돌아가요.
Next.js
React로 웹사이트를 만드는 틀이에요. HTML로 렌더링하고, 주소마다 페이지 연결, 서버에서 렌더링, 서버 쪽 코드까지 맡아요. 서버 쪽은 Node.js에서 돌아가요.
React Native
React로 휴대폰 앱을 만드는 틀이에요. iOS·Android의 네이티브 부품으로 렌더링하고, 앱 안의 Hermes 엔진에서 돌아가요. Node.js는 개발하는 컴퓨터에서만 써요.
네 개를 한 장의 지도로 모으면 이렇게 돼요. 세로로 읽으면 “무엇을 만들 때 무엇을 쓰나”, 가로로 읽으면 “같은 층에서 맡는 역할”이에요. 아래층일수록 기본이고, 위층일수록 사용자에게 가까워요.
(배포 · 출시)
(프레임워크)
(라이브러리)
(런타임)
표가 화면보다 넓으면 옆으로 밀어서 보세요.
다른 언어로 바꿔도 층 구조는 같아요. 그래서 “PHP와 CodeIgniter”, “Java와 Spring Boot”는 “JavaScript와 Next.js”와 같은 관계예요.
| 언어 | 실행 장소 (엔진·런타임) | 라이브러리 예 | 프레임워크 예 |
|---|---|---|---|
| JavaScript | 브라우저, Node.js, 앱 안의 Hermes | React, date-fns | Next.js, React Native, Express |
| PHP | Zend Engine (PHP-FPM이 실행) | Carbon, PHPMailer | CodeIgniter, Laravel, Symfony |
| Java · Kotlin | JVM | Jackson, Apache Commons | Spring, Spring Boot |
| Python | CPython | requests, pandas | Django, FastAPI, Flask |
| C# | .NET 런타임 | Newtonsoft.Json | ASP.NET Core |
- “Node.js는 프레임워크다.” 아니에요. 런타임(실행 장소)이에요. Express나 Next.js 같은 프레임워크가 그 위에서 돌아가요.
- “React만 있으면 웹사이트가 된다.” React는 화면 부품을 설계할 뿐이에요. 페이지 주소, 서버, 빌드는 Next.js 같은 프레임워크나 따로 고른 도구가 맡아요.
- “React Native 앱은 웹페이지를 앱 상자에 넣은 것이다.” 아니에요. 휴대폰의 진짜 화면 부품으로 그려요.
- “Tomcat은 Java 프레임워크다.” Tomcat은 Java 웹 앱을 돌리는 웹서버(실행 장소)예요. 프레임워크는 Spring이에요.
이번 프로젝트는 이 스택으로 가시죠.
이번 프로젝트는 이 기술 조합으로 만들자.
거기는 레거시라서 함부로 못 건드려요.
오래전에 만들어져 아직 돌아가는 코드라서, 고치다가 다른 곳이 망가질까 봐 조심스러워요.
- 브라우저는 HTML(구조), CSS(모양), JavaScript(동작) 세 가지만 알아들어요.
- 서버 언어는 여러 가지지만 하는 일은 비슷해요. 실무에서는 언어보다 프레임워크와 기술 스택을 봐요.
- 정적 사이트는 파일만 있으면 되고, 동적 사이트는 서버에서 앱이 계속 돌아야 해요.
- 엔진은 코드를 실행하고, 런타임은 엔진에 그 장소의 도구를 더한 실행 환경이에요. Node.js는 런타임, React는 라이브러리, Next.js와 React Native는 프레임워크예요.
- 앱은 OS의 공식 언어로 만드는 네이티브와, 코드 하나로 여러 OS를 맡는 크로스 플랫폼으로 나뉘어요.
누가 무엇을 하나서비스 하나에 여러 사람이 손을 대요
개발자 말고는 누가 서비스를 만들까?
작은 팀이나 혼자 하는 프로젝트에서는 한 사람이 여러 역할을 함께 맡기도 해요. 그래도 해야 할 일 자체는 대체로 이렇게 나뉘어요. 식당 비유를 이어 가 볼게요.
| 역할 | 하는 일 | 주로 만드는 것 | 식당이라면 |
|---|---|---|---|
| 기획자 PM(Project · Product Manager), PO(Product Owner) | 무엇을, 왜, 언제까지 만들지 정하고 팀 사이를 이어 줘요 | 기획서, 화면 설계서, 일정표 | 사장님, 메뉴 개발자 |
| 디자이너 UI(User Interface), UX(User Experience) | 화면 모양(UI)과 쓰기 편한 흐름(UX)을 설계해요 | Figma 같은 프로그램으로 만든 디자인 시안 | 인테리어·메뉴판 디자이너 |
| 웹 퍼블리셔 | 디자인 시안을 HTML과 CSS로 똑같이 옮겨요. 한국과 일본에 특히 많은 직군이에요 | HTML·CSS 파일 | 인테리어 시공팀 |
| 프론트엔드 개발자 | 브라우저에서 돌아가는 화면과 기능을 만들고, 서버와 연결해요 | React·Vue 등으로 만든 화면 코드 | 홀 직원 |
| 백엔드 개발자 | 서버의 규칙(로그인, 결제 등)을 만들고 데이터를 저장해요 | API 서버, 데이터베이스 구조 | 주방 요리사 |
| 앱 개발자 iOS · Android | 휴대폰 앱의 화면과 기능을 만들고, 스토어 출시까지 챙겨요. 설치형 프로그램을 만드는 데스크톱 개발자도 비슷한 자리예요 | 앱 코드, 스토어에 올릴 빌드 | 포장·배달 담당 |
| 데브옵스 · 인프라 DevOps(Development + Operations) | 서버를 준비하고, 배포를 자동으로 만들고, 서버가 아프지 않은지 지켜봐요 | 서버 설정, Docker, CI/CD | 건물 관리인, 전기·가스 담당 |
| QA (Quality Assurance, 품질 보증) | 출시 전에 일부러 이것저것 눌러 보며 버그(오류)를 찾아요 | 테스트 계획, 버그 보고서 | 시식·위생 검사원 |
회의에서 말하는 PM은 보통 위 표의 사람(기획자)이에요. 하지만 서버 이야기에서 나오는 PM2는 Node.js 앱이 꺼지지 않게 지켜 주는 프로그램이에요. 이름만 비슷하고 전혀 상관없어요. PM2는 07장에서 배워요.
킥오프 때 R&R부터 정리하고 얼라인 맞추죠.
일을 시작하는 첫 회의에서 누가 무엇을 맡는지(역할과 책임, Role & Responsibility)부터 정하고 방향을 맞추자.
리소스가 부족해서 이번 스프린트엔 못 들어가요.
일할 사람과 시간이 모자라서, 이번 작업 기간(보통 1~2주)에는 시작하지 못해요.
퍼블리싱이란?
한국의 웹 업계에서는 디자인 시안을 브라우저에서 실제로 보이는 HTML·CSS 화면으로 옮기는 일을 퍼블리싱이라고 해요. 이 일을 맡는 사람이 위 표의 웹 퍼블리셔예요. 디자이너가 그린 그림을, 누를 수 있고 화면 크기에 맞게 늘었다 줄었다 하는 진짜 웹페이지로 만드는 단계예요. 이 일을 따로 떼어 전문 직군으로 두는 곳은 주로 한국과 일본이에요. 일본에서는 같은 일을 “코딩”(コーディング), 맡는 사람을 “코더”나 “마크업 엔지니어”라고 불러요.
| 하는 일 | 무슨 뜻 |
|---|---|
| 마크업 | 내용의 의미에 맞는 HTML 태그로 구조를 짜요. 제목은 제목 태그로, 목록은 목록 태그로. 이렇게 의미를 살린 마크업을 시맨틱 마크업이라고 해요 |
| 스타일 | CSS로 색, 글꼴, 간격, 배치를 시안과 똑같이 맞춰요 |
| 반응형 | 휴대폰부터 큰 모니터까지 화면 크기에 맞게 배치가 바뀌게 해요 |
| 크로스 브라우징 | 크롬, 사파리, 엣지 등 어느 브라우저에서나 똑같이 보이고 동작하게 해요 |
| 웹 접근성 | 화면 낭독기를 쓰는 사람, 키보드만 쓰는 사람도 이용할 수 있게 해요. 공공기관 사이트는 접근성 기준을 지켜야 해요 |
| 전달 | 완성한 HTML·CSS 파일과 사용 안내를 개발자에게 넘겨요. 개발자는 여기에 데이터와 동작을 붙여요 |
<!-- 의미에 맞는 태그를 고르면 검색 엔진과 화면 낭독기도 구조를 이해해요 -->
<header>우리 식당</header>
<main>
<h1>오늘의 메뉴</h1>
<ul>
<li>김치찌개</li>
<li>된장찌개</li>
</ul>
</main>| 퍼블리싱 | 프론트엔드 개발 | |
|---|---|---|
| 주로 다루는 것 | HTML, CSS, 간단한 JavaScript | JavaScript·TypeScript, React 같은 라이브러리·프레임워크 |
| 결과물 | 시안대로 보이는 화면 (아직 진짜 데이터는 없음) | 서버의 데이터를 받아 동작하는 화면 |
| 확인하는 질문 | “시안과 똑같이 보이나? 어느 기기·브라우저에서도?” | “데이터가 바뀌면 화면이 맞게 움직이나?” |
영어권과 유럽 등 다른 나라에서는 이 일을 따로 떼지 않고 프론트엔드 개발의 일부로 봐요. 그래서 영어로는 보통 “HTML/CSS markup”, “UI implementation”이라고 하고, 맡는 사람도 그냥 프론트엔드 개발자예요. 게다가 영어의 publish는 “공개하다, 배포하다”라는 뜻이라(07장의 배포), 해외 자료에서 publishing을 찾으면 배포 이야기가 나오기 쉬워요. 한국에서도 요즘은 프론트엔드 개발자가 퍼블리싱까지 하거나 퍼블리셔가 React를 다루기도 해서, 두 역할의 경계가 섞여 가고 있어요.
퍼블 끝나면 개발 붙을게요.
퍼블리싱(HTML·CSS 작업)이 끝나면 개발을 시작할게요.
프론트엔드와 백엔드를 잇는 약속, API
프론트엔드와 백엔드는 서로 다른 사람이 따로 만들어요. 둘이 대화하려면 약속이 필요한데, 그 약속을 API(Application Programming Interface)라고 해요.
식당의 주문서 양식이라고 생각하면 돼요. 홀 직원은 주방이 어떻게 요리하는지 몰라도, 주문서에 “김치찌개 1개”라고 정해진 대로 쓰면 요리가 나와요. API도 “이 주소로 이렇게 부탁하면, 이런 모양으로 답해 줄게”라는 약속이에요.
# 부탁(요청): 1번 글을 주세요
GET https://api.example.com/posts/1
# 답(응답): JSON 형식
{
"id": 1,
"title": "처음 만든 웹사이트 회고",
"author": "김개발"
}맨 앞의 GET은 “가져다줘”라는 뜻이에요. 이 밖에도 POST(새로 만들어 줘), PUT·PATCH(고쳐 줘), DELETE(지워 줘)가 있어요. 그래서 보통 개발을 시작하기 전에 API 명세서(어떤 주소에 무엇을 보내면 무엇이 돌아오는지 적은 문서)를 먼저 정해요. 약속이 정해지면 프론트와 백엔드를 동시에 만들 수 있어요.
API 스펙 픽스되면 공유 부탁드려요.
API로 무엇을 어떤 형식으로 주고받을지 확정되면 알려 주세요.
일이 흘러가는 순서
- 기획무엇을 만들지, 무엇을 하면 성공인지 정해요.
- 디자인화면 시안을 만들고 기획자와 함께 확정해요.
- 개발API 약속을 먼저 정하고, 프론트와 백엔드가 나눠서 만들어요. 각자 Git의 브랜치에서 작업해요.
- 코드 리뷰동료가 내 코드를 읽고 의견을 남겨요(Pull Request). 승인되면 합쳐요.
- QA 테스트실제와 똑같이 만든 연습용 서버(스테이징)에서 테스트해요.
- 배포진짜 서비스 서버(프로덕션)에 올려요.
- 운영 · 모니터링오류와 접속량을 지켜보고, 문제가 생기면 고쳐요. 그리고 다시 1번부터 반복해요.
팀으로 일하면 할 일은 보통 티켓이라는 형태로 와요. Jira, Linear, GitHub Issues 같은 업무 관리 도구에 있는 “할 일 카드”예요. 카드에는 할 일, 완료 기준, 관련 디자인 링크가 적혀 있어요. 모르는 게 있으면 카드에 적힌 담당자(기획자, 디자이너, 다른 개발자)에게 물어보면 돼요.
이 건 티켓 따서 저한테 어사인해 주세요.
이 일을 할 일 카드로 만들고, 담당자를 저로 정해 주세요.
내일까지 디벨롭해서 컨펌받을게요.
내일까지 더 다듬어서 확인(승인)을 받을게요.
- 기획 → 디자인 → 개발 → 리뷰 → 테스트 → 배포 → 운영이 한 바퀴예요.
- 프론트엔드와 백엔드는 API라는 약속으로 대화해요.
- 사람 PM과 프로그램 PM2는 다른 거예요.
- 퍼블리싱은 디자인 시안을 HTML·CSS 화면으로 옮기는 일이에요. 따로 된 직군은 주로 한국(퍼블리셔)과 일본(코더)에 있고, 다른 나라에서는 프론트엔드 개발의 일부로 봐요.
내 컴퓨터 준비로컬 개발 환경 만들기
개발은 어디서 시작할까?
로컬(local)은 “지금 내 앞에 있는 내 컴퓨터”라는 뜻이에요. 개발은 항상 로컬에서 먼저 하고, 다 만들면 서버에 올려요. 로컬에서 망가뜨려도 손님(사용자)에게는 아무 영향이 없으니 마음껏 시도해도 돼요.
준비물
| 도구 | 무엇인가요? | 대표 예 |
|---|---|---|
| 코드 에디터 | 코드 쓰는 메모장이에요. 색칠, 자동 완성, 오류 표시를 해 줘요 | VS Code(Visual Studio Code), IntelliJ |
| 터미널 | 마우스 대신 글자로 컴퓨터에 명령하는 창이에요 | macOS 터미널, Windows Terminal |
| 패키지 관리자 | 프로그램을 명령어 한 줄로 설치해 주는 “앱스토어”예요 | Homebrew(맥), winget(윈도우), npm(JavaScript 부품) |
| 런타임 | 코드를 실제로 실행해 주는 환경이에요(01장). JavaScript를 브라우저 밖에서 돌리려면 Node.js가 필요해요 | Node.js, Python, JDK(Java Development Kit) |
| Git | 코드의 변경 기록을 저장하는 도구예요 (04장) | git |
| 개발자 도구 | 브라우저에서 F12를 누르면 열려요. 화면 구조, 주고받은 데이터, 오류를 볼 수 있어요 | Chrome DevTools |
터미널이 처음이라면
터미널은 처음엔 무섭지만, 사실 “명령어 + 대상”으로 된 짧은 문장이에요. 예를 들어 cd blog는 “blog 폴더로 들어가”라는 뜻이에요. 아래 다섯 개만 알아도 시작할 수 있어요.
| 명령어 | 원래 말 | 뜻 |
|---|---|---|
pwd | print working directory | 지금 내가 어느 폴더에 있는지 보여 줘 |
ls | list | 이 폴더 안에 뭐가 있는지 보여 줘 (윈도우 옛 명령은 dir) |
cd 폴더 | change directory | 그 폴더로 들어가. cd ..은 한 칸 위로 나가기 |
mkdir 이름 | make directory | 새 폴더를 만들어 |
Ctrl + C | (단축키) | 지금 실행 중인 명령을 멈춰. 개발 서버를 끌 때 써요 |
설치하기
# 1) Homebrew 설치: 공식 사이트 brew.sh 첫 화면의 명령어를 복사해 실행해요
# 2) Git, Node.js, VS Code 설치
brew install git node
brew install --cask visual-studio-code# winget은 Windows 10·11에 처음부터 들어 있어요
winget install Git.Git
winget install OpenJS.NodeJS.LTS
winget install Microsoft.VisualStudioCode
# 서버와 같은 리눅스 환경이 필요하면 WSL도 설치 (관리자 권한으로 실행)
wsl --installWSL(Windows Subsystem for Linux)은 윈도우 안에서 리눅스를 쓸 수 있게 해 주는 기능이에요. 서버는 대부분 리눅스라서 명령어 연습에 좋아요.
git --version
node -v
npm -vLTS(Long Term Support)는 “오래오래 고장 수리를 해 주는 안정 버전”이에요. 실제 서비스에는 보통 가장 최신판보다 LTS를 써요. 맥에서 brew install node는 최신판을 깔아요. 프로젝트가 특정 버전을 원하면 nvm(Node Version Manager) 같은 버전 관리 도구로 맞춰 쓰면 돼요.
팀 프로젝트를 내 컴퓨터에서 켜 보기
- 코드 받기GitHub 같은 온라인 코드 보관소(원격 저장소)에서 프로젝트 코드를 통째로 복사해 와요.터미널
git clone https://github.com/my-company/blog.git cd blog - 필요한 부품 설치
package.json에 적힌 부품(라이브러리)을 내려받아node_modules폴더에 넣어요. npm은 원래 Node Package Manager에서 온 이름이에요.터미널npm install - 비밀 설정 파일 만들기프로젝트에 있는
.env.example을 복사해서.env를 만들고, 필요한 값을 채워요(팀 프로젝트라면 담당자에게 받아요). 이런 설정 값을 환경 변수라고 해요. - 개발 서버 켜기터미널에 나온 주소를 브라우저에서 열어요. 코드를 고치고 저장하면 화면이 바로 바뀌어요.터미널
npm run dev # → Local: http://localhost:3000
localhost:3000은 무슨 뜻일까?
localhost는 “나 자신”이라는 뜻의 특별한 이름이에요. 숫자 주소로는 127.0.0.1이에요. 뒤의 3000은 내 컴퓨터의 3000번 문(포트)을 뜻해요. 그래서 친구가 자기 컴퓨터에서 localhost:3000을 치면, 친구 자신의 컴퓨터를 찾아가서 내 화면은 안 보여요. 포트는 05장에서 자세히 봐요.
꼭 알아 둘 파일
| 파일 | 역할 | Git에 올릴까? |
|---|---|---|
package.json | 필요한 부품 목록과 실행 명령(npm run dev 등)이 적혀 있어요. 장보기 목록 | 올려요 |
package-lock.json | 실제로 설치된 정확한 버전 기록이에요. 모두가 똑같은 버전을 쓰게 해 주는 영수증 | 올려요 |
node_modules/ | 설치된 부품 실물이에요. 수백 MB가 되기도 해요. npm install로 언제든 다시 만들 수 있어요 | 안 올려요 |
.env | 데이터베이스 비밀번호, API 키 같은 비밀 설정이에요 | 절대 안 올려요 |
- iOS 앱은 Mac과 Xcode가 있어야 빌드할 수 있어요. Xcode는 macOS에서만 돌아가요.
- Android 앱은 Android Studio로 만들어요. Windows, macOS, Linux 어디서나 돼요.
- 컴퓨터 안에 가짜 휴대폰을 띄워서 시험할 수 있어요. iOS는 시뮬레이터, Android는 에뮬레이터라고 불러요. 그래도 출시 전에는 진짜 기기로 꼭 확인해요.
- 설치형 프로그램은 지원할 OS마다 직접 설치하고 실행해 봐야 해요. macOS용은 보통 Mac에서 빌드하고 서명해요.
로컬 · 스테이징 · 프로덕션
같은 코드가 세 곳에서 돌아가요. 이 세 곳을 환경이라고 불러요. 연극으로 치면 연습실, 리허설 무대, 실제 공연이에요.
| 환경 | 어디에 있나 | 누가 보나 | 주소 예시 |
|---|---|---|---|
| 로컬 (개발) | 개발자 각자의 컴퓨터 | 나만 | localhost:3000 |
| 스테이징 | 실제와 똑같이 꾸민 테스트용 서버 | 팀원, QA | staging.example.com |
| 프로덕션 (운영) | 진짜 서비스 서버 | 모든 사용자 | example.com |
환경마다 .env 값이 달라요. 예를 들어 로컬은 연습용 데이터베이스, 프로덕션은 진짜 고객 데이터베이스를 가리켜요. 그래서 코드는 같고 설정만 바꿔서 여러 환경에서 돌려요.
이상하네요, 로컬에선 되는데요?
내 컴퓨터에서는 잘 되는데요. 서버와 내 컴퓨터의 환경(버전, 설정)이 다를 때 자주 나오는 말이에요.
- 준비물은 에디터, 터미널, 런타임(Node.js), Git이에요.
- 프로젝트는
git clone→npm install→.env만들기 →npm run dev순서로 켜요. node_modules와.env는 Git에 올리지 않아요.
Git코드의 세이브 포인트이자 팀 협업 도구
여러 명이 같은 코드를 고치면 어떻게 안 섞이게 할까?
숙제_최종.hwp, 숙제_진짜최종.hwp, 숙제_진짜최종_수정2.hwp… 이런 경험 있나요? Git(깃)은 이 문제를 해결하는 버전 관리 도구예요. 파일 이름은 하나로 두고, 바꿀 때마다 “언제, 누가, 무엇을, 왜” 바꿨는지 기록을 남겨요. 게임의 세이브 포인트처럼 언제든 예전 상태로 돌아갈 수 있어요.
도구 (프로그램)
내 컴퓨터에 설치하는 기록 프로그램이에요. 인터넷 없이도 동작해요.
보관소 (웹사이트)
Git 기록을 인터넷에 올려 두고 팀이 함께 보는 서비스예요. 코드 리뷰 기능도 여기 있어요.
Git이 기록을 관리하는 프로젝트 폴더를 저장소(Repository, 줄여서 레포)라고 해요. 내 컴퓨터에 있으면 로컬 저장소, GitHub에 있으면 원격 저장소예요.
Git의 네 공간
Git을 이해하는 핵심은 코드가 네 군데를 거쳐 간다는 거예요. 택배로 치면 “물건 고르기 → 상자에 담기 → 포장해서 송장 붙이기 → 택배 보내기”예요.
git clone으로 원격 저장소 전체를 복사해 와요.파일 10개를 고쳤는데, 그중 “로그인 오류 수정”에 관련된 3개만 먼저 기록하고 싶을 때가 있어요. 스테이징은 이번 기록에 넣을 파일만 골라 담는 바구니예요. 덕분에 기록(커밋) 하나하나가 한 가지 의미만 갖게 돼요.
처음 한 번만 하는 설정
git config --global user.name "김개발"
git config --global user.email "dev@example.com"
git config --global init.defaultBranch main매일 쓰는 명령어
| 명령어 | 하는 일 | 비유 |
|---|---|---|
git clone 주소 | 원격 저장소를 내 컴퓨터로 통째로 복사해요 | 책 한 권 복사해 오기 |
git status | 무엇이 바뀌었고 무엇이 바구니에 담겼는지 봐요. 가장 자주 써요 | 장바구니 확인 |
git diff | 정확히 어떤 줄이 바뀌었는지 봐요 | 틀린 그림 찾기 |
git add 파일 | 바구니(스테이징)에 담아요. git add .은 바뀐 것 전부 | 상자에 담기 |
git commit -m "메시지" | 담긴 것을 하나의 기록으로 저장해요 | 세이브 |
git push | 내 기록을 원격 저장소에 올려요 | 택배 보내기 |
git pull | 원격의 새 기록을 받아서 합쳐요 | 택배 받기 |
git log --oneline | 지금까지의 기록을 한 줄씩 봐요 | 일기장 넘겨 보기 |
git switch -c 이름 | 새 브랜치를 만들고 그쪽으로 옮겨 가요 | 평행 세계 만들기 |
git merge 이름 | 다른 브랜치의 작업을 지금 브랜치에 합쳐요 | 두 세계 합치기 |
git stash | 하던 작업을 잠깐 서랍에 넣어요. git stash pop으로 다시 꺼내요 | 책상 잠깐 치우기 |
브랜치: 안전하게 실험하는 평행 세계
브랜치(branch)는 나뭇가지라는 뜻이에요. 모두가 쓰는 본줄기 main을 직접 건드리지 않고, 가지를 따로 뻗어서 거기서 작업해요. 다 만들면 본줄기에 합쳐요(merge). 망치면 가지만 버리면 되니 안전해요.
팀 프로젝트의 하루 흐름
- 최신 코드 받기일 시작 전에 팀원들이 올린 변경부터 받아요.터미널
git switch main git pull - 내 작업용 브랜치 만들기이름은 보통
feature/할일,fix/고칠것처럼 지어요.터미널git switch -c feature/login - 작업하고 자주 커밋하기한 가지 일을 끝낼 때마다 기록해요.터미널
git status git add src/login.js git commit -m "feat: 로그인 폼 추가" - 원격에 올리기터미널
git push -u origin feature/loginorigin은 원격 저장소의 기본 별명이에요.-u는 처음 한 번만 붙이면 되고, 그다음부터는git push만 쳐도 돼요. - PR 만들기GitHub에서 “제 브랜치를 main에 합쳐 주세요”라고 요청해요. 이걸 PR(Pull Request)이라고 해요. 동료가 코드를 읽고 의견(리뷰)을 남겨요. GitLab에서는 같은 기능을 MR(Merge Request)이라고 불러요.
- 승인되면 합치기합친 뒤 다 쓴 브랜치는 지워요. main에 합쳐지면 자동으로 배포되게 해 두는 프로젝트가 많아요(07장 CI/CD).
충돌(conflict)은 고장이 아니에요
나와 팀원이 같은 파일의 같은 줄을 다르게 고치면, Git은 어느 쪽이 맞는지 몰라서 사람에게 물어봐요. 이게 충돌이에요. 파일을 열면 이렇게 표시돼 있어요.
<<<<<<< HEAD
const title = "우리 팀 블로그"; // 내 브랜치(지금 있는 곳)의 내용
=======
const title = "Example 기술 블로그"; // 합치려는 쪽(main)의 내용
>>>>>>> main해결 방법은 간단해요.
- 둘 중 맞는 내용(또는 둘을 섞은 내용)만 남겨요.
<<<<<<<,=======,>>>>>>>표시 줄을 지워요.git add→git commit해요.
어느 쪽이 맞는지 애매하면 그 줄을 고친 동료에게 물어보세요. 혼자 고민하는 것보다 훨씬 빨라요.
.gitignore: Git에 올리지 않을 파일 목록
node_modules/
.env
dist/
.DS_Store
*.log한 줄에 하나씩 적어요. *.log는 “이름이 .log로 끝나는 모든 파일”이라는 뜻이에요.
좋은 커밋 메시지
메시지만 읽어도 무엇을 왜 했는지 알 수 있어야 해요. 많은 팀이 앞에 종류를 붙이는 규칙(Conventional Commits)을 써요.
| 머리말 | 뜻 | 예시 |
|---|---|---|
feat: | 새 기능 (feature) | feat: 비밀번호 찾기 화면 추가 |
fix: | 오류 수정 | fix: 모바일에서 메뉴가 안 닫히는 문제 |
docs: | 문서 수정 (documents) | docs: README에 설치 방법 추가 |
refactor: | 동작은 그대로, 코드만 정리 | refactor: 날짜 계산 함수 분리 |
chore: | 설정 변경, 부품 업데이트 같은 잡일 | chore: eslint 버전 올림 |
- 비밀번호나 API 키를 커밋하지 마세요. 다음 커밋에서 지워도 Git 기록에는 그대로 남아요. 실수로 올렸다면 바로 팀에 알리고, 그 키를 못 쓰게 막고 새로 발급받아야 해요.
- main에 직접 push하지 마세요. 항상 브랜치 → PR → 리뷰 순서를 지켜요.
git push --force는 함께 쓰는 브랜치에 쓰지 마세요. 남이 올린 기록을 덮어써서 지울 수 있어요.- 일 시작 전에
git pull을 습관처럼 하세요. 충돌이 훨씬 줄어요.
PR 올렸어요. 리뷰 부탁드려요.
합쳐 달라는 요청(PR)을 만들었으니, 코드를 검토해 주세요.
어프루브 나면 머지할게요.
승인(approve)을 받으면 합칠게요.
컨플릭트 나서 develop 땡겨 와서 풀었어요.
충돌이 나서, develop 브랜치의 최신 내용을 받아(pull) 와서 해결했어요.
- 코드는 작업 폴더 → (add) → 스테이징 → (commit) → 로컬 저장소 → (push) → 원격 저장소로 가요.
- 작업은 브랜치에서 하고, PR로 리뷰받은 뒤 main에 합쳐요.
- 충돌은 사람이 골라 주면 끝나요. 비밀 정보는 절대 커밋하지 않아요.
IP · 도메인 · DNS인터넷에서 “주소”가 작동하는 방법
example.com이라는 이름만으로 어떻게 지구 반대편 컴퓨터를 찾아갈까?
IP 주소: 인터넷의 전화번호
인터넷에 연결된 모든 기기는 숫자로 된 번호를 하나씩 받아요. 이게 IP 주소(Internet Protocol address)예요. 컴퓨터끼리는 이 번호로 서로를 찾아요. 이름의 프로토콜은 “컴퓨터끼리 대화하는 규칙”이라는 뜻이에요.
점으로 나눈 숫자 네 덩어리
IPv4(IP version 4)는 각 덩어리가 0~255예요. 만들 수 있는 번호가 약 43억 개뿐이라 이미 모자라요.
훨씬 긴 새 주소
IPv6(IP version 6)는 번호가 거의 무한히 많아요. 점점 늘고 있지만 아직 IPv4와 함께 써요.
| 종류 | 뜻 | 예시 |
|---|---|---|
| 공인 IP | 인터넷 전체에서 하나뿐인 번호예요. 서버는 공인 IP가 있어야 바깥에서 찾아올 수 있어요 | 203.0.113.10 |
| 사설 IP | 집이나 회사 공유기 안에서만 쓰는 번호예요. 다른 집에서도 똑같은 번호를 써요. 아파트 안의 인터폰 번호 같은 거예요 | 192.168.0.5, 10.0.0.3 |
| 루프백 | 나 자신을 뜻하는 번호예요. 03장의 localhost | 127.0.0.1 |
이 교과서의 IP 예시(203.0.113.x, 2001:db8::)는 설명서용으로 따로 정해 둔 번호라서 실제 서버와 겹치지 않아요.
포트: 건물 안의 호수
IP가 건물 주소라면, 포트(port)는 그 건물 안의 호수예요. 서버 컴퓨터 한 대에서 여러 프로그램이 동시에 돌아가니까, 몇 번 문으로 들어갈지 정해야 해요. 번호는 0~65535까지 있고, 자주 쓰는 번호는 정해져 있어요.
| 포트 | 용도 | 메모 |
|---|---|---|
80 | HTTP (암호화 안 된 웹) | 주소에 안 써도 자동으로 붙어요 |
443 | HTTPS (암호화된 웹) | 요즘 거의 모든 사이트가 써요 |
22 | SSH (서버 원격 접속) | 개발자가 서버에 들어갈 때 써요 |
3000, 5173, 8080 | 개발 서버, 앱 서버 | 관습일 뿐이라 바꿀 수 있어요 |
3306 / 5432 | MySQL / PostgreSQL 데이터베이스 | 바깥에 열어 두면 위험해요 |
도메인: 외우기 쉬운 이름표
203.0.113.10을 외우는 사람은 없어요. 그래서 숫자에 이름을 붙였는데, 그게 도메인이에요. 도메인은 오른쪽에서 왼쪽으로 읽으면 큰 단위에서 작은 단위로 내려가요. 주소를 “대한민국 서울시 강남구”처럼 큰 데서부터 읽는 것과 같아요.
| 부분 | 설명 | 예시 |
|---|---|---|
| 최상위 도메인 TLD (Top-Level Domain) | 맨 끝 부분이에요. 나라나 종류를 나타내요 | .com .kr .net .io |
| 도메인 이름 | 도메인 등록 업체에 돈을 내고 1년 단위로 빌리는 이름이에요. 기간 연장을 잊으면 남이 가져갈 수도 있어요 | example.com, example.co.kr |
| 루트 도메인 | 앞에 아무것도 붙지 않은 기본 도메인이에요. 에이펙스(apex) 도메인이라고도 해요 | example.com |
| 서브도메인 | 도메인 앞에 붙이는 하위 이름이에요. 도메인 주인이 돈 안 내고 마음대로 만들 수 있고, 각각 다른 서버로 연결할 수도 있어요 | blog.example.comapi.example.comwww.example.com |
도메인은 건물 이름, 서브도메인은 그 건물 안 매장 이름이에요. “example 빌딩”을 빌렸다면 그 안에 “blog 매장”, “shop 매장”을 마음대로 낼 수 있어요. 우리가 자주 보는 www도 사실 서브도메인 중 하나예요.
DNS: 인터넷의 전화번호부
브라우저는 이름(도메인)만으로는 서버를 찾아갈 수 없어요. 꼭 숫자(IP)로 바꿔야 해요. 이 일을 하는 시스템이 DNS(Domain Name System)예요. 주소창에 도메인을 치면 대략 이런 순서로 찾아요.
- 내 컴퓨터가 기억하는지 확인최근에 가 본 곳이면 기억해 둔 IP를 바로 써요. 이렇게 잠깐 기억해 두는 걸 캐시라고 해요.
- 안내원에게 질문모르면 “안내원” 서버(리졸버)에 물어요. 보통 인터넷 통신사의 서버나 구글(8.8.8.8), 클라우드플레어(1.1.1.1) 같은 공개 서버예요.
- 안내원이 차례로 물어봄루트 서버에 물으면 “.com 담당은 저쪽이에요” → .com 담당 서버에 물으면 “example.com 담당은 저쪽이에요” → example.com의 네임서버에 도착해요.
- 네임서버가 정답을 알려 줌“blog.example.com은 203.0.113.10이에요.” 네임서버에 적혀 있는 이런 정답 한 줄 한 줄을 DNS 레코드라고 해요.
DNS 레코드 종류
개발자가 직접 DNS 레코드를 추가하거나 고치는 일이 많아요. 레코드 종류를 꼭 알아 두세요.
| 레코드 | 뜻 | 쉽게 말하면 | 값 예시 |
|---|---|---|---|
| A (Address) | 이름 → IPv4 주소 | “이 가게 주소는 여기예요” | 203.0.113.10 |
| AAAA (IPv6 Address) | 이름 → IPv6 주소 | A와 같은데 새 주소용이에요. IPv6가 IPv4보다 4배 길어서 A를 4개 붙였어요 | 2001:db8::10 |
| CNAME (Canonical Name) | 이름 → 다른 이름 (별명) | “그 가게는 저 가게랑 같은 곳이에요” | example.com |
| MX (Mail Exchange) | 이 도메인으로 오는 이메일을 받는 서버 | 우편함 위치 | mail.example.com |
| TXT (Text) | 글자로 된 메모 | “이 도메인 주인 맞아요”를 증명하거나, 메일 보안 설정에 써요 | "google-site-verification=..." |
| NS (Name Server) | 이 도메인을 담당하는 네임서버 | “우리 전화번호부는 이 회사가 관리해요” | ns1.dns-host.net |
실제 DNS 설정 화면은 이런 표예요
| 이름 (Host) | 종류 | 값 | TTL | 결과 |
|---|---|---|---|---|
@ | A | 203.0.113.10 | 3600 | example.com → 서버 1 |
www | CNAME | example.com | 3600 | www.example.com → example.com과 같은 곳 |
blog | A | 203.0.113.10 | 3600 | blog.example.com → 서버 1 (같은 서버!) |
shop | A | 203.0.113.20 | 3600 | shop.example.com → 서버 2 |
@는 루트 도메인 자기 자신을 뜻해요. TTL(Time To Live)은 “이 정답을 몇 초 동안 기억해도 되는지”예요. 3600초는 1시간이에요. 그래서 레코드를 바꿔도 다른 사람 컴퓨터에는 최대 1시간 동안 예전 답이 보일 수 있어요. “DNS 바꿨는데 왜 안 바뀌어요?”의 대부분이 이 이유예요.
blog와 example.com이 같은 IP를 가리키는 게 눈에 띄나요? 서버 한 대가 여러 사이트를 맡는 방법은 다음 장(vhost)에서 배워요.
루트 도메인(@)에는 원칙적으로 CNAME을 쓸 수 없어요. 루트에는 A 레코드를 쓰고, 별명은 www 같은 서브도메인에 쓰세요. 일부 DNS 업체는 이 제한을 피해 가는 자체 기능을 따로 제공하기도 해요.
nslookup blog.example.com
# 맥·리눅스에서는 dig도 많이 써요
dig blog.example.com A +shortnslookup은 name server lookup(네임서버에 물어보기), dig는 Domain Information Groper(도메인 정보 찾기 도구)의 줄임말이에요.
HTTP와 HTTPS
HTTP(HyperText Transfer Protocol)는 브라우저와 서버가 웹페이지를 주고받을 때 쓰는 대화 규칙이에요. HTTPS(HTTP Secure)는 여기에 암호화를 더한 거예요.
엽서
배달 중에 누구나 내용을 볼 수 있어요. 비밀번호를 보내면 위험해요. 요즘 브라우저는 “주의 요함”이라고 경고해요.
이 인증서를 흔히 SSL 인증서라고 불러요. SSL(Secure Sockets Layer)은 옛날 방식의 이름이고, 지금 실제로 쓰는 건 TLS(Transport Layer Security)예요. 둘 다 같은 걸 가리키는 말로 섞어 써요.
URL 뜯어보기
URL(Uniform Resource Locator)은 우리가 주소창에 치는 전체 주소예요. 지금까지 배운 것이 모두 들어 있어요.
- IP는 숫자 주소, 포트는 그 안의 문 번호, 도메인은 외우기 쉬운 이름이에요.
- DNS가 이름을 IP로 바꿔 줘요. A 레코드는 “이름 → IPv4”, CNAME은 “이름 → 다른 이름”이에요.
- DNS를 바꾸면 TTL만큼 기다려야 모두에게 반영돼요.
서버와 vhost컴퓨터 한 대가 사이트 여러 개를 맡는 방법
서버는 어떻게 생겼고, 손님이 오면 누가 맞이할까?
서버는 부탁(요청)을 받으면 답(응답)을 보내 주는 컴퓨터예요. 생김새가 특별하진 않아요. 다른 점은 24시간 켜져 있고, 공인 IP가 있다는 거예요.
서버는 대부분 리눅스(Ubuntu 등)라는 운영체제(OS: Operating System)를 써요. 화면 없이 터미널로만 다뤄요. 요즘은 직접 사기보다 AWS(Amazon Web Services), GCP(Google Cloud Platform), Azure 같은 클라우드에서 몇 분 만에 빌려 써요.
ssh ubuntu@203.0.113.10
# ubuntu = 서버의 사용자 이름, 203.0.113.10 = 서버 IP
# 접속하면 이제부터는 서버 컴퓨터에 명령하는 거예요. 나가려면 exitSSH(Secure Shell)는 다른 컴퓨터에 암호화된 통로로 접속하는 방법이에요. 앞으로 나올 명령어 앞의 sudo(superuser do)는 “관리자 권한으로 실행해”라는 뜻이에요.
웹서버 프로그램: 아파치와 엔진엑스
서버 컴퓨터에서 80번·443번 문을 지키며 손님을 맞는 프로그램을 웹서버라고 해요. 건물 1층의 안내 데스크예요. 파일을 직접 건네주기도 하고, 손님을 안쪽 앱에게 데려다주기도 해요. 가장 유명한 두 가지가 아파치와 엔진엑스예요.
| Apache (아파치) | Nginx (엔진엑스) | |
|---|---|---|
| 나이 | 1995년부터 쓰였어요. 오래돼서 자료가 많아요 | 2004년에 공개됐어요. 동시에 많은 손님을 받도록 설계됐어요 |
| 특징 | 폴더마다 .htaccess 파일로 설정을 바꿀 수 있어요. PHP와 잘 맞아요 | 가볍고 빨라요. 리버스 프록시로 아주 많이 써요 |
| 설정 파일 위치 (Ubuntu 기준) | /etc/apache2/sites-available/ | /etc/nginx/sites-available/ |
| 설정 다시 읽기 | sudo systemctl reload apache2 | sudo systemctl reload nginx |
vhost (가상 호스트)
05장의 DNS 표에서 example.com과 blog.example.com이 같은 IP를 가리켰어요. 그러면 서버는 손님이 어느 사이트를 원하는지 어떻게 알까요?
브라우저는 부탁을 보낼 때 Host: blog.example.com처럼 찾아온 이름을 함께 적어 보내요. 웹서버는 이 이름표를 보고 알맞은 사이트로 안내해요. 이렇게 서버 한 대에 여러 사이트를 나눠 담는 기능을 vhost(Virtual Host, 가상 호스트)라고 해요. 엔진엑스에서는 같은 기능을 server 블록이라고 불러요.
아파치 vhost 설정 예시 (정적 사이트)
<VirtualHost *:80>
# 이 이름으로 찾아온 손님을 맡아요
ServerName docs.example.com
# 손님에게 보여 줄 파일이 들어 있는 폴더
DocumentRoot /var/www/docs
# 오류 기록과 방문 기록을 남길 파일
ErrorLog ${APACHE_LOG_DIR}/docs_error.log
CustomLog ${APACHE_LOG_DIR}/docs_access.log combined
</VirtualHost>sudo a2ensite docs.conf # 이 사이트 설정을 켜요
sudo apache2ctl configtest # 설정에 오타가 없는지 검사. "Syntax OK"가 나와야 해요
sudo systemctl reload apache2 # 사이트를 끄지 않고 설정만 다시 읽어요리버스 프록시: 안쪽 방으로 안내하기
Node.js나 Python으로 만든 앱은 보통 localhost:3000 같은 안쪽 문에서 돌아요. 그런데 손님은 443번 정문으로만 들어와요. 그래서 안내 데스크(아파치나 엔진엑스)가 손님을 안쪽 방까지 대신 데려다줘야 해요. 이걸 리버스 프록시라고 해요.
이렇게 하면 HTTPS 암호화, 방문 기록, 나쁜 접속 차단 같은 일을 안내 데스크 한 곳에서 맡을 수 있어요. 앱은 요리에만 집중하면 돼요.
<VirtualHost *:80>
ServerName blog.example.com
# 손님이 적어 온 Host 이름을 앱에게도 그대로 전해요
ProxyPreserveHost On
# 모든 부탁을 안쪽 3000번 문의 앱으로 넘겨요
ProxyPass / http://127.0.0.1:3000/
ProxyPassReverse / http://127.0.0.1:3000/
</VirtualHost>아파치에서 이 기능을 쓰려면 처음 한 번 sudo a2enmod proxy proxy_http로 프록시 기능을 켜야 해요.
server {
listen 80;
server_name blog.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
}
}- 서버는 24시간 켜진 리눅스 컴퓨터예요. SSH로 접속해서 터미널로 다뤄요.
- 웹서버(아파치, 엔진엑스)는 안내 데스크예요. vhost로 Host 이름을 보고 사이트를 골라요.
- 앱이 안쪽 포트에서 돌면, 리버스 프록시로 정문(80/443)과 연결해요.
배포 방식웹 서비스를 서버에 올리기: 파일 복사부터 Docker, 자동 배포까지
내 컴퓨터에서 만든 걸 어떻게 서버로 옮기고, 계속 켜 둘까?
배포(deploy)는 내 컴퓨터에서 만든 코드를 서버에 올려서 사람들이 실제로 쓸 수 있게 하는 것이에요.
배포 전에는 보통 빌드를 해요. 빌드는 사람이 읽기 좋게 쓴 코드를 컴퓨터가 빨리 읽을 수 있게 바꾸고 압축하는 과정이에요. TypeScript를 JavaScript로 바꾸는 일도 여기서 해요. 결과물은 보통 dist/(distribution, 배포용)나 build/ 폴더에 생겨요.
배포 방법은 시간이 흐르며 발전해 왔고, 지금도 서비스마다 섞어서 써요. 쉬운 것부터 정리해 볼게요.
이 장은 서버에 올리는 웹 서비스의 배포를 다뤄요. 휴대폰 앱과 설치형 프로그램은 사용자 기기에 직접 깔리기 때문에 길이 달라요. 그건 08장에서 다뤄요.
| 방식 | 어떻게 하나 | 좋은 점 | 아쉬운 점 | 어울리는 곳 |
|---|---|---|---|---|
| ① 파일 올리기 SFTP + Apache | 빌드한 파일을 서버 폴더에 복사해요 | 가장 쉬워요 | 사람 손으로 해서 실수가 잦고 기록이 안 남아요 | 정적 사이트, 오래된 PHP 사이트 |
| ② 서버에서 git pull | SSH로 들어가 git pull 하고 다시 켜요 | Git 기록대로 올라가요 | 서버마다 설치 상태가 달라지기 쉬워요 | 작은 팀의 첫 서버 |
| ③ 프로세스 매니저 PM2 | ②에 더해 PM2가 앱을 계속 켜 둬요 | 꺼져도 자동으로 다시 켜져요 | 서버 환경이 제각각인 문제는 그대로예요 | Node.js 앱이 하나인 서버 |
| ④ Docker 컨테이너 | 앱과 실행 환경을 상자에 담아 그대로 실행해요 | 어디서나 똑같이 돌아가요 | 새로 배울 개념이 늘어요 | 요즘 대부분의 팀 |
| ⑤ CI/CD 자동 배포 | main에 합치면 로봇이 테스트·빌드·배포해요 | 사람이 실수할 틈이 없어요 | 처음 설정에 시간이 들어요 | 여럿이 자주 배포하는 팀 |
| ⑥ 배포 플랫폼 Vercel, Netlify 등 | GitHub 저장소만 연결하면 알아서 해 줘요 | 서버 관리가 거의 필요 없어요 | 세세한 조정이 어렵고, 커지면 비쌀 수 있어요 | 프론트엔드, 개인·작은 프로젝트 |
SFTP(SSH File Transfer Protocol)는 SSH 통로로 파일을 옮기는 방법이에요. 옛날에는 암호화가 없는 FTP(File Transfer Protocol)를 썼지만 지금은 안전하지 않아서 피해요.
① 아파치로 정적 사이트 배포
가장 기본이에요. 빌드해서 나온 파일을 06장의 DocumentRoot 폴더에 넣으면 끝이에요.
# 1) dist/ 폴더에 배포용 파일 만들기
npm run build
# 2) 서버의 /var/www/docs 폴더로 복사하기
rsync -avz --delete dist/ ubuntu@203.0.113.10:/var/www/docs/rsync는 바뀐 파일만 골라 보내는 복사 도구예요. --delete는 내 쪽에서 지운 파일을 서버에서도 지워서 두 폴더를 똑같이 맞춰요. 서버 폴더에 쓰기 권한이 있어야 해요.
언어마다 서버에서 사는 방식이 달라요
①처럼 파일만 올리면 되는 경우가 있고, 아래 ③④처럼 프로그램을 계속 켜 둬야 하는 경우가 있어요. 그 차이는 언어의 런타임(01장)이 프로그램을 어떻게 실행하느냐에서 와요.
| PHP | Node.js | Java | |
|---|---|---|---|
| 사는 방식 | 요청이 올 때마다 처음부터 실행하고, 끝나면 정리 | 프로그램 하나가 계속 켜져서 모든 요청을 받음 | 프로그램 하나가 계속 켜져서 모든 요청을 받음 |
| 식당으로 치면 | 주문마다 요리사가 출근해서 요리하고 퇴근 | 요리사가 하루 종일 주방에 상주 | 요리사가 상주. 대신 출근 전 교육(컴파일)이 필요 |
| 서버에 올릴 때 | Apache·Nginx 폴더에 파일을 올리면 바로 동작 | 꺼지지 않게 지키는 장치(PM2, Docker)가 필요 | java -jar app.jar로 켜고, 꺼지지 않게 지키는 장치가 필요 |
③ PM2: 앱이 꺼지지 않게 지키는 관리인
서버에서 node server.js로 앱을 켜면 두 가지 문제가 생겨요.
- SSH 접속 창을 닫으면 앱도 같이 꺼져요.
- 오류로 앱이 멈추면 아무도 다시 켜 주지 않아요. 새벽 3시에 꺼지면 아침까지 사이트가 죽어 있어요.
PM2(Process Manager 2)는 이 문제를 해결하는 프로세스 매니저예요. 실행 중인 프로그램 하나를 프로세스라고 하는데, PM2는 Node.js 앱 프로세스를 뒤에서 계속 켜 두고, 꺼지면 바로 다시 켜고, 서버를 재부팅해도 자동으로 켜 줘요.
npm install -g pm2 # 설치 (처음 한 번). -g는 컴퓨터 전체에 설치
pm2 start server.js --name blog # 앱 켜기 (이름은 blog)
pm2 list # 켜져 있는 앱 목록과 상태
pm2 logs blog # 앱이 남기는 기록(로그)을 실시간으로 보기
pm2 restart blog # 새 코드를 받은 뒤 다시 켜기
pm2 stop blog # 끄기
pm2 startup # 재부팅할 때 자동 시작 설정 (화면에 나온 명령을 한 번 더 실행)
pm2 save # 지금 켜져 있는 앱 목록을 기억실무에서는 설정을 파일로 남겨 둬요. 그러면 팀원 누구나 같은 방식으로 켤 수 있어요.
module.exports = {
apps: [{
name: "blog",
script: "server.js",
exec_mode: "cluster", // 같은 앱을 여러 개 띄우는 모드
instances: 2, // 2개를 띄워서 일을 나눠요
env: { NODE_ENV: "production", PORT: 3000 }
}]
};
// 실행: pm2 start ecosystem.config.jsPM2는 가게가 문 닫지 않게 밤새 지키는 야간 관리인이에요. 다른 언어에도 같은 역할을 하는 도구가 있어요. 리눅스에 기본으로 들어 있는 systemd가 대표적이고, Docker를 쓰면 Docker가 이 일을 대신하기도 해요.
④ Docker: 어디서나 똑같이 돌아가는 상자
개발자들이 가장 많이 하는 말 중 하나가 “제 컴퓨터에서는 되는데요?”예요. 내 컴퓨터는 Node 24인데 서버는 Node 18이거나, 서버에 필요한 프로그램이 빠져 있으면 생기는 문제예요.
Docker(도커)는 앱과, 그 앱이 돌아가는 데 필요한 모든 것(리눅스 기본 파일, 런타임, 부품, 설정)을 규격이 정해진 상자 하나에 담는 도구예요. 화물선 컨테이너는 안에 뭐가 들었든 같은 크레인으로 옮길 수 있잖아요. Docker 상자도 Docker가 설치된 컴퓨터라면 어디서든 똑같이 실행돼요.
레시피
상자를 어떻게 만들지 적은 글이에요. “Node 24를 깔고, 코드를 복사하고, 이 명령으로 켜라.”
붕어빵 틀
레시피대로 만든 완성품 틀이에요. 바뀌지 않고, Docker Hub 같은 보관소에 올려 나눠 쓸 수 있어요.
붕어빵
틀로 찍어 낸, 실제로 돌아가는 앱이에요. 틀 하나로 여러 개를 동시에 찍어 낼 수 있어요.
# 기본 재료: Node 24가 깔린 작은 리눅스
FROM node:24-alpine
# 상자 안에서 일할 폴더
WORKDIR /app
# 부품 목록을 먼저 복사하고, 목록대로 정확히 설치
COPY package*.json ./
RUN npm ci
# 나머지 코드 복사
COPY . .
# 상자 안의 앱이 3000번 문을 쓴다고 적어 둠
EXPOSE 3000
# 상자를 켜면 실행할 명령
CMD ["node", "server.js"]Dockerfile에서 설명(주석)은 #으로 시작하는 줄에만 쓸 수 있어요. 명령 뒤에 이어 쓰면 명령의 일부로 읽혀서 오류가 나요. 그리고 .dockerignore 파일에 node_modules와 .env를 적어 두면 COPY . .할 때 상자에 들어가지 않아요. .gitignore와 같은 원리예요.
# 이미지(틀) 만들기. -t는 이름표, 마지막 점은 "지금 폴더의 Dockerfile"
docker build -t blog:1.0 .
# 컨테이너(붕어빵) 실행
# -d: 뒤에서 실행 / -p 3000:3000: 서버의 3000번 문 → 상자 안 3000번 문
docker run -d --name blog -p 3000:3000 blog:1.0
docker ps # 실행 중인 컨테이너 목록
docker logs -f blog # 기록(로그) 보기
docker stop blog # 멈추기Docker Compose: 상자 여러 개를 한 번에
실제 서비스는 앱 하나로 끝나지 않아요. 앱, 데이터베이스, 캐시처럼 여러 상자가 함께 돌아야 할 때가 많아요. Docker Compose는 상자들의 관계를 파일 하나에 적어 두고, 명령 한 줄로 전부 켜 줘요.
services:
web: # 상자 1: 블로그 앱
build: .
ports:
- "127.0.0.1:3000:3000" # 서버 안쪽에서만 열기 (정문은 아파치가 맡음)
env_file: .env # 비밀 설정은 .env 파일에서 읽어요
depends_on:
- db # db 상자를 먼저 켜요
restart: always # 꺼지면 다시 켜요 (PM2가 하던 일)
db: # 상자 2: 데이터베이스
image: postgres:17
env_file: .env
volumes:
- dbdata:/var/lib/postgresql/data # 상자를 지워도 데이터는 남게
volumes:
dbdata:docker compose up -d # 전부 켜기
docker compose logs -f # 전부의 기록 보기
docker compose down # 전부 끄기 (볼륨의 데이터는 남아요)- 컨테이너를 지우면 그 안의 파일도 사라져요. 지켜야 할 데이터(데이터베이스, 사용자가 올린 사진)는 꼭 볼륨에 저장해요.
- 비밀번호를
compose.yaml에 직접 적고 Git에 올리면 안 돼요. 위 예시처럼.env로 빼 두세요. - 앱 포트를
"3000:3000"으로만 적으면 서버 바깥에서도 3000번으로 바로 들어올 수 있어요. 리버스 프록시를 쓸 땐127.0.0.1:을 앞에 붙여 안쪽에서만 열어요.
가상 머신(VM: Virtual Machine)은 컴퓨터 안에 컴퓨터 한 대를 통째로 하나 더 만드는 거라 무거워요. 컨테이너는 바탕 운영체제의 핵심(커널)은 함께 쓰고, 앱에 필요한 부분만 따로 담아요. 그래서 훨씬 가볍고 몇 초 만에 켜져요.
⑤ CI/CD: 배포를 로봇에게 맡기기
CI/CD는 두 가지를 합친 말이에요.
- CI(Continuous Integration, 지속적 통합): 코드가 올라올 때마다 자동으로 테스트하고 빌드해요. 고장 난 코드가 main에 섞이는 걸 막아요.
- CD(Continuous Delivery · Deployment, 지속적 배포): 테스트를 통과하면 자동으로 서버에 올려요.
사람이 매번 같은 명령을 치다가 실수하는 일을 없애 줘요. GitHub에서는 GitHub Actions가 대표적이에요.
name: deploy
on:
push:
branches: [main] # main에 합쳐질 때마다 실행해요
jobs:
deploy:
runs-on: ubuntu-latest # GitHub이 잠깐 빌려주는 컴퓨터에서
steps:
- uses: actions/checkout@v5 # 코드 받기
- uses: actions/setup-node@v5 # Node.js 준비
with:
node-version: 24
- run: npm ci
- run: npm test # 테스트가 실패하면 여기서 멈춰요 = 배포 안 됨
- run: npm run build
# 그다음: 서버로 보내거나 Docker 이미지를 올려요 (팀마다 달라요)배포할 때 함께 쓰는 말
| 용어 | 뜻 |
|---|---|
| 롤백 | 새 버전에 문제가 생기면 바로 이전 버전으로 되돌리는 거예요. 배포 방법보다 롤백 방법을 먼저 알아 두세요 |
| 무중단 배포 | 새 버전을 옆에 먼저 켜 두고, 준비되면 손님을 넘겨서 사이트가 한순간도 꺼지지 않게 하는 방식이에요 |
| 로그 | 프로그램이 남기는 일기예요. 문제가 생기면 가장 먼저 봐요 (pm2 logs, docker logs) |
| 모니터링 | 서버가 살아 있는지, 느려지지 않았는지 계속 지켜보고, 이상하면 알림을 보내는 거예요 |
어떤 방식을 고를까?
| 만들려는 것 | 추천 출발점 |
|---|---|
| 회사 소개, 설명서 같은 정적 사이트 | 배포 플랫폼(⑥) 또는 아파치·엔진엑스에 파일 올리기(①) |
| Node.js 앱 하나, 서버 한 대 | 리버스 프록시 + PM2(③) |
| 앱 + 데이터베이스, 팀원 여럿 | Docker Compose(④) + CI/CD(⑤) |
| 팀이나 프로젝트에 이미 정해진 방식이 있다면 | 무조건 그 방식부터 익혀요. 더 나은 방법 제안은 익숙해진 다음에 해요 |
오늘 저녁에 배포 나가요.
오늘 저녁에 새 버전을 서버에 올려요.
핫픽스 쳐서 바로 반영할게요. 안 되면 롤백 칠게요.
급한 버그만 빨리 고쳐서 바로 배포할게요. 문제가 생기면 이전 버전으로 되돌릴게요.
- 배포 = 빌드한 결과물을 서버에 올리고 계속 켜 두는 것이에요.
- PM2는 앱을 꺼지지 않게 지키고, Docker는 앱을 어디서나 똑같이 돌게 상자에 담아요.
- CI/CD는 테스트·빌드·배포를 자동으로 해 줘요. 문제가 생기면 롤백부터 해요.
앱·프로그램 출시스토어 심사, 설치 파일, 업데이트까지
웹이 아니라 앱이나 설치형 프로그램이라면, 어떻게 사람들 손에 들어갈까?
웹은 서버 한 곳만 바꾸면 모두가 새 버전을 봐요. 하지만 앱과 설치형 프로그램은 사용자 기기 하나하나에 복사본이 깔려요. 그래서 내놓기 전에 확인할 것이 더 많고, 한번 내놓으면 되돌리기도 어려워요. 그래서 이 과정을 보통 “출시” 또는 “릴리스”(release)라고 따로 불러요.
출시 전에 공통으로 챙길 것
| 챙길 것 | 무슨 뜻 |
|---|---|
| 버전 번호 | 1.4.2처럼 점으로 나눈 번호예요. 보통 유의적 버전 규칙을 따라서, 크게 바뀌면 앞자리, 기능이 늘면 가운데, 버그만 고치면 끝자리를 올려요. 스토어에는 이와 따로, 올릴 때마다 커지는 빌드 번호도 넣어요 |
| 출시용 빌드 | 개발 중에 쓰던 디버그 빌드가 아니라, 빠르고 작게 다듬은 릴리스 빌드를 만들어요 |
| 코드 서명 | “이 프로그램은 내가 만들었고, 중간에 누가 바꾸지 않았다”는 디지털 도장이에요(코드 서명). 서명이 없으면 스토어가 받아 주지 않거나 OS가 경고를 띄워요 |
| 소개 자료 | 아이콘, 스크린샷, 설명, 개인정보처리방침 주소, 연령 등급 같은 정보를 준비해요 |
| 먼저 써 보기 | 정식 출시 전에 일부 사람에게만 먼저 나눠 주고 확인받아요(베타 테스트) |
서명에 쓰는 키와 인증서 파일은 .env처럼 Git에 올리지 말고 안전한 곳에 따로 보관해요. 잃어버리면 같은 앱의 업데이트를 올리기가 아주 번거로워지거나 아예 막힐 수 있어요. 스토어가 키를 대신 보관해 주는 기능(Google Play 앱 서명 등)이 있으면 켜 두세요.
휴대폰 앱: 스토어에 올리기
iPhone 앱은 Apple의 App Store에, Android 앱은 Google Play에 올리는 게 기본이에요. 순서는 두 스토어가 거의 같아요.
- 개발자 계정 만들기Apple Developer Program은 1년에 99달러, Google Play 개발자 계정은 처음 한 번 25달러예요(2026년 11월 기준). 회사 이름으로 올리려면 사업자 확인 서류가 더 필요해요.
- 출시용 빌드를 만들고 서명하기iOS는 Xcode에서 서명한 빌드를 App Store Connect에 올려요. Android는 서명한 앱 번들(
.aab) 파일을 Play Console에 올려요. - 먼저 몇 명에게만 나눠 주기iOS는 TestFlight, Android는 내부·비공개 테스트 트랙으로 팀원과 테스터에게 먼저 설치하게 해요. Google Play에 개인 계정을 새로 만들었다면, 정식 출시 전에 테스터 12명 이상과 14일 동안 비공개 테스트를 해야 해요.
- 스토어 정보 채우기스크린샷, 설명, 개인정보처리방침 주소를 넣고, 앱이 어떤 개인정보를 모으는지 적어요(App Store의 개인정보 보호 라벨, Google Play의 데이터 보안 섹션).
- 심사 받기스토어의 사람과 자동 검사가 규칙을 지켰는지 확인해요(앱 심사). 보통 하루에서 며칠 걸리고, 처음 내는 앱은 더 오래 걸리기도 해요.
- 출시하기통과하면 바로 내놓거나 날짜를 정해 내놓아요. 사용자 일부에게만 먼저 업데이트를 퍼뜨리는 단계적 출시도 할 수 있어요.
- 실행하자마자 멈추거나(크래시), 눌러도 반응이 없는 버튼이 있어요.
- 로그인이 필요한 앱인데 심사용 테스트 계정을 주지 않았어요.
- 개인정보처리방침이 없거나, 실제로 모으는 정보와 적은 내용이 달라요.
- 회원 가입은 되는데 앱 안에서 탈퇴(계정 삭제)를 할 수 없어요.
- 앱 안에서 구독이나 게임 아이템 같은 디지털 상품을 팔면서 스토어의 결제 규칙을 따르지 않았어요(나라마다 예외가 있어요).
웹은 문제가 생기면 이전 버전으로 롤백하면 돼요. 앱은 이미 사용자 휴대폰에 깔린 버전을 내가 지울 수 없어요. 고친 버전은 다시 심사를 받아야 하고, 업데이트하지 않는 사람도 많아요. 그래서 팀들은 이렇게 대비해요.
- 서버의 API를 바꿀 때는 옛 버전 앱도 계속 동작하게 해요.
- 꼭 필요할 때 “새 버전으로 업데이트해 주세요” 화면을 띄울 수 있게 미리 만들어 둬요(강제 업데이트).
- 새 기능은 서버 설정으로 켜고 끌 수 있게 만들어서, 문제가 생기면 앱을 다시 내지 않고 꺼요.
- React Native처럼 JavaScript로 만든 앱은 일부 코드를 심사 없이 바꾸는 방법(OTA 업데이트)도 있어요. 다만 앱의 주요 기능을 바꾸면 안 된다는 스토어 규칙을 지켜야 해요.
설치형 프로그램: 설치 파일로 나눠 주기
컴퓨터용 프로그램은 스토어 없이도 내놓을 수 있어요. 홈페이지에 설치 파일을 올려 두고 내려받게 하는 방식이 가장 흔해요. OS마다 설치 파일 형식과 주의할 점이 달라요.
| OS | 설치 파일 | 스토어 · 패키지 관리자 | 주의할 점 |
|---|---|---|---|
| Windows | .exe 설치 프로그램, .msi, .msix | Microsoft Store, winget | 서명이 없으면 “Windows의 PC 보호” 경고가 떠서 사용자가 불안해해요. 코드 서명 인증서로 서명해요 |
| macOS | .dmg (끌어다 놓는 디스크 이미지), .pkg | Mac App Store, Homebrew | 서명과 공증이 없으면 기본 설정에서 바로 열리지 않아요. Apple 개발자 인증서로 서명하고 Apple에 공증을 받아요 |
| Linux | .deb, .rpm, AppImage | Flathub (Flatpak), Snap Store | 배포판마다 형식이 달라서 여러 개를 만들거나, 어디서나 도는 AppImage·Flatpak을 써요 |
설치형 프로그램에는 자동 업데이트 기능을 넣어 두는 게 중요해요. 프로그램이 켜질 때 새 버전이 있는지 서버에 물어보고, 있으면 내려받아 바꿔 끼우는 기능이에요. 이게 없으면 사용자는 처음 받은 버전을 몇 년이고 그대로 쓰기도 해요. Electron은 electron-updater, macOS 앱은 Sparkle 같은 도구를 많이 써요.
웹 서비스는 가게에서 먹는 손님이에요. 주방(서버)이 요리를 바꾸면 다음 손님부터 바로 새 요리를 먹어요. 앱과 설치형 프로그램은 밀키트 판매예요. 마트(스토어)에 들어가려면 검사를 통과해야 하고, 이미 팔린 밀키트는 다시 고칠 수 없어요. 레시피가 바뀌면 새 밀키트를 만들어 다시 납품해야 해요.
개발자를 위한 도구라면: 패키지 저장소에 올리기
다른 개발자가 가져다 쓰는 라이브러리나 명령어 도구라면, 언어별 패키지 저장소에 올려요. JavaScript는 npm(npm publish), Python은 PyPI, macOS 명령어 도구는 Homebrew에 올리는 식이에요. 영어의 publish가 “공개한다”는 뜻으로 쓰이는 대표적인 예예요. 02장의 퍼블리싱과는 다른 뜻이에요.
출시한 뒤에 하는 일
| 할 일 | 무슨 뜻 | 대표 도구 |
|---|---|---|
| 오류 모으기 | 사용자 기기에서 앱이 멈추면 어디서 멈췄는지 자동으로 모아요(크래시 리포트). 사용자 휴대폰의 로그는 내가 직접 볼 수 없어서 꼭 필요해요 | Firebase Crashlytics, Sentry |
| 버전별 사용자 보기 | 아직 옛 버전을 쓰는 사람이 얼마나 되는지 보고, 옛 API를 언제 끌지 정해요 | App Store Connect, Play Console |
| 리뷰 답하기 | 스토어 별점과 리뷰에 답하고, 자주 나오는 불만을 다음 버전에 반영해요 | 스토어 관리 화면 |
| 출시 자동화 | 빌드, 서명, 업로드를 로봇에게 맡겨요. 07장의 CI/CD와 같은 생각이에요 | fastlane, Xcode Cloud, EAS Build, GitHub Actions |
심사 리젝 먹어서 수정해서 다시 올렸어요.
앱 심사에서 거절(reject)당해서, 고친 다음 다시 냈어요.
이번 버전은 10%만 먼저 풀어 볼게요.
단계적 출시로 사용자 10%에게만 먼저 업데이트를 내보낼게요.
- 앱과 설치형 프로그램은 사용자 기기마다 복사본이 깔려서, 웹보다 되돌리기가 어려워요.
- 출시 전에 버전 번호, 코드 서명, 베타 테스트를 챙기고, 스토어 앱은 심사를 통과해야 해요.
- 내놓은 뒤에는 크래시 리포트와 업데이트 방법(강제 업데이트, 자동 업데이트)으로 지켜봐요.
실전: 서버에 직접 배포하기다 만든 블로그 앱을 blog.example.com에 손으로 올려 보기
지금까지 배운 걸 한 번에 엮어 봐요. 상황은 이래요. Node.js로 만든 블로그 앱이 있고, 이미 example.com이 돌아가는 서버(203.0.113.10)에 서브도메인으로 추가하려고 해요. 방식은 ③(아파치 리버스 프록시 + PM2)을 써요. 각 단계 옆에 관련된 장을 적어 뒀어요.
- 로컬에서 만들고 합치기 03 · 04장브랜치에서 작업 → PR → 리뷰 → main에 합치기.
- 서버에 접속하기 06장내 컴퓨터
ssh ubuntu@203.0.113.10 - 코드 받고 설치·빌드하기 04 · 07장서버
cd /srv git clone https://github.com/my-company/blog.git cd blog npm ci # package-lock.json대로 정확히 설치 npm run build nano .env # 운영용 비밀 설정 입력 (nano는 터미널용 메모장) - PM2로 앱 켜기 07장서버
pm2 start ecosystem.config.js pm2 save curl http://127.0.0.1:3000 # 서버 안에서 앱이 답하는지 확인curl(Client URL)은 터미널에서 주소를 열어 보는 도구예요. 글자로 된 HTML이 나오면 앱이 살아 있는 거예요. - DNS에 A 레코드 추가하기 05장도메인 관리 화면에서 이름
blog, 종류A, 값203.0.113.10을 추가해요. 잠시 뒤nslookup blog.example.com으로 IP가 나오는지 확인해요. - 아파치 vhost와 리버스 프록시 설정하기 06장서버
sudo nano /etc/apache2/sites-available/blog.conf # 06장의 리버스 프록시 설정 붙여 넣기 sudo a2enmod proxy proxy_http sudo a2ensite blog.conf sudo apache2ctl configtest sudo systemctl reload apache2 - HTTPS 인증서 붙이기 05장서버
sudo apt install certbot python3-certbot-apache sudo certbot --apache -d blog.example.com # 무료 Let's Encrypt 인증서를 받고, 443번용 vhost 설정도 자동으로 만들어 줘요 # 인증서는 90일마다 만료되지만 certbot이 자동으로 연장해요apt(Advanced Package Tool)는 Ubuntu의 패키지 관리자예요. 5단계의 DNS가 먼저 연결돼 있어야 인증서를 받을 수 있어요. - 확인하기브라우저에서
https://blog.example.com을 열어 자물쇠 표시와 화면을 확인해요. 안 되면pm2 logs blog와 아파치 오류 기록을 봐요. - 다음 배포부터는서버에서
git pull→npm ci→npm run build→pm2 restart blog만 하면 돼요. 이 반복 작업을 GitHub Actions로 자동화하면 ⑤ CI/CD가 돼요.
3~4단계가 docker compose up -d --build 한 줄로 바뀌어요. 5~7단계(DNS, vhost, HTTPS)는 똑같아요. 앱을 어떤 방식으로 켜든, 손님이 찾아오는 길(도메인 → DNS → IP → 웹서버 → 앱)은 같다는 걸 기억하세요.
- 코드는 로컬에서 만들고, Git으로 기록·공유하고, 배포로 서버에 올려요.
- 손님은 도메인 → DNS → IP·포트 → 웹서버(vhost) → 앱 → 데이터베이스 순서로 찾아와요.
- 문제가 생기면 이 길을 앞에서부터 하나씩 확인하세요. DNS가 맞나? 서버에 닿나? 웹서버 설정이 맞나? 앱이 켜져 있나? 이게 실무의 문제 해결 순서예요.
실전: AI와 함께 개발하기새로 만들기, 고치고 가꾸기, 그리고 AI에게 잘 설명하기
AI를 어떤 순서로, 얼마만큼의 정보를 줘서 써야 싸고 확실하게 일을 끝낼 수 있을까?
개발자의 일은 크게 두 가지예요. 없던 것을 새로 만드는 일과, 이미 있는 것을 고치고 가꾸는 일이에요. 실제로는 두 번째가 훨씬 많아요. 둘 다 AI가 도와줄 수 있지만 쓰는 방법이 달라요. 그리고 두 경우 모두, 결과는 AI에게 무엇을 얼마나 알려 주느냐에 따라 크게 달라져요.
이 장에서는 AI에게 주는 지시문을 프롬프트라고 불러요. 복사 버튼으로 그대로 가져다 쓸 수 있어요.
09장에서는 사람이 모든 명령을 직접 쳤어요. 요즘은 이 과정의 상당 부분을 AI가 도와줘요. 다만 AI를 “아무거나, 아무렇게나” 쓰면 돈과 시간이 오히려 더 들어요. 이 장의 원칙은 하나예요. 무료로 할 수 있는 건 끝까지 무료로 하고, 돈은 일이 가장 많은 곳 한 곳에만 써요.
먼저, 챗봇과 에이전트는 달라요
둘 다 속에는 LLM(Large Language Model, 거대 언어 모델)이라는 같은 종류의 AI가 들어 있어요. 차이는 손발이 있느냐예요.
똑똑한 상담사
대화로 질문에 답하고 글을 써 줘요. 코드를 알려 줘도, 그걸 파일에 넣고 실행하는 건 내가 해요. 예: Claude, ChatGPT, Gemini의 채팅 화면
손발이 있는 조수
내 프로젝트 폴더의 파일을 직접 읽고, 고치고, 터미널 명령을 실행하고, 결과를 보고 다시 고쳐요. 목표를 주면 여러 단계를 스스로 이어서 해요. 예: Claude Code, Codex, Cursor, GitHub Copilot
챗봇은 전화로 요리법을 알려 주는 친구예요. 에이전트는 우리 집 부엌에 들어와서 직접 요리하는 친구예요. 부엌에 들어오게 하는 만큼, 무엇을 만지게 할지는 내가 정하고 지켜봐야 해요.
Part A
새로 만들기: 아이디어에서 배포까지
예시 아이디어는 “회의실 예약 사이트”예요. 지금까지 배운 언어, Git, 도메인, 배포가 모두 필요한 크기예요.
전체 지도: 6단계, 돈은 4단계에서만
| 단계 | 목표 | 추천 도구 | 비용 | 결과물 |
|---|---|---|---|---|
| 1. 아이디어 다듬기 | 대화로 “무엇을, 누구를 위해, 왜”를 분명하게 | 글 잘 쓰는 챗봇 하나 (아래 표) | 무료 | 한 장짜리 기획서 |
| 2. 교차 검토 | 다른 회사 AI에게 약점과 빠진 것 찾기 | 1단계와 다른 회사 챗봇 | 무료 | 고친 기획서 |
| 3. 화면 틀 잡기 | 눌러 볼 수 있는 시안으로 방향 확정 | 화면 생성 도구의 무료 사용량 | 무료 | 프로토타입, 기술 스택 결정 |
| 4. 본격 구현 | 진짜 코드를 Git 저장소에 쌓기 | 코딩 에이전트 하나만 유료 | 월 약 10~20달러 | 동작하는 앱 |
| 5. 완성도 높이기 | 테스트, 리뷰, 보안 점검 | 4단계 에이전트 + 다른 회사 챗봇(무료) | 4단계에 포함 | 믿을 수 있는 앱 |
| 6. 배포와 운영 | 07~10장 방식으로 올리고 지켜보기 | 4단계 에이전트 | 서버비 별도 | 실제 서비스 |
- 1~3단계는 생각을 정리하는 일이라 무료 챗봇으로 충분해요. 여기서 방향을 확실히 정해 두면, 돈이 드는 4단계에서 헤매지 않아요.
- 4단계는 작업량이 많아서 무료 사용량으로는 금방 막혀요. 여기에만 한 달 구독 하나를 써요. 끝나면 해지해도 돼요.
- 검토는 항상 다른 회사 AI로 해요. 같은 AI는 자기가 만든 실수를 잘 못 찾아요. 사람도 자기 글의 오타는 잘 안 보이는 것과 같아요.
도구 고르기 (2026년 11월 기준)
AI 도구는 몇 달마다 순위와 가격이 바뀌어요. 아래 표는 2026년 11월에 여러 비교 글을 모아 정리한 것이니, 쓰기 전에 각 회사의 가격 페이지를 꼭 다시 확인하세요.
대화와 글쓰기용 챗봇 (1·2단계)
| 챗봇 | 잘하는 것 | 무료 버전의 특징 | 이럴 때 쓰세요 |
|---|---|---|---|
| Claude Anthropic | 여러 비교 글에서 자연스러운 글과 복잡한 지시 따르기를 가장 높게 평가받아요 | 무료에서도 중간 등급 모델을 쓸 수 있다는 평이 많아요. 대신 사용량 제한이 빨리 와요 | 아이디어 인터뷰, 기획서 쓰기 |
| ChatGPT OpenAI | 폭넓은 기능, 많은 사용량, 검색 | 무료에서도 대화를 많이 할 수 있어요. 미국 등 일부 지역은 무료 버전에 광고가 붙어요 | 교차 검토, 비슷한 서비스 조사 |
| Gemini | 구글 검색·문서·드라이브와 연결 | 무료 앱은 가벼운 모델로 자동 연결되는 경우가 많아 긴 글 품질은 다소 낮다는 평이에요 | 구글 문서로 일하는 팀, 사실 확인 |
이 교과서도 AI(Claude)가 함께 썼어요. 그래서 위 비교는 AI 스스로의 판단이 아니라 바깥 비교 글들을 근거로 적었어요.
화면 틀 잡기 도구 (3단계)
| 도구 | 특징 | 무료로 할 수 있는 것 |
|---|---|---|
| Bolt | 말로 설명하면 앱 전체를 만들어 브라우저에서 바로 실행해 줘요 | 무료 사용량이 넉넉한 편이라는 평이 많아요 |
| Lovable | 로그인, 데이터 저장까지 있는 앱을 만들고 GitHub로 내보내기 쉬워요 | 하루 몇 번씩 쓸 수 있는 크레딧 |
| v0 Vercel | React 화면 시안에 강해요 | 적은 양의 무료 크레딧 (조건이 자주 바뀌어요) |
| 챗봇의 미리보기 기능 | Claude의 아티팩트, ChatGPT의 캔버스처럼 대화창에서 화면을 바로 그려 줘요 | 챗봇 무료 사용량 안에서 |
무료 플랜으로 만든 결과는 보통 그 회사 주소(xxx.lovable.app 등)에 올라가고, 내 도메인을 붙일 수 없어요. 3단계 결과물은 보고 결정하는 용도로만 쓰고, 버려도 아깝지 않다고 생각하세요. 진짜 코드는 4단계에서 내 Git 저장소에 쌓아요.
코딩 에이전트 (4~6단계, 하나만 고르기)
| 에이전트 | 어떻게 쓰나 | 대략적인 비용 | 이런 사람에게 |
|---|---|---|---|
| GitHub Copilot | VS Code 안에서 자동 완성과 에이전트 모드 | 무료 플랜 있음, 유료는 월 약 10달러부터 | 가장 싸게 시작하고 싶을 때 |
| Claude Code | 터미널이나 데스크톱 앱에서 프로젝트 전체를 다뤄요 | Claude 유료 구독(월 약 20달러)부터. 무료 플랜에는 없어요 | 큰 작업을 맡기고 꼼꼼한 결과를 원할 때 |
| Codex OpenAI | 터미널, 에디터, 웹에서 작업 | ChatGPT 플랜에 묶여 있어요. 무료에선 아주 적게, 유료(월 약 20달러)에서 넉넉하게 | 이미 ChatGPT를 구독 중일 때 |
| Cursor | AI가 들어간 코드 에디터 | 무료 체험 + 유료 플랜 (요금제가 자주 바뀌어요) | 에디터 화면에서 보면서 고치고 싶을 때 |
- 0원 코스: 1~3단계 무료 챗봇 → 4단계 GitHub Copilot 무료 플랜. 작은 프로젝트라면 가능하지만 자주 사용량 제한에 걸려요.
- 추천 코스(월 약 20달러 × 1~2달): 1~3단계 무료 → 4~6단계는 Claude Code, Codex, Cursor 중 하나만 한 달 구독. 이미 쓰는 챗봇 회사의 것을 고르면 따로 결제할 필요가 없어요.
- 유료 구독을 두 개 이상 동시에 하지 마세요. 검토는 다른 회사의 무료 챗봇으로 충분해요.
1단계: 대화로 아이디어 다듬기 (무료)
가장 흔한 실수는 AI에게 처음부터 “회의실 예약 사이트 만들어 줘”라고 하는 거예요. 그러면 AI가 빈칸을 마음대로 채워서, 내가 원하지 않은 걸 만들어요. 대신 AI가 나에게 질문하게 하세요. 좋은 기획자와 회의하는 것처럼요.
너는 경험 많은 서비스 기획자야. 나는 아래 아이디어를 웹사이트로 만들고 싶어.
아이디어: 공유 회의실을 웹에서 예약하는 사이트
바로 해결책을 말하지 말고, 이 아이디어를 구체화하는 데 필요한 질문을
한 번에 하나씩만 해 줘. 내가 답하면 그다음 질문을 해.
꼭 물어볼 것: 누가 쓰는지, 지금은 어떻게 하는지와 불편한 점,
꼭 있어야 하는 기능과 나중에 해도 되는 기능, 성공의 기준.
질문이 충분히 쌓였다고 판단되면 "정리할까요?"라고 물어봐 줘.10~15개쯤 질문에 답하고 나면, 이제 정리를 시켜요. 이 정리본을 PRD(Product Requirements Document, 제품 요구사항 문서)라고 해요. 02장의 기획자가 만드는 바로 그 문서예요.
지금까지 대화를 한 장짜리 기획서로 정리해 줘. 형식은 아래와 같이.
1. 한 줄 설명
2. 사용자와 그들이 겪는 문제
3. 꼭 필요한 기능 (최대 5개, 각각 "사용자는 ~할 수 있다" 문장으로)
4. 이번에는 하지 않을 것
5. 화면 목록 (화면 이름과 그 화면에서 하는 일)
6. 저장해야 할 데이터 (예: 회의실, 예약, 사용자)
7. 성공 기준 (숫자로 확인할 수 있게)
모르는 부분은 지어내지 말고 "확인 필요"라고 적어 줘.- 대화가 길어지면 AI가 앞부분을 잘 기억하지 못하고 사용량도 빨리 닳아요. AI가 한 번에 기억할 수 있는 양을 컨텍스트라고 해요.
- 정리본(PRD)이 나오면 복사해서 메모장에 저장하고, 다음 작업은 새 대화에 정리본만 붙여 넣고 시작하세요. 이게 가장 싸고 정확한 방법이에요.
2단계: 다른 AI로 교차 검토 (무료)
1단계와 다른 회사의 챗봇을 열고 PRD를 붙여 넣어요. 칭찬 말고 비판을 시키는 게 핵심이에요.
아래는 내가 만들려는 웹사이트 기획서야. 칭찬은 빼고 검토만 해 줘.
1. 빠진 기능이나 생각 못 한 상황 (예: 두 사람이 동시에 같은 시간을 예약하면?)
2. 너무 커서 첫 버전에서는 빼는 게 좋은 기능
3. 비슷한 기존 서비스가 있다면 무엇이고, 우리 것과 무엇이 다른지
(검색해서 확인한 것만, 출처와 함께)
4. 이 기획서만 보고 개발자가 되물어볼 만한 질문 5개
[여기에 기획서 붙여 넣기]받은 의견 중 맞는 것만 골라 PRD를 고쳐요. 모든 의견을 다 받아들일 필요는 없어요. 무엇을 만들지는 내가 정해요.
3단계: 눌러 볼 수 있는 틀 만들기 (무료)
글로만 된 기획서는 사람마다 다르게 상상해요. 화면 생성 도구(Bolt, Lovable, v0)나 챗봇의 미리보기 기능에 PRD의 “화면 목록”을 주고 시안을 만들게 해요.
아래 기획서의 "화면 목록"대로 눌러 볼 수 있는 프로토타입을 만들어 줘.
- 진짜 서버나 데이터베이스는 필요 없고, 예시 데이터로 채워 줘
- 휴대폰 화면에서도 보기 좋게
- 화면 사이를 오가는 흐름이 실제처럼 동작하게
[기획서 붙여 넣기]시안을 직접 눌러 보고, 동료 한두 명에게도 보여 주세요. 이 단계에서 바꾸는 건 거의 공짜지만, 4단계에서 바꾸면 시간과 돈이 들어요.
마지막으로 기술 스택을 정해요(01장). 팀이나 프로젝트에 정해진 게 있으면 그걸 따르고, 없으면 AI에게 “이 기획서에 맞고, 처음 다루는 사람도 유지보수하기 쉬운 기술 스택을 이유와 함께 2개만 비교해 줘”라고 물어보세요. 예: Next.js + PostgreSQL.
4단계: 코딩 에이전트로 본격 구현 (유료 하나)
이제 진짜 코드를 만들어요. 03·04장에서 배운 것이 여기서 그대로 쓰여요. 에이전트는 내 컴퓨터의 Git 저장소 안에서 일하게 해요.
- 빈 저장소 만들고 PRD 넣기프로젝트 폴더에
docs/PRD.md로 기획서를 저장하고 첫 커밋을 해요. 에이전트가 언제든 읽을 수 있는 “설계도”가 돼요.터미널mkdir room-booking && cd room-booking git init mkdir docs # 여기에 PRD.md 저장 git add . && git commit -m "docs: 기획서 추가" - 프로젝트 규칙 파일 만들기에이전트가 매번 읽는 “우리 팀 규칙”이에요. 도구마다 이름이 달라요. Claude Code는
CLAUDE.md, Codex 등 여러 도구는AGENTS.md, Copilot은.github/copilot-instructions.md를 읽어요.AGENTS.md (또는 CLAUDE.md)# 회의실 예약 사이트 - 기획서: docs/PRD.md 를 먼저 읽을 것 - 기술 스택: Next.js, TypeScript, PostgreSQL - 실행: npm run dev / 테스트: npm test - 규칙 - 한 번에 기능 하나만 만든다 - 기능마다 테스트를 함께 만든다 - 비밀번호, API 키는 코드에 쓰지 말고 .env 로 - 모르는 것은 추측하지 말고 나에게 묻는다 - 계획부터 세우게 하기바로 코드를 쓰게 하지 말고, 작업 순서를 먼저 받아서 내가 확인해요. 많은 에이전트에 “계획 모드”가 따로 있어요.프롬프트 ⑤ — 에이전트에게 첫 지시
docs/PRD.md 를 읽고, 이 사이트를 만드는 작업을 30분~1시간짜리 작은 단계 8~12개로 나눈 계획을 docs/PLAN.md 에 써 줘. 각 단계에는 "끝났는지 확인하는 방법"을 적어 줘. 아직 코드는 쓰지 마. - 한 단계씩 맡기고, 단계마다 커밋하기“PLAN.md의 1단계를 해 줘. 끝나면 테스트를 돌리고 결과를 알려 줘.” → 결과를 내 눈으로 확인 →
git commit→ 다음 단계. 커밋이 세이브 포인트라서, AI가 망쳐도 바로 전 단계로 돌아갈 수 있어요(04장). - 막히면 상황을 정확히 주기“안 돼요” 대신 오류 메시지 전체, 내가 한 행동, 기대한 결과를 함께 줘요. 브라우저 개발자 도구(F12)의 오류나 터미널 출력을 그대로 붙여 넣으면 가장 빨라요.
- 작게 자르기: “사이트 다 만들어 줘”보다 “예약 목록 화면만 만들어 줘”가 훨씬 정확하고 사용량도 덜 들어요.
- 새 작업은 새 대화로: 한 단계가 끝나면 대화를 새로 시작해요. 필요한 정보는 PRD, PLAN, 규칙 파일에 있으니까요.
- 확인은 내가: AI가 “다 됐어요”라고 해도 직접 실행해서 눌러 보기 전까지는 끝난 게 아니에요.
5단계: 완성도 높이기
돌아가는 것과 믿을 수 있는 것은 달라요. 아래 네 가지를 순서대로 해요.
| 점검 | 누가 | 어떻게 |
|---|---|---|
| 테스트 | 에이전트 | “PRD의 기능마다 테스트가 있는지 확인하고, 없는 건 만들어 줘. 두 사람이 같은 시간을 동시에 예약하는 경우도 꼭.” |
| 코드 리뷰 | 다른 회사 AI (무료) | 바뀐 내용(git diff)이나 PR을 보여 주고 버그, 보안, 읽기 어려운 부분을 찾게 해요 (프롬프트 ⑥) |
| 보안 점검 | 에이전트 + 나 | 비밀 값이 코드에 들어갔는지, 로그인 안 한 사람이 남의 예약을 지울 수 있는지 확인해요 |
| 사람 확인 | 나와 동료 | 휴대폰과 컴퓨터에서 직접 눌러 봐요. 02장의 QA 역할이에요 |
너는 꼼꼼한 시니어 개발자야. 아래 코드 변경을 리뷰해 줘.
중요한 순서대로:
1. 실제로 오동작하거나 데이터가 망가질 수 있는 버그
2. 보안 문제 (권한 확인 누락, 비밀 값 노출, 입력값 검증 누락)
3. 나중에 고치기 어려워질 구조 문제
각 문제마다 파일과 줄, 왜 문제인지, 어떻게 고칠지 적어 줘.
확실하지 않은 건 "확인 필요"라고 표시해 줘.
[git diff 결과 붙여 넣기]리뷰에서 나온 문제를 다시 4단계 에이전트에게 주고 고치게 해요. 이 “만들기 → 다른 눈으로 검토 → 고치기” 반복이 적은 돈으로 품질을 올리는 가장 확실한 방법이에요.
6단계: 배포와 운영
배포도 에이전트에게 맡길 수 있지만, 무엇을 하는지 알고 맡겨야 해요. 그래서 07~10장을 먼저 배운 거예요.
이 프로젝트를 우분투 서버 한 대에 Docker Compose로 배포하려고 해.
도메인은 rooms.example.com, 웹서버는 Nginx 리버스 프록시를 쓸 거야.
1. Dockerfile, compose.yaml, .dockerignore 를 만들어 줘
2. Nginx server 블록 설정을 docs/deploy.md 에 써 줘
3. 내가 서버에서 직접 칠 명령어를 순서대로 docs/deploy.md 에 정리해 줘
4. main 에 합쳐지면 테스트와 빌드를 하는 GitHub Actions 파일을 만들어 줘
서버에 직접 접속하거나 명령을 실행하지는 마.마지막 줄이 중요해요. 진짜 서버(프로덕션)에서 실행하는 명령은 내가 읽고, 이해하고, 직접 쳐요. DNS에 A 레코드를 추가하는 것(05장)도 내가 해요. 오픈한 뒤 오류가 생기면 docker compose logs의 내용을 에이전트에게 보여 주고 원인을 찾게 하면 돼요.
Part B
유지보수와 문제 해결: 이미 있는 것을 고치고 가꾸기
서비스를 한 번 내놓으면 그때부터가 진짜 시작이에요. 오류가 생기고, 기능을 바꿔 달라는 요청이 오고, 부품(라이브러리)은 낡아요. 이런 일을 유지보수라고 해요. 새로 만들 때와 가장 다른 점은, 이미 있는 코드와 실제 사용자가 있다는 거예요. 그래서 “빨리”보다 “아무것도 망가뜨리지 않고”가 더 중요해요.
일의 종류마다 AI를 쓰는 방법이 달라요
| 일 | 예시 | 챗봇만으로 | 에이전트가 있으면 | 가장 중요한 것 |
|---|---|---|---|---|
| 작은 버그 수정 | 버튼이 안 눌려요 | 충분해요 오류 + 관련 함수만 주면 돼요 | 재현 방법만 주고 찾게 해요 | 정확한 오류 메시지 |
| 원인 모를 버그 | 가끔 예약이 두 번 들어가요 | 가능하지만 정보를 여러 번 오가야 해요 | 유리해요 코드를 직접 뒤져 봐요 | 언제 일어나는지(재현 조건) |
| 기능 추가·변경 | 예약에 메모 칸 추가 | 파일이 2~3개면 가능 | 유리해요 여러 파일을 함께 고쳐요 | 바뀐 요구사항을 PRD에 먼저 적기 |
| 라이브러리 업데이트 | Next.js 버전 올리기 | 바뀐 점 설명 듣기에 좋아요 | 고치고 테스트까지 돌려요 | 공식 변경 안내문(릴리스 노트) |
| 남이 짠 코드 이해 | 처음 맡은 프로젝트, 남이 만든 오픈소스 | 파일 목록 + 핵심 파일로 설명 듣기 | 유리해요 저장소 전체를 읽고 지도를 그려 줘요 | “무엇을 알고 싶은지” 정하기 |
| 장애 대응 | 사이트가 안 열려요! | 먼저 롤백으로 살리고, 원인 찾기에 AI를 써요. 운영 서버 명령은 사람이 직접 쳐요 | 침착함, 최근 배포 기록 | |
AI는 어느 날까지의 자료로 공부를 마쳐요. 그래서 그 뒤에 나온 버전이나 바뀐 사용법은 모를 수 있어요. 라이브러리 업데이트처럼 최신 정보가 중요한 일에는 공식 문서나 변경 안내문을 직접 붙여 넣거나, 검색이 되는 AI를 쓰세요.
문제 해결 6단계
AI가 있어도 문제를 푸는 순서는 똑같아요. 오히려 이 순서를 지켜야 AI에게 줄 정보가 저절로 모여요.
- 다시 일으켜 보기 (재현)“어떻게 하면 이 문제가 다시 생기는지”를 찾아요. 이걸 재현이라고 해요. 재현이 되면 문제의 절반은 푼 거예요. “가끔 된다”면 언제 되고 언제 안 되는지 차이를 적어요.
- 범위 좁히기09장의 길을 앞에서부터 확인해요. 도메인이 IP를 잘 가리키나(DNS)? 서버에 닿나? 웹서버 설정이 맞나? 앱이 켜져 있나? 데이터베이스가 답하나? 브라우저 쪽(프론트) 문제인지 서버 쪽(백엔드) 문제인지만 갈라도 크게 좁혀져요.
- 증거 모으기오류 메시지 전체, 로그, 브라우저 개발자 도구의 오류와 네트워크 탭, 그리고 최근에 바뀐 것을 모아요. 어제까지 됐다면 범인은 대개 그 사이의 변경이에요.터미널 — 최근에 무엇이 바뀌었나
git log --oneline -10 # 최근 커밋 10개 git diff HEAD~3 --stat # 최근 커밋 3개에서 바뀐 파일 목록 pm2 logs blog --lines 50 # 앱 로그 마지막 50줄 (Docker라면 docker compose logs --tail 50) - AI에게 묻기모은 증거를 Part C의 틀에 맞춰 줘요. 이때 “고쳐 줘”보다 “가능한 원인을 확률 높은 순서로 3개, 각각 확인하는 방법과 함께”를 먼저 물어보면 엉뚱한 수정을 피할 수 있어요.
- 한 번에 하나씩 바꾸기AI가 알려 준 원인을 하나씩 확인해요. 여러 군데를 한꺼번에 바꾸면 무엇이 효과가 있었는지 모르게 돼요. 바꾸기 전에 커밋해 두면 언제든 되돌릴 수 있어요.
- 고친 뒤 다시 안 생기게 하기1단계의 재현 방법을 테스트로 만들어 두면 같은 버그가 돌아오지 않아요. 커밋 메시지에는 원인을 적어요. 예:
fix: 같은 시간 중복 예약 (저장 전 겹침 검사 누락)
장애가 났을 때: 고치기보다 살리기가 먼저
사용자가 쓰는 사이트가 멈췄다면 순서가 달라져요.
- 팀에 알리기혼자 해결하려고 숨기지 마세요. “지금 ○○가 안 됩니다, 확인 중입니다” 한 줄이면 돼요.
- 최근 배포가 있었다면 롤백원인을 몰라도 이전 버전으로 되돌리면 대부분 살아나요(07장).
- 살린 다음 원인 찾기위의 문제 해결 6단계를 차분히 해요. AI에게 로그를 보여 주는 건 이때예요.
- 기록 남기기무슨 일이 있었고, 왜 생겼고, 어떻게 막을지 짧게 적어요. 이걸 포스트모템(사후 분석)이라고 해요. 누구 탓인지가 아니라 무엇을 바꿀지를 적어요.
서버 터졌어요! 일단 롤백하고 로그 까 볼게요.
서버에 장애가 났어요. 먼저 이전 버전으로 되돌리고, 기록(로그)을 열어 원인을 찾아볼게요.
원인 파악되면 팔로업 드릴게요.
원인을 알게 되면 이어서 알려 드릴게요.
남이 짠 코드를 AI와 함께 이해하기
유지보수는 대부분 내가 짜지 않은 코드에서 일어나요. 처음 보는 프로젝트라면 이렇게 물어보세요.
이 프로젝트를 처음 맡은 사람에게 설명하듯 알려 줘.
1. 이 프로젝트가 하는 일을 세 문장으로
2. 폴더별 역할 (중요한 것 위주로 5~8개)
3. 사용자가 "예약하기" 버튼을 누르면 어떤 파일들을 거쳐서 저장되는지 순서대로
4. 처음 고칠 때 조심해야 할 부분
코드를 고치지는 마.
[챗봇이라면 아래 "파일 목록" 결과와 핵심 파일 2~3개를 붙여 넣기]
[에이전트라면 이 문장 없이 그대로 요청]# Git이 관리하는 파일만 보여 줘서 node_modules 같은 건 빠져요
git ls-files | head -100Part C
AI에게 잘 설명하는 법: 토큰은 아끼고 성공률은 높이기
AI는 글을 토큰이라는 작은 조각 단위로 읽고 써요. 영어 단어 하나가 대략 토큰 하나 정도이고, 한국어는 같은 내용이라도 토큰이 더 드는 편이에요. 유료 요금과 무료 사용량 제한은 모두 이 토큰 수로 계산돼요. 내가 보낸 글(입력)과 AI가 쓴 글(출력)을 모두 세요.
여기서 많은 사람이 모르는 사실이 있어요. AI는 대화의 앞부분을 따로 기억하지 않아요. 내가 메시지를 하나 보낼 때마다 지금까지의 대화 전체를 처음부터 다시 읽어요. 그래서 대화가 길어질수록 메시지 하나의 값이 점점 비싸지고, 앞에서 했던 틀린 추측도 계속 따라다녀요.
AI는 매번 처음 만나는 아주 똑똑한 전문가예요. 내 사정을 전혀 모르니 필요한 건 빠짐없이, 하지만 시간(토큰)은 돈이니 필요 없는 건 빼고 말해야 해요. 병원에서 의사에게 증상을 말하는 것과 같아요. “배가 아파요”보다 “어제 저녁부터 오른쪽 아랫배가 아프고, 열이 38도예요”가 훨씬 빨리 정확한 답을 받아요.
좋은 질문의 네 가지 재료
무엇을 하려고 했나
“예약 버튼을 누르면 예약이 저장되고 목록에 보여야 해요.” 기대한 결과가 있어야 AI가 무엇이 틀렸는지 알아요.
실제로 무슨 일이 났나
오류 메시지 전체를 그대로 복사해요. 요약하거나 다시 타이핑하지 마세요. 화면이 문제라면 스크린샷 한 장이 긴 설명보다 나아요.
어디까지 봤나
관련 코드(함수 단위), 환경(로컬인지 서버인지, 버전), 재현 방법, 이미 해 본 것. 해 본 것을 말하지 않으면 AI가 같은 제안을 반복해요.
무엇이면 해결인가
“이 재현 순서대로 했을 때 오류가 안 나고, npm test가 통과하면 끝.” 답의 형식도 정해요: “원인 설명은 세 줄로, 코드는 바뀐 부분만.”
나쁜 질문과 좋은 질문
예약이 안 돼요. 고쳐 주세요.AI는 원인을 추측해서 일반적인 해결책 열 가지를 길게 늘어놓아요. 대부분 상관없는 내용이고, 출력 토큰만 많이 써요. 다시 물어보는 동안 대화는 길어지고 값은 올라가요.
예약이 안 돼요. 프로젝트 파일 전부 붙여 넣을게요.
[파일 40개, 로그 3,000줄, package-lock.json 전체 ...]입력 토큰이 크게 들고, 진짜 중요한 한 줄이 묻혀요. 무료 플랜이라면 이 메시지 하나로 사용량이 끝날 수도 있어요.
[목표] 회의실 예약 폼에서 "예약하기"를 누르면 예약이 저장돼야 해.
[증상] 버튼을 누르면 화면에 "예약 실패"가 뜨고, 서버 로그에 아래 오류가 나와.
TypeError: Cannot read properties of undefined (reading 'id')
at createBooking (src/server/booking.ts:42:31)
[환경] 로컬, Node 24, Next.js 15, PostgreSQL 17. 어제 커밋 a1b2c3d 이후부터 생김.
[재현] 로그인 → 회의실 A 선택 → 내일 10시 → 예약하기
[해 본 것] DB 연결은 정상 (다른 화면의 목록 조회는 잘 됨).
[관련 코드] src/server/booking.ts 의 createBooking 함수 (아래 붙임)
...함수 30줄...
[요청] 가능한 원인을 확률 높은 순서로 3개, 각각 확인 방법과 함께.
코드는 바뀐 줄만 보여 줘. 더 필요한 파일이 있으면 고치기 전에 먼저 물어봐.마지막 줄 “더 필요한 게 있으면 먼저 물어봐”가 아주 중요해요. 모든 걸 미리 다 주려고 애쓰지 않아도, AI가 필요한 것만 골라서 달라고 해요. 정보를 조금씩 늘려 가는 게 처음부터 다 주는 것보다 싸고 정확해요.
무엇을 넣고, 무엇을 뺄까
| 넣으세요 | 빼세요 |
|---|---|
| 오류 메시지 전문과, 스택 트레이스 중 내 코드 파일 이름이 나오는 줄 | 로그 전체. 오류가 난 시각 앞뒤 20~50줄이면 충분해요 |
| 문제와 관련된 함수 하나, 또는 파일 하나 | 프로젝트 전체 복사, node_modules, 빌드 결과물(dist/) |
관련 부품의 버전 (package.json의 해당 줄만) | package-lock.json 전체 (수만 줄이에요) |
최근 바뀐 부분 (git diff) | 문제와 상관없는 지난 대화, 긴 인사말과 사과 |
설정 값의 이름과 모양 (DB_URL=postgres://***) | 진짜 비밀번호, API 키, 고객 개인정보 |
| 최신 정보가 필요하면 공식 문서의 해당 부분 | “아마 이것 때문인 것 같은데”처럼 확인 안 된 내 추측을 사실처럼 쓰기 (추측이라면 추측이라고 적기) |
얼마나 줄까: 정보의 단계
처음부터 많이 줄 필요는 없어요. 2단계에서 시작하고, 안 풀리면 한 단계씩 올려요.
| 단계 | 주는 정보 | 어울리는 질문 |
|---|---|---|
| 1. 질문만 | 궁금한 것 한 문장 | 개념 질문. “CNAME과 A 레코드의 차이가 뭐야?” |
| 2. 오류 + 코드 | 목표, 오류 전문, 관련 함수, 버전 | 대부분의 버그는 여기서 풀려요 |
| 3. + 상황 | 재현 방법, 환경, 해 본 것, 최근 변경(diff) | 2단계에서 두 번 실패했을 때, “가끔” 생기는 문제 |
| 4. + 구조 | 파일 목록, 관련 파일 여러 개, PRD나 설계 문서 | 설계를 바꿔야 하는 문제, 여러 파일이 얽힌 문제. 이쯤 되면 에이전트가 유리해요 |
에이전트를 쓰지 않을 때 (챗봇만으로)
- 필요한 부분만 잘라서 줘요. 위의 “넣으세요” 표가 기준이에요.
- 답은 짧게 받아요. “파일 전체를 다시 쓰지 말고 바뀐 줄만, 설명은 세 줄로.” 출력 토큰이 크게 줄고, 내가 무엇이 바뀌었는지 보기도 쉬워요.
- AI가 준 코드는 내가 직접 붙여 넣고 실행해요. 그 결과(성공이든 새 오류든)를 다시 알려 줘요. 이 반복이 바로 에이전트가 자동으로 하는 일이에요. 직접 해 보면 에이전트가 무엇을 하는지도 이해하게 돼요.
- 작은 일엔 가벼운 모델, 어려운 일엔 좋은 모델. 문법 질문이나 짧은 설명은 가볍고 빠른 모델로도 충분해요. 무료 사용량을 어려운 문제에 아껴 두세요.
에이전트를 쓸 때
- 에이전트가 읽을 수 있는 건 붙여 넣지 마세요. 파일 내용 대신 경로를 알려 줘요. “
src/server/booking.ts의createBooking을 봐 줘.” 에이전트가 필요한 부분만 읽어서 토큰을 아껴요. - 재현 명령을 줘요. “
npm test -- booking을 돌리면 실패해. 통과하게 만들어 줘.” 에이전트가 스스로 실행하고 확인하면서 고치니까 성공률이 가장 높아요. - 범위를 정해요. “
src/server폴더만 고쳐. 데이터베이스 구조는 바꾸지 마.” 범위가 없으면 에이전트가 상관없는 곳까지 고치기도 해요. - 반복되는 설명은 규칙 파일에. 실행 방법, 테스트 명령, 팀 규칙을
AGENTS.md·CLAUDE.md에 적어 두면 매번 말하지 않아도 돼요. - 큰 일은 계획 먼저. 고치기 전에 “원인과 고칠 계획만 먼저 말해 줘”라고 하면, 잘못된 방향으로 한참 고치는 낭비를 막아요.
같은 대화에서 두세 번 실패하면, 새로 시작하세요
AI가 같은 문제를 두세 번 고쳐도 안 된다면, 그 대화에는 이미 틀린 추측들이 쌓여 있어요. 계속 이어 가면 값은 비싸지고 AI는 같은 실수를 되풀이해요. 이럴 땐 지금까지 알게 된 것을 정리해서 새 대화를 열어요. 다른 회사의 AI에게 물어보는 것도 좋은 방법이에요.
# 지금 대화의 마지막에 이렇게 요청해요
지금까지 대화를 다음 사람에게 넘길 메모로 정리해 줘.
- 문제와 재현 방법
- 확인해서 "원인이 아니다"라고 밝혀진 것
- 아직 확인하지 못한 가설
- 지금 코드 상태 (무엇을 바꿨는지)
10줄 이내로.
# 그 메모를 새 대화(또는 다른 AI)에 붙여 넣고 시작해요위의 “좋은 예”처럼 목표, 증상, 해 본 것을 적다 보면, 보내기 전에 답이 보이는 일이 정말 많아요. 개발자들은 이걸 고무 오리 디버깅이라고 불러요. 책상 위 고무 오리에게 설명하다가 스스로 깨닫는다는 뜻이에요. 같은 틀로 동료나 개발자 커뮤니티에 질문해도 훨씬 빨리 좋은 답을 받아요.
- AI도 틀려요. 그럴듯하지만 사실이 아닌 말을 지어내는 것을 할루시네이션이라고 해요. 없는 명령어나 없는 라이브러리를 알려 주기도 해요. 중요한 건 공식 문서로 확인하세요.
- 비밀 정보를 대화창에 붙여 넣지 마세요. 비밀번호, API 키, 고객 개인정보는 AI에게도 보여 주지 않아요.
- 무료 플랜은 대화가 AI 학습에 쓰일 수 있어요. 설정에서 학습 사용을 끌 수 있는지 확인하고, 회사 코드라면 회사의 AI 사용 규칙부터 확인하세요.
- 위험한 명령은 허락하기 전에 읽어요. 에이전트가 파일 삭제(
rm -rf),git push --force, 데이터베이스 지우기를 하려 하면 멈추고 이유를 물어보세요. - AI가 쓴 코드도 책임은 나에게 있어요. 설명하지 못하는 코드는 합치지 마세요. “이 코드를 중학생에게 설명하듯 설명해 줘”라고 물어보면 공부도 돼요.
- 새로 만들 때: 생각 정리(1~3단계)는 무료 챗봇으로, 구현(4단계)에만 코딩 에이전트 하나를 유료로 써요. 단계마다 직접 확인하고 커밋해요.
- 고칠 때: 재현 → 범위 좁히기 → 증거 모으기 → AI에게 묻기 → 하나씩 바꾸기 → 테스트로 막기. 장애라면 롤백이 먼저예요.
- 설명할 때: 목표·증상·범위·기준 네 가지를, 필요한 만큼만. 2단계 정보로 시작하고, “더 필요하면 먼저 물어봐”를 붙여요.
- 두세 번 실패하면 정리해서 새 대화로. 에이전트에게는 붙여 넣기 대신 경로와 재현 명령을 줘요.
- AI는 빠른 조수일 뿐이에요. 이 교과서의 기초를 알아야 AI가 맞게 하는지 판단할 수 있어요.
도구 비교와 가격은 2026년 11월 기준 공개 비교 글(예: Tech Insider, Developers Digest, Dupple)을 참고했어요. 자주 바뀌니 각 회사의 공식 가격 페이지를 확인하세요.