코드에서 출시까지 00 큰 그림

처음 배우는 사람도, 개념을 다시 잡고 싶은 사람도

내가 만든 코드는 어떻게
사람들 손에 닿을까?

내 컴퓨터에서 쓴 코드 한 줄이 웹사이트로, 스토어의 앱으로, 설치 프로그램으로 다른 사람에게 닿기까지, 그 사이에 있는 언어, 사람, 도구, 주소, 서버, 출시 과정을 순서대로 따라가 봐요. 프로그래밍을 막 시작했다면 처음부터, 이미 일하고 있다면 필요한 장만 골라 읽어도 돼요. 장의 순서는 실제로 서비스가 만들어지는 순서와 같아요.

  • 점선 밑줄 본문에서 이렇게 표시된 말은 용어 사전에 있어요.
    누르면 뜻이 떠요.
  • (Full Name) 줄임말의 원래 이름이에요.
    처음 나올 때 붙였어요.
  • 쉽게 말하면 생활 속 비유예요.
  • 실무에서는 실제 프로젝트에서 많이 쓰는 방식이에요.
  • 주의 많은 사람이 자주 하는 실수예요.
  • 이 장의 핵심 장마다 끝에 있는 요약이에요.
  • 판교 사투리 IT 회사에서 영어 단어를 섞어 쓰는 말투를 부르는 별명이에요.
    현업에서 자주 듣는 말과 그 뜻을 함께 적었어요.
00

큰 그림주소창에 주소를 치면 무슨 일이 생길까?

웹사이트는 결국 “부탁하면 답해 주는” 구조예요. 부탁하는 쪽을 클라이언트라고 하고, 보통은 여러분의 브라우저(크롬, 사파리 같은 인터넷 창)예요. 답해 주는 쪽은 서버라고 해요. 어딘가에서 24시간 켜져 있는 컴퓨터예요.

아래 단계를 하나씩 눌러 보세요. 이 교과서의 장들이 이 여정의 한 부분씩을 맡아서 설명해요.

    쉽게 말하면 · 식당으로 비유하기

    손님(브라우저)이 가게 이름(도메인)을 말해요. 그럼 전화번호부(DNS)에서 가게의 진짜 주소(IP 주소)를 찾아 찾아가요. 입구의 안내 데스크(웹서버)가 손님을 맞고, 주방(백엔드)은 창고(데이터베이스)에서 재료를 꺼내 요리(웹페이지)를 만들어 내보내요. 이 비유는 교과서 끝까지 계속 써요.

    무엇을 만드느냐에 따라 길이 세 갈래로 나뉘어요

    위의 식당 비유는 웹사이트 이야기예요. 하지만 개발의 결과물이 꼭 웹사이트인 건 아니에요. 휴대폰 앱일 수도 있고, 컴퓨터에 설치해서 쓰는 프로그램일 수도 있어요. 만드는 과정(언어 고르기, 역할 나누기, Git으로 함께 일하기)은 거의 같고, 사용자에게 전달하는 마지막 길이 달라요.

    웹 서비스휴대폰 앱설치형 프로그램
    예쇼핑몰, 블로그, 예약 사이트메신저, 은행 앱, 모바일 게임문서 편집기, 사진 편집 프로그램, VS Code
    어디서 돌아가나서버에서 돌고, 사용자는 브라우저로 접속해요사용자 휴대폰에 설치돼서 돌아가요사용자 컴퓨터(Windows, macOS, Linux)에 설치돼서 돌아가요
    사용자에게 가는 길서버에 배포하면 바로 모두에게 닿아요App Store, Google Play의 심사를 통과해야 해요설치 파일을 내려받게 하거나 스토어에 올려요
    업데이트서버만 바꾸면 다음 접속부터 모두 새 버전이에요사용자가 업데이트해야 바뀌어요. 옛 버전이 오래 남아요자동 업데이트를 만들어 두지 않으면 옛 버전이 오래 남아요
    이 교과서에서05~07장, 09장08장08장
    쉽게 말하면 · 앱과 프로그램도 대부분 서버를 써요

    로그인, 채팅, 결제처럼 여러 사람의 데이터를 나누는 기능은 앱이든 프로그램이든 결국 서버의 API를 불러요. 그래서 앱만 만드는 팀도 서버 이야기(05~07장)를 알아 두면 훨씬 덜 헤매요.

    서비스가 만들어지는 흐름과 이 교과서의 지도

    서비스 하나가 만들어져서 사용자에게 닿고 운영되기까지를 순서대로 놓으면 이렇게 돼요. 어떤 일이 어느 장과 연결되는지 먼저 훑어보세요.

    단계하는 일필요한 지식장
    시작어떤 언어와 도구로 만들지 정해요언어, 런타임, 프레임워크01
    시작누가 무엇을 맡을지 나눠요직군, 퍼블리싱, 일의 순서02
    준비내 컴퓨터에 개발 도구를 깔고 프로젝트를 켜 봐요터미널, 설치, localhost03
    매일코드를 고치고 기록하고 다른 사람의 작업과 합쳐요Git, 브랜치, PR04
    공개 준비사이트 주소를 정하고 연결해요IP, 도메인, DNS 레코드05
    공개 준비서버에 사이트 자리를 만들어요웹서버, vhost06
    공개만든 것을 서버에 올리고 지켜봐요배포, PM2, Docker, CI/CD07
    출시휴대폰 앱은 스토어 심사를 거쳐, 설치형 프로그램은 설치 파일로 사용자에게 보내요버전, 코드 서명, 심사, 업데이트08
    실전만든 앱을 손으로 직접 배포해 보고(09), AI와 함께 아이디어부터 배포까지 해 봐요(10)지금까지 전부09 · 10
    이 장의 핵심
    • 웹은 클라이언트(부탁하는 쪽)와 서버(답하는 쪽)의 대화예요.
    • 이름(도메인) → 숫자 주소(IP) → 서버 → 안내 데스크(웹서버) → 앱 → 응답, 이 길을 기억하세요.
    01

    언어의 종류여러 언어가 역할을 나눠 맡아요

    웹사이트 하나를 만드는 데 왜 언어가 여러 개 필요할까?

    컴퓨터에게 일을 시키려면 컴퓨터가 알아듣는 말이 필요해요. 이걸 프로그래밍 언어라고 해요. 웹에서는 한 언어가 모든 걸 하지 않고, 일하는 장소에 따라 쓰는 언어가 달라요.

    • 프론트엔드(Frontend): 사용자 눈앞의 브라우저 안에서 돌아가는 부분이에요. 식당의 홀이에요.
    • 백엔드(Backend): 서버 안에서 돌아가는 부분이에요. 손님 눈에 안 보이는 주방이에요.
    • 데이터와 설정: 정보를 저장하거나 주고받거나, 프로그램의 설정을 적는 데 쓰는 글자 형식이에요.

    프론트엔드: 브라우저가 알아듣는 세 언어

    브라우저가 직접 알아듣는 언어는 딱 세 가지예요. 집 짓기에 비유하면 쉬워요.

    HTML

    뼈대와 벽

    HTML(HyperText Markup Language)은 “여기는 제목, 여기는 사진, 여기는 버튼”처럼 무엇이 어디에 있는지 정해요. 계산이나 판단은 못 해서 프로그래밍 언어가 아니라 마크업 언어(표시하는 언어)라고 불러요.

    CSS

    인테리어

    CSS(Cascading Style Sheets)는 색깔, 글자 크기, 위치, 움직임처럼 어떻게 보일지 정해요. 같은 HTML도 CSS에 따라 완전히 다른 모습이 돼요.

    JavaScript

    전기와 스위치

    JavaScript(줄여서 JS)는 버튼을 누르면 메뉴가 열리는 것처럼 동작을 맡아요. 계산하고 판단할 수 있는 진짜 프로그래밍 언어예요. 이름은 비슷해도 Java와는 다른 언어예요.

    index.html — 세 언어가 한 파일에 모인 모습
    <!-- 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로 바꾸는 과정(빌드)을 거쳐요.

    코드는 어디서 돌아갈까: 엔진과 런타임

    코드는 사람이 읽을 수 있게 쓴 “할 일 목록”일 뿐이라, 그 자체로는 아무것도 하지 않아요. 누군가 코드를 읽고 실제로 실행해 줘야 해요. 이 일을 하는 프로그램을 엔진이라고 해요.

    엔진실행하는 언어들어 있는 곳
    V8JavaScript크롬 브라우저, Node.js
    JavaScriptCoreJavaScript사파리 브라우저
    HermesJavaScriptReact Native로 만든 휴대폰 앱
    Zend EnginePHP웹서버 뒤에서 PHP를 실행하는 PHP-FPM
    JVMJava, KotlinJava 서버 (Tomcat, Spring Boot)
    CPythonPythonPython 프로그램

    그런데 엔진은 계산과 판단만 할 줄 알아요. 화면에 버튼을 그리거나 컴퓨터의 파일을 여는 방법은 엔진이 놓인 장소가 제공해요. 이렇게 엔진에 그 장소의 도구를 더한, 코드가 실제로 돌아가는 환경을 런타임이라고 해요.

    런타임엔진할 수 있는 것못 하는 것
    브라우저V8, JavaScriptCore 등화면 요소 다루기, 클릭·입력 받기내 컴퓨터 파일 마음대로 읽기
    Node.jsV8파일 읽고 쓰기, 서버 열기, 데이터베이스 연결화면 그리기 (화면이 없음)
    React Native 앱Hermes휴대폰 화면 부품, 카메라·위치 같은 기능웹페이지(HTML) 다루기
    브라우저에서 실행하면
    document.title = "Hello";
    // ✓ 탭 제목이 바뀜
    
    require("fs");
    // ✗ require is not defined (파일 도구가 없음)
    Node.js에서 실행하면
    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, FastAPIAI 서비스, 데이터 팀
    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

    그래서 실제 일에 쓰이는 것은 언어보다 라이브러리와 프레임워크예요. “React 개발자”, “Spring 개발자”라는 말이 많은 이유예요.

    쉽게 말하면 · 과외와 학교
    • 과외 선생님 = 라이브러리. 내가 원하는 날, 원하는 과목으로 불러요. 언제 부를지는 내가 정해요.
    • 학교 = 프레임워크. 시간표와 종소리는 학교가 정해요. 선생님은 “3교시 수학” 수업 내용만 준비하면, 종이 울릴 때 학교가 그 수업을 시작시켜요.

    코드에서는 “그 기능을 부르는 줄을 내가 썼나?”로 구별해요. 이 기준은 어느 언어에서나 통해요.

    라이브러리 · JavaScript (date-fns)
    import { format } from "date-fns";
    
    const today = format(new Date(), "yyyy-MM-dd");
    // ↑ 부르는 줄을 내가 씀
    console.log(today);
    프레임워크 · Next.js
    // 파일 위치: app/about/page.js
    export default function About() {
      return <h1>About us</h1>;
    }
    // About()을 부르는 줄은 없음
    프레임워크 · PHP (CodeIgniter 4)
    // app/Config/Routes.php
    $routes->get('about', 'About::index');
    
    // app/Controllers/About.php
    class About extends BaseController {
        public function index() {
            return view('about');
        }
    }
    프레임워크 · Java (Spring Boot)
    @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 위에서 돌아가요.

    라이브러리

    React

    화면을 버튼, 목록 같은 부품(컴포넌트)으로 설계해요. 데이터가 바뀌면 바뀐 부분만 다시 그리게 해 줘요. 어디에 그릴지는 정하지 않아요.

    프레임워크 · 웹

    Next.js

    React로 웹사이트를 만드는 틀이에요. HTML로 렌더링하고, 주소마다 페이지 연결, 서버에서 렌더링, 서버 쪽 코드까지 맡아요. 서버 쪽은 Node.js에서 돌아가요.

    프레임워크 · 앱

    React Native

    React로 휴대폰 앱을 만드는 틀이에요. iOS·Android의 네이티브 부품으로 렌더링하고, 앱 안의 Hermes 엔진에서 돌아가요. Node.js는 개발하는 컴퓨터에서만 써요.

    네 개를 한 장의 지도로 모으면 이렇게 돼요. 세로로 읽으면 “무엇을 만들 때 무엇을 쓰나”, 가로로 읽으면 “같은 층에서 맡는 역할”이에요. 아래층일수록 기본이고, 위층일수록 사용자에게 가까워요.

    웹사이트
    휴대폰 앱
    컴퓨터 프로그램
    서버 · 개발 도구
    내놓는 방법
    (배포 · 출시)
    서버에 배포올리면 바로 모두에게 (07장)
    스토어 심사App Store · Google Play (08장)
    설치 파일서명 · 자동 업데이트 (08장)
    서버에 배포도구라면 npm에 공개 (07 · 08장)
    틀
    (프레임워크)
    Next.js주소 연결 · 서버 렌더링
    React Native네이티브 부품으로 렌더링
    Electron웹 기술로 프로그램 창을 띄워요
    ExpressAPI 서버를 만드는 틀
    화면 설계
    (라이브러리)
    React세 곳이 같은 설계 방식을 함께 써요
    —화면이 없어요
    실행 장소
    (런타임)
    브라우저서버 쪽은 Node.js
    휴대폰 앱 안iOS · Android 부품을 빌려 써요
    Electron 안Chromium(화면) + Node.js(파일 · OS)를 함께 담아요
    Node.js내 컴퓨터와 서버에서
    엔진
    V8 · JavaScriptCore 등브라우저마다 달라요
    Hermes앱용으로 가볍게 만든 엔진
    V8Chromium과 Node.js가 함께 써요
    V8크롬과 같은 엔진
    언어
    JavaScript또는 타입 규칙을 더한 TypeScript

    표가 화면보다 넓으면 옆으로 밀어서 보세요.

    다른 언어로 바꿔도 층 구조는 같아요. 그래서 “PHP와 CodeIgniter”, “Java와 Spring Boot”는 “JavaScript와 Next.js”와 같은 관계예요.

    언어실행 장소 (엔진·런타임)라이브러리 예프레임워크 예
    JavaScript브라우저, Node.js, 앱 안의 HermesReact, date-fnsNext.js, React Native, Express
    PHPZend Engine (PHP-FPM이 실행)Carbon, PHPMailerCodeIgniter, Laravel, Symfony
    Java · KotlinJVMJackson, Apache CommonsSpring, Spring Boot
    PythonCPythonrequests, pandasDjango, FastAPI, Flask
    C#.NET 런타임Newtonsoft.JsonASP.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를 맡는 크로스 플랫폼으로 나뉘어요.
    02

    누가 무엇을 하나서비스 하나에 여러 사람이 손을 대요

    개발자 말고는 누가 서비스를 만들까?

    작은 팀이나 혼자 하는 프로젝트에서는 한 사람이 여러 역할을 함께 맡기도 해요. 그래도 해야 할 일 자체는 대체로 이렇게 나뉘어요. 식당 비유를 이어 가 볼게요.

    역할하는 일주로 만드는 것식당이라면
    기획자
    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”은 두 가지 뜻이에요

    회의에서 말하는 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, 간단한 JavaScriptJavaScript·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로 무엇을 어떤 형식으로 주고받을지 확정되면 알려 주세요.

    일이 흘러가는 순서

    1. 기획무엇을 만들지, 무엇을 하면 성공인지 정해요.
    2. 디자인화면 시안을 만들고 기획자와 함께 확정해요.
    3. 개발API 약속을 먼저 정하고, 프론트와 백엔드가 나눠서 만들어요. 각자 Git의 브랜치에서 작업해요.
    4. 코드 리뷰동료가 내 코드를 읽고 의견을 남겨요(Pull Request). 승인되면 합쳐요.
    5. QA 테스트실제와 똑같이 만든 연습용 서버(스테이징)에서 테스트해요.
    6. 배포진짜 서비스 서버(프로덕션)에 올려요.
    7. 운영 · 모니터링오류와 접속량을 지켜보고, 문제가 생기면 고쳐요. 그리고 다시 1번부터 반복해요.
    실무에서는

    팀으로 일하면 할 일은 보통 티켓이라는 형태로 와요. Jira, Linear, GitHub Issues 같은 업무 관리 도구에 있는 “할 일 카드”예요. 카드에는 할 일, 완료 기준, 관련 디자인 링크가 적혀 있어요. 모르는 게 있으면 카드에 적힌 담당자(기획자, 디자이너, 다른 개발자)에게 물어보면 돼요.

    판교 사투리

    이 건 티켓 따서 저한테 어사인해 주세요.이 일을 할 일 카드로 만들고, 담당자를 저로 정해 주세요.

    내일까지 디벨롭해서 컨펌받을게요.내일까지 더 다듬어서 확인(승인)을 받을게요.

    이 장의 핵심
    • 기획 → 디자인 → 개발 → 리뷰 → 테스트 → 배포 → 운영이 한 바퀴예요.
    • 프론트엔드와 백엔드는 API라는 약속으로 대화해요.
    • 사람 PM과 프로그램 PM2는 다른 거예요.
    • 퍼블리싱은 디자인 시안을 HTML·CSS 화면으로 옮기는 일이에요. 따로 된 직군은 주로 한국(퍼블리셔)과 일본(코더)에 있고, 다른 나라에서는 프론트엔드 개발의 일부로 봐요.
    03

    내 컴퓨터 준비로컬 개발 환경 만들기

    개발은 어디서 시작할까?

    로컬(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 폴더로 들어가”라는 뜻이에요. 아래 다섯 개만 알아도 시작할 수 있어요.

    명령어원래 말뜻
    pwdprint working directory지금 내가 어느 폴더에 있는지 보여 줘
    lslist이 폴더 안에 뭐가 있는지 보여 줘 (윈도우 옛 명령은 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
    설치 확인 — 버전 숫자가 나오면 성공이에요
    git --version
    node -v
    npm -v
    쉽게 말하면 · LTS가 뭐예요?

    LTS(Long Term Support)는 “오래오래 고장 수리를 해 주는 안정 버전”이에요. 실제 서비스에는 보통 가장 최신판보다 LTS를 써요. 맥에서 brew install node는 최신판을 깔아요. 프로젝트가 특정 버전을 원하면 nvm(Node Version Manager) 같은 버전 관리 도구로 맞춰 쓰면 돼요.

    팀 프로젝트를 내 컴퓨터에서 켜 보기

    1. 코드 받기GitHub 같은 온라인 코드 보관소(원격 저장소)에서 프로젝트 코드를 통째로 복사해 와요.
      터미널
      git clone https://github.com/my-company/blog.git
      cd blog
    2. 필요한 부품 설치package.json에 적힌 부품(라이브러리)을 내려받아 node_modules 폴더에 넣어요. npm은 원래 Node Package Manager에서 온 이름이에요.
      터미널
      npm install
    3. 비밀 설정 파일 만들기프로젝트에 있는 .env.example을 복사해서 .env를 만들고, 필요한 값을 채워요(팀 프로젝트라면 담당자에게 받아요). 이런 설정 값을 환경 변수라고 해요.
    4. 개발 서버 켜기터미널에 나온 주소를 브라우저에서 열어요. 코드를 고치고 저장하면 화면이 바로 바뀌어요.
      터미널
      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
    스테이징실제와 똑같이 꾸민 테스트용 서버팀원, QAstaging.example.com
    프로덕션 (운영)진짜 서비스 서버모든 사용자example.com

    환경마다 .env 값이 달라요. 예를 들어 로컬은 연습용 데이터베이스, 프로덕션은 진짜 고객 데이터베이스를 가리켜요. 그래서 코드는 같고 설정만 바꿔서 여러 환경에서 돌려요.

    판교 사투리

    이상하네요, 로컬에선 되는데요?내 컴퓨터에서는 잘 되는데요. 서버와 내 컴퓨터의 환경(버전, 설정)이 다를 때 자주 나오는 말이에요.

    이 장의 핵심
    • 준비물은 에디터, 터미널, 런타임(Node.js), Git이에요.
    • 프로젝트는 git clone → npm install → .env 만들기 → npm run dev 순서로 켜요.
    • node_modules와 .env는 Git에 올리지 않아요.
    04

    Git코드의 세이브 포인트이자 팀 협업 도구

    여러 명이 같은 코드를 고치면 어떻게 안 섞이게 할까?

    숙제_최종.hwp, 숙제_진짜최종.hwp, 숙제_진짜최종_수정2.hwp… 이런 경험 있나요? Git(깃)은 이 문제를 해결하는 버전 관리 도구예요. 파일 이름은 하나로 두고, 바꿀 때마다 “언제, 누가, 무엇을, 왜” 바꿨는지 기록을 남겨요. 게임의 세이브 포인트처럼 언제든 예전 상태로 돌아갈 수 있어요.

    Git

    도구 (프로그램)

    내 컴퓨터에 설치하는 기록 프로그램이에요. 인터넷 없이도 동작해요.

    GitHub · GitLab

    보관소 (웹사이트)

    Git 기록을 인터넷에 올려 두고 팀이 함께 보는 서비스예요. 코드 리뷰 기능도 여기 있어요.

    Git이 기록을 관리하는 프로젝트 폴더를 저장소(Repository, 줄여서 레포)라고 해요. 내 컴퓨터에 있으면 로컬 저장소, GitHub에 있으면 원격 저장소예요.

    Git의 네 공간

    Git을 이해하는 핵심은 코드가 네 군데를 거쳐 간다는 거예요. 택배로 치면 “물건 고르기 → 상자에 담기 → 포장해서 송장 붙이기 → 택배 보내기”예요.

    ① 작업 폴더 Working Directory 지금 고치는 파일 ② 스테이징 Staging Area 저장할 것 골라 담기 ③ 로컬 저장소 Local Repository 내 컴퓨터의 기록 ④ 원격 저장소 Remote · GitHub 팀이 함께 보는 기록 add commit push pull 팀원이 올린 변경을 받아와 내 작업 폴더에 합치기
    코드는 왼쪽에서 오른쪽으로 저장되고, 팀원의 변경은 pull로 받아와요. 맨 처음 한 번은 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). 망치면 가지만 버리면 되니 안전해요.

    main feature/login 여기서 갈라짐 팀원의 다른 작업 합치기 (merge) 로그인 화면 · 로그인 API 배포
    동그라미 하나가 커밋 하나예요. 내가 로그인 기능을 만드는 동안 팀원은 main에서 다른 작업을 할 수 있어요.

    팀 프로젝트의 하루 흐름

    1. 최신 코드 받기일 시작 전에 팀원들이 올린 변경부터 받아요.
      터미널
      git switch main
      git pull
    2. 내 작업용 브랜치 만들기이름은 보통 feature/할일, fix/고칠것처럼 지어요.
      터미널
      git switch -c feature/login
    3. 작업하고 자주 커밋하기한 가지 일을 끝낼 때마다 기록해요.
      터미널
      git status
      git add src/login.js
      git commit -m "feat: 로그인 폼 추가"
    4. 원격에 올리기
      터미널
      git push -u origin feature/login
      origin은 원격 저장소의 기본 별명이에요. -u는 처음 한 번만 붙이면 되고, 그다음부터는 git push만 쳐도 돼요.
    5. PR 만들기GitHub에서 “제 브랜치를 main에 합쳐 주세요”라고 요청해요. 이걸 PR(Pull Request)이라고 해요. 동료가 코드를 읽고 의견(리뷰)을 남겨요. GitLab에서는 같은 기능을 MR(Merge Request)이라고 불러요.
    6. 승인되면 합치기합친 뒤 다 쓴 브랜치는 지워요. main에 합쳐지면 자동으로 배포되게 해 두는 프로젝트가 많아요(07장 CI/CD).

    충돌(conflict)은 고장이 아니에요

    나와 팀원이 같은 파일의 같은 줄을 다르게 고치면, Git은 어느 쪽이 맞는지 몰라서 사람에게 물어봐요. 이게 충돌이에요. 파일을 열면 이렇게 표시돼 있어요.

    header.js — 충돌이 난 모습
    <<<<<<< HEAD
    const title = "우리 팀 블로그";        // 내 브랜치(지금 있는 곳)의 내용
    =======
    const title = "Example 기술 블로그";   // 합치려는 쪽(main)의 내용
    >>>>>>> main

    해결 방법은 간단해요.

    1. 둘 중 맞는 내용(또는 둘을 섞은 내용)만 남겨요.
    2. <<<<<<<, =======, >>>>>>> 표시 줄을 지워요.
    3. git add → git commit 해요.

    어느 쪽이 맞는지 애매하면 그 줄을 고친 동료에게 물어보세요. 혼자 고민하는 것보다 훨씬 빨라요.

    .gitignore: Git에 올리지 않을 파일 목록

    .gitignore
    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에 합쳐요.
    • 충돌은 사람이 골라 주면 끝나요. 비밀 정보는 절대 커밋하지 않아요.
    05

    IP · 도메인 · DNS인터넷에서 “주소”가 작동하는 방법

    example.com이라는 이름만으로 어떻게 지구 반대편 컴퓨터를 찾아갈까?

    IP 주소: 인터넷의 전화번호

    인터넷에 연결된 모든 기기는 숫자로 된 번호를 하나씩 받아요. 이게 IP 주소(Internet Protocol address)예요. 컴퓨터끼리는 이 번호로 서로를 찾아요. 이름의 프로토콜은 “컴퓨터끼리 대화하는 규칙”이라는 뜻이에요.

    IPv4 · 203.0.113.10

    점으로 나눈 숫자 네 덩어리

    IPv4(IP version 4)는 각 덩어리가 0~255예요. 만들 수 있는 번호가 약 43억 개뿐이라 이미 모자라요.

    IPv6 · 2001:db8::1

    훨씬 긴 새 주소

    IPv6(IP version 6)는 번호가 거의 무한히 많아요. 점점 늘고 있지만 아직 IPv4와 함께 써요.

    종류뜻예시
    공인 IP인터넷 전체에서 하나뿐인 번호예요. 서버는 공인 IP가 있어야 바깥에서 찾아올 수 있어요203.0.113.10
    사설 IP집이나 회사 공유기 안에서만 쓰는 번호예요. 다른 집에서도 똑같은 번호를 써요. 아파트 안의 인터폰 번호 같은 거예요192.168.0.5, 10.0.0.3
    루프백나 자신을 뜻하는 번호예요. 03장의 localhost127.0.0.1

    이 교과서의 IP 예시(203.0.113.x, 2001:db8::)는 설명서용으로 따로 정해 둔 번호라서 실제 서버와 겹치지 않아요.

    포트: 건물 안의 호수

    IP가 건물 주소라면, 포트(port)는 그 건물 안의 호수예요. 서버 컴퓨터 한 대에서 여러 프로그램이 동시에 돌아가니까, 몇 번 문으로 들어갈지 정해야 해요. 번호는 0~65535까지 있고, 자주 쓰는 번호는 정해져 있어요.

    포트용도메모
    80HTTP (암호화 안 된 웹)주소에 안 써도 자동으로 붙어요
    443HTTPS (암호화된 웹)요즘 거의 모든 사이트가 써요
    22SSH (서버 원격 접속)개발자가 서버에 들어갈 때 써요
    3000, 5173, 8080개발 서버, 앱 서버관습일 뿐이라 바꿀 수 있어요
    3306 / 5432MySQL / PostgreSQL 데이터베이스바깥에 열어 두면 위험해요

    도메인: 외우기 쉬운 이름표

    203.0.113.10을 외우는 사람은 없어요. 그래서 숫자에 이름을 붙였는데, 그게 도메인이에요. 도메인은 오른쪽에서 왼쪽으로 읽으면 큰 단위에서 작은 단위로 내려가요. 주소를 “대한민국 서울시 강남구”처럼 큰 데서부터 읽는 것과 같아요.

    blog서브도메인
    . 
    example도메인 이름 (돈 내고 빌린 부분)
    . 
    com최상위 도메인
    부분설명예시
    최상위 도메인
    TLD (Top-Level Domain)
    맨 끝 부분이에요. 나라나 종류를 나타내요.com .kr .net .io
    도메인 이름도메인 등록 업체에 돈을 내고 1년 단위로 빌리는 이름이에요. 기간 연장을 잊으면 남이 가져갈 수도 있어요example.com, example.co.kr
    루트 도메인앞에 아무것도 붙지 않은 기본 도메인이에요. 에이펙스(apex) 도메인이라고도 해요example.com
    서브도메인도메인 앞에 붙이는 하위 이름이에요. 도메인 주인이 돈 안 내고 마음대로 만들 수 있고, 각각 다른 서버로 연결할 수도 있어요blog.example.com
    api.example.com
    www.example.com
    쉽게 말하면

    도메인은 건물 이름, 서브도메인은 그 건물 안 매장 이름이에요. “example 빌딩”을 빌렸다면 그 안에 “blog 매장”, “shop 매장”을 마음대로 낼 수 있어요. 우리가 자주 보는 www도 사실 서브도메인 중 하나예요.

    DNS: 인터넷의 전화번호부

    브라우저는 이름(도메인)만으로는 서버를 찾아갈 수 없어요. 꼭 숫자(IP)로 바꿔야 해요. 이 일을 하는 시스템이 DNS(Domain Name System)예요. 주소창에 도메인을 치면 대략 이런 순서로 찾아요.

    1. 내 컴퓨터가 기억하는지 확인최근에 가 본 곳이면 기억해 둔 IP를 바로 써요. 이렇게 잠깐 기억해 두는 걸 캐시라고 해요.
    2. 안내원에게 질문모르면 “안내원” 서버(리졸버)에 물어요. 보통 인터넷 통신사의 서버나 구글(8.8.8.8), 클라우드플레어(1.1.1.1) 같은 공개 서버예요.
    3. 안내원이 차례로 물어봄루트 서버에 물으면 “.com 담당은 저쪽이에요” → .com 담당 서버에 물으면 “example.com 담당은 저쪽이에요” → example.com의 네임서버에 도착해요.
    4. 네임서버가 정답을 알려 줌“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결과
    @A203.0.113.103600example.com → 서버 1
    wwwCNAMEexample.com3600www.example.com → example.com과 같은 곳
    blogA203.0.113.103600blog.example.com → 서버 1 (같은 서버!)
    shopA203.0.113.203600shop.example.com → 서버 2

    @는 루트 도메인 자기 자신을 뜻해요. TTL(Time To Live)은 “이 정답을 몇 초 동안 기억해도 되는지”예요. 3600초는 1시간이에요. 그래서 레코드를 바꿔도 다른 사람 컴퓨터에는 최대 1시간 동안 예전 답이 보일 수 있어요. “DNS 바꿨는데 왜 안 바뀌어요?”의 대부분이 이 이유예요.

    blog와 example.com이 같은 IP를 가리키는 게 눈에 띄나요? 서버 한 대가 여러 사이트를 맡는 방법은 다음 장(vhost)에서 배워요.

    주의

    루트 도메인(@)에는 원칙적으로 CNAME을 쓸 수 없어요. 루트에는 A 레코드를 쓰고, 별명은 www 같은 서브도메인에 쓰세요. 일부 DNS 업체는 이 제한을 피해 가는 자체 기능을 따로 제공하기도 해요.

    터미널 — DNS가 어떻게 답하는지 직접 확인
    nslookup blog.example.com
    # 맥·리눅스에서는 dig도 많이 써요
    dig blog.example.com A +short

    nslookup은 name server lookup(네임서버에 물어보기), dig는 Domain Information Groper(도메인 정보 찾기 도구)의 줄임말이에요.

    HTTP와 HTTPS

    HTTP(HyperText Transfer Protocol)는 브라우저와 서버가 웹페이지를 주고받을 때 쓰는 대화 규칙이에요. HTTPS(HTTP Secure)는 여기에 암호화를 더한 거예요.

    http://

    엽서

    배달 중에 누구나 내용을 볼 수 있어요. 비밀번호를 보내면 위험해요. 요즘 브라우저는 “주의 요함”이라고 경고해요.

    https://

    봉인된 편지

    내용이 암호화돼서 받는 사람만 읽을 수 있어요. 이를 위해 서버에 인증서를 설치해요. Let's Encrypt에서 무료로 받을 수 있어요.

    이 인증서를 흔히 SSL 인증서라고 불러요. SSL(Secure Sockets Layer)은 옛날 방식의 이름이고, 지금 실제로 쓰는 건 TLS(Transport Layer Security)예요. 둘 다 같은 걸 가리키는 말로 섞어 써요.

    URL 뜯어보기

    URL(Uniform Resource Locator)은 우리가 주소창에 치는 전체 주소예요. 지금까지 배운 것이 모두 들어 있어요.

    https://프로토콜
    blog.서브도메인
    example.com도메인
    :443포트 (보통 생략)
    /posts/1경로 (어느 페이지)
    ?sort=new쿼리 (추가 조건)
    #comments해시 (페이지 안 위치)
    이 장의 핵심
    • IP는 숫자 주소, 포트는 그 안의 문 번호, 도메인은 외우기 쉬운 이름이에요.
    • DNS가 이름을 IP로 바꿔 줘요. A 레코드는 “이름 → IPv4”, CNAME은 “이름 → 다른 이름”이에요.
    • DNS를 바꾸면 TTL만큼 기다려야 모두에게 반영돼요.
    06

    서버와 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
    # 접속하면 이제부터는 서버 컴퓨터에 명령하는 거예요. 나가려면 exit

    SSH(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 apache2sudo systemctl reload nginx

    vhost (가상 호스트)

    05장의 DNS 표에서 example.com과 blog.example.com이 같은 IP를 가리켰어요. 그러면 서버는 손님이 어느 사이트를 원하는지 어떻게 알까요?

    브라우저는 부탁을 보낼 때 Host: blog.example.com처럼 찾아온 이름을 함께 적어 보내요. 웹서버는 이 이름표를 보고 알맞은 사이트로 안내해요. 이렇게 서버 한 대에 여러 사이트를 나눠 담는 기능을 vhost(Virtual Host, 가상 호스트)라고 해요. 엔진엑스에서는 같은 기능을 server 블록이라고 불러요.

    손님(브라우저)의 부탁 Host: example.com 회사 홈페이지 보여 줘 Host: blog.example.com 블로그 보여 줘 Host: docs.example.com 설명서 보여 줘 서버 1대 IP 203.0.113.10 · 포트 80/443 Apache (안내 데스크) Host 이름표를 보고 맞는 vhost 설정을 골라요 세 도메인 모두 A 레코드가 이 IP를 가리켜요 각자 다른 폴더나 앱 /var/www/main 홈페이지 파일 (정적) localhost:3000 Node.js 블로그 앱 (동적) /var/www/docs 설명서 파일 (정적)
    IP는 하나, 사이트는 셋이에요. 안내 데스크가 손님의 Host 이름표를 보고 각자의 매장으로 보내 줘요. HTTPS에서는 암호화된 통로를 열기 전에 SNI(Server Name Indication)라는 방식으로 이름을 먼저 알려 줘서 같은 일이 가능해요.

    아파치 vhost 설정 예시 (정적 사이트)

    /etc/apache2/sites-available/docs.conf
    <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 암호화, 방문 기록, 나쁜 접속 차단 같은 일을 안내 데스크 한 곳에서 맡을 수 있어요. 앱은 요리에만 집중하면 돼요.

    /etc/apache2/sites-available/blog.conf — 아파치
    <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로 프록시 기능을 켜야 해요.

    /etc/nginx/sites-available/blog — 같은 일을 엔진엑스로
    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)과 연결해요.
    07

    배포 방식웹 서비스를 서버에 올리기: 파일 복사부터 Docker, 자동 배포까지

    내 컴퓨터에서 만든 걸 어떻게 서버로 옮기고, 계속 켜 둘까?

    배포(deploy)는 내 컴퓨터에서 만든 코드를 서버에 올려서 사람들이 실제로 쓸 수 있게 하는 것이에요.

    배포 전에는 보통 빌드를 해요. 빌드는 사람이 읽기 좋게 쓴 코드를 컴퓨터가 빨리 읽을 수 있게 바꾸고 압축하는 과정이에요. TypeScript를 JavaScript로 바꾸는 일도 여기서 해요. 결과물은 보통 dist/(distribution, 배포용)나 build/ 폴더에 생겨요.

    배포 방법은 시간이 흐르며 발전해 왔고, 지금도 서비스마다 섞어서 써요. 쉬운 것부터 정리해 볼게요.

    이 장은 서버에 올리는 웹 서비스의 배포를 다뤄요. 휴대폰 앱과 설치형 프로그램은 사용자 기기에 직접 깔리기 때문에 길이 달라요. 그건 08장에서 다뤄요.

    방식어떻게 하나좋은 점아쉬운 점어울리는 곳
    ① 파일 올리기
    SFTP + Apache
    빌드한 파일을 서버 폴더에 복사해요가장 쉬워요사람 손으로 해서 실수가 잦고 기록이 안 남아요정적 사이트, 오래된 PHP 사이트
    ② 서버에서 git pullSSH로 들어가 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장)이 프로그램을 어떻게 실행하느냐에서 와요.

    PHPNode.jsJava
    사는 방식요청이 올 때마다 처음부터 실행하고, 끝나면 정리프로그램 하나가 계속 켜져서 모든 요청을 받음프로그램 하나가 계속 켜져서 모든 요청을 받음
    식당으로 치면주문마다 요리사가 출근해서 요리하고 퇴근요리사가 하루 종일 주방에 상주요리사가 상주. 대신 출근 전 교육(컴파일)이 필요
    서버에 올릴 때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                          # 지금 켜져 있는 앱 목록을 기억

    실무에서는 설정을 파일로 남겨 둬요. 그러면 팀원 누구나 같은 방식으로 켤 수 있어요.

    ecosystem.config.js
    module.exports = {
      apps: [{
        name: "blog",
        script: "server.js",
        exec_mode: "cluster",     // 같은 앱을 여러 개 띄우는 모드
        instances: 2,              // 2개를 띄워서 일을 나눠요
        env: { NODE_ENV: "production", PORT: 3000 }
      }]
    };
    // 실행: pm2 start ecosystem.config.js
    쉽게 말하면

    PM2는 가게가 문 닫지 않게 밤새 지키는 야간 관리인이에요. 다른 언어에도 같은 역할을 하는 도구가 있어요. 리눅스에 기본으로 들어 있는 systemd가 대표적이고, Docker를 쓰면 Docker가 이 일을 대신하기도 해요.

    ④ Docker: 어디서나 똑같이 돌아가는 상자

    개발자들이 가장 많이 하는 말 중 하나가 “제 컴퓨터에서는 되는데요?”예요. 내 컴퓨터는 Node 24인데 서버는 Node 18이거나, 서버에 필요한 프로그램이 빠져 있으면 생기는 문제예요.

    Docker(도커)는 앱과, 그 앱이 돌아가는 데 필요한 모든 것(리눅스 기본 파일, 런타임, 부품, 설정)을 규격이 정해진 상자 하나에 담는 도구예요. 화물선 컨테이너는 안에 뭐가 들었든 같은 크레인으로 옮길 수 있잖아요. Docker 상자도 Docker가 설치된 컴퓨터라면 어디서든 똑같이 실행돼요.

    Dockerfile

    레시피

    상자를 어떻게 만들지 적은 글이에요. “Node 24를 깔고, 코드를 복사하고, 이 명령으로 켜라.”

    이미지 (Image)

    붕어빵 틀

    레시피대로 만든 완성품 틀이에요. 바뀌지 않고, Docker Hub 같은 보관소에 올려 나눠 쓸 수 있어요.

    컨테이너 (Container)

    붕어빵

    틀로 찍어 낸, 실제로 돌아가는 앱이에요. 틀 하나로 여러 개를 동시에 찍어 낼 수 있어요.

    Dockerfile 레시피 (글자 파일) docker build 이미지 붕어빵 틀 (blog:1.0) docker run 컨테이너 1 · 실행 중 컨테이너 2 · 실행 중 컨테이너 3 · 실행 중
    Dockerfile — Node.js 블로그 앱
    # 기본 재료: 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는 상자들의 관계를 파일 하나에 적어 두고, 명령 한 줄로 전부 켜 줘요.

    compose.yaml
    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가 대표적이에요.

    .github/workflows/deploy.yml
    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는 테스트·빌드·배포를 자동으로 해 줘요. 문제가 생기면 롤백부터 해요.
    08

    앱·프로그램 출시스토어 심사, 설치 파일, 업데이트까지

    웹이 아니라 앱이나 설치형 프로그램이라면, 어떻게 사람들 손에 들어갈까?

    웹은 서버 한 곳만 바꾸면 모두가 새 버전을 봐요. 하지만 앱과 설치형 프로그램은 사용자 기기 하나하나에 복사본이 깔려요. 그래서 내놓기 전에 확인할 것이 더 많고, 한번 내놓으면 되돌리기도 어려워요. 그래서 이 과정을 보통 “출시” 또는 “릴리스”(release)라고 따로 불러요.

    출시 전에 공통으로 챙길 것

    챙길 것무슨 뜻
    버전 번호1.4.2처럼 점으로 나눈 번호예요. 보통 유의적 버전 규칙을 따라서, 크게 바뀌면 앞자리, 기능이 늘면 가운데, 버그만 고치면 끝자리를 올려요. 스토어에는 이와 따로, 올릴 때마다 커지는 빌드 번호도 넣어요
    출시용 빌드개발 중에 쓰던 디버그 빌드가 아니라, 빠르고 작게 다듬은 릴리스 빌드를 만들어요
    코드 서명“이 프로그램은 내가 만들었고, 중간에 누가 바꾸지 않았다”는 디지털 도장이에요(코드 서명). 서명이 없으면 스토어가 받아 주지 않거나 OS가 경고를 띄워요
    소개 자료아이콘, 스크린샷, 설명, 개인정보처리방침 주소, 연령 등급 같은 정보를 준비해요
    먼저 써 보기정식 출시 전에 일부 사람에게만 먼저 나눠 주고 확인받아요(베타 테스트)
    주의 · 서명 키는 비밀번호만큼 소중해요

    서명에 쓰는 키와 인증서 파일은 .env처럼 Git에 올리지 말고 안전한 곳에 따로 보관해요. 잃어버리면 같은 앱의 업데이트를 올리기가 아주 번거로워지거나 아예 막힐 수 있어요. 스토어가 키를 대신 보관해 주는 기능(Google Play 앱 서명 등)이 있으면 켜 두세요.

    휴대폰 앱: 스토어에 올리기

    iPhone 앱은 Apple의 App Store에, Android 앱은 Google Play에 올리는 게 기본이에요. 순서는 두 스토어가 거의 같아요.

    1. 개발자 계정 만들기Apple Developer Program은 1년에 99달러, Google Play 개발자 계정은 처음 한 번 25달러예요(2026년 11월 기준). 회사 이름으로 올리려면 사업자 확인 서류가 더 필요해요.
    2. 출시용 빌드를 만들고 서명하기iOS는 Xcode에서 서명한 빌드를 App Store Connect에 올려요. Android는 서명한 앱 번들(.aab) 파일을 Play Console에 올려요.
    3. 먼저 몇 명에게만 나눠 주기iOS는 TestFlight, Android는 내부·비공개 테스트 트랙으로 팀원과 테스터에게 먼저 설치하게 해요. Google Play에 개인 계정을 새로 만들었다면, 정식 출시 전에 테스터 12명 이상과 14일 동안 비공개 테스트를 해야 해요.
    4. 스토어 정보 채우기스크린샷, 설명, 개인정보처리방침 주소를 넣고, 앱이 어떤 개인정보를 모으는지 적어요(App Store의 개인정보 보호 라벨, Google Play의 데이터 보안 섹션).
    5. 심사 받기스토어의 사람과 자동 검사가 규칙을 지켰는지 확인해요(앱 심사). 보통 하루에서 며칠 걸리고, 처음 내는 앱은 더 오래 걸리기도 해요.
    6. 출시하기통과하면 바로 내놓거나 날짜를 정해 내놓아요. 사용자 일부에게만 먼저 업데이트를 퍼뜨리는 단계적 출시도 할 수 있어요.
    주의 · 심사에서 자주 거절되는 이유
    • 실행하자마자 멈추거나(크래시), 눌러도 반응이 없는 버튼이 있어요.
    • 로그인이 필요한 앱인데 심사용 테스트 계정을 주지 않았어요.
    • 개인정보처리방침이 없거나, 실제로 모으는 정보와 적은 내용이 달라요.
    • 회원 가입은 되는데 앱 안에서 탈퇴(계정 삭제)를 할 수 없어요.
    • 앱 안에서 구독이나 게임 아이템 같은 디지털 상품을 팔면서 스토어의 결제 규칙을 따르지 않았어요(나라마다 예외가 있어요).
    실무에서는 · 앱은 되돌리기가 어려워요

    웹은 문제가 생기면 이전 버전으로 롤백하면 돼요. 앱은 이미 사용자 휴대폰에 깔린 버전을 내가 지울 수 없어요. 고친 버전은 다시 심사를 받아야 하고, 업데이트하지 않는 사람도 많아요. 그래서 팀들은 이렇게 대비해요.

    • 서버의 API를 바꿀 때는 옛 버전 앱도 계속 동작하게 해요.
    • 꼭 필요할 때 “새 버전으로 업데이트해 주세요” 화면을 띄울 수 있게 미리 만들어 둬요(강제 업데이트).
    • 새 기능은 서버 설정으로 켜고 끌 수 있게 만들어서, 문제가 생기면 앱을 다시 내지 않고 꺼요.
    • React Native처럼 JavaScript로 만든 앱은 일부 코드를 심사 없이 바꾸는 방법(OTA 업데이트)도 있어요. 다만 앱의 주요 기능을 바꾸면 안 된다는 스토어 규칙을 지켜야 해요.

    설치형 프로그램: 설치 파일로 나눠 주기

    컴퓨터용 프로그램은 스토어 없이도 내놓을 수 있어요. 홈페이지에 설치 파일을 올려 두고 내려받게 하는 방식이 가장 흔해요. OS마다 설치 파일 형식과 주의할 점이 달라요.

    OS설치 파일스토어 · 패키지 관리자주의할 점
    Windows.exe 설치 프로그램, .msi, .msixMicrosoft Store, winget서명이 없으면 “Windows의 PC 보호” 경고가 떠서 사용자가 불안해해요. 코드 서명 인증서로 서명해요
    macOS.dmg (끌어다 놓는 디스크 이미지), .pkgMac App Store, Homebrew서명과 공증이 없으면 기본 설정에서 바로 열리지 않아요. Apple 개발자 인증서로 서명하고 Apple에 공증을 받아요
    Linux.deb, .rpm, AppImageFlathub (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%에게만 먼저 업데이트를 내보낼게요.

    이 장의 핵심
    • 앱과 설치형 프로그램은 사용자 기기마다 복사본이 깔려서, 웹보다 되돌리기가 어려워요.
    • 출시 전에 버전 번호, 코드 서명, 베타 테스트를 챙기고, 스토어 앱은 심사를 통과해야 해요.
    • 내놓은 뒤에는 크래시 리포트와 업데이트 방법(강제 업데이트, 자동 업데이트)으로 지켜봐요.
    09

    실전: 서버에 직접 배포하기다 만든 블로그 앱을 blog.example.com에 손으로 올려 보기

    지금까지 배운 걸 한 번에 엮어 봐요. 상황은 이래요. Node.js로 만든 블로그 앱이 있고, 이미 example.com이 돌아가는 서버(203.0.113.10)에 서브도메인으로 추가하려고 해요. 방식은 ③(아파치 리버스 프록시 + PM2)을 써요. 각 단계 옆에 관련된 장을 적어 뒀어요.

    1. 로컬에서 만들고 합치기 03 · 04장브랜치에서 작업 → PR → 리뷰 → main에 합치기.
    2. 서버에 접속하기 06장
      내 컴퓨터
      ssh ubuntu@203.0.113.10
    3. 코드 받고 설치·빌드하기 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는 터미널용 메모장)
    4. PM2로 앱 켜기 07장
      서버
      pm2 start ecosystem.config.js
      pm2 save
      curl http://127.0.0.1:3000     # 서버 안에서 앱이 답하는지 확인
      curl(Client URL)은 터미널에서 주소를 열어 보는 도구예요. 글자로 된 HTML이 나오면 앱이 살아 있는 거예요.
    5. DNS에 A 레코드 추가하기 05장도메인 관리 화면에서 이름 blog, 종류 A, 값 203.0.113.10을 추가해요. 잠시 뒤 nslookup blog.example.com으로 IP가 나오는지 확인해요.
    6. 아파치 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
    7. 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가 먼저 연결돼 있어야 인증서를 받을 수 있어요.
    8. 확인하기브라우저에서 https://blog.example.com을 열어 자물쇠 표시와 화면을 확인해요. 안 되면 pm2 logs blog와 아파치 오류 기록을 봐요.
    9. 다음 배포부터는서버에서 git pull → npm ci → npm run build → pm2 restart blog만 하면 돼요. 이 반복 작업을 GitHub Actions로 자동화하면 ⑤ CI/CD가 돼요.
    Docker로 한다면

    3~4단계가 docker compose up -d --build 한 줄로 바뀌어요. 5~7단계(DNS, vhost, HTTPS)는 똑같아요. 앱을 어떤 방식으로 켜든, 손님이 찾아오는 길(도메인 → DNS → IP → 웹서버 → 앱)은 같다는 걸 기억하세요.

    교과서 전체의 핵심
    • 코드는 로컬에서 만들고, Git으로 기록·공유하고, 배포로 서버에 올려요.
    • 손님은 도메인 → DNS → IP·포트 → 웹서버(vhost) → 앱 → 데이터베이스 순서로 찾아와요.
    • 문제가 생기면 이 길을 앞에서부터 하나씩 확인하세요. DNS가 맞나? 서버에 닿나? 웹서버 설정이 맞나? 앱이 켜져 있나? 이게 실무의 문제 해결 순서예요.
    10

    실전: AI와 함께 개발하기새로 만들기, 고치고 가꾸기, 그리고 AI에게 잘 설명하기

    AI를 어떤 순서로, 얼마만큼의 정보를 줘서 써야 싸고 확실하게 일을 끝낼 수 있을까?

    개발자의 일은 크게 두 가지예요. 없던 것을 새로 만드는 일과, 이미 있는 것을 고치고 가꾸는 일이에요. 실제로는 두 번째가 훨씬 많아요. 둘 다 AI가 도와줄 수 있지만 쓰는 방법이 달라요. 그리고 두 경우 모두, 결과는 AI에게 무엇을 얼마나 알려 주느냐에 따라 크게 달라져요.

    이 장에서는 AI에게 주는 지시문을 프롬프트라고 불러요. 복사 버튼으로 그대로 가져다 쓸 수 있어요.

    09장에서는 사람이 모든 명령을 직접 쳤어요. 요즘은 이 과정의 상당 부분을 AI가 도와줘요. 다만 AI를 “아무거나, 아무렇게나” 쓰면 돈과 시간이 오히려 더 들어요. 이 장의 원칙은 하나예요. 무료로 할 수 있는 건 끝까지 무료로 하고, 돈은 일이 가장 많은 곳 한 곳에만 써요.

    먼저, 챗봇과 에이전트는 달라요

    둘 다 속에는 LLM(Large Language Model, 거대 언어 모델)이라는 같은 종류의 AI가 들어 있어요. 차이는 손발이 있느냐예요.

    AI 챗봇

    똑똑한 상담사

    대화로 질문에 답하고 글을 써 줘요. 코드를 알려 줘도, 그걸 파일에 넣고 실행하는 건 내가 해요. 예: Claude, ChatGPT, Gemini의 채팅 화면

    AI 에이전트

    손발이 있는 조수

    내 프로젝트 폴더의 파일을 직접 읽고, 고치고, 터미널 명령을 실행하고, 결과를 보고 다시 고쳐요. 목표를 주면 여러 단계를 스스로 이어서 해요. 예: 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
    Google
    구글 검색·문서·드라이브와 연결무료 앱은 가벼운 모델로 자동 연결되는 경우가 많아 긴 글 품질은 다소 낮다는 평이에요구글 문서로 일하는 팀, 사실 확인

    이 교과서도 AI(Claude)가 함께 썼어요. 그래서 위 비교는 AI 스스로의 판단이 아니라 바깥 비교 글들을 근거로 적었어요.

    화면 틀 잡기 도구 (3단계)

    도구특징무료로 할 수 있는 것
    Bolt말로 설명하면 앱 전체를 만들어 브라우저에서 바로 실행해 줘요무료 사용량이 넉넉한 편이라는 평이 많아요
    Lovable로그인, 데이터 저장까지 있는 앱을 만들고 GitHub로 내보내기 쉬워요하루 몇 번씩 쓸 수 있는 크레딧
    v0
    Vercel
    React 화면 시안에 강해요적은 양의 무료 크레딧 (조건이 자주 바뀌어요)
    챗봇의 미리보기 기능Claude의 아티팩트, ChatGPT의 캔버스처럼 대화창에서 화면을 바로 그려 줘요챗봇 무료 사용량 안에서
    주의

    무료 플랜으로 만든 결과는 보통 그 회사 주소(xxx.lovable.app 등)에 올라가고, 내 도메인을 붙일 수 없어요. 3단계 결과물은 보고 결정하는 용도로만 쓰고, 버려도 아깝지 않다고 생각하세요. 진짜 코드는 4단계에서 내 Git 저장소에 쌓아요.

    코딩 에이전트 (4~6단계, 하나만 고르기)

    에이전트어떻게 쓰나대략적인 비용이런 사람에게
    GitHub CopilotVS Code 안에서 자동 완성과 에이전트 모드무료 플랜 있음, 유료는 월 약 10달러부터가장 싸게 시작하고 싶을 때
    Claude Code터미널이나 데스크톱 앱에서 프로젝트 전체를 다뤄요Claude 유료 구독(월 약 20달러)부터. 무료 플랜에는 없어요큰 작업을 맡기고 꼼꼼한 결과를 원할 때
    Codex
    OpenAI
    터미널, 에디터, 웹에서 작업ChatGPT 플랜에 묶여 있어요. 무료에선 아주 적게, 유료(월 약 20달러)에서 넉넉하게이미 ChatGPT를 구독 중일 때
    CursorAI가 들어간 코드 에디터무료 체험 + 유료 플랜 (요금제가 자주 바뀌어요)에디터 화면에서 보면서 고치고 싶을 때
    가장 경제적인 조합
    • 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장의 기획자가 만드는 바로 그 문서예요.

    프롬프트 ② — 한 장짜리 기획서(PRD)로 정리
    지금까지 대화를 한 장짜리 기획서로 정리해 줘. 형식은 아래와 같이.
    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 저장소 안에서 일하게 해요.

    1. 빈 저장소 만들고 PRD 넣기프로젝트 폴더에 docs/PRD.md로 기획서를 저장하고 첫 커밋을 해요. 에이전트가 언제든 읽을 수 있는 “설계도”가 돼요.
      터미널
      mkdir room-booking && cd room-booking
      git init
      mkdir docs           # 여기에 PRD.md 저장
      git add . && git commit -m "docs: 기획서 추가"
    2. 프로젝트 규칙 파일 만들기에이전트가 매번 읽는 “우리 팀 규칙”이에요. 도구마다 이름이 달라요. 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 로
        - 모르는 것은 추측하지 말고 나에게 묻는다
    3. 계획부터 세우게 하기바로 코드를 쓰게 하지 말고, 작업 순서를 먼저 받아서 내가 확인해요. 많은 에이전트에 “계획 모드”가 따로 있어요.
      프롬프트 ⑤ — 에이전트에게 첫 지시
      docs/PRD.md 를 읽고, 이 사이트를 만드는 작업을
      30분~1시간짜리 작은 단계 8~12개로 나눈 계획을 docs/PLAN.md 에 써 줘.
      각 단계에는 "끝났는지 확인하는 방법"을 적어 줘.
      아직 코드는 쓰지 마.
    4. 한 단계씩 맡기고, 단계마다 커밋하기“PLAN.md의 1단계를 해 줘. 끝나면 테스트를 돌리고 결과를 알려 줘.” → 결과를 내 눈으로 확인 → git commit → 다음 단계. 커밋이 세이브 포인트라서, AI가 망쳐도 바로 전 단계로 돌아갈 수 있어요(04장).
    5. 막히면 상황을 정확히 주기“안 돼요” 대신 오류 메시지 전체, 내가 한 행동, 기대한 결과를 함께 줘요. 브라우저 개발자 도구(F12)의 오류나 터미널 출력을 그대로 붙여 넣으면 가장 빨라요.
    쉽게 말하면 · 에이전트에게 일 잘 시키는 법
    • 작게 자르기: “사이트 다 만들어 줘”보다 “예약 목록 화면만 만들어 줘”가 훨씬 정확하고 사용량도 덜 들어요.
    • 새 작업은 새 대화로: 한 단계가 끝나면 대화를 새로 시작해요. 필요한 정보는 PRD, PLAN, 규칙 파일에 있으니까요.
    • 확인은 내가: AI가 “다 됐어요”라고 해도 직접 실행해서 눌러 보기 전까지는 끝난 게 아니에요.

    5단계: 완성도 높이기

    돌아가는 것과 믿을 수 있는 것은 달라요. 아래 네 가지를 순서대로 해요.

    점검누가어떻게
    테스트에이전트“PRD의 기능마다 테스트가 있는지 확인하고, 없는 건 만들어 줘. 두 사람이 같은 시간을 동시에 예약하는 경우도 꼭.”
    코드 리뷰다른 회사 AI (무료)바뀐 내용(git diff)이나 PR을 보여 주고 버그, 보안, 읽기 어려운 부분을 찾게 해요 (프롬프트 ⑥)
    보안 점검에이전트 + 나비밀 값이 코드에 들어갔는지, 로그인 안 한 사람이 남의 예약을 지울 수 있는지 확인해요
    사람 확인나와 동료휴대폰과 컴퓨터에서 직접 눌러 봐요. 02장의 QA 역할이에요
    프롬프트 ⑥ — 다른 AI에게 코드 리뷰
    너는 꼼꼼한 시니어 개발자야. 아래 코드 변경을 리뷰해 줘.
    중요한 순서대로:
    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는 어느 날까지의 자료로 공부를 마쳐요. 그래서 그 뒤에 나온 버전이나 바뀐 사용법은 모를 수 있어요. 라이브러리 업데이트처럼 최신 정보가 중요한 일에는 공식 문서나 변경 안내문을 직접 붙여 넣거나, 검색이 되는 AI를 쓰세요.

    문제 해결 6단계

    AI가 있어도 문제를 푸는 순서는 똑같아요. 오히려 이 순서를 지켜야 AI에게 줄 정보가 저절로 모여요.

    1. 다시 일으켜 보기 (재현)“어떻게 하면 이 문제가 다시 생기는지”를 찾아요. 이걸 재현이라고 해요. 재현이 되면 문제의 절반은 푼 거예요. “가끔 된다”면 언제 되고 언제 안 되는지 차이를 적어요.
    2. 범위 좁히기09장의 길을 앞에서부터 확인해요. 도메인이 IP를 잘 가리키나(DNS)? 서버에 닿나? 웹서버 설정이 맞나? 앱이 켜져 있나? 데이터베이스가 답하나? 브라우저 쪽(프론트) 문제인지 서버 쪽(백엔드) 문제인지만 갈라도 크게 좁혀져요.
    3. 증거 모으기오류 메시지 전체, 로그, 브라우저 개발자 도구의 오류와 네트워크 탭, 그리고 최근에 바뀐 것을 모아요. 어제까지 됐다면 범인은 대개 그 사이의 변경이에요.
      터미널 — 최근에 무엇이 바뀌었나
      git log --oneline -10       # 최근 커밋 10개
      git diff HEAD~3 --stat      # 최근 커밋 3개에서 바뀐 파일 목록
      pm2 logs blog --lines 50    # 앱 로그 마지막 50줄 (Docker라면 docker compose logs --tail 50)
    4. AI에게 묻기모은 증거를 Part C의 틀에 맞춰 줘요. 이때 “고쳐 줘”보다 “가능한 원인을 확률 높은 순서로 3개, 각각 확인하는 방법과 함께”를 먼저 물어보면 엉뚱한 수정을 피할 수 있어요.
    5. 한 번에 하나씩 바꾸기AI가 알려 준 원인을 하나씩 확인해요. 여러 군데를 한꺼번에 바꾸면 무엇이 효과가 있었는지 모르게 돼요. 바꾸기 전에 커밋해 두면 언제든 되돌릴 수 있어요.
    6. 고친 뒤 다시 안 생기게 하기1단계의 재현 방법을 테스트로 만들어 두면 같은 버그가 돌아오지 않아요. 커밋 메시지에는 원인을 적어요. 예: fix: 같은 시간 중복 예약 (저장 전 겹침 검사 누락)

    장애가 났을 때: 고치기보다 살리기가 먼저

    사용자가 쓰는 사이트가 멈췄다면 순서가 달라져요.

    1. 팀에 알리기혼자 해결하려고 숨기지 마세요. “지금 ○○가 안 됩니다, 확인 중입니다” 한 줄이면 돼요.
    2. 최근 배포가 있었다면 롤백원인을 몰라도 이전 버전으로 되돌리면 대부분 살아나요(07장).
    3. 살린 다음 원인 찾기위의 문제 해결 6단계를 차분히 해요. AI에게 로그를 보여 주는 건 이때예요.
    4. 기록 남기기무슨 일이 있었고, 왜 생겼고, 어떻게 막을지 짧게 적어요. 이걸 포스트모템(사후 분석)이라고 해요. 누구 탓인지가 아니라 무엇을 바꿀지를 적어요.
    판교 사투리

    서버 터졌어요! 일단 롤백하고 로그 까 볼게요.서버에 장애가 났어요. 먼저 이전 버전으로 되돌리고, 기록(로그)을 열어 원인을 찾아볼게요.

    원인 파악되면 팔로업 드릴게요.원인을 알게 되면 이어서 알려 드릴게요.

    남이 짠 코드를 AI와 함께 이해하기

    유지보수는 대부분 내가 짜지 않은 코드에서 일어나요. 처음 보는 프로젝트라면 이렇게 물어보세요.

    프롬프트 ⑧ — 처음 보는 프로젝트의 지도 그리기
    이 프로젝트를 처음 맡은 사람에게 설명하듯 알려 줘.
    1. 이 프로젝트가 하는 일을 세 문장으로
    2. 폴더별 역할 (중요한 것 위주로 5~8개)
    3. 사용자가 "예약하기" 버튼을 누르면 어떤 파일들을 거쳐서 저장되는지 순서대로
    4. 처음 고칠 때 조심해야 할 부분
    코드를 고치지는 마.
    
    [챗봇이라면 아래 "파일 목록" 결과와 핵심 파일 2~3개를 붙여 넣기]
    [에이전트라면 이 문장 없이 그대로 요청]
    터미널 — 챗봇에게 줄 파일 목록 만들기
    # Git이 관리하는 파일만 보여 줘서 node_modules 같은 건 빠져요
    git ls-files | head -100

    Part C

    AI에게 잘 설명하는 법: 토큰은 아끼고 성공률은 높이기

    AI는 글을 토큰이라는 작은 조각 단위로 읽고 써요. 영어 단어 하나가 대략 토큰 하나 정도이고, 한국어는 같은 내용이라도 토큰이 더 드는 편이에요. 유료 요금과 무료 사용량 제한은 모두 이 토큰 수로 계산돼요. 내가 보낸 글(입력)과 AI가 쓴 글(출력)을 모두 세요.

    여기서 많은 사람이 모르는 사실이 있어요. AI는 대화의 앞부분을 따로 기억하지 않아요. 내가 메시지를 하나 보낼 때마다 지금까지의 대화 전체를 처음부터 다시 읽어요. 그래서 대화가 길어질수록 메시지 하나의 값이 점점 비싸지고, 앞에서 했던 틀린 추측도 계속 따라다녀요.

    쉽게 말하면

    AI는 매번 처음 만나는 아주 똑똑한 전문가예요. 내 사정을 전혀 모르니 필요한 건 빠짐없이, 하지만 시간(토큰)은 돈이니 필요 없는 건 빼고 말해야 해요. 병원에서 의사에게 증상을 말하는 것과 같아요. “배가 아파요”보다 “어제 저녁부터 오른쪽 아랫배가 아프고, 열이 38도예요”가 훨씬 빨리 정확한 답을 받아요.

    좋은 질문의 네 가지 재료

    1 · 목표

    무엇을 하려고 했나

    “예약 버튼을 누르면 예약이 저장되고 목록에 보여야 해요.” 기대한 결과가 있어야 AI가 무엇이 틀렸는지 알아요.

    2 · 증상과 증거

    실제로 무슨 일이 났나

    오류 메시지 전체를 그대로 복사해요. 요약하거나 다시 타이핑하지 마세요. 화면이 문제라면 스크린샷 한 장이 긴 설명보다 나아요.

    3 · 범위

    어디까지 봤나

    관련 코드(함수 단위), 환경(로컬인지 서버인지, 버전), 재현 방법, 이미 해 본 것. 해 본 것을 말하지 않으면 AI가 같은 제안을 반복해요.

    4 · 기준

    무엇이면 해결인가

    “이 재현 순서대로 했을 때 오류가 안 나고, 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와 일할 때 꼭 지킬 것
    • 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)을 참고했어요. 자주 바뀌니 각 회사의 공식 가격 페이지를 확인하세요.

    11

    용어 사전본문의 점선 밑줄 단어가 모두 여기 있어요

    코드에서 출시까지 · 2026년 11월 작성. 명령어는 Ubuntu 서버와 최신 macOS·Windows 기준이에요. 스토어 요금과 정책은 바뀔 수 있으니 출시 전에 공식 안내를 확인하세요. 프로젝트마다 도구와 절차가 다를 수 있으니, 실제 프로젝트에서는 그 프로젝트의 문서를 먼저 따르세요.