Absolute beginner

완전 초보 가이드

코드를 몰라도 됩니다. 바이브코딩이 무엇인지부터 Claude Code · Codex · Antigravity 설치(앱 우선, CLI 선택)까지 한곳에 모았습니다. 설치 명령은 시점마다 바뀌므로 공식 링크를 항상 확인하세요. 기준 2026-07-17.

개념 Git · Node 도구 설치 학습 순서 프롬프트 5칸

개념 (아주 기초)

바이브코딩이란?

바이브코딩(vibe coding)은 “코드를 한 줄씩 직접 다 쓰는 것”보다, AI에게 목표를 말로 설명하고, AI가 파일을 만들고 고치게 한 뒤, 내가 브라우저·화면으로 결과를 확인하며 짧은 루프로 고치는 방식입니다.

이렇게 생각하면 됩니다

내가 하는 일: 목표·규칙·완료 조건을 짧게 적기, 결과 확인, 다음 지시
AI가 하는 일: 파일 생성·수정, 명령 실행, 에러 읽고 재시도
핵심은 ‘한 번에 완벽한 앱’이 아니라 ‘작은 조각을 빨리 검증’하는 것
코딩을 몰라도 시작할 수 있지만, 검증(실행·화면 확인)은 꼭 본인이 합니다

이건 바이브코딩이 아닙니다

복붙만 하고 확인하지 않는 것
한 채팅에 ‘전체 SaaS’를 시키는 것
API 키를 채팅·Git에 올리는 것

AI 에이전트란?

채팅 AI는 주로 “글로 답”합니다. 코딩 에이전트는 내 컴퓨터(또는 클라우드)에서 파일을 읽고 고치고, 명령을 실행하며 목표를 향해 여러 단계를 스스로 이어 갑니다.

채팅: 질문 → 설명·코드 조각 제안 (직접 파일 수정은 약함)
에이전트: 질문 → 계획 → 파일 수정 → 실행 → 에러 보고 → 재수정
승인: 위험한 명령·큰 삭제는 내가 허락하는 설정이 중요합니다
도구 이름 예: Claude Code, Codex, Cursor, Google Antigravity

초보가 쓰는 5단계 루프

1) 목표 한 문장
2) 이번 턴에 할 범위(하지 말 것 포함)
3) AI가 작업
4) 내가 화면·에러로 확인
5) 짧은 피드백으로 다음 턴

시작 전에 깔아 두면 좋은 것

앱(GUI)만 쓸 때는 당장 필수가 아닐 수 있습니다. 다만 CLI·배포·협업으로 가면 Git과 Node.js가 자주 필요합니다. Windows 사용자를 기준으로 적었습니다.

Git

코드 변경 기록·되돌리기·GitHub 업로드에 씁니다. AI가 ‘커밋해’라고 할 때도 필요합니다.

설치

공식 설치 파일로 설치합니다. 설치 중 PATH 추가 옵션을 켜 두세요.

확인

PowerShell 또는 터미널에서 버전을 확인합니다.

git --version

처음 설정 (이름·이메일)

커밋 작성자 정보입니다. 본인 정보로 바꿉니다.

git config --global user.name "내이름"
git config --global user.email "me@example.com"

Git 공식 다운로드· Windows / macOS / Linux
GitHub Desktop (GUI, 선택)· 터미널 없이 GitHub 쓰기에 편함
GitHub 가입

Node.js

많은 CLI 도구·웹 프론트 도구가 Node로 설치·실행됩니다. LTS(장기 지원) 버전을 권장합니다.

설치

nodejs.org에서 LTS 설치 파일을 받아 설치합니다. ‘Add to PATH’가 있으면 켭니다.

확인

터미널을 새로 연 뒤 확인합니다.

node --version
npm --version

Node.js LTS 다운로드· LTS 권장
npm 문서 (참고)

코드 에디터 (선택)

파일을 눈으로 보고 싶을 때. 에이전트 앱만 써도 되지만 VS Code가 흔합니다.

설치

Visual Studio Code를 설치해 두면 나중에 확장·터미널 통합이 편합니다.

VS Code 다운로드

도구 설치 · 활용 (앱 우선)

처음에는 앱(GUI)으로 시작하고, 터미널이 편해지면 CLI를 쓰면 됩니다. 한 번에 세 개를 다 깔지 말고 하나만 고르세요.

업데이트 기준 2026-07-17. 명령이 안 되면 공식 Setup 문서가 정본입니다.

Claude Code

Anthropic

로컬 프로젝트에서 파일을 읽고 고치는 Anthropic 코딩 에이전트. 초보는 데스크톱 앱(Code 탭)부터, 익숙해지면 CLI.

홈페이지 문서

기본 · 앱

앱으로 시작

터미널이 어렵다면 앱이 기본 경로입니다. Claude 데스크톱을 설치한 뒤 Code 탭에서 폴더를 열고 작업합니다.

1) 앱 설치claude.com/download 에서 OS에 맞는 설치 파일을 받아 설치합니다.
2) 로그인Anthropic / Claude 계정으로 로그인합니다. 구독·요금 정책은 공식 페이지를 확인하세요.
3) Code 탭앱을 연 뒤 Code 탭으로 들어갑니다. (메뉴 이름은 버전에 따라 약간 다를 수 있음)
4) 프로젝트 폴더 열기작업할 폴더를 지정합니다. 빈 폴더로 ‘연습용’을 하나 만들어도 됩니다.
5) 짧은 지시로 시작한 번에 전체가 아니라 ‘화면 하나·기능 하나’만 요청합니다. 아래 첫 프롬프트 예시를 복사해 보세요.

Claude 데스크톱 다운로드· macOS / Windows (Linux는 문서 확인)
데스크톱 빠른 시작

선택 · CLI

CLI로 쓰기

터미널에서 `claude` 명령으로 돌립니다. 공식은 네이티브 설치 스크립트를 안내합니다. (npm 방식도 문서·커뮤니티에 있으나 공식 Setup을 우선하세요.)

Windows PowerShellPowerShell을 관리자 권한이 아닌 일반으로 연 뒤 실행합니다. 끝나면 터미널을 다시 엽니다.
```
irm https://claude.ai/install.ps1 | iex
```
macOS / Linux / WSL터미널에서 실행합니다.
```
curl -fsSL https://claude.ai/install.sh | bash
```
실행·로그인프로젝트 폴더로 이동한 뒤 실행하고, 안내에 따라 로그인합니다.
```
cd 내프로젝트경로
claude
```

첫 프롬프트 예시 (복붙)

목표: 연습용 폴더에 "안녕" 이라고 뜨는 아주 작은 웹 페이지 하나
규칙: 파일은 최소한만, 한국어, 복잡한 프레임워크 쓰지 말 것
완료: 브라우저에서 글자가 보이면 끝
범위: 지금은 이 페이지만. 로그인·DB 금지

CLAUDE.md에 프로젝트 규칙(언어, 하지 말 것)을 적어 두면 반복 지시가 줄어듭니다.
막히면 에러 메시지 전체보다 ‘재현 3줄 + 목표’만 새 채팅에 옮기세요.
API 키·비밀번호를 채팅에 붙이지 마세요.

OpenAI Codex

OpenAI

ChatGPT 생태계와 묶인 코딩 에이전트. 초보는 Codex 앱(또는 ChatGPT의 Codex 진입점)부터, 터미널이 익숙하면 CLI.

홈페이지 문서

기본 · 앱

앱으로 시작

2026년 기준 macOS·Windows용 Codex 앱이 공개·확대되는 추세입니다. ChatGPT 계정으로 로그인하는 경로가 일반적입니다. 최신 다운로드는 공식 Codex/ChatGPT 페이지를 확인하세요.

1) 계정ChatGPT 계정이 필요합니다. 플랜(Free/Plus/Pro 등)에 따라 Codex 기능·한도가 다를 수 있습니다.
2) 앱 또는 웹 진입chatgpt.com/codex 또는 공식 안내의 앱 다운로드 링크로 설치·실행합니다. OS별 지원 여부는 페이지에서 확인하세요.
3) 프로젝트 연결로컬 폴더 또는 저장소를 연결·엽니다. 처음엔 연습용 빈 폴더로 충분합니다.
4) 작은 작업부터‘전체 앱’ 대신 ‘한 화면·한 기능’만 요청하고, 결과를 브라우저로 확인합니다.

선택 · CLI

CLI로 쓰기

터미널에서 `codex`로 실행합니다. Node.js가 있으면 npm 설치가 흔하고, 공식 설치 스크립트도 있습니다.

사전: Node.jsnpm 방식을 쓸 경우 Node LTS를 먼저 설치합니다. (nodejs.org)
```
node --version
```
npm 설치 (흔함)패키지 이름은 @openai/codex 입니다. 예전에 있던 다른 `codex` 패키지와 혼동하지 마세요.
```
npm install -g @openai/codex
```
공식 스크립트 (대안)macOS/Linux 예: curl 설치 스크립트. Windows는 PowerShell 스크립트(공식 README 확인).
```
curl -fsSL https://chatgpt.com/codex/install.sh | sh
```
실행프로젝트 폴더에서 실행 후 로그인/키 안내에 따릅니다.
```
cd 내프로젝트경로
codex
```

첫 프롬프트 예시 (복붙)

목표: index.html 하나에 "Codex 연습" 제목과 버튼 하나
규칙: 외부 라이브러리 없이, 파일 최소
완료: 더블클릭 또는 로컬 서버로 버튼이 보이면 끝
범위: CSS 화려하게 하지 말 것. 이번 턴은 HTML만

ChatGPT 구독 한도와 API 키 과금이 다를 수 있습니다. 결제 화면을 확인하세요.
모델 티어(예: Sol/Terra/Luna)는 제품 UI에 따라 이름이 달라질 수 있습니다.
클라우드 위임 작업은 비밀 파일이 올라가지 않게 주의하세요.

Google Antigravity

Google

에이전트 우선 개발 플랫폼. 초보는 데스크톱 앱 설치·Google 계정 로그인이 기본. CLI/SDK는 익숙해진 뒤.

홈페이지 문서

기본 · 앱

앱으로 시작

antigravity.google 에서 OS별 설치 파일을 받아 설치하는 것이 기본입니다. (Windows .exe, macOS .dmg, Linux 패키지 등)

1) 다운로드antigravity.google/download 에서 Windows / Mac / Linux 중 본인 OS를 고릅니다.
2) 설치 마법사설치 파일을 실행하고 안내에 따릅니다. 보안 경고가 뜨면 공식 사이트에서 받은 파일인지 확인하세요.
3) Google 계정 로그인프리뷰·개인 Gmail 정책이 시점마다 달라질 수 있습니다. Workspace 계정 제한이 있으면 개인 계정 안내를 확인하세요.
4) 에이전트에게 작은 과제멀티 에이전트·브라우저 기능이 강조됩니다. 처음엔 ‘한 페이지 UI’처럼 범위를 좁히세요.

Antigravity 다운로드· 공식 다운로드 허브
제품 홈

선택 · CLI

CLI로 쓰기

Antigravity CLI는 터미널에서 에이전트를 호출·모니터링하는 가벼운 경로로 소개됩니다. 설치 명령은 공식 블로그·다운로드 페이지 최신 안내를 우선하세요.

문서 확인CLI·SDK는 프리뷰 성격이 강합니다. I/O 발표·공식 블로그의 설치 한 줄을 확인한 뒤 실행하세요.
Linux 예시 (문서에 있는 경우)일부 가이드에 curl 설치 스크립트가 언급됩니다. 반드시 공식 도메인인지 확인하세요.
```
# 공식 페이지에 나온 명령만 사용
# 예시는 시점마다 바뀔 수 있음
```

Antigravity 블로그 (CLI·2.0 안내)

첫 프롬프트 예시 (복붙)

목표: 간단한 할 일 목록 웹 페이지 (추가 버튼 + 목록)
규칙: 모노톤 UI, 한국어, 로컬만
완료: 버튼을 누르면 항목이 목록에 보이면 끝
범위: 서버·DB·로그인 없음

Google 생태계(AI Studio, Firebase 등)와 연결 스토리가 많습니다. 범위를 넓히기 전에 한 기능을 끝내세요.
프리뷰 제품은 메뉴·요금이 자주 바뀝니다. 공식 다운로드 페이지만 믿으세요.
브라우저 자동화 권한이 넓으면 실수 범위도 커집니다. 연습 폴더에서 시작하세요.

안전 · 습관

API 키·비밀번호·.env 내용을 채팅·스크린샷·Git에 올리지 마세요.
‘전체 앱 한 번에’ 대신 한 화면·한 기능만.
AI가 ‘됐습니다’ 해도 브라우저·실행으로 직접 확인하세요.
모르는 삭제 명령·시스템 경로는 거절하거나 범위를 좁히세요.
막히면 progress 일지(/learn/progress)에 목표·에러만 남기고 새 대화를 시작하세요.

더 볼 자료

커뮤니티 글은 명령이 예전일 수 있습니다. 공식 문서가 우선입니다.

다음 단계

설치가 끝났으면 프롬프트 연습 → 작은 결과 공유

프롬프트 5칸 Build 올리기 도구·모델 비교

완전 초보 가이드

시작 전에 깔아 두면 좋은 것

앱(GUI)만 쓸 때는 당장 필수가 아닐 수 있습니다. 다만 CLI·배포·협업으로 가면 Git과 Node.js가 자주 필요합니다. Windows 사용자를 기준으로 적었습니다.

Git

코드 변경 기록·되돌리기·GitHub 업로드에 씁니다. AI가 ‘커밋해’라고 할 때도 필요합니다.

설치

공식 설치 파일로 설치합니다. 설치 중 PATH 추가 옵션을 켜 두세요.

확인

PowerShell 또는 터미널에서 버전을 확인합니다.

git --version

처음 설정 (이름·이메일)

커밋 작성자 정보입니다. 본인 정보로 바꿉니다.

git config --global user.name "내이름"
git config --global user.email "me@example.com"

Git 공식 다운로드· Windows / macOS / Linux
GitHub Desktop (GUI, 선택)· 터미널 없이 GitHub 쓰기에 편함
GitHub 가입

Node.js

많은 CLI 도구·웹 프론트 도구가 Node로 설치·실행됩니다. LTS(장기 지원) 버전을 권장합니다.

설치

nodejs.org에서 LTS 설치 파일을 받아 설치합니다. ‘Add to PATH’가 있으면 켭니다.

확인

터미널을 새로 연 뒤 확인합니다.

node --version
npm --version

Node.js LTS 다운로드· LTS 권장
npm 문서 (참고)

코드 에디터 (선택)

파일을 눈으로 보고 싶을 때. 에이전트 앱만 써도 되지만 VS Code가 흔합니다.

설치

Visual Studio Code를 설치해 두면 나중에 확장·터미널 통합이 편합니다.

VS Code 다운로드

목표: 연습용 폴더에 "안녕" 이라고 뜨는 아주 작은 웹 페이지 하나 규칙: 파일은 최소한만, 한국어, 복잡한 프레임워크 쓰지 말 것 완료: 브라우저에서 글자가 보이면 끝 범위: 지금은 이 페이지만. 로그인·DB 금지

목표: index.html 하나에 "Codex 연습" 제목과 버튼 하나 규칙: 외부 라이브러리 없이, 파일 최소 완료: 더블클릭 또는 로컬 서버로 버튼이 보이면 끝 범위: CSS 화려하게 하지 말 것. 이번 턴은 HTML만

목표: 간단한 할 일 목록 웹 페이지 (추가 버튼 + 목록) 규칙: 모노톤 UI, 한국어, 로컬만 완료: 버튼을 누르면 항목이 목록에 보이면 끝 범위: 서버·DB·로그인 없음

완전 초보 가이드

추천 순서

개념 (아주 기초)

시작 전에 깔아 두면 좋은 것

도구 설치 · 활용 (앱 우선)

Claude Code

OpenAI Codex

Google Antigravity

안전 · 습관

더 볼 자료

완전 초보 가이드

추천 순서

개념 (아주 기초)

시작 전에 깔아 두면 좋은 것

도구 설치 · 활용 (앱 우선)

Claude Code

OpenAI Codex

Google Antigravity

안전 · 습관

더 볼 자료