1. 에이전트 코딩이란? + 도구 셋업
🎯 학습 목표
에이전트 코딩이 무엇인지 이해하고 도구 하나를 설치해서 첫 프롬프트로 작은 파이썬 프로그램을 만들어 봐요.
너는 감독, AI는 코딩 팀원
영화 감독은 카메라를 직접 들지 않아요. 대신 "여기서 클로즈업, 조명은 따뜻하게" 라고 말하면 팀이 움직여요. 에이전트 코딩도 똑같아요.
| 너(감독)가 하는 일 | AI 에이전트가 하는 일 |
|---|---|
| 무엇을 만들지 정한다 | 필요한 파일을 만든다 |
| 말(프롬프트)로 지시한다 | 코드를 짠다 |
| 결과를 확인한다 | 프로그램을 실행한다 |
| "이 부분 바꿔" 라고 한다 | 에러를 찾아 고친다 |
핵심
에이전트는 스스로 여러 단계를 밟아요: 파일 만들고 → 코드 쓰고 → 실행하고 → 에러 보고 → 고치고. 이 "스스로 도는 반복"이 그냥 챗봇과 다른 점이에요.
도구 설치하기
4개 다 깔 필요 없어요. 하나만 골라 시작해요. 처음이라면 Gemini CLI를 추천해요: 무료 한도가 넉넉하고 설치가 제일 쉬워요.
준비물
터미널 도구는 Node.js가 필요해요. nodejs.org에서
LTS 버전을 먼저 설치하세요. 설치됐는지 확인: 터미널에 node --version
① Gemini CLI (추천 · 무료)
터미널을 열고:
npm install -g @google/gemini-cli
gemini처음 실행하면 구글 계정 로그인 창이 떠요. 로그인하면 끝! 채팅처럼 지시를 적으면 돼요.
② Claude Code (요금제 필요)
npm install -g @anthropic-ai/claude-code
claude여러 파일을 한 번에 다루는 큰 파이썬 프로젝트에 강해요.
③ Antigravity · ④ Cursor (에디터형)
이 둘은 터미널이 아니라 코드 에디터예요. 각 사이트에서 프로그램을 내려받아 설치해요(일반 앱처럼). 에디터 안에서 코드를 보며 에이전트와 대화해요.
- Antigravity: 구글의 에이전트 에디터. 그림→웹앱 같은 시각 작업에 좋아요(레슨 3).
- Cursor: 무료 플랜이 있는 인기 AI 에디터.
첫 프롬프트 날리기
도구를 켰으면, 이렇게 적어보세요(복사해서 붙여넣어도 돼요):
파이썬으로 "숫자 맞히기" 게임을 만들어 줘.
- 컴퓨터가 1~100 사이 숫자를 하나 정한다
- 내가 숫자를 입력하면 "더 큰", "더 작은", "정답!"을 알려준다
- 정답을 맞히면 몇 번 만에 맞혔는지 보여준다
다 만들고 나서 한 번 실행해서 잘 되는지 보여줘.에이전트가 파일을 만들고 코드를 짜고 실행까지 해줄 거예요. 🎉
좋은 프롬프트의 3요소
- 목표: 무엇을 만들지 (숫자 맞히기 게임)
- 규칙/제약: 어떻게 동작해야 하는지 (더 큰/작은 알려주기)
- 확인 요청: "실행해서 보여줘" 처럼 결과를 직접 확인
꼭 지킬 안전 수칙
⚠️ 안전하게 쓰기
- API 키·비밀번호는 비밀. 화면 공유나 깃허브에 올리지 않기.
- 코드를 읽어보기. 에이전트가 짠 코드를 그냥 믿지 말고 무엇을 하는지 확인.
- 모르는 명령은 실행 전에 물어보기. 파일을 지우거나 무언가 설치하려 하면 "이거 왜 필요해?"라고 되물어요.
- 어른과 함께. 설치·결제·계정 관련은 보호자/선생님과 같이.
🎯 퀴즈
생각해보기
에이전트 코딩에서 사람(감독)이 하는 가장 중요한 일은 무엇일까요?
정답 확인
무엇을 만들지 정하고 결과가 맞는지 확인하고 방향을 잡아주는 것이에요. 에이전트는 코드를 빨리 짜지만 "옳은 것을 만들고 있는지"는 사람이 판단해야 해요. 그래서 코드를 읽는 눈이 중요하고 이 코스에서 그걸 길러요.
무엇을 배웠나요?
- 에이전트 코딩 = 사람이 지시, AI가 코드를 짜고 실행·수정
- 도구 하나(Gemini CLI 추천)를 설치하고 첫 프롬프트를 날렸어요
- 좋은 프롬프트엔 목표·규칙·확인 요청이 들어가요
- 다음 레슨: 에이전트로 손동작 웹캠 핑퐁을 만들어요 🖐️