CH01 · Claude Code 입문 & 세팅

1-2. 대안 환경 & 도구 원리

설명 영상이 챕터를 영상으로 먼저 훑어보세요 · 5분 44초

Claude Code 구독료가 부담되시나요? 걱정 마세요. 이미 쓰고 계신 ChatGPT나 Gemini 계정만으로도 똑같은 실습을 끝까지 따라올 수 있습니다. 이 페이지에서는 대안 도구를 설치·실행하는 법과, "도구가 달라도 원리는 같다"는 이 강의의 핵심 철학을 함께 익힙니다.


1. 구독료가 부담된다면 — ChatGPT·Gemini로도 똑같이 실습합니다

여기서 가장 자주 나오는 질문. "Claude Code 유료 플랜을 꼭 결제해야 하나요?" 답은 아니요입니다. 이미 ChatGPT나 Gemini를 쓰고 계신다면, 그 계정으로 동일한 종류의 터미널 에이전트를 설치해 강의의 모든 실습을 따라올 수 있습니다.

ChatGPT 사용자라면

OpenAI Codex CLI

  • 설치: npm install -g @openai/codex
  • 실행: codex 입력 → ChatGPT 계정으로 로그인
  • 지침 파일은 AGENTS.md
Gemini 사용자라면

Google Antigravity CLI

  • 설치(맥): curl -fsSL https://antigravity.google/cli/install.sh | bash
  • 설치(윈도우 PowerShell): irm https://antigravity.google/cli/install.ps1 | iex
  • 실행: agy 입력 → 개인 구글 계정으로 로그인
  • 지침 파일은 GEMINI.md (또는 AGENTS.md)

예전 강의 자료의 Gemini CLI(gemini)는 2026년 6월 18일부터 개인 무료 계정과 Google AI Pro/Ultra 사용자에게 서비스가 끝나고, 구글이 Antigravity CLI로 옮겼습니다.

"원리는 같다"는 말로만 끝내지 않겠습니다. 위에서 Claude로 한 흐름(폴더 만들기 → 첫 실행 → 로그인 → 폴더 접근 승인 → 성공 화면 → 첫 프롬프트로 검증)을 Codex로도 그대로 밟아 보겠습니다. 폴더를 만드는 단계는 위 4번의 ③~⑤(cd Desktop → mkdir vibecoding → cd vibecoding)와 한 글자도 다르지 않으니 그 폴더 안에 들어와 있는 상태에서 시작하면 됩니다.

C1

설치: 터미널에 아래를 붙여넣고 엔터. 점과 패키지 이름이 흐르다가 멈추고 에러 글자 없이 새 입력 줄이 돌아오면 설치 완료입니다. (sudo 금지 · EACCES 에러는 위 4번 처방과 동일)
npm install -g @openai/codex

C2

실행: 위에서 만든 vibecoding 폴더 안에서 codex를 입력하고 엔터를 칩니다. 그러면 에이전트 대화창이 켜집니다.

C3

브라우저 로그인: 처음 실행하면 로그인 안내가 뜨고 브라우저가 열립니다. ChatGPT 계정으로 로그인 → 승인을 누르면 터미널로 돌아와 연결이 완료됩니다. (Claude는 Anthropic 계정이었던 그 자리만 ChatGPT로 바뀐 것뿐이에요.)

C4

"이 폴더에서 작업할까요?" 승인: Codex도 안전을 위해 처음에 이 폴더의 파일에 접근/작업해도 되는지 확인을 물을 수 있습니다. 방향키로 허용(Yes)을 골라 엔터. 내가 직접 만든 폴더이니 안심하고 허용하세요.

C5

성공 화면: 환영 메시지와 함께 한국어를 입력할 수 있는 빈 입력 줄이 보이면 준비 끝입니다. Claude의 9번 성공 화면과 모양만 조금 다를 뿐 역할은 똑같아요.

C6

첫 프롬프트로 검증: 위 4번에서 Claude에게 보냈던 그 문장을 그대로 붙여넣고 엔터를 쳐 보세요(아래 박스). 폴더 안 파일 목록을 한국어로 읊어 주면 설치·로그인이 모두 정상입니다.

"안녕! 너를 처음 써봐. 지금 이 폴더 안에 어떤 파일이 있는지 한국어로 알려줄래?"

💡 구글 계정이라면 Antigravity CLI도 똑같습니다. 위 절차에서 설치 명령만 위의 Antigravity 설치 한 줄, 실행 명령만 agy, 로그인만 개인 구글 계정으로 바꾸면 C1~C6이 그대로 반복됩니다. 처음 실행할 때 화면 색상과 표시 방식을 고르는 질문, "이 폴더를 신뢰할까요?" 확인이 먼저 나오는데 기본값으로 진행하면 됩니다. (지침 파일도 도구별로 AGENTS.md / GEMINI.md로 이름만 다릅니다.)

세 도구를 한눈에 비교하면 다음과 같습니다. 설치·실행·로그인·지침 파일만 도구마다 다를 뿐, 쓰는 방법은 거의 똑같습니다.

항목 Claude Code ChatGPT → Codex CLI 구글 → Antigravity CLI
설치 명령 네이티브 설치 (1-1 참고, 대안: npm install -g @anthropic-ai/claude-code) npm install -g @openai/codex 네이티브 설치 (위 설치 한 줄)
실행 명령 claude codex agy
로그인 Anthropic 계정 (브라우저) ChatGPT 계정 (브라우저) 개인 구글 계정 (브라우저)
무료·요금 Pro 이상 유료 구독 필요(무료 플랜 불가) 또는 API 사용량 기반 ChatGPT 구독 한도 안에서 이용 무료 구글 계정도 사용 가능(주 단위 할당량). Google AI Pro·Ultra는 더 넉넉
지침 파일 CLAUDE.md AGENTS.md GEMINI.md 또는 AGENTS.md

💡 도구는 빠르게 진화합니다. 무료 한도나 요금 정책은 수시로 바뀌니, 한시적 정책에 의존해 선택하기보다 이미 쓰고 있는 계정 기준으로 하나만 고르세요. 어떤 터미널 에이전트를 골라도 이 강의의 실습은 동일하게 진행됩니다.

2. "도구가 달라도 원리는 같다"

이 강의를 듣고 나면 특정 도구에 얽매이지 않게 됩니다. 왜냐하면 진짜 중요한 것은 도구의 브랜드가 아니라, 그 아래 흐르는 공통 원리이기 때문입니다.

① 한국어로 지시 프롬프트로 의도를 전달
② 에이전트가 실행 파일을 직접 읽고·쓰고·명령 실행
③ 평문 지침으로 길들임 CLAUDE.md / AGENTS.md / GEMINI.md

세 도구 모두 이 흐름을 똑같이 따릅니다. 그래서 한 도구로 익힌 감각은 다른 도구로 자연스럽게 옮겨 갑니다. 다만 솔직하게 짚고 넘어갈 점이 있습니다.

옮겨 가는 것 (전이됨)

원리와 디렉팅 실력

  • 평문 지침 파일로 규칙을 정해 주는 습관
  • 자주 쓰는 작업을 재사용 커스텀 명령으로 묶는 감각
  • 에러를 읽고 다시 지시하는 디렉팅(지휘) 실력
옮겨 가지 않는 것 (도구마다 다름)

세부 기능명과 화면

  • 기능의 이름·메뉴·단축키는 도구마다 제각각
  • "한 도구의 기능이 다른 도구에 100% 그대로 있다"는 말은 과장
  • 그러니 기능 이름을 외우기보다 원리를 체득하세요
다음 클립
1-3. 첫 바이브코딩
이어보기 →