Ai 마법서

비개발자 AI개발 문턱 넘기 - 강의 대본

35 min read

비개발자 AI개발 문턱 넘기 — 강의 대본

강의 컨셉: 완전 실습 위주. 이론은 최소, 손은 항상 움직인다. 말투 가이드: 친근하고 가볍게. “어렵지 않아요” 보다 “지금 바로 해봅시다”

🎬 오프닝 (인트로)

안녕하세요, 여러분!

오늘부터 저와 함께 AI 개발의 첫 문턱을 같이 넘어가 보겠습니다.

제목이 왜 “문턱 넘기”냐고요?

“마스터하기”도 아니고, “정복하기”도 아니에요. 딱 문턱 하나만 넘으면 된다는 뜻입니다.

잠깐, 제가 질문 하나 드릴게요.

회계사가 회계 프로그램을 만들면 잘 만들까요, 개발자가 만들면 잘 만들까요?

“당연히 개발자지!” 라고 생각하셨다면, 지금부터 그 생각을 바꾸셔야 해요.

개발자는 코드를 잘 써요. 그런데 회계를 몰라요. 실무에서 어떤 예외 상황이 생기는지, 어느 숫자가 핵심인지, 어떤 흐름으로 일이 돌아가는지 — 이건 수십 년 현장을 뛴 회계사만 알아요.

그래서 지금까지는 어떻게 했냐? 회계사가 개발자에게 설명하고, 개발자가 구현하고, 결과물이 마음에 안 들면 다시 설명하고, 또 수정하고… 이 과정에서 진짜 하고 싶었던 것의 절반도 구현이 안 되는 경우가 허다했어요.

근데 지금은 달라졌어요.

AI가 코드를 대신 씁니다. 완벽하게요.

그렇다면 이제 필요한 건 뭘까요?

도메인 전문성 — 그 분야를 깊이 아는 사람. 바로 여러분이에요.

의사가 직접 AI에게 “환자 데이터를 이렇게 분석하고, 이런 패턴이 나오면 이렇게 알림을 줘” 라고 말하면, 그 의사는 의사이면서 동시에 세상 어떤 개발자도 흉내 낼 수 없는 의료 앱을 만들 수 있어요.

마케터가 직접 AI에게 “우리 캠페인 데이터를 이 방식으로 시각화하고, 이 지표가 꺾이면 자동으로 리포트를 뽑아줘” 라고 하면? 그 마케터는 어떤 외주 개발사보다 훨씬 정확한 툴을 갖게 됩니다.

문턱 하나만 넘으면, 그 다음부터는 여러분이 개발자보다 훨씬 좋은 프로그램을 만들 수 있어요.

왜냐고요? 여러분은 그 분야의 진짜 문제가 뭔지 알고 있으니까요.

그 문턱이 뭐냐? 오늘 이 강의에서 배울 내용들이에요.

AI에게 제대로 된 지시를 내리는 방법, AI가 만들어준 코드가 돌아가는 환경을 세팅하는 방법 — 이것만 알면, 문턱은 넘은 거예요.

자, 그럼 시작해봅시다!

1강. VS Code — 개발자의 작업실 세팅하기

🎙️ 인트로

여러분 글 쓸 때 워드나 한글 쓰시죠? 개발자들한테도 그런 프로그램이 있어요. 그게 바로 VS Code입니다. Visual Studio Code의 줄임말인데, Microsoft에서 만든 코드 편집기예요. 무료고, 세계에서 가장 많이 쓰는 편집기입니다.

자, 지금 바로 설치부터 해봅시다.

💻 실습 1-1: VS Code 설치

👉 브라우저에서 code.visualstudio.com 접속 → 다운로드 → 설치

설치 중에 한 가지만 체크해주세요. “PATH에 추가” 옵션이 나오면 반드시 체크하고 넘어가세요. 이게 뭔지는 나중에 설명할게요. 일단 체크!

설치 완료됐으면 VS Code를 열어봅니다.

🎙️ UI 둘러보기

처음 열면 막막하실 텐데, 크게 보면 세 공간이에요.

왼쪽 사이드바 — 파일 탐색기, 검색, Git 등이 있어요. 지금은 파일 탐색기만 알면 됩니다.

가운데 에디터 — 코드를 실제로 쓰는 공간이에요. 워드의 본문 영역이라고 보시면 돼요.

아래 터미널 — 명령어를 입력하는 공간이에요. 이게 처음에 가장 낯선 부분인데, 오늘 이 시간 안에 친해지실 거예요.

터미널이 안 보이면? 상단 메뉴 → Terminal → New Terminal 클릭.

💻 실습 1-2: 첫 번째 폴더 열기

바탕화면에 my-ai-project 라는 폴더를 만들어봅시다.

바탕화면 우클릭 → 새 폴더 → 이름: my-ai-project

VS Code로 돌아와서 → File → Open Folder → 방금 만든 폴더 선택

이제 이 폴더가 여러분의 작업실이에요.

🎙️ Extension (확장 프로그램)

VS Code 왼쪽 사이드바에 블록 아이콘 보이시나요? 그게 Extension입니다. 일종의 앱스토어예요. VS Code에 기능을 추가로 설치할 수 있어요.

지금 당장 필요한 건 두 가지예요.

💻 실습 1-3: Extension 설치

Extension 아이콘 클릭 → 검색창에 입력:

  1. Korean Language Pack → 설치 (한국어 UI)
  2. Python → 설치 (나중에 파이썬 쓸 때 필요)

설치 후 VS Code 재시작하면 UI가 한국어로 바뀝니다.

🎙️ Claude Code 소개

이제 진짜 핵심이에요. Claude Code는 AI(Claude)를 VS Code 안에서 직접 쓸 수 있게 해주는 도구예요.

코드를 모르는 분들이 Claude Code를 쓰면 어떤 일이 벌어지냐? 제가 직접 보여드릴게요.

💻 실습 1-4: Claude Code 설치 및 첫 사용

터미널을 열고 아래 명령어를 붙여넣기 해주세요.

npm install -g @anthropic-ai/claude-code

⚠️ npm이 뭔지 지금 몰라도 됩니다. 2강에서 배워요.

설치 완료 후:

claude

처음 실행하면 로그인 화면이 나와요. Anthropic 계정으로 로그인하면 됩니다.

로그인 완료! 이제 여러분은 AI 개발자입니다. (웃음)

2강. 터미널 — 개발자의 진짜 언어

🎙️ 인트로

많은 분들이 터미널을 보면 왠지 영화에서 해커가 쓰는 그 검은 화면처럼 느끼시더라고요. 근데 터미널은 그냥 “컴퓨터에 말 거는 방법” 이에요. 마우스로 클릭하는 대신, 글자로 명령을 내리는 거예요.

왜 이걸 배워야 하냐? AI가 만들어준 코드를 실행하려면 터미널을 써야 합니다. 피할 수 없어요.

🎙️ CLI란?

CLI는 Command Line Interface의 약자예요. 우리가 쓰는 윈도우 바탕화면처럼 아이콘을 마우스로 클릭하는 건 GUI(Graphic User Interface)고, 텍스트로 명령을 입력하는 방식이 CLI입니다.

Windows에서 우리가 쓸 CLI는 PowerShell이에요.

VS Code 터미널에서 기본으로 PowerShell이 열립니다. 지금 바로 연습해봅시다.

💻 실습 2-1: 기본 터미널 명령어

VS Code 터미널을 열고 아래 명령어들을 하나씩 입력해보세요.

현재 위치 확인

pwd

내가 지금 어느 폴더에 있는지 알려줘요.

폴더 안의 파일 목록 보기

ls

현재 폴더에 뭐가 있는지 보여줘요.

폴더 이동

cd Desktop

Desktop(바탕화면) 폴더로 이동해요.

cd ..

한 단계 위 폴더로 올라가요.

폴더 만들기

mkdir test-folder

test-folder라는 새 폴더를 만들어요.

파일 만들기

New-Item hello.txt

hello.txt 파일을 만들어요.

🎙️ 정리

터미널 명령어 다 외울 필요 없어요. 모르면 Claude에게 물어보면 됩니다. 중요한 건 터미널이 뭔지, 왜 쓰는 건지를 아는 것이에요.

자, 이제 다음 단계로 넘어가봅시다.

3강. Python — AI 개발의 기본 언어

🎙️ 인트로

AI 개발할 때 가장 많이 쓰는 언어가 Python(파이썬) 이에요. 왜냐면 AI 라이브러리 대부분이 파이썬으로 만들어져 있거든요. OpenAI, Claude(Anthropic), HuggingFace… 전부 파이썬 SDK를 가장 먼저 내놔요.

파이썬은 문법이 영어 문장처럼 읽혀서 비개발자에게도 상대적으로 친근한 언어예요.

💻 실습 3-1: Python 설치

👉 브라우저에서 python.org 접속 → Downloads → Windows 버전 다운로드

⚠️ 설치할 때 반드시 체크할 것!

설치 화면 맨 아래에 “Add Python to PATH” 체크박스가 있어요. 이걸 꼭 체크하고 설치를 진행하세요. 이걸 빠뜨리면 나중에 파이썬 명령어가 안 먹혀요.

설치 완료 후, 터미널에서 확인:

python --version

Python 3.x.x 이런 식으로 버전이 뜨면 성공입니다!

🎙️ pip — 파이썬 패키지 관리자

파이썬 혼자로는 할 수 있는 게 한계가 있어요. 그래서 패키지라는 걸 써요.

패키지가 뭐냐? 예를 들어 여러분이 스마트폰으로 지도 보려면 지도 앱을 설치해야 하잖아요. 파이썬도 마찬가지예요. “Claude API 쓰고 싶다” → anthropic 패키지 설치. “엑셀 파일 읽고 싶다” → pandas 패키지 설치. 이렇게 필요한 기능을 패키지로 설치해서 쓰는 거예요.

그 패키지 설치 도구가 바로 pip입니다. Python Install Package의 약자예요.

💻 실습 3-2: pip로 패키지 설치해보기

pip install anthropic

이 명령어 하나로 Claude API를 쓸 수 있는 패키지가 설치됩니다. 신기하죠?

설치된 패키지 목록 보기:

pip list

패키지 제거:

pip uninstall anthropic

🎙️ 가상환경 — 프로젝트별 공간 분리

자, 이제 조금 중요한 개념이에요. 집중해주세요.

여러분이 프로젝트 A와 프로젝트 B를 동시에 개발한다고 해봅시다. A는 anthropic 버전 1.0이 필요하고, B는 버전 2.0이 필요해요. 그런데 컴퓨터에 하나만 설치할 수 있다면? 충돌이 나겠죠.

그래서 **가상환경(virtual environment)**을 씁니다. 프로젝트마다 독립된 파이썬 환경을 만드는 거예요. 마치 각 프로젝트에게 별도의 방을 주는 것처럼요.

아나콘다(Anaconda)라는 도구도 있는데, 우리는 **파이썬 기본 내장 기능인 .venv**를 쓸 거예요. 더 가볍고 단순해요.

💻 실습 3-3: 가상환경 만들기

my-ai-project 폴더에서 터미널을 열고:

python -m venv .venv

이 명령어를 실행하면 폴더 안에 .venv라는 숨겨진 폴더가 생겨요. 이게 가상환경이에요.

가상환경 활성화 (이걸 해야 가상환경이 실제로 적용됩니다):

.venv\Scripts\activate

터미널 앞에 (.venv) 라고 표시되면 성공! 이제 이 상태에서 pip로 설치하는 패키지는 모두 이 프로젝트에만 적용됩니다.

가상환경 비활성화:

deactivate

💡 팁: VS Code는 .venv를 자동으로 감지해서 가상환경을 활성화해줘요. 오른쪽 하단에 Python 버전이 표시되면 클릭해서 .venv 선택!

4강. Node.js — 또 다른 필수 도구

🎙️ 인트로

Node.js는 JavaScript를 브라우저 밖에서도 실행할 수 있게 해주는 환경이에요.

“잠깐, JavaScript는 웹 브라우저에서 쓰는 언어 아닌가요?” 맞아요. 근데 Node.js 덕분에 서버에서도, 터미널에서도 JavaScript를 쓸 수 있게 됐어요.

우리가 Node.js를 배워야 하는 이유는 두 가지예요.

첫째, 앞에서 설치한 Claude Code 자체가 Node.js로 만들어져 있어요. 둘째, AI Agent 도구들(LangChain, LlamaIndex 등)의 JavaScript 버전을 쓸 때 필요해요. 셋째, 프론트엔드(웹 화면) 개발할 때 React 같은 도구가 Node.js를 기반으로 해요.

💻 실습 4-1: Node.js 설치

👉 nodejs.org 접속 → LTS 버전 다운로드 → 설치

LTS는 “Long Term Support”의 약자예요. 안정적인 버전이라는 뜻이니까 LTS를 선택하세요.

설치 후 확인:

node --version
npm --version

둘 다 버전이 뜨면 성공! npm은 Node.js의 패키지 관리자예요. 파이썬의 pip랑 같은 역할을 합니다.

🎙️ npm이란?

npm은 Node Package Manager예요. 전 세계 개발자들이 만든 패키지(도구, 라이브러리)를 설치하고 관리하는 도구예요.

npm install 패키지이름    # 패키지 설치
npm install -g 패키지이름 # 전역(global) 설치

-g 옵션이 붙으면 이 컴퓨터 어디서나 쓸 수 있는 전역 설치예요. Claude Code도 -g로 설치했었죠.

5강. 백엔드 / 프론트엔드 — 웹의 구조

🎙️ 인트로

이제 개념 강의 시간이에요. 짧게 갑니다.

웹 서비스나 앱을 만들 때, 개발은 크게 두 영역으로 나뉩니다.

🎙️ 프론트엔드란?

**프론트엔드(Frontend)**는 사용자가 직접 보고 클릭하는 화면이에요.

네이버 홈페이지에서 여러분이 보는 검색창, 버튼, 뉴스 목록… 이 모든 게 프론트엔드예요. 주로 HTML, CSS, JavaScript로 만들어요. 요즘은 React, Vue 같은 프레임워크를 많이 써요.

🎙️ 백엔드란?

**백엔드(Backend)**는 사용자 눈에는 안 보이지만, 뒤에서 모든 걸 처리하는 서버예요.

네이버에서 검색어를 입력하면, 그 검색어가 서버로 전송되고, 서버가 수십억 개의 웹페이지에서 관련 결과를 찾아서 돌려줘요. 이게 백엔드의 일이에요.

백엔드는 데이터를 저장하고 (DB), 복잡한 계산을 하고, 보안을 처리해요. Python(Flask, FastAPI, Django), Node.js(Express) 같은 도구로 만들어요.

🎙️ 비유로 이해하기

레스토랑에 비유하면 이래요.

영역레스토랑 비유
프론트엔드홀 (메뉴판, 인테리어, 웨이터)
백엔드주방 (요리사, 재료 보관, 조리 과정)
데이터베이스냉장고 (재료 저장 창고)

손님(사용자)은 홀(프론트엔드)에서 주문하고, 주방(백엔드)이 요리해서 가져다줘요. 재료는 냉장고(DB)에서 꺼내오고요.

6강. Git & GitHub — 코드의 시간 여행

🎙️ 인트로

코딩을 하다 보면 이런 상황이 생겨요.

“어? 아까는 됐는데 지금은 왜 안 되지?” “3일 전 버전으로 돌아가고 싶은데…”

이럴 때 필요한 게 버전 관리예요. 코드의 변경 이력을 저장해두는 시스템이에요. 그 도구가 바로 Git이고, Git으로 관리한 코드를 인터넷에 올려두는 공간이 GitHub예요.

💻 실습 6-1: Git 설치

👉 git-scm.com 접속 → Download → 설치 (기본 옵션으로 Next Next…)

설치 확인:

git --version

💻 실습 6-2: Git 초기 설정

처음 한 번만 하면 돼요.

git config --global user.name "여러분 이름"
git config --global user.email "이메일@gmail.com"

이건 커밋(저장)할 때 “누가 저장했는지” 표시하기 위한 거예요.

💻 실습 6-3: 첫 번째 Git 저장소 만들기

my-ai-project 폴더에서:

git init

이 명령어 하나로 이 폴더가 Git 저장소가 됩니다.

git status

현재 변경 사항을 보여줘요.

git add .
git commit -m "첫 번째 커밋"

이렇게 하면 현재 상태가 저장돼요. 커밋은 “저장 포인트”라고 생각하면 돼요. 나중에 여기로 돌아올 수 있어요.

🎙️ GitHub란?

GitHub는 여러분의 Git 저장소를 인터넷에 올려두는 공간이에요. 구글 드라이브가 문서를 올려두는 공간이라면, GitHub는 코드를 올려두는 공간이에요.

AI Agent가 코드를 만들어주면 GitHub에 올려두면 됩니다. 백업도 되고, 협업도 되고, 나중에 서버에 배포할 때도 GitHub에서 가져와요.

가입은 github.com에서 무료로 할 수 있어요.

7강. JSON — AI와 데이터를 주고받는 언어

🎙️ 인트로

AI API를 쓸 때 데이터를 어떤 형태로 주고받는지 아세요? 바로 JSON이에요. JavaScript Object Notation의 약자인데, 이름은 어렵지만 형태는 정말 단순해요.

🎙️ JSON이 뭔데요?

JSON은 데이터를 저장하고 전달하는 형식이에요. 사람도 읽을 수 있고, 컴퓨터도 읽을 수 있어요.

예를 들어볼게요. 제가 Claude API에 메시지를 보낼 때 이런 형태예요:

{
  "model": "claude-opus-4-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "안녕하세요!"
    }
  ]
}

어때요? 생각보다 읽힌다는 느낌 들지 않나요?

🎙️ JSON 규칙

JSON은 세 가지만 알면 됩니다.

1. 중괄호 {} → 하나의 “객체(Object)“. 속성과 값의 묶음이에요.

{ "이름": "홍길동", "나이": 30 }

2. 대괄호 [] → “배열(Array)“. 여러 항목의 목록이에요.

["사과", "바나나", "딸기"]

3. 콜론 : → 속성 이름과 값을 연결해요.

{ "속성이름": "값" }

이게 전부예요!

💻 실습 7-1: VS Code에서 JSON 파일 만들어보기

my-ai-project 폴더에 data.json 파일을 만들고 입력해보세요:

{
  "name": "나의 AI 프로젝트",
  "version": "1.0",
  "features": [
    "챗봇",
    "이미지 분석",
    "문서 요약"
  ],
  "active": true
}

저장하고 보면 VS Code가 색상을 입혀서 보여줘요. 이게 **문법 강조(Syntax Highlighting)**이에요.

8강. 프로그래밍 용어 & 에러 다루기

🎙️ 인트로

개발하다 보면 무조건 에러가 납니다. 그리고 그 에러를 보고 당황하면 안 돼요. 에러는 컴퓨터가 뭔가 잘못됐다고 알려주는 메시지예요. 사실 친절한 거예요.

이 강의에서는 에러가 났을 때 당황하지 않고 대처하는 방법을 배울 거예요.

🎙️ 주요 프로그래밍 용어

변수(Variable): 데이터를 담아두는 상자예요.

name = "홍길동"  # name이라는 상자에 "홍길동"을 담아둠
age = 30

함수(Function): 특정 작업을 수행하는 코드 묶음이에요.

def greet(name):
    print(f"안녕하세요, {name}님!")
 
greet("홍길동")  # → "안녕하세요, 홍길동님!"

반복문(Loop): 같은 작업을 여러 번 반복해요.

fruits = ["사과", "바나나", "딸기"]
for fruit in fruits:
    print(fruit)

조건문(Conditional): 조건에 따라 다른 코드를 실행해요.

if age >= 18:
    print("성인입니다.")
else:
    print("미성년자입니다.")

🎙️ 에러 핸들링

에러가 나도 프로그램이 멈추지 않게 처리하는 방법이에요.

try:
    result = 10 / 0  # 0으로 나누면 에러!
except ZeroDivisionError:
    print("0으로 나눌 수 없어요.")

try 안에서 에러가 나면 except가 받아서 처리해요. 프로그램이 뻗지 않고 우아하게 넘어가요.

🎙️ 디버깅 — AI와 함께하면 쉬워진다

**디버깅(Debugging)**은 버그(에러, 오류)를 찾아서 고치는 과정이에요.

에러가 나면 이렇게 하세요:

Step 1: 터미널에 빨간 글씨로 에러 메시지가 뜨면, 당황하지 말고 전체를 복사하세요.

Step 2: Claude에게 붙여넣기하고 이렇게 질문하세요:

“이 에러가 왜 나는 건지, 어떻게 고치면 되는지 설명해줘.”

Step 3: Claude가 알려주는 대로 수정해요.

💻 실습 8-1: 일부러 에러 내고 고쳐보기

test.py 파일을 만들고:

print("안녕하세요"

일부러 괄호를 안 닫았어요. 실행해보세요:

python test.py
SyntaxError: '(' was never closed

이런 에러가 납니다. 이제 이 메시지를 Claude에게 가져가보세요!

9강. API란? — 소프트웨어끼리 대화하는 방법

🎙️ 인트로

API는 Application Programming Interface의 약자예요. 어렵게 느껴지지만, 실은 우리 일상에 이미 있어요.

🎙️ API를 비유로 이해하기

식당을 다시 예로 들어볼게요.

손님(여러분의 앱)이 웨이터(API)에게 주문서(요청)를 건네면, 웨이터가 주방(서버)에 전달하고, 주방이 요리(처리)해서 웨이터를 통해 음식(응답)을 가져다 줍니다.

여러분은 주방에 직접 들어갈 필요 없어요. 웨이터(API)를 통해서만 소통하면 돼요.

🎙️ REST API

우리가 주로 쓸 건 REST API예요. 인터넷(HTTP)을 통해 데이터를 주고받는 방식이에요.

주요 동작 4가지:

동작의미비유
GET가져오기메뉴판 보기
POST보내기/생성주문하기
PUT수정주문 변경
DELETE삭제주문 취소

💻 실습 9-1: Claude API 첫 호출

my-ai-project 폴더에 hello_claude.py 파일을 만들어요.

import anthropic
 
client = anthropic.Anthropic()
 
message = client.messages.create(
    model="claude-opus-4-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "안녕! 나는 비개발자인데 지금 API를 처음 호출해봤어. 칭찬해줘!"}
    ]
)
 
print(message.content[0].text)

실행:

python hello_claude.py

Claude가 칭찬해줍니다! 🎉

이게 바로 API 호출이에요. 몇 줄의 코드로 전 세계 어디서든 AI와 대화할 수 있어요.

10강. 소프트웨어 아키텍처 — 전체 그림 이해하기

🎙️ 인트로

지금까지 부품들을 배웠다면, 이제 그 부품들이 어떻게 연결되는지 볼 차례예요.

🎙️ 전형적인 웹 서비스 구조

[사용자 브라우저]
       ↕ HTTP 요청/응답
[프론트엔드 서버] ← React, HTML/CSS
       ↕ API 호출
[백엔드 서버] ← FastAPI, Express
       ↕ 쿼리
[데이터베이스] ← SQLite, PostgreSQL
       +
       ↕ API 호출
[외부 AI API] ← Claude, OpenAI

사용자가 화면(프론트엔드)에서 뭔가를 하면 → 백엔드 서버가 처리하고 → 필요한 데이터는 DB에서 꺼내고 → AI가 필요한 작업은 AI API를 호출해서 → 결과를 다시 사용자에게 돌려줘요.

🎙️ AI 앱을 만들 때 가장 단순한 구조

처음부터 복잡하게 할 필요 없어요. 시작은 이렇게도 충분해요:

[Python 스크립트]
       ↕ API 호출
[Claude API]

터미널에서 Python으로 Claude에게 질문하고, 답을 받아요. 이게 가장 기본적인 AI 앱이에요.

11강. DB(데이터베이스) — 데이터를 저장하는 공간

🎙️ 인트로

**데이터베이스(DB)**는 구조화된 데이터를 저장하는 공간이에요. 엑셀이랑 비슷한데, 엑셀보다 훨씬 많은 데이터를 빠르게 처리할 수 있어요.

🎙️ DB의 종류

크게 두 가지예요.

관계형 DB (SQL): 표(테이블) 형태로 저장. 엑셀처럼 행과 열이 있어요. → SQLite (가벼움, 파일 하나로 끝), PostgreSQL, MySQL

비관계형 DB (NoSQL): JSON처럼 유연한 형태로 저장. → MongoDB, Firebase

💻 실습 11-1: SQLite로 데이터 저장해보기

Python에는 SQLite가 기본 내장돼 있어요. 설치 필요 없어요!

db_test.py 파일 만들기:

import sqlite3
 
# DB 연결 (파일이 없으면 새로 만들어요)
conn = sqlite3.connect("my_data.db")
cursor = conn.cursor()
 
# 테이블 만들기
cursor.execute("""
    CREATE TABLE IF NOT EXISTS users (
        id INTEGER PRIMARY KEY,
        name TEXT,
        email TEXT
    )
""")
 
# 데이터 넣기
cursor.execute("INSERT INTO users (name, email) VALUES (?, ?)", 
               ("홍길동", "hong@gmail.com"))
 
# 데이터 가져오기
cursor.execute("SELECT * FROM users")
rows = cursor.fetchall()
 
for row in rows:
    print(row)
 
conn.commit()
conn.close()

실행하면 my_data.db 파일이 생기고, 데이터가 저장돼요!

12강. AI 기술 — 프롬프트·컨텍스트·하네스 엔지니어링

🎙️ 인트로

자, 이제 대망의 마지막 강의예요. 지금까지 개발 환경, 도구, 기본 개념을 다 배웠어요. 이제 AI를 제대로 다루는 기술을 배울 차례예요.

🎙️ 프롬프트 엔지니어링

**프롬프트(Prompt)**는 AI에게 보내는 질문 또는 지시예요.

프롬프트 엔지니어링은 AI가 더 좋은 답을 내놓도록 질문을 잘 설계하는 기술이에요.

나쁜 프롬프트 예시:

“앱 만들어줘”

좋은 프롬프트 예시:

“Python과 FastAPI를 사용해서 사용자가 텍스트를 입력하면 Claude API로 요약해주는 REST API 서버를 만들어줘. 엔드포인트는 POST /summarize 이고, 요청 형식은 JSON { text: string }이야.”

차이 느껴지시나요? 구체적일수록 AI가 정확하게 도와줘요.

🎙️ 컨텍스트 엔지니어링

**컨텍스트(Context)**는 AI가 대화할 때 기억하고 있는 내용이에요.

컨텍스트 엔지니어링은 AI가 최대한 상황을 잘 이해하도록 배경 정보를 잘 제공하는 기술이에요.

예를 들어, Claude Code에게 코드 작성을 시킬 때:

역할: 너는 Python FastAPI 전문가야.
프로젝트 구조: [프로젝트 파일 트리]
기술 스택: Python 3.11, FastAPI, SQLite, Anthropic API
요구사항: ...

이런 식으로 AI에게 충분한 맥락을 주면, 훨씬 좋은 결과를 얻을 수 있어요.

🎙️ 하네스 엔지니어링

**하네스(Harness)**는 원래 마구(馬具), 즉 말을 제어하기 위한 장비예요.

하네스 엔지니어링은 AI Agent가 일을 잘 할 수 있도록 작업 환경과 도구 자체를 설계하는 것이에요.

Claude Code를 예로 들면:

  • CLAUDE.md 파일 작성 → AI에게 프로젝트 규칙 알려주기
  • 도구 권한 설정 → AI가 어떤 파일을 읽고 쓸 수 있는지
  • 훅(Hook) 설정 → AI 작업 전후로 자동으로 실행할 명령어

쉽게 말하면, 프롬프트는 “AI에게 말 걸기”고, 컨텍스트는 “상황 설명하기”고, 하네스는 “AI가 일할 수 있는 환경 만들기”예요.

💻 실습 12-1: CLAUDE.md 만들어보기

my-ai-project 폴더에 CLAUDE.md 파일을 만들어요:

# 프로젝트 규칙
 
## 기술 스택
- Python 3.11
- FastAPI
- SQLite
- Anthropic Claude API
 
## 코드 스타일
- 주석은 한국어로 작성
- 함수명은 영어 snake_case
- 에러 처리는 반드시 포함
 
## 작업 규칙
- 새 파일 만들기 전에 기존 파일 확인
- 환경변수는 .env 파일 사용

이제 Claude Code를 실행하면, 이 파일을 읽고 여러분 프로젝트에 맞게 일해요!

🎬 클로징

자, 여기까지 왔습니다! 박수 한 번 쳐주세요. 👏

오늘 우리가 배운 것들을 정리해볼게요:

강의핵심
VS Code코드 편집기 설치 및 Claude Code 연동
터미널CLI 기본 명령어
Python설치, pip, 가상환경
Node.js설치, npm
백/프론트엔드웹의 구조 이해
Git & GitHub버전 관리
JSON데이터 형식 이해
에러 핸들링당황하지 않고 AI에게 물어보기
APIClaude API 직접 호출
아키텍처전체 시스템 그림
DBSQLite로 데이터 저장
AI 기술프롬프트·컨텍스트·하네스 엔지니어링

비개발자분들이 AI 개발을 시작하는 데 필요한 모든 기초를 다 짚었어요.

앞으로 뭔가 막히면 기억하세요. 에러는 친구예요. 그리고 Claude는 항상 여러분 옆에 있어요.

감사합니다! 🙌

01.기획 강의 커리큘럼 구상 ← 커리큘럼 원본

Graph View