오토프로그 — 노트북 앞의 개구리오토프로그
메뉴
무료 진단
강의 목차펼치기

3강: 개발 환경 세팅

V11작성2026-04-12읽는 시간8분

도구를 설치하고 첫 페이지를 열어요

깃허브 가입 → 명령 한 줄 → 창 껐다 켜기 → 말로 시작, 네 단계로 이어지는 환경 세팅 흐름도

오늘 끝나면 이런 걸 갖게 돼요

VS Code가 열리고, AI에 로그인된 상태에서 웹페이지 파일 index.html 하나가 생겨요. 브라우저에는 나의 첫 바이브 코딩 페이지가 보여요.

그림에 나온 깃허브 가입은 5강에서 해요. 이번 강에서는 도구 설치와 첫 페이지까지 끝냅니다.


먼저 VS Code만 설치하세요

개발 환경 세팅은 새 자전거를 처음 맞추는 일과 비슷해요. 안장과 바퀴를 한 번 맞춰 두면 그다음부터는 타는 데 집중할 수 있어요.

VS Code(Visual Studio Code, 파일을 보고 고치는 프로그램)는 작업대와 같아요. VS Code 내려받기에서 설치 파일을 받아 실행하세요.

윈도우는 User Installer x64, 맥은 Apple Silicon을 고르면 돼요. 설치가 끝나면 VS Code를 열어 주세요.

이것만 직접 하시면 나머지는 클로드 코드나 코덱스와 대화하며 진행해요.


사용할 도구 하나를 고르세요

클로드 코드는 Claude 구독, 코덱스는 ChatGPT 구독이 있어야 AI가 실제로 일해요. 쓰고 있는 구독에 맞는 탭 하나만 보세요.

1. 클로드 코드를 설치해요

윈도우는 시작 메뉴에서 powershell을 검색해 Windows PowerShell을 여세요. 이름에 (x86)이 붙지 않은 창에 아래 한 줄을 붙여 넣고 Enter를 누릅니다.

winget install --id Anthropic.ClaudeCode -e --source winget

맥은 터미널(명령을 붙여 넣는 앱)을 열고 아래 한 줄을 붙여 넣으세요.

curl -fsSL https://claude.ai/install.sh | bash

화면이 다르면 클로드 코드·코덱스 설치 페이지도 함께 보세요.

윈도우에서 촬영할 때는 211MB를 내려받았고 1~3분쯤 걸렸어요. 화면에 설치 성공이 나오면 PowerShell 또는 터미널과 VS Code를 완전히 닫았다가 다시 여세요.

맥은 두 앱에서 각각 Command + Q를 눌러 종료해야 해요. 새로 연 창만 방금 설치한 claude를 찾을 수 있어요.

윈도우 PowerShell에서 클로드 코드 설치 명령을 실행해 211MB를 내려받고 설치 성공이 뜬 화면

2. 폴더를 열고 로그인해요

바탕화면에 test 폴더를 만드세요. VS Code에서 파일(File) → 폴더 열기(Open Folder)를 누르고 그 폴더를 선택합니다.

메뉴에서 터미널(Terminal) → 새 터미널(New Terminal)을 누른 뒤 claude 한 단어를 입력하고 Enter를 누르세요. 브라우저가 열리면 Claude 계정으로 로그인합니다.

처음에는 이 폴더를 믿어도 되는지 물어요. 내가 만든 test 폴더가 맞는지 확인한 뒤 Yes, I trust this folder를 선택하세요.

클로드 코드가 이 폴더를 믿어도 되는지 묻는 첫 확인 화면

로그인과 폴더 승인은 직접 해야 해요. 이것만 직접 하시면 파일 만들기는 클로드가 해요.

3. 첫 페이지를 부탁해요

클로드에게 이렇게 말하세요.

지금 연 test 폴더에 index.html 파일 한 장을 만들어 줘.
페이지 가운데에 "나의 첫 바이브 코딩 페이지"라고 크게 보여 줘.
배경은 밝게 하고, 처음 보는 사람도 파일을 찾기 쉽게 작업이 끝나면 만든 파일 이름을 알려 줘.

파일을 만들어도 되는지 물으면 index.html 한 장을 만드는 요청인지 확인하고 승인하세요.

4. 브라우저로 열어 봐요

클로드에게 이어서 말하세요.

방금 만든 index.html을 내 기본 브라우저로 열어 줘.

브라우저에 문장이 보이면 이 탭의 실습은 끝이에요.


여기까지 확인하세요

  • VS Code가 열렸어요.
  • 클로드 코드 또는 코덱스에 로그인했어요.
  • test 폴더에 index.html이 생겼어요.
  • 브라우저에 첫 페이지가 보여요.

네 가지가 보이면 3강을 마친 거예요. Git과 GitHub는 저장과 되돌리기를 배우는 5강에서 준비합니다.


막히면 이 문장을 붙여 넣으세요

설치나 실행이 멈췄을 때
  • claude 또는 codex를 찾을 수 없다고 나오면 PowerShell이나 터미널과 VS Code를 완전히 끈 뒤 다시 여세요.
  • 윈도우에서 PowerShell 이름에 (x86)이 붙었다면 그 창을 닫고 (x86)이 없는 Windows PowerShell을 여세요.
  • winget을 찾을 수 없다면 Microsoft Store에서 앱 설치 관리자(App Installer)를 업데이트하세요.

그래도 막히면 화면의 오류 문구를 복사하세요. AI가 안 열릴 때는 브라우저의 Claude나 ChatGPT를 이용하면 돼요.

나는 코딩과 터미널을 처음 써.
아래 오류가 왜 생겼는지 쉬운 말로 설명해 줘.
내가 직접 눌러야 할 버튼이 있으면 먼저 알려 주고,
그다음 해결 과정을 한 단계씩 안내해 줘.
[여기에 오류 문구를 붙여 넣기]

로그인, 설치 승인, 프로그램 업데이트는 직접 해야 해요. 이것만 직접 하시면 나머지는 클로드나 챗GPT가 안내해 줘요.


이 강의, 영상으로도 있어요

영상에는 윈도우에서 설치하는 실제 화면이 나와요. 글에서 막힌 장면을 찾아 함께 보세요.

영상이 더 편하면 유튜브에서 이어서 보세요.

👉 유튜브 채널 「오토프로그」 바로 가기


이런 분께 추천해요

개발 도구를 처음 설치하는 사장님·직장인·예비창업자에게 맞아요. 설치 명령만 복사하고 첫 웹페이지부터 보고 싶은 분도 따라올 수 있어요.


참고 링크


다음 강

4강: VS Code 200% 활용하기에서는 오늘 만든 페이지의 글과 사진, 디자인을 AI에게 말해 바꿔요.

4강으로 넘어가기

▸개정 이력11건
  • v112026-09-30초보 이탈 개선 — 명령어를 프롬프트로, 분량 축소, 첫 화면 재구성
  • v102026-09-18윈도우 PC에서 실제로 설치하며 찍은 화면 7장으로 전면 교체, 설치 명령을 한 줄씩 풀어서 설명, 유료 수강생 전용인 셋팅 선별기 안내 삭제
  • v92026-09-151주차 강의안 기준으로 전면 단순화 — 설치 한 줄 + 셋팅 선별기 + 프롬프트 중심, 터미널 암기·에디터 비교·장문 트러블슈팅 제거
  • v82026-09-03Windows 설치 섹션을 3가지 방법 비교 → 한 줄씩 따라 하는 10단계로 전면 재구성. Git Bash 경로 고정(CLAUDE_CODE_GIT_BASH_PATH)·실행 경로 등록·VS Code 완전 재시작·where.exe 확인을 정식 단계로 승격, npm 설치를 기본 안내에서 제외(충돌 정리용으로만 유지), Claude Desktop 실행 별칭 충돌과 임시 PATH 대처를 문제 해결 절로 분리, Mac에도 터미널 완전 종료 안내 추가 — 실제 설치 현장에서 "설치는 됐는데 claude 를 못 찾는" 사고가 반복돼 반영
  • v72026-08-09요금제를 촬영 화면(2026-08-09 claude.ai) 실측으로 정정 — Pro $20→$19(연간 청구), Max $100/$200→$110부터, Free 행 추가
  • v62026-08-09실습 폴더명을 vibe-practice → test 로 변경 (3강 영상과 일치)
  • v52026-07-191~20강 공통으로 반복되던 `!` 셸 모드 안내 문구를 하나로 통일 — 실행 결과에 클로드가 한마디 덧붙인다는 현행 동작과, 터미널에서 연 클로드 코드에서만 되고 VS Code 확장 채팅 창에서는 안 된다는 조건을 추가
  • v42026-07-19운영체제 조건을 공식 표기(Windows 10 1809 이상)로 정정, 설치 확인 단계에 자가 진단 명령 claude doctor 추가
  • v32026-07-19요금제 표 최신화(Max 사용량 Pro의 10배 → 20배, 요금제별 모델 구분 행 삭제, Pro 연간 결제가 병기), Windows Git for Windows를 필수 → 권장으로 정정, npm 설치의 deprecated 표기 삭제(정식 대안 경로 · Node.js 22 이상 필요)
  • v22026-04-15Windows 설치 섹션 3단계 플랜 구조로 재구성 (PowerShell → WinGet → npm 최후수단). Windows 11 WinGet 권장 명시, 공식 스크립트 실패 시 대응법 추가, 관리자 권한 안내 제거(공식 문서 기준 불필요), Node.js LTS 다운로드 링크 추가
  • v12026-04-12초판

이 글은 오토프로그(AutoFrog) 랩스에서 씁니다 — (주)디온웍스가 운영하는 AI 업무 자동화·바이브 코딩 교육 브랜드 · autofrog.kr