비전공자를 위한 Claude Code와 AntiGravity 실습 튜토리얼, 첫 자동화 도구 만들기

왜 지금 바이브 코딩을 배워야 할까

비전공자가 코딩을 배울 때 가장 먼저 막히는 지점은 문법이 아니라 두려움이다. 터미널을 켜는 순간 머리가 하얘지고, 파일 하나 만드는 일도 괜히 어려워 보인다. 그런데 Claude Code나 AntiGravity 같은 도구를 쓰면 이 흐름이 완전히 바뀐다. 내가 모든 문법을 외운 상태에서 시작하는 게 아니라, 문제를 설명하고 결과를 확인하면서 배우는 식으로 진입할 수 있기 때문이다.

특히 바이브 코딩은 '완벽히 이해한 뒤 시작'이 아니라 '작게 실행하면서 이해를 따라잡는 방식'에 가깝다. 이게 왜 중요하냐면, 비전공자는 이론만 오래 붙들면 지치기 쉽기 때문이다. 반대로 바로 손을 움직여서 폴더를 만들고, 파일을 생성하고, AI에게 수정 요청을 던져보면 학습 속도가 급격히 빨라진다.

오늘 글에서는 어려운 서비스 개발이 아니라 아주 작은 자동화 도구를 만든다. 목표는 거창하지 않다. 컴퓨터에게 반복 작업을 시키는 경험을 직접 해보는 것이다. 이 한 번의 성공 경험이 쌓이면 다음부터는 웹페이지, 챗봇, 업무 자동화까지 연결된다.

Claude Code와 AntiGravity를 어떻게 나눠 쓰는가

두 도구를 한 문장으로 나누면 이렇다. Claude Code는 코드와 파일 작업을 실제로 밀어붙이는 실행형 도우미이고, AntiGravity는 전체 흐름과 작업 설계를 더 자연스럽게 잡아주는 보조 파일럿에 가깝다. 둘을 같이 쓰면 비전공자도 훨씬 덜 헤맨다.

Claude Code가 강한 지점

• 프로젝트 폴더를 읽고 수정하는 일
• 명령어를 제안하고 실행 흐름을 잡는 일
• 에러 메시지를 보고 바로 수정안을 내는 일
• 작은 앱, 스크립트, 페이지를 빠르게 만드는 일

AntiGravity가 강한 지점

• 무엇부터 해야 할지 순서를 정하는 일
• 초보자 눈높이로 설명을 풀어주는 일
• 실습 과제를 작은 단계로 쪼개는 일
• 결과물을 보고 다음 학습 루트를 제안하는 일

실전에서는 AntiGravity에게 먼저 이렇게 묻는 식이 좋다. '나는 비전공자고, 오늘 30분 안에 끝낼 수 있는 자동화 실습 하나를 설계해줘.' 그러고 나서 Claude Code에게 실제 파일 생성과 수정을 맡기면 된다. 한쪽은 네비게이션, 한쪽은 작업 엔진이라고 보면 이해가 쉽다.

비전공자용 준비물과 설치

이번 실습은 맥 기준으로 설명하지만, 윈도우나 리눅스도 흐름은 거의 같다. 필요한 것은 세 가지다. 터미널, Node.js, 그리고 AI 코딩 도구에 접근할 수 있는 환경이다.

1. 작업 폴더 만들기

mkdir my-first-vibe-tool
cd my-first-vibe-tool

이 두 줄이 시작이다. 새 폴더를 만들고 그 안으로 들어간다. 코딩은 결국 파일을 다루는 일이라, 폴더 감각부터 익히는 게 중요하다.

2. Node.js 프로젝트 초기화

npm init -y

이 명령은 package.json 파일을 만든다. 이름만 거창하지, 프로젝트의 기본 설정 메모장 정도로 생각하면 된다.

3. 실습용 파일 만들기

mkdir src
touch src/index.js
touch names.txt

names.txt에는 실습용 데이터를 넣는다.

김민수
박서연
이준호
최하린

이제 Claude Code나 AntiGravity에게 이런 요청을 던지면 된다. 'names.txt를 읽어서 각 이름 앞에 안녕하세요를 붙여 출력하는 Node.js 스크립트를 src/index.js에 만들어줘. 초보자라서 주석도 넣어줘.' 여기서 중요한 건, 애매하게 말하지 말고 입력 파일과 원하는 출력 형태를 명확히 적는 것이다.

첫 실습, 폴더 만들고 AI에게 일 맡기기

비전공자가 가장 빨리 성장하는 방법은 직접 코드를 다 짜려 하지 말고, 먼저 '요청하는 법'을 배우는 것이다. 아래처럼 요청하면 꽤 높은 확률로 원하는 결과가 나온다.

names.txt 파일의 각 줄을 읽어서
안녕하세요, [이름]님
형태로 출력하는 Node.js 코드를 만들어줘.
파일 경로는 src/index.js야.
초보자라서 각 줄마다 주석도 넣어줘.

그러면 대략 이런 코드가 만들어진다.

const fs = require("fs");
const path = require("path");

const filePath = path.join(__dirname, "..", "names.txt");
const rawText = fs.readFileSync(filePath, "utf8");
const names = rawText.split("
").filter(Boolean);

names.forEach((name) => {
  console.log(`안녕하세요, ${name}님`);
});

이 코드를 실행하는 명령은 아래와 같다.

node src/index.js

여기서 초보자가 꼭 봐야 할 포인트는 세 가지다. 첫째, 파일을 읽는 코드가 있다는 것. 둘째, 줄바꿈 기준으로 데이터를 나눈다는 것. 셋째, 반복문으로 같은 형식의 문장을 여러 번 출력한다는 것이다. 이 세 개만 이해해도 이미 자동화의 핵심 절반은 잡은 셈이다.

에러가 나면 어떻게 할까

초보자는 에러를 실패로 받아들이는데, 사실 에러는 AI에게 보여줄 단서다. 예를 들어 실행 후 경로 오류가 나면 에러 메시지를 그대로 복사해서 이렇게 물으면 된다.

node src/index.js 실행했더니 아래 에러가 나왔어.
경로 관련 문제 같아.
초보자도 이해하게 왜 틀렸는지 설명하고 수정 코드도 같이 줘.

이 방식이 중요한 이유는, 비전공자가 혼자 검색하며 헤매는 시간을 크게 줄여주기 때문이다. 바이브 코딩의 핵심은 모든 걸 암기하는 게 아니라, 막혔을 때 다시 앞으로 나가는 루틴을 만드는 데 있다.

두 번째 실습, 반복 작업 자동화하기

이제 한 단계 올려보자. 이름 목록을 읽어서 인사말을 화면에만 출력하지 말고, 결과를 새 파일로 저장해보자. 실무에서는 출력보다 저장이 더 중요하다. 보고서 초안, 안내문, 상품 설명, 고객 응답 초안처럼 반복 생성 후 저장하는 일이 훨씬 많기 때문이다.

Claude Code에게 이렇게 요청하면 된다.

기존 코드를 수정해서 결과를 console.log만 하지 말고
output.txt 파일에도 저장하게 바꿔줘.
한 줄에 하나씩 저장하고,
파일이 없으면 새로 만들게 해줘.

수정된 코드는 보통 이런 형태가 된다.

const fs = require("fs");
const path = require("path");

const inputPath = path.join(__dirname, "..", "names.txt");
const outputPath = path.join(__dirname, "..", "output.txt");

const rawText = fs.readFileSync(inputPath, "utf8");
const names = rawText.split("
").filter(Boolean);

const messages = names.map((name) => `안녕하세요, ${name}님`);

console.log(messages.join("
"));
fs.writeFileSync(outputPath, messages.join("
"), "utf8");
console.log("output.txt 저장 완료");

실행은 똑같다.

node src/index.js

이제 output.txt 파일이 생겼다면, 그 순간부터 당신은 단순 사용자에서 자동화 입문자로 넘어온 것이다. 별거 아닌 것 같지만 이 감각이 중요하다. 입력 파일을 넣고, 규칙을 적용하고, 결과 파일을 뽑는다. 이 패턴은 엑셀 정리, 문자 초안 생성, 교육 자료 가공, 블로그 초안 제작 같은 업무에 그대로 확장된다.

AntiGravity와 같이 쓰면 좋은 질문

• '이 실습 다음 단계로 난이도 1만 올린 과제를 3개 추천해줘'
• '비전공자가 여기서 헷갈릴 개념을 미리 설명해줘'
• '이걸 학원 업무, 학교 행정, 1인 사업에 적용하면 어떤 예제가 좋을까'

좋은 도구를 쓰는 사람과 헤매는 사람의 차이는 손이 빠른 게 아니라 질문이 구체적인가에 달려 있다. vague하게 말하면 vague한 결과가 나온다. 이건 AI도 똑같다.

실무형 Q&A

Q1. 비전공자인데 코드를 한 줄도 몰라도 시작 가능할까

가능하다. 다만 '완전 자동'을 기대하면 안 된다. 최소한 파일, 폴더, 실행, 에러 메시지 정도는 읽는 습관을 들여야 한다. 좋은 소식은 이 기초가 생각보다 빨리 익는다는 점이다. 1주일만 매일 20분씩 해도 감이 생긴다.

Q2. Claude Code가 만들어준 코드를 이해 못하면 의미 없는 것 아닌가

처음엔 절반만 이해해도 된다. 중요한 건 결과를 바꿀 수 있는가다. 예를 들어 이름 앞 문구를 바꾸거나, 출력 파일명을 바꾸거나, 입력 형식을 바꾸는 수정부터 해보면 된다. 실습은 이해를 기다리지 않고 앞으로 가는 방식이 더 효율적이다.

Q3. AntiGravity는 정확히 언제 쓰면 좋을까

작업 시작 전에 많이 쓴다. 내가 뭘 만들어야 할지, 난이도를 어떻게 잡아야 할지, 학습 순서를 어떻게 짜야 할지 막막할 때 특히 좋다. 반면 실제 파일을 뜯어고치고 코드 블록을 빠르게 생산하는 건 Claude Code 쪽이 더 직관적인 경우가 많다.

Q4. 터미널이 무섭다

그 감정 정상이다. 다만 터미널은 위험한 괴물이 아니라 '정확히 시키면 정확히 일하는 창'에 가깝다. 처음에는 아래 네 개만 익혀도 충분하다.

pwd
ls
cd 폴더이름
node 파일이름

이 네 개만으로도 파일 위치 확인, 목록 보기, 이동, 실행까지 된다. 처음부터 복잡한 명령어를 외울 필요 없다.

Q5. 실무에 바로 연결되는 첫 프로젝트는 뭘까

반복 문구 생성기, CSV 정리기, 블로그 초안 생성기, 공지문 템플릿 생성기가 좋다. 이유는 입력과 출력이 명확하기 때문이다. 비전공자에게 중요한 건 멋진 앱이 아니라 작은 성공을 자주 만드는 것이다.

Q6. AI가 틀린 코드를 주면 어떡하나

틀린다. 꽤 자주 틀린다. 그래서 복붙 후 끝이 아니라 실행 후 검증이 필수다. 대신 예전에는 내가 무엇이 틀렸는지조차 몰라서 멈췄다면, 지금은 에러와 결과를 다시 던져 수정받을 수 있다. 이 차이가 엄청 크다.

Q7. 공부 순서는 어떻게 잡는 게 좋을까

추천 루트는 이렇다. 파일 읽기, 파일 쓰기, 반복문, 조건문, API 호출, 간단한 웹페이지 순서다. 이 순서를 따라가면 자동화에서 서비스 제작으로 자연스럽게 이어진다. 처음부터 프레임워크 전쟁에 들어가면 머리만 아프고 손이 안 움직인다.

오늘 5분 실습

아래 5분 실습만 해도 충분하다. 복잡하게 생각하지 말고 그냥 해보면 된다.

1. 터미널에서 새 폴더를 만든다.
2. names.txt 파일에 이름 3개를 적는다.
3. Claude Code에게 인사말 출력 코드를 요청한다.
4. node src/index.js로 실행한다.
5. 출력 문구를 내 스타일로 한 번 수정해본다.

추천 요청문은 아래 그대로 써도 된다.

나는 비전공자야.
names.txt 파일을 읽어서
각 줄마다 환영합니다, [이름]님
형태로 출력하는 초보자용 Node.js 코드를 만들어줘.
주석을 충분히 넣고,
실행 명령도 마지막에 알려줘.

이 정도면 오늘 실습으로 딱이다. 5분 안에 끝나고, 자동화의 핵심 패턴도 맛볼 수 있다.

마무리

비전공자에게 필요한 것은 천재적인 코딩 재능이 아니라, 작게 만들고 바로 실행해보는 루틴이다. Claude Code는 실행력을 올려주고, AntiGravity는 길을 잃지 않게 도와준다. 둘을 같이 쓰면 혼자 독학할 때보다 훨씬 빠르게 첫 결과물을 만들 수 있다.

오늘 소개한 실습은 아주 작다. 그런데 바로 그 작음이 중요하다. 작은 성공이 쌓여야 다음 단계로 넘어간다. 이름 목록을 읽는 스크립트 하나가 나중에는 블로그 초안 생성기, 고객 응답 도우미, 교육 콘텐츠 제작 파이프라인으로 이어질 수 있다.

더 체계적으로 배우고 싶다면 두온교육과 미래이음연구소 자료를 함께 참고해봐라. 현장형 실습 중심으로 접근하면 비전공자도 생각보다 빨리 자기 도구를 만들 수 있다. 핵심은 많이 아는 척이 아니라, 오늘 바로 한 번 돌려보는 것이다.

두온교육와 미래이음연구소에서 더 많은 실전형 자료와 교육 정보를 확인할 수 있다.