Blog Post

Think. Prompt. Create – A New Way to Build Software – My AI Smarteasy와 책 읽기 – 사용자 정의 코파일럿 AI 에이전트 – 일타 저스틴

29 7월 2026
0 Comment

안녕하세요! 여러분의 전담 강사 저스틴(Justin)입니다. 복잡하고 어려운 개념을 여러분의 눈높이에 맞춰 뼈대부터 차근차근 짚어드리는 역할을 맡고 있죠.

오늘 우리가 함께 파고들 책은 Joey Primiani의 《Think. Prompt. Create》“A New Way to Build Software (소프트웨어를 만드는 새로운 방식)”입니다.

 

STAGE 1 — Why It Matters: 내 아이디어는 왜 늘 생각으로만 끝났을까?

혹시 살면서 “아, 이런 앱 하나 있으면 정말 편할 텐데…” 하고 생각해보신 적 있으신가요? 아마 한 번쯤은 있으실 겁니다. 하지만 그 아이디어를 실제로 만들어본 분은 많지 않을 거예요. 왜일까요?

원작자 Joey Primiani는 책의 시작에서 아주 흥미로운 숫자를 제시합니다.

“AI does not make humans less necessary. It makes us more capable.”
“AI는 인간을 필요 없게 만드는 것이 아니라, 우리를 더 유능하게 만듭니다.”

전 세계 인구는 80억 명입니다. 그런데 전문적으로 코드를 짜는 개발자는 약 2,700만 명에 불과합니다. 전체 인구의 0.3% 정도만 소프트웨어를 직접 만들 수 있는 ‘열쇠’를 쥐고 있었던 셈이죠.

나머지 99.7%의 사람들에게 “아이디어가 있다”는 것과 “제품으로 만들어냈다” 사이의 거리는 까마득히 멀었습니다. 수년간 코딩을 공부하거나, 비싼 돈을 주고 개발자를 고용해야만 했죠. 그래서 수많은 위대한 아이디어가 세상에 나오지도 못하고 사라졌습니다.

하지만 지금, 그 거대한 격차가 무너지고 있습니다. 

STAGE 2 — Unpacking the Core Concept: Claude Code는 ‘요술봉’이 아니라 ‘최고의 파트너’입니다

이 책에서 다루는 중심 도구는 바로 ‘Claude Code’입니다.

Claude Code가 무엇일까요? 저자는 이 도구를 “요술봉이 아니다”라고 단언합니다. 내가 자고 있는 동안 알아서 완벽한 앱을 뚝딱 만들어주는 그런 마법은 아니라는 뜻이죠.

대신 Claude Code를 이렇게 생각해 보세요. 인터넷에 존재하는 거의 모든 코드를 읽어보았고, 절대 지치지 않으며, 내가 무엇을 만들고 싶은지 말하면 쉬운 언어로 설명해 주면서 함께 코드를 짜주는 ‘옆자리의 수석 개발자’입니다.

핵심은 ‘어떻게(How)’ 구현할지의 지루한 문법은 AI에게 맡기고, 여러분은 ‘무엇을(What)’ 만들지에 집중하는 것입니다. “구글 로그인 기능을 넣어줘”라고 목적을 말하면, Claude Code가 그에 필요한 수백 줄의 코드를 번역하듯 적어주는 방식이죠.

STAGE 3 — Evidence and Application: “내가 다 안 짰는데, 진짜 내 작품일까요?”

AI로 코딩을 시작할 때 많은 초보자들이 뜻밖의 감정을 느낍니다. 바로 “내가 직접 코드를 타이핑하지 않았으니, 이건 내가 만든 게 아닌 것 같아”라는 일종의 죄책감입니다.

저자는 이 마음에 대해 단호하게 답합니다. “그 생각은 틀렸습니다.”

  • 망치 대신 ‘못총(네일건)’을 써서 집을 지은 목수에게 “너는 손으로 못을 박지 않았으니 목수가 아니야”라고 말할 수 있을까요?
  • 손으로 도면을 그리다가 ‘CAD 컴퓨터 프로그램’을 도입한 건축가에게 “진짜 건축이 아니다”라고 할 수 있을까요?

개발의 역사에서 도구는 늘 진화해 왔습니다. 중요한 것은 ‘내가 코드를 한 땀 한 땀 적었는가’가 아니라, ‘내가 원하는 문제를 해결하는 제품을 세상에 내놓았는가(Shipping)’입니다.

이 책의 목표는 코딩 이론을 깊게 파고드는 것이 아닙니다. 직접 만들어서 세상에 배포하는 것(Shipping)이 최우선 목표입니다. 이해는 만들다 보면 자연스럽게 따라옵니다.

STAGE 4 — Summary and Extension: 오늘 강의의 핵심 정리

오늘 내용을 3가지로 정리해 볼게요.

  1. 격차의 해소: AI는 개발자가 아닌 99.7%의 보통 사람들이 자신의 아이디어를 소프트웨어로 만들 수 있게 도와줍니다.
  2. 협력자로서의 AI: Claude Code는 마법이 아니라, 내 지시에 따라 복잡한 코드 문법과 오타를 대신 처리해 주는 유능한 동료입니다.
  3. 결과 중심 마인드셋: 코드를 직접 타이핑하지 않아도 괜찮습니다. 진짜 중요한 것은 ‘문제를 해결하는 제품을 세상에 출시하는 것’입니다.

 

지난 시간에는 AI 시대를 맞이하는 마음가짐에 대해 이야기했죠. 오늘은 Chapter 1, “Claude Code란 무엇인가? (전체적인 그림)”에 대해 이야기해보겠습니다.

본격적으로 터미널 창을 열고 명령어를 치기 전에, 우리가 사용할 도구가 ‘진짜 무엇인지’ 제대로 이해하는 것이 훨씬 중요합니다. 준비되셨나요?

STAGE 1 — Why It Matters: 생각의 틀(Mental Model)을 바꿔야 질문이 달라집니다

많은 사람들이 Claude Code를 처음 접할 때 “좀 더 똑똑한 오타 수정기” 정도로 생각합니다. 내가 코드를 치다가 막히면 힌트를 주고, 작성한 코드를 복사해서 내 컴퓨터에 붙여넣는 용도로 쓰죠.

하지만 저자인 Joey Primiani는 이 관점이 Claude Code의 진짜 능력을 아주 작게 제한해 버린다고 지적합니다. 저자는 이렇게 정의합니다.

“Claude Code is a senior developer who is sitting next to you”
“Claude Code는 여러분의 바로 옆에 앉아 있는 수석 개발자입니다.”

단순한 ‘자동 완성 도구’가 아니라 ‘수석 동료 개발자’라는 생각의 틀(Mental Model)을 갖는 순간, 여러분이 Claude Code를 다루는 방식이 완전히 달라집니다.

  • 지시의 단위가 커집니다: 진짜 수석 개발자에게 “함수 이름은 이렇게 짓고, 변수는 이렇게 만들어줘”라고 일일이 말하지 않죠? 대신 “우리 앱에 로그인 기능을 추가해 줘”라고 말합니다. Claude Code도 마찬가지입니다.
  • 문맥(Context)을 줄수록 똑똑해집니다: 여러분의 프로젝트 사정을 잘 아는 개발자가 일을 더 잘하듯, Claude Code에게 프로젝트 정보를 더 많이 줄수록 결과물은 대단해집니다.
  • 검토는 여러분의 몫입니다: 아무리 뛰어난 수석 개발자라도 실수를 합니다. 여러분은 이 프로젝트의 ‘총괄 책임자(Product Owner)’로서 최종 결과를 확인하고 승인하는 역할을 맡게 됩니다.

AI를 바라보는 시선이 ‘도구’에서 ‘동료’로 바뀌는 것입니다.

STAGE 2 — Unpacking the Core Concept: Claude Code의 기술적 실체와 안전장치

그렇다면 Claude Code는 웹브라우저에서 쓰는 일반적인 AI(ChatGPT나 Claude.ai)와 무엇이 다를까요?

가장 큰 차이는 Claude Code에게 ‘손과 발’이 달려있다는 점입니다.

Claude Code는 터미널(검은색 명령 창)에서 실행되는 프로그램(CLI)입니다. 웹 브라우저 안에서 말만 하는 것이 아니라, 여러분 컴퓨터에 직접 접근할 수 있는 ‘도구(Tools)’를 가지고 있습니다.

  1. 파일 읽기/쓰기: 여러분의 코드 파일을 직접 열어보고, 새로 쓰거나 수정합니다.
  2. 명령어 실행: 프로그램 설치, 앱 실행, 테스트 구동을 알아서 터미널 명령어로 입력합니다.
  3. 검색: 프로젝트 전체를 훑어서 필요한 코드를 찾아냅니다.

“잠깐만요, 내 파일과 컴퓨터를 마음대로 건드리면 위험하지 않나요?”

당연히 걱정이 되실 겁니다! 그래서 Claude Code에는 ‘권한 모델(Permission Model)’이라는 안전장치가 있습니다.

기본 설정(Default Mode)에서 Claude Code는 위험할 수 있는 행동(파일 삭제, 외부 프로그램 설치 등)을 하기 직전에 반드시 여러분에게 허락을 구합니다.

처음 시작할 때는 이 기본 모드를 유지하면서, AI가 어떤 명령을 내리려 하는지 유심히 관찰해 보세요. 그 과정 자체가 훌륭한 공부가 됩니다.

STAGE 3 — Evidence and Application: 다른 AI 도구와의 차이 & 비밀 무기 CLAUDE.md

유명한 AI 코딩 도구들이 많은데요, Claude Code는 어디에 위치해 있을까요? 한눈에 비교해 드릴게요.

구분 GitHub Copilot Cursor Claude Code
주요 역할 다음 문장 자동 완성 AI 중심 코드 에디터 (화면) 프로젝트 전체를 이해하는 동료 (터미널)
작업 범위 한 줄 ~ 한 파일 단위 열려있는 파일 중심 프로젝트 전체 구조 및 복수 파일 동시 수정
강점 빠른 타이핑 보조 시각적인 편집 환경 아키텍처 설계, 테스트 실행, 복잡한 오류 해결

프로젝트의 기억 창고: CLAUDE.md

새로운 수석 개발자가 출근했을 때, 우리 회사만의 규칙을 담은 ‘인수인계 문서’를 주면 적응이 훨씬 빠르겠죠? Claude Code에게는 CLAUDE.md라는 파일이 바로 그 역할을 합니다.

프로젝트 폴더 안에 CLAUDE.md라는 텍스트 파일을 만들고, 아래처럼 적어두기만 하면 됩니다.

이렇게 써두면 Claude Code는 작업을 시작하기 전 이 파일을 먼저 읽고, 여러분 프로젝트의 규칙에 딱 맞는 코드를 작성해 줍니다.

STAGE 4 — Summary and Extension: Claude Code를 사용할 때 기억할 한계점

마지막으로, Claude Code를 최고로 잘 활용하기 위해 명심해야 할 점들을 정리해 드립니다.

  1. AI도 실수를 합니다: 코드가 완벽해 보여도 미세한 오류가 있을 수 있습니다. 항상 직접 실행해 보고 테스트하세요.
  2. 대화가 너무 길어지면 집중력이 떨어집니다: 한 대화 창에서 너무 오래 이야기하면 품질이 떨어집니다. 이럴 때는 /compact 명령을 치거나 대화를 새로 시작하는 것이 좋습니다.
  3. 최고의 스승입니다: Claude Code가 코드를 고쳐줄 때 “왜 이렇게 고쳤어?”라고 물어보세요. 쉬운 언어로 설명해 줄 겁니다. Claude Code와 함께 만드는 수백 시간이 여러분을 진짜 개발자로 만들어 줄 것입니다.

 

오늘은 Chapter 2, “Getting Set Up (설치, API 키, 그리고 비개발자를 위한 터미널 기초)”를 다룹니다.

기술 서적에서 ‘환경 설정’ 장은 가장 지루하거나, 반대로 가장 좌절하기 쉬운 구간입니다. 생소한 검은 창(터미널)이 나오고 오류 메시지가 뜨면 덜컥 겁부터 나기 때문이죠. 하지만 걱정하지 마세요! 오늘 저와 함께 한 단계씩 천천히 따라오시면 누구나 완벽하게 준비를 마칠 수 있습니다. 

STAGE 1 — Why It Matters: 검은색 터미널 창은 전혀 무섭지 않습니다

컴퓨터를 켰을 때 나오는 검은 화면에 흰 글씨, 일명 ‘터미널(Terminal)’을 처음 보면 영화 속 해커들이나 쓰는 것처럼 보입니다. 하지만 본질은 아주 단순합니다.

“the terminal is a text-based interface to your computer.”
“터미널은 컴퓨터를 다루는 텍스트 기반의 인터페이스일 뿐입니다.”

우리가 평소에 마우스로 폴더 아이콘을 ‘더블 클릭’해서 열듯, 터미널에서는 cd 폴더이름이라고 글자를 입력해서 여는 것뿐입니다. 클릭 대신 타이핑을 할 뿐, 컴퓨터를 제어한다는 목적은 똑같습니다.

  • Mac 사용자: Applications(응용 프로그램) → Utilities(기능) 안에 있는 Terminal을 켜시면 됩니다. (더 좋은 무료 프로그램인 iTerm2를 설치하시는 것도 추천합니다.)
  • Windows 사용자: 기본 명령어 창도 있지만, 저자는 WSL2(Windows Subsystem for Linux) 설치를 강력히 권장합니다. 개발자 생태계는 대부분 Linux 환경을 기준으로 만들어져 있기 때문이죠.

터미널을 열고 ls라고 입력한 뒤 Enter를 눌러보세요. 내 컴퓨터의 파일 목록이 쭈욱 뜨나요? 축하합니다! 여러분은 방금 터미널 사용법의 20%를 마스터하셨습니다.

STAGE 2 — Unpacking the Core Concept: Claude Code 설치의 3단계

Claude Code를 실행하려면 딱 3가지 단계가 필요합니다.

1단계: Node.js (실행 엔진)

Claude Code는 JavaScript라는 언어로 만들어졌습니다. 컴퓨터에서 이 프로그램을 돌려주는 엔진이 바로 Node.js입니다. 터미널에 node --version을 쳐서 숫자가 나온다면 이미 설치된 것이고, 안 나온다면 NVM(Node Version Manager)을 통해 설치해 줍니다.

2단계: Claude Code 설치

Node.js가 준비되었다면, 단 한 줄의 명령어로 Claude Code를 설치할 수 있습니다.

여기서 -g는 ‘내 컴퓨터 어디서나 이 프로그램을 쓸 수 있게 설치해 달라’는 뜻입니다.

3단계: API 키 (디지털 출입증)와 비용 관리

Claude Code를 쓰려면 Anthropic 사이트(console.anthropic.com)에서 API Key를 발급받아야 합니다. 이것은 Claude 서버를 이용할 때 내가 누구인지 증명하는 비밀번호와 같습니다. 절대 타인에게 공개하면 안 됩니다!

  • 비용은 얼마나 나오나요?: 사용한 만큼 지불하는 방식입니다. 초보자가 작은 프로젝트를 만든다면 월 $5$30(약 7천 원4만 원) 정도면 충분합니다.
  • 안전장치: 예상치 못한 요금이 나오지 않도록 Anthropic 콘솔의 Billing(결제) 메뉴에서 월 사용 한도(예: $20)를 미리 설정해 두는 것을 강력히 추천합니다.

STAGE 3 — Evidence and Application: 꼭 알아야 할 필수 명령어 & 추천 도구

1. 비개발자를 위한 필수 터미널 명령어 10선

이 10가지 명령어만 알고 계시면 터미널에서 헤맬 일이 없습니다!

명령어 하는 일 (뜻) 비유
pwd 현재 내가 위치한 폴더 경로 표시 “나 지금 어디 있지?”
ls 현재 폴더 안의 파일/폴더 목록 보기 폴더 안을 둘러보기
cd 폴더명 지정한 폴더 안으로 이동 폴더 더블 클릭하기
cd .. 상위(이전) 폴더로 나가기 ‘뒤로 가기’ 버튼
mkdir 폴더명 새로운 폴더 생성 ‘새 폴더 만들기’
touch 파일명 새로운 빈 파일 생성 ‘새 문서 만들기’
clear 지저분한 터미널 화면 깨끗이 비우기 칠판 지우기
Ctrl + C 실행 중인 작업 강제 중단 ‘긴급 정지’ 버튼

2. 나만의 프로젝트 폴더 만들기

작업을 시작할 때는 항상 전용 폴더를 만들고 그 안에서 Claude Code를 켜야 합니다.

이렇게 폴더 안에서 claude를 실행해야, Claude Code가 그 폴더 안의 모든 파일들을 읽고 작업할 수 있습니다.

3. Visual Studio Code (VS Code) 연동

Claude Code가 알아서 코드를 작성해 주지만, 그 모습을 눈으로 직접 보면 훨씬 이해하기 쉽습니다. 무료 코드 에디터인 VS Code를 설치하고, 터미널에서 code .을 입력해 보세요. 현재 폴더가 화면에 뜨면서 Claude Code가 실시간으로 코드를 쓰고 수정하는 장관을 눈으로 확인할 수 있습니다!

4. 흔한 오류 해결법 (Troubleshooting)

  • command not found: claude: 설치 후 터미널 창을 닫았다가 다시 열어보세요.
  • Error: invalid API key: API 키를 복사할 때 맨 앞의 sk-ant-api03-... 문자열이 빠짐없이 잘 들어갔는지 확인하세요.
  • 반응이 느릴 때: Claude Code가 서버와 통신하며 생각하는 중입니다. 멈춘 게 아니니 Ctrl+C를 누르지 말고 조금만 기다려 주세요!

STAGE 4 — Summary and Extension: 세팅 완료, 준비는 끝났습니다!

오늘 강의의 핵심 요약입니다:

  1. 터미널은 대화창이다: 마우스 클릭 대신 글자로 컴퓨터에게 일을 시키는 도구일 뿐입니다.
  2. API 키와 한도 설정: 내 전용 출입증(API 키)을 등록하고, 월 한도를 설정해 안심하고 사용하세요.
  3. 프로젝트 폴더에서 실행하기: 내가 만들 작업 폴더로 이동(cd)한 뒤 claude를 입력하는 습관을 들이세요.

 

 

지난 시간에 우리는 컴퓨터에 Claude Code라는 강력한 엔진을 달아주었습니다. 이제 드디어 첫 대화를 나눠볼 차례입니다!

오늘 다룰 Chapter 3의 주제는 “Claude Code와의 첫 대화 (Your First Conversation With Claude Code)”입니다. 프로그래밍 세상의 오랜 전통인 “Hello World” 순간을 AI와 함께 경험해 보겠습니다.

STAGE 1 — Why It Matters: “Hello World” 그 이상의 감동

프로그래머들이 새로운 언어나 도구를 배울 때 가장 먼저 만들어보는 프로그램이 있습니다. 화면에 그저 “Hello, World!”라는 글자만 띄워보는 것이죠. 너무 단순해 보이지만, “내가 친 글자가 컴퓨터를 움직였다”는 사실을 증명하는 아주 중요한 순간입니다.

저자는 Claude Code와 함께하는 우리의 첫 순간에 대해 이렇게 말합니다.

“The code exists. You caused it to exist. You are a developer.”
“코드가 존재합니다. 여러분이 존재하게 만든 것입니다. 여러분은 개발자입니다.”

하지만 우리는 그냥 까만 화면에 글자만 띄우지 않을 겁니다. AI에게 “Hello World 글자를 예쁜 디자인과 애니메이션, 그리고 내 이름을 치면 인사를 건네는 기능까지 담아서 만들어줘”라고 말할 겁니다. 그리고 30초 만에 여러분의 웹 브라우저에서 그 앱이 작동하는 모습을 직접 확인하게 될 것입니다. Does that make sense?

STAGE 2 — Unpacking the Core Concept: 핵심은 ‘점토 조각’ 같은 반복 루프입니다

많은 분들이 AI를 쓸 때 “한 번의 질문으로 100점짜리 완성품을 받아야지”라고 생각합니다. 하지만 Claude Code를 다루는 진짜 비밀은 ‘반복적인 피드백 루프(Iterative Loop)’에 있습니다.

비유하자면, 찰흙으로 조각상을 만드는 과정과 같습니다. 처음부터 다비드상이 짠 하고 나타나는 것이 아닙니다. 덩어리를 만들고, 눈코입을 다듬고, 세부적인 결을 깎아나가는 것이죠.

이 루프를 몇 번만 돌면, 어느새 초보자가 몇 주 동안 공부해야 만들 수 있는 ‘사용자와 상호작용하는 웹 앱’이 완성됩니다.

팁: 코드를 몰라도 ‘읽어보는’ 습관을 들이세요

Claude Code가 코드를 짜주면, 그냥 넘기지 말고 VS Code로 파일을 열어 쓱 훑어보세요.

  • <style>이라고 적힌 부분은 디자인(CSS)이구나!
  • <script>라고 적힌 부분은 동작(JavaScript)이구나!

모든 줄을 이해할 필요는 없습니다. 자주 보다 보면 패턴이 눈에 익게 되고, 그것이 자연스럽게 여러분의 실력으로 쌓이게 됩니다.

STAGE 3 — Evidence and Application: 특수 명령어와 에러 대처법

Claude Code와 대화할 때 알아두면 삶이 편해지는 특수 명령어들을 소개합니다.

1. 슬래시 명령어 (/) — Claude Code 자체를 조종할 때

대화창 맨 앞에 /를 붙이면 AI에게 말을 건네는 게 아니라, Claude Code 프로그램 자체에 명령을 내리게 됩니다.

  • /help: 사용할 수 있는 모든 특수 명령어를 보여줍니다.
  • /clear: 대화 기록을 깔끔히 비우고 새 마음으로 시작합니다. (AI가 혼란스러워할 때 강력 추천!)
  • /compact: 대화가 너무 길어졌을 때 핵심만 요약하여 AI의 기억 용량을 확보합니다.
  • /exit: Claude Code를 종료합니다.

2. 느낌표 명령어 (!) — 내 컴퓨터 터미널에 직접 명령할 때

대화창 맨 앞에 !를 붙이면, Claude Code를 나가지 않고도 내 컴퓨터 터미널 명령을 바로 실행할 수 있습니다.

  • ! open hello.html (Mac) 또는 ! explorer.exe hello.html (Windows): 작성된 HTML 파일을 브라우저로 바로 엽니다.

3. 에러나 오해가 생겼을 때의 대처법

작업을 하다 보면 AI가 내 뜻을 잘못 이해하거나 에러 코드를 뱉을 때가 있습니다. 지극히 정상입니다!

  1. 에러가 났을 때: 브라우저나 터미널의 에러 메시지를 그대로 복사해서 붙여넣으세요. “이런 에러가 나는데 고쳐줘”라고 하면 귀신같이 잡아냅니다.
  2. 오해가 생겼을 때: 답답해하지 마시고 더 구체적으로 말해주세요. (“예쁘게 해줘” 대신 “Apple 웹사이트처럼 깔끔하고 심플하게 해줘”)
  3. 대화가 꼬였을 때: 망설이지 말고 /clear를 치고 대화를 리셋하세요.

나의 첫 CLAUDE.md 자동 생성하기

대화창에 이렇게 입력해 보세요:

“지금까지 우리가 만든 내용과 결정 사항을 정리해서 CLAUDE.md 파일을 만들어줘.”

Claude Code가 알아서 프로젝트의 설명서를 작성해 줍니다! 다음에 이 폴더에서 claude를 실행하면 AI가 이 문서를 읽고 지난 작업을 완벽히 기억해 냅니다.

STAGE 4 — Summary and Extension: 우리는 이미 무언가를 만들어냈습니다

오늘 내용의 핵심 요약입니다:

  1. Iterative Loop: Claude Code와의 작업은 한 번에 끝나는 것이 아니라 ‘대화-확인-수정’의 반복입니다.
  2. 슬래시(/)와 느낌표(!): AI 설정 조종은 /, 내 컴퓨터 터미널 실행은 !를 기억하세요.
  3. 에러는 친구다: 에러 메시지를 복사해서 Claude Code에게 전달하는 것이 가장 빠른 해결책입니다.

 

지난 시간에는 Claude Code와의 첫 대화와 반복적인 피드백 루프를 경험했습니다. 오늘 다룰 Chapter 4는 AI 개발에서 가장 중요하다고 해도 과언이 아닌 핵심 중의 핵심, “프롬프트의 기술 (The Art of the Prompt)”입니다.

강의를 시작하기 전에 비결 하나를 공개할게요. Claude Code의 결과물 품질은 여러분이 입력하는 지시문(프롬프트)의 품질과 99% 일치합니다. AI가 엉뚱한 코드를 짠다면, 십중팔구는 우리의 지시가 모호했기 때문입니다.

그럼 어떻게 해야 개찰떡같이 알아듣는 프롬프트를 쓸 수 있을까요? 저자가 정리한 5가지 핵심 기둥과 만능 공식을 알려드리겠습니다!

STAGE 1 — Why It Matters: 레시피를 주지 말고, 목표를 제시하세요

초보자들이 가장 많이 하는 실수는 Claude Code를 너무 세세하게 마이크로매니징(Micromanaging)하려 드는 것입니다.

“give it goals, not recipes.”
“레시피(단계)를 주지 말고, 목표를 제시하세요.”

예를 들어볼까요?

  • ❌ 레시피형 지시: “getUserData 함수를 만들고, async로 설정하고, axios 라이브러리로 https://… URL을 호출한 다음 사용자 객체를 반환해 줘.”
  • ⭕ 목표형 지시: “API에서 사용자 ID로 정보를 가져오는 기능을 추가해 줘. 참고로 우리 프로젝트에는 이미 axios 라이브러리가 설치되어 있어.”

전자는 AI를 단순 타이핑 일꾼으로 쓰는 방식입니다. 후자는 ‘수석 개발자의 능력’을 200% 활용하는 방식이죠. Claude Code는 여러분보다 훨씬 코딩을 잘합니다. 목적을 명확히 제시하면, AI가 최선의 구현 방법을 스스로 찾아냅니다. 

저스틴) 기대한 만큼 AI는 응답합니다. 그래서 저는 전 세계에서 개발을 제일 잘 하는 멘토 형님이라고 마인드를 셋합니다. 그러면 그 형님에게 기대하는 바가 있고. 그 기대에 맞게 요청합니다. 그리고 형님의 응답을 잘 듣습니다.

STAGE 2 — Unpacking the Core Concept: 명품 프롬프트를 만드는 5가지 기둥 (5 Pillars)

좋은 프롬프트를 만드는 5가지 핵심 원칙입니다.

  1. 결과(Goal)를 명확히 하라: 단계별 코딩 순서가 아니라, “어떤 결과가 나와야 하는가”를 말하세요.
  2. 맥락(Context)을 충분히 제공하라: AI는 내 마음을 읽지 못합니다. “src/auth.js 파일에 로그인 로직이 있어”처럼 관련된 파일이나 프로젝트 상황을 미리 알려주세요.
  3. 제약 조건(Constraints)을 먼저 말하라: “우리는 프레임워크 없는 순수 JavaScript를 쓰고 있어”처럼 지켜야 할 규칙이나 한계를 미리 차단해 두세요.
  4. 원하는 형태의 예시(Example)를 들어라: “에러 처리는 우리 프로젝트의 다른 코드처럼 해줘”라며 샘플 코드를 한 줄 보여주는 것이 백 마디 설명보다 정확합니다.
  5. 설명을 요구하라: 코드만 짜달라고 하지 말고 “초보자도 이해할 수 있게 쉬운 말로 작동 방식을 설명해 줘”라고 요구하세요. AI는 최고의 스승이 됩니다.

STAGE 3 — Evidence and Application: 당장 써먹는 만능 프롬프트 패턴

실전에서 바로 쓸 수 있는 프롬프트 만능 공식 3가지를 알려드립니다. 그대로 복사해서 단어만 바꿔 써보세요!

1. [맥락 + 목표 + 제약] 만능 공식

2. 하지 말아야 할 일 지정 공식 (Negative Space)

3. ‘수석 엔지니어’ 페르소나 부여하기 (강력 추천!)

프롬프트 맨 앞에 이 문장을 붙여보세요. 결과물의 수준이 완전히 달라집니다.

“코드의 품질과 유지보수성을 깊게 고민하는 수석 엔지니어의 관점에서 이 문제에 접근해 줘. 50줄의 복잡한 코드보다 10줄의 명확하고 단순한 코드를 선호해.”

🚫 피해야 할 나쁜 질문 유형 vs ⭕ 좋은 수정

나쁜 질문 (Avoid) 왜 나쁜가? 좋은 수정 (Better)
“이 코드 좀 좋게 만들어줘.” ‘좋게’가 뭔지 모름 (속도? 디자인? 안전성?) “이 코드의 읽기 쉬운 정도(가독성)를 높이고 복잡한 함수를 분리해 줘.”
“로그인 만들고, 디자인 바꾸고, 검색 버그 고치고, PDF 출력도 넣어줘.” 한 번에 너무 많은 일을 요구 “우선 로그인 기능부터 만들자.” (하나씩 진행)
“이거 완전 별로야. 다 고쳐줘.” 감정적이고 모호함 “버튼이 입력창 아래로 떨어져 있어. 입력창 바로 옆에 배치해 줘.”

STAGE 4 — Summary and Extension: 프롬프트는 AI와의 계속되는 대화입니다

오늘 강의의 핵심 요약입니다:

  1. 목표 중심 지시: 레시피(단계)를 지시하지 말고, 원하는 결과와 목적을 제시하세요.
  2. 3대 요소: [맥락 + 목표 + 제약] 조합은 절대로 실패하지 않는 만능 공식입니다.
  3. 검증 부탁하기: 작업을 마친 AI에게 ! npm test를 돌려 스스로 검증하게 만들거나, “방금 짠 코드에 허점은 없는지 스스로 리뷰해 줘”라고 요청해 보세요.

 

지난 시간에 우리는 AI 파트너에게 명확하게 지시하는 프롬프트 공식을 배웠습니다. 오늘 다룰 Chapter 5의 주제는 “낯선 코드베이스를 전문가처럼 탐색하는 법 (Navigating Any Codebase Like a Pro)”입니다.

동료가 짜던 프로젝트를 물려받았거나, 오픈소스 코드를 보거나, 심지어 6개월 전에 내가 짜둔 코드를 다시 열었을 때 “이게 도대체 무슨 코드지?”하고 멍해진 적 있으신가요?

걱정 마세요. Claude Code만 있다면 수백 페이지짜리 매뉴얼을 읽지 않고도 단 몇 분 만에 전체 지도를 그릴 수 있습니다!

STAGE 1 — Why It Matters: 낯선 도시에 도착했을 때의 전략

낯선 여행지에 처음 내렸을 때, 무작정 어두운 골목길부터 들어가는 사람은 없습니다. 먼저 높은 전망대에 올라가 도시 전체를 내려다보고, 가장 큰 메인 도로가 어디인지 파악하는 것이 순서죠.

코드베이스(프로젝트)를 탐색하는 것도 정확히 똑같습니다. 무턱대고 파일 하나하나를 열어서 복잡한 코드를 읽으려 하면 금방 길을 잃고 좌절합니다.

Claude Code는 프로젝트의 모든 파일 경로를 꿰고 있는 최고의 현지 가이드입니다. 가이드에게 어떻게 질문하느냐에 따라 프로젝트 파악 속도가 10배 이상 차이 납니다. 

STAGE 2 — Unpacking the Core Concept: 오리엔테이션 3단계 워크플로우

낯선 프로젝트 폴더에 들어가서 Claude Code를 실행했다면, 다음 3단계 순서대로 질문을 던져보세요.

[1단계] 높은 곳에서 바라보기 (The Overview)

“이 프로젝트의 전체적인 개요를 알려줘. 무엇을 하는 앱이고, 폴더 구조가 어떻게 되어 있으며, 내가 꼭 알아야 할 가장 중요한 파일들은 뭐야?”

README 문서만 읽는 것과 다릅니다. Claude Code는 실제 코드를 샅샅이 읽어보고 “문서에 적힌 말이 아니라 실제 코드가 하고 있는 일”을 솔직하게 알려줍니다.

[2단계] 메인 도로 파악하기 (The Entry Points)

“이 프로그램은 어디서부터 실행이 시작돼? 사용자가 버튼을 눌렀을 때 데이터가 저장되기까지 어떤 경로를 거치는지 흐름을 추적해 줘.”

이 질문을 던지면 앱의 가장 핵심적인 ‘혈맥’을 한눈에 파악할 수 있습니다.

[3단계] 지도 완성하기, 데이터 구조 (The Data Model)

“이 프로젝트의 데이터 구조(모델)는 어떻게 되어 있어? 주요 데이터 종류와 항목들, 그들 간의 관계를 설명해 줘.”

소프트웨어의 본질은 결국 ‘데이터를 주고받는 것’입니다. 데이터가 어떻게 생겼는지 이해하면, 어려운 코드 로직도 자연스럽게 이해됩니다.

STAGE 3 — Evidence and Application: 안전한 수정과 버그 탐정놀이

프로젝트의 지도를 그렸다면, 이제 실전에서 활용해 볼 시간입니다.

1. 내력벽과 가벽 구분하기 (Ownership Map)

건물을 리모델링할 때 ‘건드리면 건물이 무너지는 내력벽’과 ‘헐어도 상관없는 가벽’을 구분하는 것이 중요하죠? 코드도 마찬가지입니다.

“src/ 폴더 안의 파일들 중에서, 함부로 수정하면 다른 곳에 비상이 걸리는 위험한 핵심 파일과 비교적 독립적이어서 마음대로 고쳐도 되는 파일들을 분류해 줘.”

이 질문 하나로 여러분은 코드 수정을 시작하기 전에 위험 지수(Risk Map)를 미리 파악할 수 있습니다.

2. 원인 모를 버그 원인 추적하기

원인을 알 수 없는 이상한 증상이 나타날 때, AI에게 탐정 역할을 맡겨보세요.

“사용자들이 로그인하고 30분이 지나면 자동으로 튕긴다고 해. 로그인 섹션 코드를 읽어보고 무엇이 이 문제를 일으키는지 원인을 추측해 줘.”

3. 대수술(리팩토링) 전 승인 단계 거치기

복잡한 코드를 깔끔하게 재정리(Refactoring)할 때는 Claude Code에게 “먼저 계획만 세우고 내 승인을 기다려”라고 제약을 거는 것이 안전합니다.

“UserService 코드를 더 깔끔하게 나누고 싶어. 단, 바로 고치지 말고 1) 현재 문제점 2) 파일 분할 계획을 먼저 제시해 줘. 내가 승인하면 그때 고치자.”

4. 완성된 지도를 CLAUDE.md로 저장하기

프로젝트 분석이 끝났다면, 다음 세션이나 다른 개발자를 위해 요약본을 만들어두세요.

“방금 분석한 구조와 핵심 흐름을 바탕으로 이 프로젝트용 CLAUDE.md 파일을 만들어줘.”

STAGE 4 — Summary and Extension: 코드를 몰라도 흐름을 지배할 수 있습니다

오늘 강의의 핵심 요약입니다:

  1. 3단계 탐색: [전체 개요 → 실행 흐름 → 데이터 구조] 순서로 질문하여 지도를 그리세요.
  2. 안전성 확인: 코드를 건드리기 전 “이 파일을 고치면 다른 곳에 영향을 주니?”라고 먼저 물어보세요.
  3. 계획 후 실행: 큰 규모의 수정은 항상 AI의 계획을 먼저 들은 뒤 승인하고 진행하는 습관을 들이세요.

 

지난 강의들에서 우리는 멘탈 모델, 환경 설정, 프롬프트의 기술, 그리고 코드 탐색법까지 단단하게 기초를 다졌습니다.

오늘 다룰 Chapter 6은 드디어 기다리시던 순간입니다! “나의 첫 번째 진짜 프로젝트 만들기 (Building Your First Real Project)” 시간입니다.

오늘은 이론 공부가 아닙니다. 단순한 “Hello World” 수준을 벗어나, 친들에게 자랑스럽게 보여줄 수 있고 실제로 매일 쓸 수 있는 ‘나만의 독서 기록장(Reading Tracker)’ 웹 앱을 처음부터 끝까지 함께 만들어보겠습니다. 준비되셨나요?

STAGE 1 — Why It Matters: 진짜 제품을 만들어봐야 진짜 개발자가 됩니다

소프트웨어 개발을 배울 때 가장 큰 고비는 “개념은 알겠는데, 막상 앱 하나를 혼자 만들려고 하면 아무것도 못 하겠다”는 무력감입니다.

그래서 오늘은 한 걸음씩 레고 블록을 쌓듯, 8개의 단계를 거쳐 완성품을 만들어볼 겁니다. 이 프로젝트 하나만 완성해도 여러분은:

  1. 데이터를 영구히 저장하고
  2. 검색 및 정렬을 수행하며
  3. 예외 상황(에러)을 처리하고
  4. 엑셀(CSV) 파일로 내보내는 완벽한 웹 애플리케이션의 개발 경험을 갖게 됩니다.

실무 개발팀이 일주일 동안 개발할 분량을, 우리는 오늘 Claude Code와 함께 단 한 번의 세션 만에 만들어낼 것입니다! 

STAGE 2 — Unpacking the Core Concept: 앱의 생로병사 ‘CRUD’와 ‘localStorage’

프로젝트를 시작하기 전, 오늘 접하게 될 2가지 중요한 핵심 개념만 짚고 가겠습니다.

  1. CRUD (크루드): 모든 데이터 기반 앱의 기초입니다.
    • Create (생성): 새 책을 목록에 추가하기
    • Read (읽기): 저장된 책 목록을 화면에 보여주기
    • Update (수정): 입력한 책 정보나 별점을 수정하기
    • Delete (삭제): 읽은 책을 목록에서 지우기
  2. localStorage (로컬 스토리지): 웹 브라우저 안에 존재하는 ‘작은 데이터 저장소’입니다. 별도의 복잡한 데이터베이스 서버 없이도, 브라우저를 껐다 켜거나 새로고침해도 내가 등록한 책 목록이 그대로 유지되도록 만들어주는 고마운 기술입니다.

STAGE 3 — Evidence and Application: 8단계 실전 프로젝트 빌드 가이드

터미널을 열고 프로젝트 폴더를 만든 뒤 claude를 실행하세요!

1단계: 뼈대 잡기 (The Foundation)

AI에게 첫 지시를 내릴 때, 전체 스펙을 명확히 제시하세요.

[프롬프트]
“나만의 독서 기록장 웹 앱을 만들고 싶어. 단 하나의 index.html 파일로 작성해 줘 (프레임워크 없이 순수 HTML, CSS, JS만 사용).
기능:

  • 책 제목, 저자, 읽은 날짜, 별점(1~5점), 메모 입력하기
  • 추가된 책 목록을 최신순으로 보여주기
  • 새로고침해도 데이터가 유지되도록 localStorage 사용하기
  • 노션(Notion) 느낌의 깔끔하고 심플한 디자인
    코드를 짜기 전에 먼저 구현 계획을 제안해 주고 내 의견을 물어봐 줘.”

Claude Code의 계획을 확인한 뒤 “좋아, 만들어줘!”라고 하면 index.html 파일이 생성됩니다. ! open index.html로 브라우저에서 열어보세요.

2단계: 디자인 다듬기 (Polish)

화면을 보고 개선할 점을 번호 목록으로 지시합니다.

[프롬프트]
“기본 틀이 마음에 드네! 몇 가지 수정해 줘:

  1. 입력 폼 여백을 넓혀서 답답하지 않게 해줘.
  2. 별점은 숫자 입력 대신 클릭할 수 있는 ‘★’ 모양 아이콘으로 바꿔줘.
  3. 새 책이 추가될 때 부드럽게 나타나는 애니메이션 효과를 넣어줘.”

3단계: 삭제 및 통계 기능 추가 (Delete & Stats)

[프롬프트]
“각 책 카드의 우측 상단에 ‘X’ 버튼을 달아서 삭제 기능을 추가해 줘. 삭제 시 ‘정말 삭제하시겠습니까?’ 확인창을 띄워줘. 그리고 목록 위에 [총 읽은 책 수, 평균 별점]을 보여주는 상단 통계 바를 만들어줘.”

4단계: 검색 및 정렬 (Search & Sort)

[프롬프트]
“책 목록 위에 검색창을 만들어줘. 제목이나 저자 이름을 입력하면 실시간으로 해당 책만 걸러서 보여줘야 해. 또 [최신순, 별점 높은순, 제목순]으로 정렬할 수 있는 드롭다운 메뉴도 추가해 줘.”

5단계: 수정 기능 완성하기 (Update)

데이터의 핵심인 ‘수정(Edit)’을 추가합니다.

[프롬프트]
“각 책 카드에 ‘수정’ 버튼을 만들어줘. 클릭하면 기존 내용이 상단 입력 폼에 채워지고, ‘등록’ 버튼이 ‘수정 완료’로 바뀌면서 내용이 덮어씌워지도록 해줘.”

6단계: 예외 상황 처리 (Edge Cases)

전문가처럼 앱의 허점을 메우는 단계입니다.

[프롬프트]
“현재 앱의 허점이나 예외 상황(제목 없이 제출할 때, Mobile 화면에서 볼 때 등)을 점검하고, 문제가 될 만한 부분을 알아서 보완해 줘.”

7단계: 접근성 향상 (Accessibility)

[프롬프트]
“스크린 리더 사용자나 키보드 조작 사용자를 위해 기본 웹 접근성(ARIA 라벨, 버튼 대비 등)을 점검하고 개선해 줘.”

8단계: 엑셀 파일 내보내기 (Export CSV)

[프롬프트]
“저장된 책 목록을 엑셀이나 구글 시트에서 열 수 있도록 ‘CSV 파일로 내보내기’ 버튼을 하나 만들어줘.”

STAGE 4 — Summary and Extension: 첫 작품 완성을 축하합니다!

마지막으로 이 프로젝트의 기억을 남겨둘 차례입니다.

“우리가 지금까지 만든 앱의 구조, 사용된 기술(localStorage, Vanilla JS), 주요 기능들을 정리해서 CLAUDE.md 파일을 생성해 줘.”

단 한 번의 세션 만에 여러분은 완벽한 웹 앱을 손에 쥐었습니다!

 

 

 

지난 시간에는 우리만의 ‘독서 기록장’ 프로젝트를 완성해 보았습니다. 오늘 다룰 Chapter 7은 프로그래머의 성패를 가르는 가장 중요한 습관, “디버깅, 에러를 기능으로 바꾸는 법 (Debugging, Turning Errors Into Features)”입니다.

강의를 시작하기 전에 제가 수년간 개발을 하면서 깨달은 비밀 하나를 말씀드릴게요. 에러는 실패가 아닙니다. 에러는 아주 친절한 ‘정보’일 뿐입니다.

초보자들은 빨간색 에러 창을 보면 나를 비난하는 ‘비명 소리’로 느낍니다. 하지만 경험 많은 개발자들은 에러 창을 보물이 묻힌 ‘GPS 좌표’로 받아들입니다. 오늘 저와 함께 에러를 보는 시선을 완벽히 바꿔봅시다!

STAGE 1 — Why It Matters: 에러 메시지는 친절한 GPS 좌표입니다

저자는 에러에 대해 이렇게 강조합니다.

“errors are not failures. They are information.”
“에러는 실패가 아닙니다. 정보입니다.”

개발을 하다 에러를 만나면 기분 나빠할 필요가 전혀 없습니다. 컴퓨터는 지금 여러분에게 “내가 작동하다가 어느 줄에서 왜 멈췄는지” 인간이 읽을 수 있는 언어로 아주 정확하게 고백하고 있는 중입니다.

이 고백을 읽어내는 법만 배우면, 에러는 나를 괴롭히는 악마가 아니라 문제를 해결하도록 도와주는 최고의 힌트가 됩니다. Does that make sense?

STAGE 2 — Unpacking the Core Concept: 에러 메시지(Stack Trace) 해독하기

실제 웹 개발 중 가장 흔히 만나는 에러 메시지 한 줄을 해부해 보겠습니다.

초보자는 첫 줄만 보고 “악! 타입 에러다!” 하고 창을 닫아버립니다. 하지만 밑줄까지 읽어보면 완벽한 4가지 정보가 담겨 있습니다.

  1. 에러의 종류 (TypeError): 데이터 타입을 잘못 다루었음.
  2. 무슨 일이 터졌는가 (Cannot read properties of undefined (reading 'name')): 존재하지 않는(undefined) 데이터에서 ‘name’ 항목을 읽으려고 시도했음.
  3. 어디서 터졌는가 (index.html:142:35): index.html 파일의 142번째 줄, 35번째 글자에서 터졌음!
  4. 누가 실행했는가 (at displayBook): displayBook이라는 함수 안에서 일어난 일임.

어때요? 완벽한 GPS 좌표죠? 142번째 줄만 찾아가면 버그의 원인을 잡을 수 있습니다!

브라우저 비밀의 창: F12 (개발자 도구)

웹 앱을 만들 때는 키보드의 F12 키(Mac은 Cmd + Option + I)를 누르는 습관을 들이세요.

  • Console(콘솔) 탭: 발생한 모든 에러 좌표와 console.log 기록이 뜨는 가장 중요한 화면입니다.
  • Elements(요소) 탭: HTML과 CSS 디자인이 어떻게 적용되었는지 눈으로 보는 창입니다.

STAGE 3 — Evidence and Application: Claude Code와 함께하는 5단계 디버깅 루프

이제 이 GPS 좌표를 Claude Code에게 전달하여 문제를 해결하는 5단계 디버깅 루프를 소개합니다.

초보자가 Claude Code에게 버그를 제보하는 명품 프롬프트

“메모가 없는 책을 선택하고 ‘수정’ 버튼을 누를 때 브라우저 콘솔에 아래와 같은 에러가 발생해:

TypeError: Cannot read properties of undefined (reading 'name') at displayBook (index.html:142:35)

displayBook 함수 안에서 notes 데이터가 비어있을 때 발생하는 문제 같은데, 확인하고 고쳐줘.”

세상에서 가장 똑똑한 ‘AI 러버덕(Rubber Duck)’ 기법

개발자 세계에는 ‘러버덕 디버깅’이라는 유명한 관습이 있습니다. 책상 위에 노란 오리 인형을 두고, 내가 짠 코드가 왜 안 되는지 오리에게 말로 설명하다 보면 스스로 해결책을 깨닫게 되는 현상이죠.

Claude Code는 세계 최고 성능의 러버덕입니다! 코드가 안 될 때 그냥 이렇게 말을 건네보세요.

“이 코드가 왜 안 되는지 나도 헷갈려. 내가 생각하는 작동 방식을 설명할 테니, 내 논리에서 어느 부분이 틀렸는지 짚어줘.”

STAGE 4 — Summary and Extension: 디버깅의 황금률 “한 번에 하나씩!”

마지막으로 버그를 잡을 때 반드시 지켜야 할 황금 규칙입니다.

“한 번에 딱 한 가지만 수정하세요!”

버그가 안 잡힌다고 불안한 마음에 한 번에 코드 3개, 4개를 동시에 고치면 안 됩니다. 버그가 고쳐져도 ‘셋 중에 무엇 때문에 고쳐졌는지’ 알 수 없게 되고, 오히려 3개의 새로운 버그가 태어날 수 있습니다.

하나를 고치고, 테스트하고, 그다음으로 넘어가세요. 디버깅은 속도전이 아니라 방향성입니다.

 

지난 시간에는 디버깅 노하우를 배우며 버그를 잡는 법을 익혔습니다. 오늘 다룰 Chapter 8의 주제는 “Git, GitHub 그리고 세상으로 앱 배포하기 (Git, GitHub and Shipping Code)”입니다.

내가 만든 멋진 웹 앱을 내 컴퓨터 안에서만 보는 건 너무 아깝죠? 오늘 우리는 1) 내 작업을 안전하게 백업하고 2) 클릭 몇 번으로 전 세계 누구나 들어올 수 있는 진짜 웹사이트 URL을 만드는 법을 다룹니다. Part 1의 하이라이트라고 할 수 있죠!

STAGE 1 — Why It Matters: 게임의 ‘세이브 포인트’를 만드세요

개발을 하다 보면 이런 비극을 겪곤 합니다. “잘 작동하던 코드였는데, 새로 기능을 고치다가 다 꼬여버렸어요! 예전으로 돌아가고 싶어요…”

Git(깃)은 이 문제를 완벽히 해결해 주는 게임의 ‘세이브 포인트(타임머신)’입니다.

  • 새로운 기능을 추가하기 직전에 세이브 포인트를 만들어 둡니다.
  • 혹시나 코드가 엉망이 되더라도 언제든 클릭 한 번으로 과거의 안전한 상태로 되돌아갈 수 있습니다.

그리고 GitHub(깃허브)는 내 컴퓨터 속 세이브 포인트들을 인터넷 클라우드 창고에 안전하게 보관하고, 다른 사람들과 공유할 수 있게 만들어주는 웹사이트입니다. 

STAGE 2 — Unpacking the Core Concept: 평생 써먹는 Git 3대 명령어

Git에는 수백 개의 어려운 명령어가 있지만, 실무의 90%는 딱 3개의 명령어로 끝납니다.

1. 세이브 포인트 만들기 실습

터미널에서 프로젝트 폴더로 이동한 뒤 딱 한 번만 다음을 실행합니다.

이제 이 폴더는 Git이 세이브 포인트를 추적하는 관리구역이 됩니다.

2. 절대 클라우드에 올리면 안 되는 파일: .gitignore

보안 비밀번호(API 키)나 용량이 너무 큰 임시 파일은 GitHub에 올라가면 안 됩니다. Claude Code에게 이렇게 지시하세요:

“우리 프로젝트에 맞는 .gitignore 파일을 생성해 줘.”

STAGE 3 — Evidence and Application: 전 세계에 내 웹 앱 공개하기 (GitHub Pages)

이제 지난 시간에 만든 ‘독서 기록장’ 프로젝트를 진짜 인터넷 세상에 배포해 봅시다!

1. 내 프로젝트를 GitHub에 연결하기

  1. github.com 로그인 후 오른쪽 위의 + 버튼 → New repository 클릭.
  2. 이름에 reading-tracker 입력 후 Create repository 클릭.
  3. 화면에 나오는 3줄의 명령어를 내 터미널에 복사해서 붙여넣기!

2. 무료 웹 호스팅 서비스: GitHub Pages 배포 5단계

GitHub는 무료로 내 웹사이트를 인터넷에 띄워주는 GitHub Pages 기능을 제공합니다.

  1. GitHub의 내 프로젝트 화면에서 Settings(설정) 탭 클릭
  2. 왼쪽 메뉴에서 Pages 클릭
  3. Source 항목에서 Deploy from a branch 선택
  4. Branch 메뉴에서 main / /(root) 선택 후 Save 클릭
  5. 1~2분 뒤 새로고침하면? https://내아이디.github.io/reading-tracker/ 주소 완성!

이 주소를 카톡으로 친구들에게 공유해 보세요. 브라우저에서 여러분이 만든 독서 기록장이 진짜로 실행되는 장관을 볼 수 있습니다!

3. Claude Code에게 Git 작업 부탁하기

터미널 명령어가 귀찮다면 Claude Code에게 말로 시키세요.

“오늘 작업한 내용들을 ‘검색 및 정렬 기능 추가’라는 메시지로 커밋하고 GitHub에 push해 줘.”

4. 코드 충돌(Merge Conflict)이 발생했을 때

여러 작업을 하다가 코드가 꼬여서 Git이 당황해할 때도 겁먹지 말고 Claude Code에게 코드를 복사해서 던져주세요.

“Git에서 머지 충돌(Merge Conflict)이 났어. 이 코드 중에서 어떤 걸 선택해서 합쳐야 하는지 해결해 줘.”

STAGE 4 — Summary and Extension: 여러분은 이제 정식으로 앱을 배포한 개발자입니다!

오늘 강의의 핵심 요약입니다:

  1. Git = 세이브 포인트: git add . -> git commit -m "메시지"로 안전한 복구 지점을 만드세요.
  2. GitHub = 클라우드 창고: git push로 내 세이브 파일을 인터넷으로 올리세요.
  3. GitHub Pages = 무료 배포: 클릭 몇 번으로 내 앱을 전 세계 누구나 접속 가능한 진짜 URL로 만드세요.

 

축하합니다! 여러분은 기초 과정을 멋지게 마치고 드디어 Part 2 심화 과정에 들어섰습니다.

오늘 다룰 Chapter 9의 주제는 “MCP 서버와 커스텀 에이전트 (MCP Servers and Custom Agents)”입니다. 지금까지 우리가 사용한 Claude Code는 “내가 말하면 답하고 코드를 짜주는” 수동적인 조수였습니다. 하지만 오늘 배우는 3가지 무기를 장착하면 Claude Code는 스스로 판단하고 외부 세상과 소통하는 ‘자율형 개발 파트너’로 변신합니다.

숙련된 개발자들도 시연 모습을 보면 “잠깐만, 방금 그거 어떻게 한 거야?” 하고 눈을 비비게 만드는 비밀 무기들을 공개합니다!

STAGE 1 — Why It Matters: 단순 조수에서 ‘자율적 파트너’로의 도약

원작자 Joey Primiani는 이번 장의 핵심을 이렇게 정의합니다.

“transform Claude Code into an autonomous development partner.”
“Claude Code를 자율적인 개발 파트너로 변신시킵니다.”

지금까지는 우리가 하나하나 지시해야 했습니다. 하지만 앱이 커지면 데이터베이스도 직접 조회해야 하고, 코드를 고칠 때마다 자동으로 테스트도 돌려야 하며, 여러 일을 동시에 처리해야 합니다.

오늘 배울 Hooks, MCP Servers, Sub-Agents는 바로 Claude Code의 한계를 허물어주는 3대 열쇠입니다. 

STAGE 2 — Unpacking the Core Concept: Claude Code의 3대 초능력

이 3가지 기능을 아주 직관적인 비유로 정리해 드릴게요.

1. Hooks (훅): 자동으로 움직이는 ‘감지 센서’

자동문 센서처럼, Claude Code가 특정 행동을 할 때 사용자가 지정한 명령어가 자동으로 실행되도록 만드는 기능입니다. (~/.claude/settings.json 파일에 설정)

  • PreToolUse: AI가 파일 수정 등의 행동을 하기 직전에 실행 (예: 실행 명령어 로그 남기기)
  • PostToolUse: AI가 행동을 마친 직후에 실행 (예: 코드가 수정되면 자동으로 npm test 구동하기)
  • Stop: 긴 작업이 끝났을 때 실행 (예: 작업 완료 시 컴퓨터에서 “띵~” 소리가 나게 하기)

2. MCP Servers (Model Context Protocol): 외부 세상을 연결하는 ‘플러그인’

MCP는 Anthropic이 만든 오픈 표준으로, 쉽게 말해 Claude Code에 장착하는 확장 플러그인(앱스토어)입니다. 기본 Claude Code는 내 프로젝트 폴더 안의 파일만 볼 수 있지만, MCP 서버를 연결하면:

  • SQLite / PostgreSQL DB: “최근 30일간 가입한 회원 목록을 DB에서 조회해 줘”라고 하면 SQL을 직접 실행하여 결과를 가져옵니다.
  • Figma / Slack / GitHub: 디자인 도구, 대화방, 이슈 트래커에 접속해 정보를 읽고 씁니다.

3. Sub-Agents (서브 에이전트): 일을 분담하는 ‘분신술’

복잡한 대형 작업이 들어왔을 때, Claude Code가 자기 자신을 복제하여 여러 개의 하위 AI 에이전트를 동시에 띄워 일을 병렬로 처리합니다. (예: 1번 에이전트는 스페인어 번역, 2번 에이전트는 언어 변경 버튼 생성, 3번 에이전트는 번역 테스트 실행)

STAGE 3 — Evidence and Application: 실전 활용 및 강력한 경고!

🚨 경고: --dangerously-skip-permissions 플래그 사용법

Sub-Agents를 실행하거나 완전 자율 모드를 쓸 때 --dangerously-skip-permissions라는 옵션을 켤 수 있습니다. 말 그대로 “허락받지 말고 네 마음대로 파일을 고치고 명령어를 실행해”라는 뜻입니다.

  • ❌ 위험한 사용: 개인 문서나 중요한 통장/인증서 파일이 있는 메인 노트북에서 그냥 실행하는 것.
  • ⭕ 안전한 사용: 내 컴퓨터와 격리된 도커(Docker) 컨테이너나 테스트 전용 가상 서버(VM) 안에서 실행하는 것.

이 옵션은 칼과 같습니다. 격리된 안전한 상자(샌드박스) 안에서만 사용하세요!

고급 프로젝트를 위한 CLAUDE.md 파일의 진화

프로젝트가 커질수록 CLAUDE.md의 내용도 풍성해져야 합니다. 고급 사용자는 이런 내용을 담아둡니다.

이렇게 세세하게 적어두면 Claude Code가 스스로 판단할 때 발생할 수 있는 사고를 100% 미연에 방지할 수 있습니다.

STAGE 4 — Summary and Extension: Claude Code는 여러분의 시스템이 됩니다

오늘 강의의 핵심 요약입니다:

  1. Hooks: AI의 행동 앞뒤로 자동으로 실행될 스크립트를 걸어두는 센서입니다.
  2. MCP: DB, 외부 API, 슬랙 등 Claude Code가 외부 데이터와 직접 대화하게 만드는 확장 플러그인입니다.
  3. Sub-Agents: 복잡한 과제를 분할하여 병렬로 처리하는 AI 분신술입니다. (단, 자율 모드는 격리된 환경에서만!)

 

Claude Code와 오랜 시간을 보내다 보면 누구나 한 번쯤 문득 이런 불안감이 찾아옵니다.

“내가 AI에 너무 의존하는 거 아닐까? AI 서버가 꺼지면 난 아무것도 못 하는 바보가 되는 건 아닐까? 내가 진짜 이 코드를 이해하고 있긴 한 걸까?”

오늘 다룰 Chapter 10의 주제는 바로 이 불안감에 대한 명쾌한 해답, “생각의 전환: AI-Native 개발자처럼 사고하는 법 (The Mindset Shift)”입니다.

이 장은 단순한 기술 설명이 아닙니다. AI 시대를 살아가는 여러분이 ‘단순 타이퍼’가 아니라 ‘진짜 위대한 개발자’로 성장하기 위한 철학과 정체성을 다룹니다!

STAGE 1 — Why It Matters: “나 바보 되는 거 아니야?”라는 불안감의 진실

저자는 여러분이 느끼는 그 불안감이 사실은 ‘엄청난 성장의 신호’라고 말합니다.

“You are the architect, not the laborer”
“여러분은 노동자가 아니라 건축가입니다.”

과거의 개발 공부는 지루한 문법 암기, 라이브러리 문서 읽기, 반복적인 타이핑이라는 ‘노동(Labor)’으로 가득 차 있었습니다.

하지만 Claude Code를 쓰면서 여러분은 단순 노동을 AI에게 맡기고, “무엇을 만들 것인가? 왜 만드는가? 어떤 구조가 가장 좋은가?”를 고민하는 ‘건축가(Architect)’의 위치로 올라선 것입니다.

직접 손으로 벽돌을 쌓지 않는다고 해서 건축가가 아닌 것이 아닙니다. 건축가는 건물의 전체적인 모양과 목적, 안전성을 통찰하는 사람입니다. 

STAGE 2 — Unpacking the Core Concept: 80/20 법칙과 ‘건축가’의 사고방식

Claude Code가 짜주는 코드를 유심히 관찰해 보면 80/20 법칙이 적용된다는 것을 알 수 있습니다.

AI-Native 개발자의 핵심 실력은 5%의 나쁜 코드를 알아보는 ‘안목’입니다.

AI가 너무 복잡한 코드를 내놓았을 때, 그냥 승인하지 말고 이렇게 되물어보세요.

“이 구현은 문제의 크기에 비해 너무 복잡해 보여. 가장 단순하면서도 목표를 달성할 수 있는 최소한의 코드는 뭐야?”

훌륭한 엔지니어는 복잡하게 짜는 사람이 아닙니다. 가장 단순하고 명확하게 문제를 해결하는 사람입니다.

STAGE 3 — Evidence and Application: AI-Native 개발자의 3대 필살 습관

AI와 함께 일하면서 진정한 전문가로 성장하는 3가지 습관을 소개합니다.

1. 코드를 ‘적극적으로’ 읽고 질문하라 (Active Reading)

AI가 코드를 짜주면 그냥 넘기지 말고, 하루에 딱 한 번씩 이렇게 물어보세요.

“방금 짠 코드에서 네가 내린 가장 핵심적인 설계 결정은 뭐야? 만약 2달 뒤에 여기서 버그가 터진다면 어디서 터질 것 같아?”

이 질문 하나가 여러분에게 수년 치의 경험과 컴퓨터 과학 지식을 선사합니다. AI의 설명을 듣는 과정 자체가 최고의 1:1 맞춤 수업이 됩니다.

2. 적절한 범위(Scope)로 나누어 지시하라

AI에게 한 번에 너무 많은 일을 시키지 마세요.

  • ❌ 나쁜 지시: “로그인 만들고, 메인 페이지 디자인 바꾸고, 결제 시스템 버그 고쳐줘.” (너무 커서 검토 불가능)
  • ⭕ 좋은 지시: “우선 사용자 로그인 기능부터 만들자.” (5~10분 만에 코드를 검토할 수 있는 크기)

3. “신뢰하되, 검증하라” (Trust, But Verify)

AI는 완벽하지 않습니다. 코드를 받으면 항상 3단계 검증 의식을 거치세요:

  1. 눈으로 읽기: 전체적인 코드의 모양과 흐름 파악
  2. 직접 실행하기: 브라우저나 터미널에서 기능 동작 확인
  3. AI에게 스스로 허점 묻기: “네가 방금 짠 코드에서 위험하거나 다시 점검할 만한 곳이 있니?”

STAGE 4 — Summary and Extension: 여러분은 지금 ‘안목(Taste)’을 키우고 있습니다

이 모든 과정의 최종 목적지는 무엇일까요? 바로 ‘기술적 안목(Taste)’을 갖추는 것입니다.

좋은 코드가 무엇인지, 어떤 아키텍처가 오래 살아남는지 알아보는 눈, 즉 ‘안목’은 책을 외운다고 생기지 않습니다. 수많은 코드를 접하고, 판단하고, 에러를 고쳐보는 경험 속에서 완성됩니다.

Claude Code는 여러분이 평생 경험할 코드의 양을 10배 이상 늘려줍니다. 매 순간 적극적으로 읽고, 고민하고, 질문하는 사람은 이 시대 최고의 AI-Native 엔지니어로 거듭나게 될 것입니다.

 

오늘은 Chapter 11, “흔히 하는 실수와 이를 피하는 방법 (Common Mistakes and How to Avoid Them)”에 대해 다룹니다.

기술을 배울 때 가장 빨리 성장하는 방법은 “남들이 어디서 넘어지는지 미리 알아두는 것”입니다. 아무리 뛰어난 개발자라도 Claude Code를 쓸 때 범하는 고질적인 10가지 실수가 있습니다.

오늘 이 10가지 함정을 확실히 파악해 두시면, 여러분은 수십 시간의 시행착오를 아낄 수 있습니다! 준비되셨나요?

STAGE 1 — Why It Matters: 함정을 알면 복구 대신 ‘건축’에 집중할 수 있습니다

원작자는 이 장의 목적을 이렇게 말합니다.

“spend time building instead of recovering.”
(Joey Primiani, Think. Prompt. Create, Chapter 11)
“복구하는 대신 만드는 데 시간을 쓰세요.”

개발에서 가장 안타까운 순간은 AI가 나쁜 도구가 아니라, 우리의 습관이 나빠서 코드가 꼬였을 때입니다. 실수들을 바로잡는 것만으로도 여러분의 작업 속도는 2배 이상 빨라질 것입니다. Does that make sense?

STAGE 2 — Unpacking the Core Concept: 초보자가 자주 빠지는 10대 실수와 처방전

10가지 실수를 3가지 유형으로 깔끔하게 묶어서 정리해 드릴게요.

1그룹: 보안 및 권한의 실수 (가장 위험함!)

  • 실수 1. 자동 승인 남발 (--dangerously-skip-permissions): 귀찮다고 안전장치를 꺼버리면, AI가 소중한 파일을 삭제하거나 예기치 않은 명령을 실행할 수 있습니다.
    • 👉 처방전: 격리된 테스트 환경(도커 등)이 아니라면 승인 창(Approval)은 ‘무료 보험’이라 생각하고 즐겁게 누르세요.
  • 실수 2. 비밀번호/API 키 커밋 (Secret Leak): API 키나 DB 비밀번호를 코드에 직접 적어뒀다가 GitHub에 올려버리는 일입니다.
    • 👉 처방전: 보안 정보는 무조건 .env 파일에 넣고, 커밋 전 AI에게 *”혹시 내가 올릴 파일에 비밀번호나 API 키가 하드코딩되어 있니?”*라고 꼭 물어보세요.

2그룹: 대화 및 맥락의 실수 (AI를 바보로 만드는 원인)

  • 실수 3. CLAUDE.md 무시하기: 새 세션을 열 때마다 프로젝트 설명을 처음부터 다시 타이핑하는 행동입니다.
    • 👉 처방전: 프로젝트 루트에 CLAUDE.md를 만들어두면 매번 설명할 필요가 없습니다.
  • 실수 4. 세션을 너무 오랫동안 끌기: 4시간 넘게 한 대화창에서 계속 일하면 AI가 건망증에 걸립니다.
    • 👉 처방전: 대화가 길어지면 /compact 명령어로 대화를 압축하거나, 세션을 새로 켜세요.
  • 실수 5. 한 번에 너무 많은 일 요구하기: “로그인 만들고, 디자인 고치고, 검색 버그 잡아줘”라고 한꺼번에 시키는 일입니다.
    • 👉 처방전: 한 번에 딱 한 가지 작업만 시키고 커밋(git commit)하세요.

3그룹: 검증 및 태도의 실수 (실력을 방해하는 요소)

  • 실수 6. 코드 안 읽고 넘어가기: AI가 짜준 코드를 열어보지도 않고 그냥 써버리는 행동입니다.
    • 👉 처방전: 무조건 VS Code(! code .)로 파일을 열어 최소한 훑어보는 습관을 들이세요.
  • 실수 7. 코드를 직접 실행해 보지 않기: 10가지 수정을 거칠 때까지 브라우저나 앱을 한 번도 안 켜보는 일입니다.
    • 👉 처방전: 하나의 기능이 끝날 때마다 즉시 브라우저를 새로고침해서 눈으로 확인하세요.
  • 실수 8. AI의 제안에 무조건 복종하기: AI가 너무 복잡하게 코드를 짤 때도 군말 없이 받아들이는 행동입니다.
    • 👉 처방전: “더 간단하게 해결하는 방법은 없어?” 하고 반문하는 습관을 들이세요.
  • 실수 9. 에러 메시지를 싹둑 잘라서 제보하기: 에러 첫 줄만 딸랑 전달하는 일입니다.
    • 👉 처방전: F12 콘솔 창의 전체 에러(Stack Trace)와 내가 무슨 행동을 했을 때 터졌는지를 함께 전달하세요.
  • 실수 10. 한 번 실패했다고 포기하기: 첫 시도에 안 된다고 AI를 탓하는 행동입니다.
    • 👉 처방전: 소프트웨어 개발은 원래 ‘반복(Iteration)’입니다. 에러를 힌트 삼아 조율해 나가세요.

STAGE 3 — Evidence and Application: 실수 방지 요약 체크리스트

작업에 들어가기 전, 이 4가지 질문만 스스로 던져보세요!

이 4가지만 지켜도 여러분의 개발 프로세스는 상위 1% 개발자만큼 안정적으로 바뀝니다.

STAGE 4 — Summary and Extension: 실수는 실패가 아니라 교정의 기회입니다

오늘 강의의 핵심 요약입니다:

  1. 안전장치 끄지 않기: --dangerously-skip-permissions와 API 키 노출을 주의하세요.
  2. 대화의 질 유지하기: CLAUDE.md를 적극 활용하고 대화가 길어지면 /compact를 사용하세요.
  3. 검증의 주도권 쥐기: 코드를 눈으로 읽고, 직접 실행하며, AI에게 더 쉬운 방법을 계속 질문하세요.

 

오늘 다룰 Chapter 12는 이 책 전체를 관통하는 아주 중요한 철학적 메시지이자 비전, “다음에 올 것들: 바이브 코딩의 미래 (What Comes Next, The Future of Vibe Coding)”입니다.

2025년 초, AI 연구계의 거장 안드레이 카파시(Andrej Karpathy)가 ‘바이브 코딩(Vibe Coding)’이라는 단어를 제시해 큰 화제가 되었습니다. 한 땀 한 땀 코드를 작성하는 대신, 내가 원하는 느낌과 방향(Vibe)을 AI에게 건네며 대화하듯 프로그램을 만드는 개발 방식을 뜻하죠.

“AI가 코딩을 다 해주는 시대에 내 역할은 무엇일까?”라는 질문에 대해, 오늘 저와 함께 완벽한 답을 찾아보겠습니다!

STAGE 1 — Why It Matters: 계산기, 워드프로세서, 그리고 AI

새로운 기술이 나올 때마다 사람들은 항상 비슷한 두려움을 느꼈습니다.

  • 계산기가 나왔을 때: “이제 수학 선생은 필요 없겠네?”
  • 워드프로세서가 나왔을 때: “타자 학원은 다 망하겠네?”
  • 구글 맵이 나왔을 때: “길을 외우는 능력이 무의미해졌네?”

하지만 계산기가 나왔다고 수학이 사라졌나요? 아닙니다. 기계적인 암기와 계산은 도구에 넘어가고, 인간은 ‘문제 해결과 판단’이라는 더 높은 차원의 일에 집중하게 되었을 뿐입니다.

소프트웨어 개발도 똑같은 역사적 전환점을 지나고 있습니다. 저자는 이렇게 말합니다.

“The tool handles the mechanical execution; you handle the judgment.”
“도구는 기계적 실행을 담당하고, 여러분은 판단을 담당합니다.”

STAGE 2 — Unpacking the Core Concept: 자동화되는 것 vs 안 되는 것

AI-Native 개발자가 되려면 ‘무엇이 자동화되고, 무엇이 여전히 인간의 몫인가’를 정확히 알아야 합니다.

구분 AI가 완벽히 대체하는 것 (기계적 실행) 인간만이 할 수 있는 것 (판단과 직관)
핵심 역할 문법 번역, 라이브러리 문서 기억 사용자가 진짜 필요한 것이 무엇인지 파악
작업 내용 지루한 보일러플레이트(기본 코드) 작성 장기적 영향력을 고려한 아키텍처 설계
오류 해결 단순 오타, 문법 버그 잡기 ‘단순함 vs 유연함’ 사이의 트레이드오프 결정
가치 단순 노동의 자동화 “이 결과물이 진짜 유용한가?”에 대한 안목

보시다시피 AI가 지루한 단순 노동을 가져간 덕분에, 인간은 ‘소프트웨어 개발에서 가장 재미있고 가치 있는 영역’에만 집중할 수 있게 되었습니다! 

저스틴) 인간이 할 일과 AI가 할 일 구분은 쓸데없는 일 입니다. 내 일을 세계에서 제일 잘 하는 멘토 형님이 옆에 있다고 하고, 큰 기대치를 갖고 요청하는 일에 집중하세요. 그렇게 해도 멘토 형님이 잘 못하는 것은 귀신 같이 찾아낼거니 걱정하지 말고요.

STAGE 3 — Evidence and Application: 기술 프리미엄의 이동과 5년 뒤 미래

앞으로 2~5년 안에 다가올 변화는 명확합니다.

  1. 다중 에이전트(Multi-agent)의 일상화: 혼자 일하는 AI가 아니라, 수많은 AI 분신들이 각자 디자인, 백엔드, 테스트를 나눠서 작업하는 시스템이 기본이 될 것입니다.
  2. 역할의 전문화: 보안만 전문으로 감시하는 보안 에이전트, 성능만 최적화하는 성능 에이전트가 여러분의 지시에 따라 작동하게 됩니다.
  3. 가치의 이동: 코딩 문법을 달달 외우는 기술보다, “원하는 바를 명확하게 전달하는 소통 능력”과 “제품에 대한 직관(Product Intuition)”의 가치가 폭발적으로 올라갈 것입니다.

비개발자라도 아이디어와 제품 직관만 있다면, Claude Code를 통해 상위 1%의 개발력을 손에 쥐게 되는 시대가 온 것입니다!

STAGE 4 — Summary and Extension: “AI가 도와줬는데, 진짜 내 작품일까요?”

마지막으로 마음속 깊이 남는 질문 하나에 답을 드립니다.

“AI가 대부분의 코드를 짰는데, 이 프로그램은 진짜 내가 만든 게 맞을까요?”

저자는 주저 없이 “100% 여러분의 작품입니다”라고 단언합니다.

건축가가 직접 망치로 벽돌을 쌓지 않고 시공팀에 지시했다고 해서, 그 건물이 건축가의 작품이 아니라고 말하는 사람은 없습니다.

아이디어를 내고, 스펙을 결정하고, AI를 지휘하고, 결과물을 검증하여 세상에 내놓은 주체는 바로 여러분입니다. Claude Code는 지치지 않는 아주 유능한 손발이었을 뿐입니다.

두려워하지 마세요. 망설이지 말고 생각했던 아이디어를 만들고 세상에 출시하세요(Ship)! 세상을 바꾸는 것은 기술을 논쟁하는 사람이 아니라, 직접 무언가를 만들어내는 사람입니다.

 

 

[ANALYSIS_START] LECTURE_THEME: Claude Code 커스텀 스킬 (Skills / Slash Commands) 활용 및 작성법 LEARNER_STRUGGLE_POINT: “매번 새로운 대화창에서 디자인 지침이나 코딩 스타일을 일일이 재설명하는 것이 귀찮다”, “AI가 매번 생소하고 평범한 디폴트 디자인만 뱉어낸다”라는 번거로움 해소. CANDIDATE_ANALOGIES/EXAMPLES:

  1. 책상 위의 ‘업무 가이드 라미네이트 코팅 카드’: 매번 수기 지시서를 쓰는 대신, 전문가의 지침이 적힌 카드 한 장을 딱 집어서 던져주는 것.
  2. 스킬 파일: CLAUDE.md가 특정 ‘프로젝트’의 규칙이라면, Skills는 특정 ‘업무 유형(태스크)’에 사용하는 전문가 모자(필살기 페르소나). PRIMARY_LEARNER_BACKGROUND / DIFFICULTY_CALIBRATION: Part 2 실전 응용 과정. 마크다운(.md) 파일 하나로 내 AI 파트너에게 장착할 커스텀 커맨드(/frontend-design, /commit 등)를 생성하는 실용적 가이드. SOURCE_STATUS: HAS SOURCE (Joey Primiani, Think. Prompt. Create, Chapter 13) SOURCE_HANDLING_PLAN: 원문의 라미네이트 카드 비유와 스킬 작동 원리를 15자 이내 단일 인용 포함하여 저스틴의 언어로 해설. VISUAL_AID_PLAN: [CLAUDE.md vs Skills 비교 표] 및 [스킬 파일 작성 5단계 anatomy 구조도] 제공. STRUCTURAL_PLAN:
  • STAGE 1 (Why It Matters): 매번 같은 지시를 반복하던 비효율의 종말 (라미네이트 코팅 카드).
  • STAGE 2 (Unpacking Core Concept): 스킬(Skills / Slash Commands)이란 무엇인가? 작동 원리와 위치.
  • STAGE 3 (Evidence and Application): 내장 스킬 활용, 나만의 커스텀 스킬 작성법 (실전 마크다운 예시), CLAUDE.md와의 차이점.
  • STAGE 4 (Summary and Extension): 팀 단위 공유 스킬 및 실습 과제 제시. MEMORY_LOG_CHECK: 심화 응용 과정 첫 번째 회차 (Chapter 13). [ANALYSIS_END]

 

Part 2 실전 응용 편의 첫 번째 시간, Chapter 13 “스킬: 나만의 커스텀 파워업 (Skills, Your Custom Power-Ups)”에 오신 것을 환영합니다!

새 대화창을 열 때마다 AI에게 “디자인은 노션 스타일로 해주고, 코드는 이렇게 짜고…” 하고 반복해서 설명하다가 지친 적 있으신가요? 오늘 배울 스킬(Skills / Slash Commands)은 이 번거로움을 단 한 줄의 명령어로 싹 날려버리는 강력한 비밀 무기입니다.

STAGE 1 — Why It Matters: 책상 위에 놓인 ‘전문가 가이드 카드’

스킬을 이해하는 가장 좋은 비유가 있습니다.

책상 위에 ‘업무별 라미네이트 코팅 카드’ 몇 장이 올려져 있다고 생각해 보세요.

  • [카드 1] 프로 디자이너처럼 예쁜 UI 만드는 법
  • [카드 2] 깔끔한 Git 커밋 메시지 작성하는 법
  • [카드 3] 랜딩페이지 카피라이팅 모범 답안

매번 길게 설명할 필요 없이, Claude Code에게 원하는 카드 한 장을 딱 내밀며 “이 카드대로 해!”라고 지시하는 것입니다.

저자는 스킬의 본질을 이렇게 말합니다.

“a skill gives it context about how to approach a class of problems.”
(Joey Primiani, Think. Prompt. Create, Chapter 13)
“스킬은 특정 문제 유형에 접근하는 방식의 맥락을 제공합니다.”

슬래시 명령어 하나로 Claude Code에게 전문가 모자를 씌워주는 것이죠! 

저스틴) 당신의 업무에 이 카드들을 만드세요. 전 세계에서 가장 내 일을 잘 하는 멘토 형님은 어떻게 일 할까?를 생각하면서.  시작은 내 수준에서 어떻게 하는 지 작성합니다.

STAGE 2 — Unpacking the Core Concept: 스킬은 어떻게 작동할까요?

스킬의 실체는 사실 아주 간단한 마크다운(.md) 파일입니다.

우리가 대화창에 /frontend-design이라고 치는 순간, Claude Code는 내 컴퓨터 특정 폴더에 저장된 frontend-design.md 파일을 읽어서 그 안에 적힌 전문가 지침을 내 질문에 싹 적용합니다.

스킬 파일이 저장되는 위치

  1. 전역 스킬 (모든 프로젝트용): ~/.claude/skills/ 폴더 안
  2. 프로젝트 전용 스킬: 내 프로젝트 폴더 안의 .claude/skills/ 폴더 안

파일 이름이 명령어가 됩니다! commit.md라는 파일로 저장하면 /commit이라는 나만의 필살기 명령어가 탄생합니다.

STAGE 3 — Evidence and Application: 내장 스킬 활용 및 나만의 스킬 만들기

1. 이미 들어있는 내장 스킬들

Claude Code에는 이미 유용한 기본 스킬들이 들어있습니다. 대화창에 /help를 치면 목록을 볼 수 있습니다.

  • /frontend-design: 예쁜 UI를 만드는 디자이너 모드로 전환
  • /commit: 변경된 코드를 자동으로 읽고 멋진 Git 커밋 메시지 생성
  • /review-pr: 작성된 코드의 문제점과 보안을 리뷰해 주는 검사관 모드

2. 나만의 커스텀 스킬 만들기 (예: /landing-copy)

자주 반복하는 작업이 있다면 직접 스킬을 만드세요! 예를 들어, 마케팅 문구를 잘 써주는 스킬을 만들고 싶다면 ~/.claude/skills/landing-copy.md 파일에 이렇게 작성하면 됩니다.

이제 어떤 대화창에서든 /landing-copy 바쁜 부모를 위한 건강 식단 앱 문구 작성해 줘라고 치기만 하면 최고의 결과가 나옵니다!

3. CLAUDE.md vs Skills 한눈에 비교하기

구분 CLAUDE.md Skills (스킬)
중심 대상 프로젝트(Project) 자체에 대한 정보 특정 업무(Task)를 처리하는 노하우
적용 시점 대화가 시작되면 항상 켜져 있음 /스킬명을 입력할 때 필요할 때만 켜짐
비유 프로젝트 인수인계서 분야별 전문가 가이드 카드

STAGE 4 — Summary and Extension: 팀의 자산을 만드세요

오늘 강의의 핵심 요약입니다:

  1. 반복 지시의 자동화: 자주 반복하는 고품질 프롬프트 지침은 .md 파일로 만들어 스킬로 등록하세요.
  2. 스킬의 저장 위치: 모든 곳에서 쓰려면 ~/.claude/skills/, 해당 프로젝트에서만 쓰려면 .claude/skills/에 저장하세요.
  3. 팀의 가산: 팀원들과 공통 스킬(.claude/skills/)을 공유하면, 모든 팀원이 상위 1% 품질의 코드를 똑같은 스타일로 생산해 낼 수 있습니다.

 

[ANALYSIS_START] LECTURE_THEME: 프로덕션급 UI 디자인을 빠르게 구축하는 방법 (/frontend-design 스킬 및 레퍼런스 기법) LEARNER_STRUGGLE_POINT: “AI가 짜주는 UI 디자인은 너무 평범하고 촌스럽다 (어설픈 흰색 카드, 어정쩡한 파란 버튼)”, “디자이너 없이 예쁜 웹 화면을 만들 방법이 없을까?”라는 고민 해소. CANDIDATE_ANALOGIES/EXAMPLES:

  1. AI 디자인의 ‘촌스러운 디폴트(Default) 신드롬’: 명확한 레퍼런스나 디자인 지침을 안 주면 AI는 제일 무난하고 흔해 터진 흰색 카드와 파란 버튼만 뱉어낸다.
  2. 유명 브랜드 페르소나 기법 (“Think Linear”, “Think Notion”): 무의미한 수식어 대신 검증된 디자인 브랜드의 영혼을 빌려와 적용하는 기법. PRIMARY_LEARNER_BACKGROUND / DIFFICULTY_CALIRMATION: 초보자 및 비디자이너 대상. 복잡한 CSS 문법을 안 외워도, 레퍼런스 제시 프롬프트와 /frontend-design 스킬을 활용해 프로급 웹 화면(Hero section, Dashboard, Pricing table 등)을 만드는 실전 노하우 전달. SOURCE_STATUS: HAS SOURCE (Joey Primiani, Think. Prompt. Create, Chapter 14) SOURCE_HANDLING_PLAN: 원문의 “AI-generated UI 느낌”을 벗어나는 레퍼런스 기법과 디자인 시스템 구축법을 15자 이내 단일 인용 포함하여 저스틴의 언어로 해설. VISUAL_AID_PLAN: [주요 디자인 레퍼런스 페르소나 5선] 및 [핵심 UI 컴포넌트 프롬프트 모음] 표 제공. STRUCTURAL_PLAN:
  • STAGE 1 (Why It Matters): 왜 AI가 만들어낸 UI는 촌스러워 보일까? (디폴트 신드롬)
  • STAGE 2 (Unpacking Core Concept): /frontend-design 스킬의 5대 디자인 원칙과 레퍼런스 제시 기법.
  • STAGE 3 (Evidence and Application): 치트키 브랜드 5선, CSS 변수(:root)로 만드는 디자인 시스템, 실전 컴포넌트 프롬프트.
  • STAGE 4 (Summary and Extension): 진짜 디자이너와의 협업 지점 및 요약. MEMORY_LOG_CHECK: Chapter 13(Skills)에 이어 실전 UI 디자인 적용 회차. [ANALYSIS_END]

 

오늘은 Chapter 14, “프로덕션급 예쁜 인터페이스 빠르게 만들기 (Building Beautiful Interfaces Fast)”를 다룹니다.

솔직하게 말해보겠습니다. 지금까지 AI가 만들어준 웹 화면들을 떠올려보세요. 어딘가 모르게 “아, 이거 AI가 만들었네…” 하는 촌스러운 느낌이 들지 않으셨나요? 흰색 네모 카드, 구석에 박힌 우중충한 파란색 버튼, 어색한 여백… 작동은 하지만 기억에는 전혀 남지 않는 디자인이죠.

오늘 배울 /frontend-design 스킬과 레퍼런스 제시 기법을 사용하면 디자이너 없이도 애플, 리니어, 노션 느낌의 깔끔하고 매혹적인 UI를 뚝딱 만들어낼 수 있습니다!

STAGE 1 — Why It Matters: AI 디자인이 촌스러웠던 진짜 이유

왜 일반 AI에게 UI를 만들어달라고 하면 촌스럽게 나올까요?

원작자는 AI가 디자인 감각이 없어서가 아니라 ‘우리가 아무런 기준을 주지 않았기 때문’이라고 지적합니다.

“look like AI-generated UIs.”
“AI가 생성한 듯한 흔하고 촌스러운 모습”

우리가 “예쁘게 만들어줘”라는 모호한 말만 던지면, AI는 가장 무난하고 지루한 ‘기본값(Default)’으로 채워버립니다.

하지만 /frontend-design 스킬을 켜면, AI는 디자이너의 관점(시각적 위계, 4px/8px 여백 규칙, 절제된 색상, 타이포그래피)으로 생각하기 시작합니다. 

STAGE 2 — Unpacking the Core Concept: 치트키 “Think [브랜드]” 레퍼런스 기법

UI 프롬프트를 작성할 때 가장 강력한 비결은 모호한 감상평(“멋지게 해줘”) 대신 검증된 유명 서비스의 디자인 레퍼런스를 대는 것입니다!

Claude Code는 세상의 수많은 우수한 디자인을 이미 학습했기 때문에, 이름만 대도 그 스타일을 완벽히 구현해 냅니다.

디자이너 없이 활용하는 5대 브랜드 레퍼런스

  1. “Think Linear”: 어두운 다크모드, 치밀하고 정교함. (개발자 도구, 기술/생산성 앱 추천)
  2. “Think Notion”: 군더더기 없는 미니멀리즘, 훌륭한 가독성. (문서, 지식 관리 앱 추천)
  3. “Think Stripe”: 고급스러운 그라데이션, 압도적인 신뢰감. (결제, 핀테크, SaaS 앱 추천)
  4. “Think Airbnb”: 따뜻하고 친근함, 사진과 카드가 돋보임. (마켓플레이스, 라이프스타일 앱 추천)
  5. “Think Apple”: 넉넉한 여백, 극강의 심플함과 세련미. (제품 소개, 프리미엄 서비스 추천)

STAGE 3 — Evidence and Application: 디자인 시스템 구축과 실전 프롬프트

1. 일관성을 유지하는 ‘디자인 시스템’ 먼저 만들기

앱의 페이지가 여러 개로 늘어날 때 디자인이 튀지 않으려면, 개별 페이지를 만들기 전에 디자인 시스템(CSS 변수)을 먼저 정의하라고 지시하세요.

[프롬프트 예시]
“/frontend-design 페이지를 만들기 전에, 우리 앱 전체에서 사용할 디자인 시스템을 먼저 정의해 줘.

  • 브랜드 메인 컬러 1개, 중립 색상 5단계, 에러/성공 색상
  • 폰트 크기와 여백 단계(4px, 8px, 16px…)
    이 값들을 CSS 변수(:root 블록)로 작성해 줘.”

이렇게 지시해 두면, 다음 대화부터 Claude Code는 이 변수를 자동으로 재활용하여 모든 페이지의 디자인 일관성을 유지합니다!

2. 실전 컴포넌트 프롬프트 모음

  • 히어로 섹션 (첫 화면): /frontend-design SaaS 제품 소개용 첫 화면(Hero section). 큰 헤드라인, 보조 설명글, 2개의 CTA 버튼, 대시보드 캡처 목업 포함. Dark background. Think Stripe.
  • 요금제 비교표 (Pricing Table): /frontend-design 3단계 요금제 비교표. Free($0), Pro($12/월 - '가장 인기' 표시), Enterprise. 월/연 결제 토글 스위치 포함. Think Linear.
  • 대시보드 (Dashboard): /frontend-design 통합 분석 대시보드. 좌측 사이드바 메뉴, 상단 프로필 바, 상단에 4개의 핵심 지표 카드(숫자 및 변동률%), 아래에는 큰 차트 영역 배치. Think Notion.

STAGE 4 — Summary and Extension: 90%의 완성도와 인간 디자이너

오늘 강의의 핵심 요약입니다:

  1. /frontend-design 스킬: AI에게 프로 디자이너의 안목을 부여하는 치트키입니다.
  2. 레시피는 “Think [브랜드]”: Linear, Notion, Stripe, Apple 같은 브랜드를 언급하면 디자인 품질이 획기적으로 올라갑니다.
  3. 디자인 시스템 구축: :root 변수로 색상과 여백을 미리 정해두면 여러 페이지를 만들어도 디자인이 깨지지 않습니다.

/frontend-design 스킬은 디자인의 90%까지 완벽하게 끌어올려 줍니다. 나머지 10%의 독창적인 브랜드 아이덴티티나 세밀한 미감은 인간 디자이너와 협업할 때 빛을 발하게 됩니다.

 

오늘은 Chapter 15, “프롬프트 하나로 발표 자료(Slide Deck) 완성하기 (Presentations, From Prompt to Slide Deck)”를 다룹니다.

회사 일이나 사업을 하면서 PPT나 피치덱(Pitch Deck)을 만드느라 몇 시간 동안 텍스트 상자 맞추고, 색상 고르고, 템플릿 찾느라 밤새운 경험 있으시죠?

프로그래밍 관점에서 잘 만든 프레젠테이션은 사실 ‘구조와 디자인, 메시지를 담은 멋진 프로그램’입니다. 오늘 수업에서는 Claude Code에게 말 한마디만 던져서 몇 초 만에 고품질 슬라이드 덱을 만들어내는 3가지 비법을 공개합니다!

STAGE 1 — Why It Matters: PPT 디자인과의 지루한 싸움은 끝났습니다

프레젠테이션 제작에서 진짜 중요한 것은 ‘어떤 이야기(Narrative)를 전달할 것인가’입니다. 하지만 우리는 80%의 시간을 텍스트 크기 조절, 상자 맞추기, 색상 맞추기 같은 무의미한 디자인 작업에 빼앗기곤 합니다.

원작자는 이를 이렇게 표현합니다.

“A well-built slide deck is a program”
“잘 만들어진 슬라이드 덱은 하나의 프로그램입니다.”

프로그램을 짜듯 Claude Code에게 구조와 내용만 전달하면, 디자인과 레이아웃은 AI가 완벽하게 다듬어서 완성된 파일로 선물해 줍니다. Does that make sense?

STAGE 2 — Unpacking the Core Concept: 발표 자료를 만드는 3가지 접근법

상황에 따라 가장 적합한 방식을 선택하세요!

접근법 1: 개발자가 가장 사랑하는 HTML 슬라이드 (reveal.js)

가장 깔끔하고 반응속도가 빠른 방법입니다. 단 하나의 presentation.html 파일로 완성되며, 브라우저에서 방향키나 스페이스바를 누르면 슬라이드가 부드럽게 넘어갑니다.

[프롬프트 예시]
“reveal.js 라이브러리를 사용해서 ‘Meridian’이라는 B2B 계약 관리 소프트웨어 투자 유치용 피치덱(7장)을 만들어줘.

  1. 표지 (제목 및 한 줄 요약)
  2. 문제점 (스프레드시트와 이메일의 혼란)
  3. 해결책 (Meridian의 3가지 핵심 기능)
  4. 제품 화면 스크린샷 자리
  5. 지표 (12개 고객사, $240K ARR)
  6. 팀 소개
  7. 투자 요청 ($1.5M 시드 투자)
    배경은 진한 곤색(#0A192F), 글자는 흰색, 강조색은 전동 블루(#3B82F6)로 고급스럽게 디자인해 줘.”

! open presentation.html을 치면 브라우저에 최고급 피치덱이 즉시 펼쳐집니다!

접근법 2: PowerPoint (.pptx) 전용 파일 만들기

Node.js의 PptxGenJS 라이브러리를 활용하면, Claude Code가 코드를 짜서 백그라운드에서 실행해 포맷이 완벽한 .pptx 파일로 짜잔 하고 추출해 냅니다.

[프롬프트 예시]
“PptxGenJS 라이브러리를 사용해서 Atlas Logistics 회사 소개서 5장짜리 .pptx 파일로 추출하는 스크립트를 짜고 실행해 줘.”

STAGE 3 — Evidence and Application: 긴 보고서를 슬라이드로 자동 변환하기

1. 긴 PDF나 회의록을 슬라이드로 뚝딱 변환하기

이미 작성된 긴 보고서, PDF, 회의록 메모가 있다면 Claude Code에게 던져주고 슬라이드로 요약해달라고 하세요.

[프롬프트 예시]
“내 연구 보고서 research-report.pdf 파일 전체를 읽고, 핵심 내용만 뽑아서 10장짜리 임원보고용 프레젠테이션으로 요약해 줘. [문제점 → 주요 발견 → 제안] 순서의 스토리텔링 구조로 구성하고, 가장 중요한 통계 수치는 대형 텍스트 카드로 강조해 줘.”

2. 매달 숫자가 자동으로 바뀌는 ‘살아있는 슬라이드 (Living Document)’

매달 임원 회의나 실적 보고를 할 때 PPT를 새로 만드느라 고생하셨나요?

Claude Code에게 “모든 주요 지표(매출, 유저 수 등)를 코드 맨 위의 변수(Variables)로 모아줘”라고 지시해 두세요. 다음 달에는 변수의 숫자 몇 개만 바꾸고 재생성 버튼을 누르면 1초 만에 최신 실적 슬라이드로 갱신됩니다!

STAGE 4 — Summary and Extension: 명품 슬라이드를 만드는 3대 실전 팁

오늘 강의의 핵심 요약입니다:

  1. 한 슬라이드에는 오직 하나의 메시지만!: Claude Code에게 “한 슬라이드에 두 가지 이야기가 들어가면 슬라이드를 2장으로 쪼개줘”라고 제약 조건을 주세요.
  2. 시원시원한 폰트 크기: 헤드라인은 60px 이상, 본문은 28px 이상으로 크게 요청해야 발표장에서 잘 보입니다.
  3. 데이터의 자동 갱신: 핵심 수치를 변수로 관리하여 상시 업데이트 가능한 ‘살아있는 슬라이드’를 만드세요.

 

오늘은 Chapter 16, “구글 생태계 연동: Google Docs, Sheets, Workspace 자동화 (Connecting Claude Code to Your Google Workspace)”를 다룹니다.

회사원이나 사업가라면 누구나 매일 Google Docs로 보고서를 쓰고, Google Sheets로 매출이나 회원 명부를 정리하며, Google Calendar로 일정을 잡을 것입니다.

만약 Claude Code가 여러분의 구글 계정과 직접 대화하면서 데이터를 읽고, 보고서를 쓰고, 자동으로 일정을 잡아준다면 어떨까요? 오늘 강의를 통해 여러분의 업무 시간을 90% 이상 줄여드리겠습니다!

STAGE 1 — Why It Matters: 내 구글 드라이브에 잠들어 있는 거대한 데이터 보물창고

구글 시트의 매출 기록, 구글 문서의 고객 인터뷰 노트, 구글 폼의 설문조사 결과… 우리는 엄청난 양의 데이터를 구글 드라이브에 쌓아두고 있습니다.

원작자는 이 가치를 이렇게 말합니다.

“you are sitting on an enormous amount of data”
“여러분은 거대한 데이터 보물창고 위에 앉아 있습니다.”

문제는 이 데이터들을 사람이 손으로 일일이 옮겨 적고 집계하느라 수많은 시간을 허비한다는 점입니다. Claude Code를 구글 드라이브와 연결하는 순간, 이 노가다 작업은 30초짜리 자동 스크립트로 변신합니다. 

STAGE 2 — Unpacking Core Concept: 구글 연동의 2가지 접근법

상황에 맞춰 2가지 길 중 하나를 선택하면 됩니다!

방법 A: 복잡한 설정 없이 당장 쓰는 방법 (Export/Import)

API 인증이 귀찮다면 구글 시트에서 파일 → 다운로드 → CSV로 받은 뒤, 폴더에 넣고 Claude Code에게 던져주면 끝납니다.

[프롬프트 예시]
“고객 인터뷰 노트를 다운로드해서 interviews.txt로 넣었어. 이 문서를 읽고 1) 공통적인 불편사항(Pain Points), 2) 인상 깊은 고객 인용구, 3) 가장 많이 요구된 기능 3가지를 정리해서 제품팀용 보고서로 만들어줘.”

방법 B: 실시간 라이브 API 연결 4단계 (Option B)

실시간으로 구글 시트나 문서를 자동으로 고치고 싶다면, 구글 클라우드 콘솔(console.cloud.google.com)에서 OAuth 2.0 인증 키를 받으면 됩니다.

  1. Google Cloud에서 새 프로젝트 생성
  2. 사용할 API 활성화 (Google Docs API, Google Sheets API, Google Calendar API 등)
  3. 인증 정보(OAuth Client ID) 생성 후 .json 파일로 다운로드
  4. Claude Code에게 이렇게 지시하세요:

    “내 구글 API 인증 키가 ~/google-credentials.json에 있어. 이 키를 사용해서 구글 시트의 첫 번째 탭 데이터를 읽어오는 Node.js 스크립트를 짜고 실행해 줘.”

STAGE 3 — Evidence and Application: 실전 업무 자동화 레시피

API 연동이 끝났다면 실행할 수 있는 놀라운 자동화 업무들을 소개합니다.

1. 구글 시트 다중 분석 (Cross-Document Analysis)

매출 데이터, 고객 지원 티켓, 앱 사용량 시트 3개를 한꺼번에 읽어서 상관관계를 분석시킬 수 있습니다.

“매출 시트(sales.csv)와 고객 문의 시트(support.csv)를 비교 분석해 줘. 제품 문의를 가장 많이 한 고객들이 실제로 매출에 기여하는 비중이 얼마나 되는지 확인해 줘.”

2. 구글 캘린더 자동 일정 예약

“다음 주 내 캘린더를 읽어서 2시간 이상 연속으로 비어있는 집중 업무(Deep Work) 시간을 찾아서 알려줘. 그리고 매주 화요일 오후 2시에 ‘제품 리뷰 회의’ 반복 일정을 생성하고 팀원들을 초대해 줘.”

3. 월요병을 없애주는 ‘매주 자동 보고서 체인’ (Full Automation)

여러 API를 하나로 엮으면 월요일 아침마다 스스로 작동하는 완전 자동화 스크립트를 만들 수 있습니다.

이 스크립트를 한 번 만들어두면, 매주 월요일마다 수동으로 보고서를 쓰던 2시간이 단 30초로 단축됩니다!

STAGE 4 — Summary and Extension: 구글 생태계가 여러분의 무기가 됩니다

오늘 강의의 핵심 요약입니다:

  1. 단순 분석은 방법 A: CSV나 TXT 파일로 다운로드해서 폴더에 넣고 질문하는 것이 가장 빠릅니다.
  2. 자동화는 방법 B: OAuth 2.0 키를 연동해 두면 구글 문서 생성, 시트 수정, 캘린더 예약을 프로그램으로 자동 실행할 수 있습니다.
  3. 보안 주의: 다운로드한 구글 API 인증 키(.json)는 절대로 GitHub에 커밋하지 마세요! (.gitignore에 추가 필수)

이해가 잘 되시나요? (Does that make sense?)

 

오늘은 Chapter 17, “진짜 데이터베이스: Supabase 연동하기 (Real Databases, Connecting to Supabase)”를 다룹니다.

우리가 Chapter 6에서 만든 독서 기록장은 브라우저 임시 저장소(localStorage)를 사용했습니다. 내 컴퓨터에서 혼자 쓸 때는 괜찮지만, 로그인 기능을 넣거나, 친구와 공유하거나, 스마트폰에서도 접속하고 싶다면 진짜 클라우드 데이터베이스가 필요합니다.

과거에는 로그인과 DB를 구축하려면 몇 달 동안 백엔드 프로그래밍을 배워야 했습니다. 하지만 오늘 배울 Supabase(수파베이스)와 Claude Code가 만나면, 단 한 번의 세션 만에 누구나 진짜 백엔드를 장착한 고성능 웹 앱을 완성할 수 있습니다!

STAGE 1 — Why It Matters: 임시 저장소를 넘어 ‘진짜 앱’으로의 진화

localStorage는 언제든 인터넷 방문 기록을 비우면 소중한 데이터가 싹 날아가 버립니다.

원작자는 진정한 앱 개발을 위해 이렇게 선언합니다.

“Real applications need real databases.”
(Joey Primiani, Think. Prompt. Create, Chapter 17)
“진짜 애플리케이션에는 진짜 데이터베이스가 필요합니다.”

백엔드 개발자를 따로 고용하지 않고도, 구글 로그인 기능, 데이터 영구 저장, 이미지 업로드, 실시간 대화창 동기화까지 갖춘 완성형 서비스를 만들어봅시다. Does that make sense?

STAGE 2 — Unpacking Core Concept: Supabase는 ‘조립식 클라우드 백엔드’입니다

Supabase는 백엔드에 필요한 모든 것을 미리 다 만들어두고 우리에게 빌려주는 ‘풀옵션 클라우드 백엔드 빌딩’입니다.

Supabase가 제공하는 5대 핵심 무기

  1. Database (PostgreSQL): 세계 최고의 안정성을 자랑하는 데이터베이스.
  2. Authentication (회원가입/로그인): 이메일 로그인, 구글/깃허브 소셜 로그인 완벽 지원.
  3. Storage (파일 저장소): 프로필 사진, PDF, 이미지 업로드용 클라우드 용량.
  4. Realtime (실시간 동기화): 새로고침 없이 화면이 착착 바뀌는 실시간 데이터 연결.
  5. Edge Functions (서버 코드): 회원가입 시 환영 이메일을 쏘는 서버 전용 스크립트.

STAGE 3 — Evidence and Application: 5분 만에 연결하고 앱 완성하기

1. Supabase 연동 3단계

  1. supabase.com에서 회원가입 후 New Project 생성.
  2. 설정(Settings) → API 메뉴에서 2가지 정보를 복사:
    • Project URL (예: https://xyz.supabase.co)
    • Anon Key (공개용 API 키)
  3. .env 파일에 발급받은 URL과 Key를 적어두면 준비 끝!

2. Claude Code에게 테이블 만들라고 시키기

[프롬프트 예시]
“Supabase에 연결해서 할 일 목록(Todos) 앱을 만들고 싶어.

  1. id, title, is_complete, created_at 컬럼을 가진 todos 테이블을 만드는 SQL 문을 작성해 줘. (내가 Supabase SQL 에디터에 붙여넣을게)
  2. 그리고 이 테이블과 연동되는 HTML 프론트엔드 코드를 짜줘.”

3. 회원가입과 로그인 & 내 집 보안(Row Level Security, RLS)

로그인 기능을 넣을 때 가장 중요한 것은 ‘남의 데이터를 내가 볼 수 없게 만드는 것’입니다.

[프롬프트 예시]
“우리 앱에 이메일/비밀번호 로그인 및 회원가입 기능을 추가해 줘.
핵심 조건: 각 사용자는 자신이 만든 todos만 볼 수 있어야 해 (Row Level Security 적용). 로그인하지 않은 사용자는 로그인 페이지로 튕기게 해줘.”

여기서 적용되는 Row Level Security(RLS)는 마치 아파트 도어락 같습니다. 내 열쇠로는 오직 내 집(내 데이터)만 열리고, 남의 집은 절대로 접근할 수 없도록 데이터베이스 자체에서 강력하게 지켜주는 보안 기술입니다.

4. 실전 종합 프로젝트: 나만의 미니 CRM (고객 관리 시스템)

Supabase와 Claude Code가 만나면 비싼 회사용 CRM 시스템도 직접 만들어낼 수 있습니다.

[프롬프트 예시]
“Supabase를 이용해 미니 CRM 웹 앱을 만들어줘.

  • 인증: 팀원 이메일 로그인
  • 고객 관리: 고객 이름, 이메일, 전화번호, 회사명, 메모 검색 및 정렬
  • 상담 기록: 전화/이메일/미팅 상담 일지 타임라인 작성
  • 대시보드: 총 고객 수, 이번 주 상담 건수 통계 그래프”

STAGE 4 — Summary and Extension: 백엔드 보안의 황금 규칙 3가지

오늘 강의의 핵심 요약입니다:

  1. RLS(행 단위 보안) 필수 적용: 유저 데이터를 다루는 모든 테이블에는 반드시 RLS를 켜야 안전합니다.
  2. 두 개의 키 구분하기: 공개용 Anon Key는 프론트엔드에 써도 되지만, 강력한 비밀 키인 Service Role Key는 절대 외부에 노출하면 안 됩니다!
  3. 배포 전 보안 감사 요청: Claude Code에게 항상 배포 전 audit을 부탁하세요:
    “배포하기 전에 우리 앱에 하드코딩된 API 키가 있는지, RLS가 잘 걸려있는지 보안 점검을 해줘.”

 

오늘은 Chapter 18, “나만의 소셜 네트워크 서비스 만들기 (Building a Social Network)”를 다룹니다.

트위터(X), 인스타그램, 쓰레드(Threads) 같은 소셜 네트워크(SNS)라고 하면 수백 명의 천재 엔지니어와 거대한 자본이 필요하다고 생각하곤 합니다. 하지만 본질을 들여다보면 SNS는 ‘사람(프로필), 글(포스트), 관계(팔로우)’라는 3가지 요소의 조합일 뿐입니다.

오늘 수업에서는 Supabase와 Claude Code를 활용해 이번 주말에 바로 사람들을 초대해서 쓸 수 있는 진짜 미니 SNS 서비스를 처음부터 끝까지 구축해 보겠습니다!

STAGE 1 — Why It Matters: 트위터도 시작은 작은 아이디어였습니다

소셜 네트워크를 만들 때 거창하게 시작할 필요가 전혀 없습니다.

원작자는 이 프로젝트의 가치를 이렇게 강조합니다.

“surprisingly buildable in a weekend”
(Joey Primiani, Think. Prompt. Create, Chapter 18)
“주말 동안 충분히 만들어낼 수 있는 서비스입니다.”

여러분만의 취향을 담은 비공개 커뮤니티, 특정 동호회 전용 SNS, 회사 내부용 피드 등 진짜 사용자가 가입하고, 글을 올리고, 팔로우하며 소통하는 진짜 플랫폼을 만드는 기쁨을 경험해 보세요. Does that make sense?

STAGE 2 — Unpacking Core Concept: SNS 설계의 3가지 질문과 데이터 모델

코드 한 줄을 적기 전, 서비스의 방향을 결정하는 3가지 질문에 답해야 합니다.

  1. 콘텐츠 단위는 무엇인가?: 글 중심인가(트위터), 사진 중심인가(인스타그램)? (우리는 280자 글 + 사진으로 정합니다)
  2. 관계는 어떻게 작동하는가?: 서로 동의해야 친구가 되는 쌍방향(페이스북)인가, 일방적으로 구독하는 단방향(트위터)인가? (우리는 단방향 팔로우로 정합니다)
  3. 공개 범위는 어떠한가?: 전체 공개인가, 비공개 계정인가? (기본은 전체 공개로 시작합니다)

SNS의 핵심 5대 데이터베이스 테이블

Claude Code에게 데이터베이스 뼈대를 만들어달라고 요청할 때 이 5개 테이블을 언급하세요!

성능의 비밀: 수치 직접 저장 (Denormalization)

글을 불러올 때마다 “좋아요가 몇 개지?” 하고 매번 개수를 카운트하면 서버가 터집니다. 그래서 posts 테이블에 like_count(좋아요 수)나 follower_count 수치를 아예 적어두고, 좋아요를 누를 때마다 +1씩 자동으로 올라가게 만든 트리거(Trigger)를 구축하는 것이 상위 1%의 노하우입니다.

STAGE 3 — Evidence and Application: 실전 기능 구현 및 Vercel 배포

1. 앱의 속도감을 10배 높여주는 ‘낙관적 업데이트 (Optimistic Update)’

SNS가 둔하게 느껴지면 유저들은 바로 떠납니다.

‘좋아요’ 하트 버튼이나 ‘팔로우’ 버튼을 누를 때, 서버 응답이 올 때까지 기다렸다가 화면을 바꾸지 마세요. 버튼을 누르자마자 화면 수치를 먼저 +1 올리고, 백그라운드에서 서버와 통신하는 기법이 바로 낙관적 업데이트입니다.

[프롬프트 예시]
“홈 피드(Home Feed)를 구축해 줘.

  • 내가 팔로우하는 사람들과 내 글을 최신순으로 보여주기
  • 각 카드에 작성자 프로필, 상대적 시간(‘2시간 전’), 글 내용, 좋아요 하트 버튼, 댓글 수 표시
  • 중요: 유저가 좋아요를 누르면 서버 응답을 기다리지 않고 화면의 하트 색상과 숫자를 즉시 올려주는 낙관적 업데이트를 적용해 줘. 아래로 스크롤 하면 글이 계속 나오는 무한 스크롤(Infinite Scroll)도 구현해 줘.”

2. 실시간 알림 시스템 (Notifications)

누군가 내 글에 좋아요를 누르거나 팔로우를 하면 알림이 뜨는 시스템입니다.

“누군가 나를 팔로우하거나 내 글에 좋아요/댓글을 남기면 notifications 테이블에 자동으로 기록되고, 상단 종 모양 아이콘에 빨간색 미확인 알림 뱃지가 뜨게 해줘.”

3. 전 세계에 무료 배포하기 (Vercel)

앱이 다 만들어졌다면 Vercel(버셀)이라는 초고속 무료 호스팅 서비스에 올려봅시다!

  1. GitHub에 내 소스 코드를 git push로 올리기
  2. vercel.com에 가입 후 내 GitHub 저장소 연결
  3. Supabase의 SUPABASE_URL과 SUPABASE_ANON_KEY를 Vercel의 환경 변수(Environment Variables) 세팅에 복사해 넣기!
  4. Deploy 버튼을 누르면 1분 만에 나만의 SNS 주소(my-social-app.vercel.app) 탄생!

STAGE 4 — Summary and Extension: 진짜 유저를 받아볼 준비가 되었습니다

오늘 강의의 핵심 요약입니다:

  1. SNS의 5대 테이블: profiles, posts, follows, likes, replies의 관계만 세우면 어떤 SNS든 만들 수 있습니다.
  2. 낙관적 업데이트: 좋아요나 팔로우 버튼은 클릭 즉시 반응하도록 만들어 유저 경험을 극대화하세요.
  3. Vercel 배포: Supabase(백엔드) + Vercel(프론트엔드) 조합으로 이번 주말 나만의 소셜 서비스를 인터넷에 배포해 보세요.

 

오늘은 Chapter 19, “Claude Code로 아이폰 앱 만들기 (Creating iOS Apps With Claude Code)”를 다룹니다.

내 스마트폰 홈 화면에 내가 만든 앱 아이콘이 깔리고, 손가락을 댈 때마다 햅틱 진동이 느껴지며, 위젯까지 띄워지는 기쁨! 상상만 해도 가슴이 뛰지 않나요?

과거에는 아이폰 앱을 만들려면 어려운 Swift 언어를 배우고, 까다로운 Xcode 프로그램을 공부해야 했습니다. 하지만 오늘, Claude Code와 함께라면 웹 개발보다 훨씬 가볍게 나만의 아이폰 앱을 제작할 수 있습니다!

STAGE 1 — Why It Matters: 내 손안의 아이폰 앱이 현실이 됩니다

애플의 모바일 앱 개발 환경은 진입 장벽이 높기로 유명했습니다.

원작자는 Claude Code가 가져온 변화를 이렇게 말합니다.

“the learning curve compresses dramatically.”
(Joey Primiani, Think. Prompt. Create, Chapter 19)
“학습 곡선이 획기적으로 단축됩니다.”

Mac 컴퓨터와 Xcode 프로그램만 준비되어 있다면, 어려운 문법을 외우지 않고도 내 아이디어대로 작동하는 진짜 아이폰 앱을 만들어낼 수 있습니다. Does that make sense?

STAGE 2 — Unpacking Core Concept: SwiftUI를 다루는 3가지 핵심 키워드

우리는 애플의 공식 앱 제작 프레임워크인 SwiftUI를 사용할 것입니다. Swift 언어 전체를 몰라도 다음 3가지 개념만 알면 Claude Code에게 완벽하게 지시할 수 있습니다.

  • View: 버튼 하나도, 글자 하나도, 전체 화면도 모두 ‘뷰(View)’입니다.
  • State: 만약 체크박스를 눌렀는데 화면이 안 바뀐다면? AI에게 이렇게 말하세요. “데이터가 @State로 지정이 안 되어있어서 화면이 갱신되지 않는 것 같아. 확인해 줘.”

STAGE 3 — Evidence and Application: 습관 관리기(Habit Tracker) 앱과 아이폰 고유 기능

실제로 앱스토어에 올릴 만한 ‘습관 관리기(Habit Tracker)’ 앱을 만들어봅시다.

1. Xcode 프로젝트 생성 후 Claude Code 시작하기

  1. Mac에서 Xcode 실행 → Create a new Xcode project → App 선택
  2. Interface에서 SwiftUI 선택 후 저장
  3. 터미널에서 해당 프로젝트 폴더로 이동 후 claude 실행!

[프롬프트 예시]
“Xcode로 SwiftUI 아이폰 습관 관리기 앱을 만들고 있어.
주요 기능: 1) 매일 지킬 습관 추가, 2) 오늘 달성한 습관 체크하기, 3) 연속 달성일(🔥 12일) 표시, 4) 30일 달성 달력 보기.
디자인은 애플의 공식 Human Interface Guidelines (HIG) 지침을 준수해서 SF Pro 폰트와 깔끔한 iOS 순정 스타일로 만들어줘.”

2. 아이폰만의 강력한 하드웨어 기능 4가지

웹 앱에서는 느낄 수 없는 진짜 모바일 앱만의 기능들을 추가해 보세요!

  1. 손맛이 느껴지는 햅틱 진동 (Haptics):

    “습관을 체크할 때 UIImpactFeedbackGenerator를 사용해 묵직하고 기분 좋은 진동 효과를 넣어줘.”

  2. 푸시 알림 (Notifications):

    “매일 저녁 8시까지 완료되지 않은 습관이 있으면 ‘잊지 마세요: [습관 이름]’ 알림을 띄워줘.”

  3. 바탕화면 위젯 (WidgetKit):

    “아이폰 바탕화면에 오늘 습관 달성률을 보여주는 진행률 링 위젯을 만들어줘.”

  4. Face ID 생체 인증 (LocalAuthentication):

    “앱을 열 때 Face ID로 잠금을 해제해야 들어올 수 있는 보안 설정을 추가해 줘.”

STAGE 4 — Summary and Extension: 앱스토어 제출과 Cross-Platform (React Native)

앱이 완벽하게 만들어졌다면? Claude Code에게 “App Store Connect에 앱을 올리기 위한 스크린샷 사이즈와 개인정보 처리방침, 심사 거절 방지 체크리스트를 뽑아줘”라고 지시하여 제출을 준비하세요!

만약 안드로이드(Android) 앱도 동시에 만들고 싶다면?

SwiftUI 대신 React Native를 선택하면 됩니다. 우리가 그동안 배운 JavaScript 기술 그대로 하나의 소스코드로 아이폰과 안드로이드 앱을 동시에 출시할 수 있습니다!

오늘 강의의 핵심 요약입니다:

  1. SwiftUI의 3대 요소: Views, State, Previews의 흐름만 파악하세요.
  2. Apple HIG 준수: “Apple의 Human Interface Guidelines을 따라줘”라고 말하면 순정 아이폰 앱처럼 고급스러워집니다.
  3. 모바일 특화 기능: 햅틱 진동, 위젯, Face ID, 알림을 붙여 진짜 스마트폰 앱의 손맛을 완성하세요.

 

오늘은 Chapter 20, “하드웨어와 임베디드 시제품 만들기 (Hardware, Firmware and the Physical World)”를 다룹니다.

화면 안에서만 움직이던 내 코드가 실물 전구(LED)를 밝히고, 모터를 돌리며, 온도 센서를 읽어내는 순간! 개발자로서 느껴지는 전율은 사뭇 다릅니다.

어려운 C++ 문법이나 전자회로 지식이 부족해도 괜찮습니다. Claude Code는 전 세계 수백만 건의 하드웨어 배선도와 펌웨어 코드를 학습했기 때문에, “어떤 전선을 어디에 꽂아야 하는지”까지 친절하게 가이드해 줍니다. 준비되셨나요?

STAGE 1 — Why It Matters: 모니터 밖의 세상으로 확장되는 나의 코드

웹이나 모바일 앱 개발과 달리, 하드웨어 개발은 ‘물리적 기기(Hardware)’를 다룹니다.

원작자는 이 짜릿한 순간을 이렇게 말합니다.

“When your code makes an LED blink for the first time, something shifts.”
(Joey Primiani, Think. Prompt. Create, Chapter 20)
“여러분이 짠 코드로 LED가 처음으로 반짝일 때, 무언가가 달라집니다.”

단돈 1만~2만 원짜리 작은 보드 하나로 내 방의 온도를 모니터링하고, 화분에 자동으로 물을 주며, 움직임을 감지해 스마트폰으로 사진을 쏘아주는 사물인터넷(IoT) 세상을 내 손으로 만들 수 있습니다! Does that make sense?

STAGE 2 — Unpacking Core Concept: 3대 하드웨어 플랫폼 한눈에 정리하기

상황에 맞는 하드웨어를 선택하는 것이 첫걸음입니다.

플랫폼 특징 비유 주요 용어 추천 용도
Arduino (아두이노) 운영체제 없음. 가볍고 단순함. 단순 무식한 노동자 C++, setup(), loop() 센서 읽기, LED 조작, 모터 제어 입문
Raspberry Pi (라즈베리파이) 리눅스(OS)가 돌아가는 초소형 컴퓨터. 손바닥만한 미니 PC Python, Linux, GPIO 보안 카메라, 파일 서버, AI 영상 처리
ESP32 1만 원대! Wi-Fi와 블루투스가 기본 탑재됨. 통신 능력을 갖춘 똑똑한 기계 MicroPython, Wi-Fi IoT 초연결 장비, 클라우드 DB 연동

하드웨어 코드의 핵심 구조: setup()과 loop()

모든 미니 기판(아두이노/ESP32)은 똑같은 원리로 작동합니다.

  • setup(): 기기가 켜질 때 딱 1번만 실행되는 초기화 설정
  • loop(): 전원이 꺼질 때까지 24시간 끊임없이 영원히 반복(Loop)되는 무한 실행 루틴

STAGE 3 — Evidence and Application: 실전 IoT 온도 모니터링 시스템 구축

실제로 가장 인기가 많은 ESP32 + Supabase 클라우드 데이터베이스 조합으로 집안 온도를 감시하는 IoT 시스템을 만들어봅시다!

1단계: ESP32 펌웨어 작성 프롬프트

Claude Code에게 내가 가진 센서 이름과 핀 번호를 알려주세요. 배선 방법까지 상세히 알려줍니다.

[프롬프트 예시]
“ESP32 보드와 DHT22 온도 센서를 가지고 있어.

  1. 30초마다 온습도를 측정하고 Wi-Fi를 통해 우리 Supabase DB temperatures 테이블에 보낼 MicroPython 코드를 짜줘.
  2. 온도가 28도가 넘어가면 빨간색 LED가 켜지게 해줘.
  3. 센서 전선을 ESP32의 몇 번 핀에 꽂아야 하는지 배선 연결 가이드(Wiring Diagram)를 초보자 눈높이로 설명해 줘.”

2단계: 클라우드 웹 대시보드 연동

하드웨어가 Supabase로 전송한 실시간 온도 데이터를 웹 화면에 멋지게 띄웁니다.

[프롬프트 예시]
“/frontend-design Supabase DB에 저장되는 온도 데이터를 읽어서 보여주는 웹 대시보드를 만들어줘.

  • 현재 온도/습도를 30초마다 실시간 갱신
  • 최근 24시간 온도 변화 선 그래프(Chart)
  • 온도가 28도 이상이면 상단에 빨간색 경고 바 표시”

이것으로 여러분은 [실물 센서 ➔ 클라우드 DB ➔ 웹 화면]으로 이어지는 완벽한 엔드투엔드 사물인터넷(IoT) 시스템을 구축한 것입니다!

STAGE 4 — Summary and Extension: 하드웨어 디버깅의 황금 규칙

소프트웨어와 달리 하드웨어는 코드가 틀렸을 수도 있지만, ‘전선이 헐겁거나 엉뚱한 핀에 꽂혔을 확률’이 훨씬 높습니다!

  1. 배선부터 재확인하라: 코드를 고치기 전에 전선이 올바른 핀에 잘 꽂혀있는지 그림과 비교하세요.
  2. Serial.print() 활용하기: 화면이 없는 하드웨어 기기는 시리얼 모니터로 글자를 출력해 봐야 센서가 제대로 동작하는지 알 수 있습니다.
  3. 노이즈 필터링 요청하기: 센서 수치가 기복이 심하게 튀면 Claude Code에게 *”센서 측정값에 필터링(Moving Average)을 적용해서 부드럽게 다듬어줘”*라고 요청하세요.

 

오늘 다룰 Chapter 21은 이 책 본문의 마지막 장, “10가지 선물 같은 실전 활용법 모음집 (Ten More Things Claude Code Can Build)”입니다.

지금까지 우리는 멘탈 모델부터 시작해 웹 앱, 데이터베이스, 소셜 네트워크, 아이폰 앱, 하드웨어 IoT까지 깊숙하게 공부했습니다.

마지막 시간인 오늘은 시야를 크게 넓혀보는 시간입니다! 크롬 확장 프로그램, 디스코드 보트, 터미널 CLI 도구, 데이터 파이프라인, 그리고 내 컴퓨터에서 무료로 돌리는 ‘로컬 AI’까지… Claude Code로 당장 만들어볼 수 있는 10가지 실전 프로젝트의 비밀 레시피를 모두 공개합니다!

STAGE 1 — Why It Matters: 기술과 기술 사이의 ‘다리(Bridge)’를 놓다

서로 다른 시스템을 연결하는 일(예: 크롬 브라우저 ➔ 로컬 파일, 디스코드 ➔ 깃허브, 센서 ➔ 클라우드)은 과거에 두 시스템의 복잡한 규칙을 모두 외워야만 가능했습니다.

원작자는 이 10가지 사례를 관통하는 핵심을 이렇게 강조합니다.

“Claude Code knows both systems and can build the bridge.”
(Joey Primiani, Think. Prompt. Create, Chapter 21)
“Claude Code는 두 시스템을 모두 알고 있으며 그 사이의 다리를 놓아줍니다.”

여러분에게 필요한 것은 이제 코딩 지식이 아닙니다. “두 기술을 연결해서 무엇을 만들어낼 것인가”에 대한 명확한 아이디어와 비전뿐입니다! Does that make sense?

STAGE 2 — Unpacking Core Concept: 당장 써먹는 10대 실전 프로젝트 보물상자

원하는 아이디어를 하나 골라서 오늘 당장 터미널에 프롬프트를 던져보세요!

1. 크롬 확장 프로그램 (Chrome Extension)

“집중력을 높여주는 ‘Focus Blocker’ 크롬 확장 프로그램을 만들어줘. 유튜브, 트위터 접속을 차단하고 타이머를 보여주는 manifest.json, popup.html, content.js 파일을 생성해 줘.”

2. 디스코드 보트 (Discord Bot)

“매일 아침 9시마다 팀원들에게 오늘 할 일을 물어보고 요약해 주는 Standup 디스코드 보트를 Discord.js로 만들어줘.”

3. 슬랙 자동화 앱 (Slack App)

“GitHub에서 새로운 기능 배포(PR)가 완료되면 슬랙 #deployments 채널에 변경 사항 요약과 이모지 반응을 자동으로 올려주는 슬랙 앱을 만들어줘.”

4. 터미널 시간 관리 CLI 도구 (Command-Line Tool)

“터미널에서 timetrack start [프로젝트명]으로 프로젝트별 작업 시간을 기록하고 CSV로 내보내는 CLI 도구를 만들어줘.”

5. 자동 데이터 파이프라인 (ETL)

“매일 밤 12시 쇼피파이 매출 데이터를 가져와 PostgreSQL DB 유저 정보와 합성한 뒤, 구글 시트와 슬랙으로 일간 KPI 보고서를 쏴주는 자동화 파이프라인을 만들어줘.”

6. AI 기반 서비스 (AI-Powered App)

“유저가 제출한 PDF 이력서와 채용 공고를 읽고, Anthropic API(Claude)를 활용해 이력서 점수와 5가지 개선점을 분석해 주는 웹 앱을 만들어줘.”

7. 웹 브라우저 자동화 (Playwright / Puppeteer)

“채용 사이트를 자동으로 탐색하여 새로 올라온 채용 공고를 긁어오고(크롤링), 엑셀 파일로 정리해 매주 월요일 이메일로 보내주는 스크립트를 만들어줘.”

8. 웹 기반 HTML5 게임 (Games)

“/frontend-design 끝말잇기 단어 게임 ‘Chain Reaction’을 만들어줘. 15초 제한 시간, 스코어보드, 콤보 효과, localStorage 최고기록 저장을 포함해 줘.”

9. 뉴스레터 이메일 자동화 (Email Automation)

“Supabase에 구독자 이메일을 저장하고, Resend API를 이용해 오픈율 추적이 가능한 뉴스레터를 발송하는 이메일 마케팅 시스템을 만들어줘.”

10. 완전히 사적인 내 컴퓨터 ‘로컬 AI’ (Local AI with Ollama)

인터넷 연결 없이, 내 개인 문서 데이터를 서버 외부로 전혀 유출하지 않는 100% 비공개 AI 조수입니다!

“내 컴퓨터에 오라마(Ollama)와 llama3 모델이 돌아가고 있어. 내 컴퓨터의 ~/notes/*.md 개인 문서들을 읽어서 내 질문에 비공개로 답해주는 나만의 개인 지식 보조 웹 UI를 만들어줘.”

STAGE 3 — Evidence and Application: 기술적 한계를 뛰어넘는 비전의 힘

이 10가지 프로젝트를 만드는 데 필요한 것은 컴퓨터 과학 학위가 아닙니다.

  • 크롬 브라우저 ➔ 확장 프로그램 연동
  • 로컬 문서 ➔ 내 컴퓨터 안의 로컬 AI 연동
  • 센서 데이터 ➔ 클라우드 DB 연동

서로 다른 2개 이상의 기술을 엮는 접점에서 Claude Code의 능력은 폭발적으로 발휘됩니다. 여러분이 해야 할 일은 [무엇을 엮을 것인가]를 명확한 문장으로 설명하는 것뿐입니다.

STAGE 4 — Summary and Extension: 여정을 마치며, 이제 가서 만드세요!

이것으로 Joey Primiani의 《Think. Prompt. Create》 모든 본문 강의를 마치게 됩니다!

그동안 우리는:

  1. AI를 바라보는 멘탈 모델(수석 동료 개발자)을 세웠고
  2. 프롬프트와 CLAUDE.md로 대화하는 법을 배웠으며
  3. 웹, DB, SNS, iOS 앱, 하드웨어, 자동화까지 모든 영역을 누볐습니다.

원작자는 마지막으로 우리에게 최고의 당부를 건넵니다.

“The differentiator was not technical expertise. It was the clarity of their vision and the quality of their prompts. You have both of those. Now go build something.”
“차이를 만드는 것은 기술적 지식이 아니었습니다. 비전의 명확함과 프롬프트의 품질이었습니다. 여러분은 이미 그 두 가지를 모두 가졌습니다. 이제 가서 무언가를 직접 만들어보세요!”

 

드디어 우리가 Joey Primiani의 《Think. Prompt. Create》 거대한 여정의 가장 마지막 페이지, “결론: 당신은 이미 개발자입니다 (CONCLUSION: You Are Already a Developer)”에 도달했습니다!

이 마지막 강의를 시작하기 전, 눈을 감고 우리가 지난시간 동안 함께 해낸 일들을 돌아봅시다.

여러분은 개발자들의 전용 도구를 설치했고, AI와 코드로 대화했으며, 웹 앱을 만들었고, 빨간색 에러 메시지를 해결했으며, GitHub에 코드를 올리고 인터넷 세상에 배포했습니다. 나아가 데이터베이스, 소셜 네트워크, 아이폰 앱, 하드웨어 IoT까지 구축해 냈습니다.

이제 제가 여러분에게 꼭 드리고 싶은 말이 있습니다.

STAGE 1 — Why It Matters: “내가 진짜 개발자가 맞을까요?”

이 책을 마치는 이 순간에도 마음 한구석에서 이런 음성이 들릴지 모릅니다. “하지만 난 아직 C++도 잘 모르고, 10년 차 수석 엔지니어처럼 복잡한 알고리즘을 짜지도 못하는데… 내가 개발자가 맞을까?”

원작자는 이 자격지심에 대해 단호하고 명확하게 답합니다.

“You are a developer.”
(Joey Primiani, Think. Prompt. Create, Conclusion)
“당신은 개발자입니다.”

10년 차 카레이서처럼 차를 개조하지 못한다고 해서, 운전대를 잡고 원하는 목적지까지 안전하게 차를 몰고 가는 사람을 ‘운전자’가 아니라고 부를 수 있을까요?

당신은 아이디어를 가지고, 강력한 도구를 활용해 작동하는 소프트웨어로 만들어냈으며, 세상에 출시(Ship)하고 개조할 수 있는 사람입니다. 소프트웨어 세상에서 가장 중요한 능력은 바로 그것입니다. Does that make sense?

STAGE 2 — Unpacking Core Concept: 지름길을 택했을 뿐, 이해를 건너뛴 것이 아닙니다

과거에는 ‘아이디어’가 ‘실제 작동하는 제품’이 되기까지 최소 3년에서 5년이라는 지루한 문법 암기의 시간이 필요했습니다. 그리고 대부분의 사람들은 그 지루한 ‘시간의 병목’을 견디지 못하고 포기했죠.

여러분은 그 병목을 뛰어넘는 가장 스마트한 지름길을 통과한 것입니다.

우리는 이해를 건너뛰지 않았습니다. 개념을 배우고, 에러를 경험했으며, 아키텍처를 결정했습니다. 단지 개념과 구현 사이의 지루한 시간을 AI라는 초고속 엔진으로 압축했을 뿐입니다.

STAGE 3 — Evidence and Application: 책을 덮은 후 실천해야 할 5가지 행동 지침

이제 이 책을 덮고 나면 무엇을 해야 할까요? 저자가 제시하는 5가지 행동 지침을 가슴에 품으세요.

STAGE 4 — Summary and Extension: 도구는 인간의 열정을 섬길 뿐입니다

마지막으로 여러분의 가슴에 새겨두어야 할 가장 중요한 진실이 있습니다.

Claude Code는 인류 역사상 가장 위대한 생산성 도구입니다. 하지만 그것은 어디까지나 ‘도구’일 뿐입니다.

  • AI에게는 자신의 목표가 없습니다.
  • AI는 여러분이 제품을 배포했을 때 함께 기뻐해 주지 않습니다.
  • AI는 스스로 위대한 아이디어를 품고 가슴 뛰지 않습니다.

무언가를 만들겠다는 열망, 완성했을 때의 자부심, 세상을 바꾸겠다는 야망은 오직 ‘인간인 여러분의 것’입니다. Claude Code는 여러분의 그 위대한 야망을 섬기기 위해 존재하는 지치지 않는 손발입니다.

도구를 멋지게 사용하세요. 훌륭하게 만들고, 자주 세상에 배포(Ship)하세요. 세상은 이제 여러분이 만들어낼 위대한 작품들을 기다리고 있습니다.

 

본문 과정을 멋지게 완주하신 여러분, 정말 고생 많으셨습니다!

오늘부터는 실전 개발 현장에서 여러분의 시간을 10배 아껴줄 부록 파트를 진행합니다. 그 첫 시간으로 “부록 A: 필수 명령어 치트시트 (Essential Commands Cheat Sheet)”를 준비했습니다.

강의를 시작하기 전에 한 가지 약속할게요. 오늘 배우는 명령어들을 절대로 외우려고 하지 마세요!

개발자들도 이 명령어들을 머릿속에 다 외우고 다니지 않습니다. 필요할 때마다 책상 옆에 붙여둔 ‘스킬 커맨드 표(Cheat Sheet)’를 슬쩍 보고 타이핑할 뿐입니다. Does that make sense?

STAGE 1 — Why It Matters: 외우지 말고, 주머니에서 꺼내 쓰세요

원작자는 이번 부록의 목적을 이렇게 명시합니다.

“Essential Commands Cheat Sheet”
(Joey Primiani, Think. Prompt. Create, Appendix A)
“필수 명령어 요약 치트시트”

개발을 하다가 “아, 이전 대화 요약하는 슬래시 명령어가 뭐였지?”, “Git 커밋 메시지 남기는 명령어가 뭐였지?” 하고 헷갈릴 때마다 이 챕터를 단축키처럼 열어보세요.

여러분의 시간을 벌어주는 가장 실용적인 컨닝 페이퍼가 되어드릴 겁니다!

STAGE 2 — Unpacking Core Concept: 5대 핵심 명령어 카테고리

가장 자주 쓰는 명령어들을 5가지 영역으로 깔끔하게 나누어 정리했습니다.

1. Claude Code 시작하기 (터미널에서 실행)

  • claude: 대화형 세션 시작
  • claude --continue: [자주 씀] 가장 최근에 나누던 대화 이어가기
  • claude -p "지시문": 단발성 명령 실행 (대화 세션 없이 바로 결과 도출)
  • claude --dangerously-skip-permissions: 승인 창 없는 자동 자율 실행 모드 (격리된 환경에서만 사용!)

2. 세션 내부 슬래시 명령어 (/) — AI 자체 조종

  • /help: 사용 가능한 모든 명령 보여주기
  • /clear: [자주 씀] 대화 내역 초기화하고 깨끗하게 새 시작하기
  • /compact: [핵심] 대화가 길어졌을 때 기억을 압축하여 요약하기 (속도 개선)
  • /status: 현재 사용 중인 토큰(기억 용량) 및 상태 확인
  • /exit: Claude Code 종료하기

3. 세션 내부 쉘 명령어 (!) — 내 컴퓨터 터미널 조종

Claude 세션을 나가지 않고 맨 앞에 !를 붙여 내 컴퓨터 명령을 직접 실행합니다.

  • ! open index.html (Mac) / ! explorer.exe index.html (Win): 작성한 웹 페이지 브라우저로 열기
  • ! npm test: 테스트 코드 실행하기
  • ! npx serve .: 현재 폴더를 임시 웹 서버로 띄우기
  • ! git status / ! git add . / ! git push: Git 작업 실행하기

4. Git 필수 명령어 (버전 관리)

  • git init: 현재 폴더를 Git 저장소로 초기화
  • git add .: 변경된 모든 파일 상자에 담기
  • git commit -m "메시지": 세이브 포인트 남기기
  • git push: GitHub 클라우드로 업로드
  • git checkout -b branch-name: 새로운 작업 가지(Branch) 만들고 이동하기

5. 프로젝트 생성 & Node.js (npm) 명령어

  • mkdir 폴더명 & cd 폴더명: 새 폴더 만들고 들어가기
  • npm install 패키지명: 필요한 라이브러리 설치하기
  • npm run dev: 개발용 서버 구동하기

STAGE 3 — Evidence and Application: 실무에서 매일 쓰는 ‘황금 커맨드 패턴’

개발할 때 매일 반복되는 가장 완벽한 명령어 조합 순서입니다. 그대로 따라 해보세요!

이 패턴만 손에 익히면 여러분은 이미 숙련된 개발자처럼 매끄럽게 앱을 개발하고 배포할 수 있습니다.

STAGE 4 — Summary and Extension: 치트시트를 북마크해 두세요!

오늘 강의의 핵심 요약입니다:

  1. /와 !의 차이: Claude 자체 설정은 / (예: /compact), 내 컴퓨터 터미널 명령은 ! (예: ! open index.html).
  2. 외우지 않기: 이 치트시트 페이지를 브라우저에 북마크(즐겨찾기) 해두고 필요할 때마다 복사해서 쓰세요.

 

오늘은 “부록 B: 훔쳐서 바로 쓰는 50가지 명품 프롬프트 (50 Powerful Prompts to Steal)”를 다룹니다.

개발을 하다가 “아, 이걸 AI에게 뭐라고 물어봐야 가장 정확하게 답해줄까?” 하고 화면만 빤히 바라보며 프롬프트 문장을 고민한 적 있으시죠?

걱정 마세요! 오늘 수업에서는 지난 수천 시간 동안 개발자들이 사용해보며 검증한 가장 효과적인 50가지 명품 프롬프트 주문서를 몽땅 공개합니다. 고민하지 말고 그냥 훔쳐서 복사해 쓰세요!

STAGE 1 — Why It Matters: 고민하지 말고 훔쳐서 복사하세요

원작자는 이번 부록의 핵심을 이렇게 말합니다.

“50 Powerful Prompts to Steal”
(Joey Primiani, Think. Prompt. Create, Appendix B)
“훔쳐서 바로 쓰는 50가지 명품 프롬프트”

좋은 질문이 좋은 코드를 만듭니다. 여러분이 만들고 싶은 거의 모든 상황에 대한 템플릿이 이 50개 안에 들어있습니다. 필요할 때마다 복사해서 단어만 살짝 바꿔 사용해 보세요! Does that make sense?

STAGE 2 — Unpacking Core Concept: 8대 상황별 프롬프트 보물상자

50가지 프롬프트를 8가지 실무 상황으로 분류해 두었습니다.

1. 코드 이해 및 탐색 (Understanding & Exploration)

  • #1 (개요 파악): “이 코드베이스의 전체 개요를 알려줘. 무슨 일을 하고, 구조가 어떻고, 제일 중요한 파일이 뭐야?”
  • #2 (실행 추적): “사용자 요청이 프론트엔드에서 DB를 거쳐 돌아오기까지의 전체 경로를 파일과 함수 단위로 추적해 줘.”
  • #4 (취약점 파악): “이 프로젝트에서 가장 복잡하거나 깨지기 쉬운 취약한 부분은 어디야? 어디를 고칠 때 제일 조심해야 해?”

2. 코딩 전 사전 기획 (Planning Before Building)

  • #6 (3가지 제안 비교): “코드를 짜기 전에 [기능명]을 구현하는 3가지 접근 방식을 제안하고 각 방식의 장단점을 비교해 줘.”
  • #9 (최소 기능 시작): “핵심 요구사항만 충족하는 가장 단순한 버전의 [기능명]은 뭐야? 거기서부터 시작하자.”
  • #10 (선 승인 후 구현): “구현하기 전에 네 계획을 쉬운 말로 먼저 설명해 줘. 내가 승인하면 그때 코드를 짜자.”

3. 기능 구현 (Building & Implementing)

  • #12 (기존 컨벤션 준수): “우리 프로젝트의 기존 스타일에 맞춰서 [기능명]을 구현해 줘. 다른 파일들을 참고해서 똑같은 패턴을 따라줘.”
  • #15 (라이브러리 추가 금지): “새로운 패키지 설치 없이 구현해 줘. 오직 package.json에 이미 있는 것만 사용해.”

4. 코드 품질 및 리팩토링 (Code Quality)

  • #17 (단순화 지시): “이 코드를 더 단순하게 만들어줘. 똑똑하고 기발한 코드보다 읽기 쉽고 평범한 코드가 좋아.”
  • #18 (에러 예외 처리): “현실적으로 발생할 수 있는 모든 실패 케이스를 처리하는 에러 핸들링 코드를 추가해 줘.”

5. 디버깅 및 버그 해결 (Debugging)

  • #21 (에러 제보): “이런 에러가 나: [에러 복사]. [내 행동]을 했을 때 발생했어. 관련 코드를 읽고 원인을 찾아줘.”
  • #23 (콘솔 디버깅): “[함수명]에 console.log 문을 추가해서 각 단계마다 무슨 일이 일어나는지 추적할 수 있게 해줘.”

6. 성능 및 보안 (Performance & Security)

  • #26 (보안 점검): “사용자 입력, 인증, 데이터 노출 측면에서 보안 취약점이 있는지 이 코드를 점검해 줘.”
  • #28 (비밀번호/키 검사): “이 파일들 안에 하드코딩된 API 키, 비밀번호, 인증 정보가 있는지 확인해 줘.”

7. Git, 배포 및 문서화 (Git, Deployment & Docs)

  • #38 (스마트 커밋): “git diff를 확인하고 변경된 이유와 내용을 완벽하게 설명하는 커밋 메시지를 적어줘.”
  • #41 (CLAUDE.md 갱신): “오늘 나눈 결정 사항과 정립된 규칙들을 바탕으로 CLAUDE.md 파일 내용을 업데이트해 줘.”

8. 고급 및 메타 질문 (Advanced & Meta)

  • #46 (수석 엔지니어 리뷰): “네가 비판적인 수석 엔지니어라고 생각하고 배포 직전의 이 코드를 엄격하게 코드 리뷰해 줘.”
  • #50 (기술 부채 파악): “이 방식으로 구현하면 어떤 기술 부채가 쌓이게 되고, 어느 시점에 고쳐야 할까?”

STAGE 3 — Evidence and Application: 저스틴이 뽑은 ‘Top 5 만능 프롬프트’

50개 중에서도 실무에서 가장 자주 쓰이는 필살기 Top 5를 따로 정리해 드립니다. 이것만 복사해 두셔도 개발 생산성이 3배 올라갑니다!

STAGE 4 — Summary and Extension: 나만의 프롬프트 노트 만들기

오늘 강의의 핵심 요약입니다:

  1. 프롬프트를 외우지 말 것: 50가지 템플릿을 필요할 때마다 복사해서 사용하세요.
  2. 질문의 수준이 코드의 수준: AI에게 수석 엔지니어의 관점(#46)을 요구하면 수석 엔지니어급 코드가 나옵니다.

 

오늘 다룰 강의는 이 시리즈의 진짜 마지막 부록, “부록 C: 실력 성장을 위한 추천 프로젝트 12선 (Recommended Projects for Practice)”입니다.

소프트웨어 개발을 가장 빠르게 배우는 방법은 이론서를 10번 읽는 것이 아니라, 내 손으로 직접 앱 하나를 완성해 보는 것입니다.

오늘 소개하는 난이도별 12가지 프로젝트 중에서 마음에 드는 것 하나를 골라 당장 시작해 보세요! 시작 프롬프트까지 완벽하게 준비되어 있습니다. 준비되셨나요?

STAGE 1 — Why It Matters: 가장 좋은 공부는 만드는 것입니다

원작자는 이 부록의 마지막 문장에서 이렇게 당부합니다.

“The best way to learn is to build.”
(Joey Primiani, Think. Prompt. Create, Appendix C)
“학습하는 가장 좋은 방법은 만드는 것입니다.”

튜토리얼을 눈으로 볼 때는 다 아는 것 같지만, 직접 만들어볼 때 비로소 내 진짜 실력이 됩니다.

오늘 소개해 드리는 난이도별 프로젝트들은 여러분이 한 단계씩 승급하며 상위 1% AI-Native 개발자로 성장할 수 있도록 설계된 최고의 수련 과제들입니다! Does that make sense?

STAGE 2 — Unpacking Core Concept: 난이도별 12대 실전 프로젝트 로드맵

난이도와 완성 시간에 따라 3단계로 나누어져 있습니다.

🟢 1단계: 초급 프로젝트 (단 한 번의 세션, 2~4시간 소요)

별도의 외부 데이터베이스 없이, 단 하나의 index.html 파일과 브라우저 내장 저장소(localStorage)로 빠르게 성취감을 맛보는 프로젝트입니다.

  1. 개인 가계부 (Personal Budget Tracker): 수입/지출 입력, 카테고리별 통계, 잔액 계산.
  2. 포모도로 타이머 (Pomodoro Timer): 25분 집중, 5분 휴식 타이머, 알림음 및 시각적 애니메이션.
  3. 단어 빈도 분석기 (Word Frequency Analyzer): 글을 붙여넣으면 총 단어 수, 가장 많이 쓰인 단어 Top 20 분석.
  4. 나만의 브라우저 새 탭 페이지 (Custom New Tab Page): 예쁜 대형 시계, 개인화된 인사말, 북마크 관리.
  5. 마크다운 노트 앱 (Markdown Note-Taking App): 좌측은 마크다운 작성, 우측은 실시간 라이브 미리보기.

🟡 2단계: 중급 프로젝트 (다중 세션, 4~12시간 소요)

데이터 간의 관계가 복잡해지고, 검색/정렬/달력/애니메이션 등 풍부한 UX 기능이 들어갑니다.

  1. 요리 레시피 상자 (Recipe Box): 재료 및 요리 순서 등록, 인원수에 따른 재료 양 자동 계산, 인쇄용 CSS 지원.
  2. 습관 달력 추적기 (Habit Tracker): 달력 뷰(Calendar UI)를 통해 매일 습관 체크 및 연속 달성일(Streak) 계산.
  3. 암기 암기장 앱 (Flashcard Study App): 앞면(질문), 뒷면(답변) 플립 카드, 난이도별 반복 학습(Spaced Repetition) 알고리즘.
  4. 개인 자산 대시보드 (Personal Finance Dashboard): 가상의 은행 API 데이터를 읽어 시각적 차트(SVG)와 예산 한도 관리.

🔴 3단계: 고급 프로젝트 (본격적인 서비스 구축, 수주 소요)

실제 스타트업에서 서비스하는 수준의 복잡한 아키텍처와 기능을 갖춘 풀스택 앱입니다.

  1. 블로그 플랫폼 (Blog Platform): 마크다운 작성, 태그 검색, 암호화된 관리자 페이지, 깔끔한 URL 라우팅.
  2. 칸반 프로젝트 보드 (Kanban Board): 트렐로(Trello) 스타일의 카드 이동, 드래그 앤 드롭(Drag & Drop) 구현, 마감일 및 라벨.
  3. 프리랜서 인공지능 견적서/청구서 발행기 (Invoice Generator): 소계, 세금 자동 계산, PDF 내보내기/다운로드 기능.

STAGE 3 — Evidence and Application: 첫 번째 추천 시작 프롬프트

어떤 것부터 시작할지 고민되신다면, 초급 첫 번째인 ‘개인 가계부(Budget Tracker)’부터 시작해 보세요!

터미널을 열고 아래 프롬프트를 그대로 복사해서 던져보세요.

[개인 가계부 시작 프롬프트]
“Build a personal budget tracker as a single HTML file. I can add income and expense entries with amount, category, and description. The app shows a running balance, a breakdown by category, and persists data in localStorage.”
(하나의 HTML 파일로 나만의 개인 가계부 앱을 만들어줘. 금액, 카테고리, 설명을 적어 수입과 지출을 기록할 수 있고, 현재 잔액과 카테고리별 지출 비중을 보여주며, 새로고침해도 데이터가 유지되도록 localStorage를 사용해 줘.)

STAGE 4 — Summary and Extension: 책을 덮고, 터미널을 열어라!

원작자가 이 책의 가장 마지막에 던진 위대한 한 문장으로 강의를 마칩니다.

“Thank you for reading. Now close the book and open your terminal.”
“읽어주셔서 감사합니다. 이제 책을 덮고, 여러분의 터미널을 열어 실행하세요!”

그동안 저스틴과 함께 《Think. Prompt. Create》의 모든 과정을 함께해 주셔서 진심으로 감사드립니다! 여러분의 앞날에 위대한 AI-Native 개발자로서의 축복이 가득하기를 응원합니다! 🎉

 

드디어 Joey Primiani의 《Think. Prompt. Create》 그 기나긴 여정의 진정한 마침표, “부록 D: 비개발자를 위한 필수 코딩 용어 사전 (Glossary for Non-Technical Readers)”에 오신 것을 환영합니다!

소프트웨어 개발 분야의 용어들은 처음 들으면 외계어처럼 느껴집니다. 하지만 쉬운 비유로 개념을 짚고 나면 “아, 별것 아니었구나!” 하고 이내 고개를 끄덕이게 되죠.

오늘 수업은 어려운 전문 용어 없이, 일상의 언어로 명확하게 풀어낸 개발 용어 사전입니다. 평생 개발자들과 소통할 때 꺼내볼 수 있는 최고의 지식 무기가 되어줄 것입니다. 준비되셨나요?

STAGE 1 — Why It Matters: 용어의 벽을 허물면 세상이 명확해집니다

원작자는 이번 부록의 의도를 이렇게 밝힙니다.

“Plain-English Definitions for the Terms You Will Encounter”
(Joey Primiani, Think. Prompt. Create, Appendix D)
“여러분이 만나게 될 용어들에 대한 쉬운 해설”

어려운 기술 용어 때문에 주눅 들 필요가 전혀 없습니다. 용어의 본질적인 개념만 알고 있다면 여러분은 어떤 개발자와도 당당하게 대등한 대화를 나눌 수 있습니다! Does that make sense?

STAGE 2 — Unpacking Core Concept: 6대 영역별 핵심 용어 사전

가장 중요한 용어 45가지를 6개 영역으로 묶어 비유와 함께 정리해 드립니다.

1. 웹/앱 기본 구조 용어

  • API: [식당 메뉴판] 프로그램을 연결해 주는 인터페이스. 손님(프론트엔드)이 주문할 수 있는 음식(데이터)의 종류와 응답 규칙.
  • Frontend: [식당 홀] 사용자가 눈으로 보고 손으로 터치하는 모든 화면 (HTML, CSS, JS).
  • Backend: [식당 주방] 눈에 보이지 않는 서버 영역. 비즈니스 로직, 데이터 계산, 보안 처리.
  • Database: [디지털 창고/스프레드시트] 수많은 데이터를 안전하게 보관하고 주고받는 시스템.

2. 프로그래밍 기초 용어

  • Array: [목록 상자] 여러 개의 항목을 나열한 데이터 주머니 (예: ["사과", "바나나"]).
  • Boolean: 참(true) 또는 거짓(false) 딱 2가지 값만 가지는 가장 원초적인 데이터.
  • Function: [자판기] 동전(입력)을 넣으면 정해진 음료수(결과)를 뱉어내는 재사용 가능한 코드 상자.

3. 버전 관리 (Git & GitHub) 용어

  • Git: [타임머신 세이브 시스템] 코드의 과거 변경 이력을 추적하고 복구하는 소프트웨어.
  • Commit: [게임 세이브 포인트] 특정 시점의 내 코드를 설명 메시지와 함께 저장해 둔 스냅샷.
  • Branch: [평행 우주/복사본] 원본 코드를 건드리지 않고 새로운 실험을 해보기 위해 따낸 독립된 코드 가지.

4. AI & Claude Code 전용 용어

  • Token: [AI가 읽는 글자 단어 조각] AI가 문장을 이해할 때 쪼개서 계산하는 최소 단위 (보통 1단어 = 약 1.3 토큰).
  • Context Window: [AI의 작업 기억 용량] AI가 한 대화 창에서 한꺼번에 머릿속에 기억할 수 있는 텍스트의 총량.
  • MCP (Model Context Protocol): [AI용 플러그인 연결잭] Claude Code에 DB, 슬랙 등 외부 도구를 연결해 주는 표준 규칙.

5. 서버 및 보안 용어

  • localhost: [내 컴퓨터의 자기 자신 이름] 내 컴퓨터에서 서버를 돌려 웹을 테스트할 때 접속하는 인터넷 주소 (http://localhost:3000).
  • Environment Variable (.env): [비밀 금고] API 키나 비밀번호 등 중요한 비밀값을 코드 밖에 숨겨두고 읽어오는 시스템 환경 변수.

STAGE 3 — Evidence and Application: 비개발자가 꼭 기억해야 할 ‘핵심 5대 용어’

실무 대화에서 가장 자주 등장하는 필수 5대 용어를 한눈에 정리합니다!

STAGE 4 — Summary and Extension: 여러분의 지식 지도를 완성했습니다!

이것으로 Joey Primiani의 《Think. Prompt. Create》 책의 모든 본문과 부록(Appendix A, B, C, D) 과정이 완전히 마무리되었습니다! 🎉

기술 용어를 아는 것은 단순히 단어를 외우는 것이 아닙니다. 기술 용어는 세상을 새롭게 바라보는 ‘관점’을 선사합니다.

이제 여러분은 비개발자의 눈이 아닌, 기술의 본질을 이해하는 위대한 AI-Native 개발자의 눈으로 세상을 바라보게 되었습니다.

궁금한 용어가 생길 때마다 이 부록 D 사전 챕터를 편하게 열어보세요.

그동안 저스틴 강사와 함께해 주셔서 진심으로 감사드립니다! 세상을 바꿀 여러분의 멋진 제품들을 응원합니다! 

About the Author
(주)뉴테크프라임 대표 김현남입니다. 저에 대해 좀 더 알기를 원하시는 분은 아래 링크를 참조하세요. http://www.umlcert.com/kimhn/

Leave a Reply

*

About Us

회사명: (주)뉴테크프라임
대표자명: 김현남
서비스: 소프트웨어 모델링, 소프트웨어 개발
제품: RSM, RSM Smarteasy
연락처: admin@umlcert.com

Copyright © 뉴테크프라임. All Rights Reserved