공개 문서
content/courses/00-intro.mdx
아래는 content/courses/00-intro.mdx 와 동일한 원문입니다. Markdown과 HTML 변환 결과를 각각 복사할 수 있습니다.
공개 문서 원문 (Markdown)
---
title: "AI 코딩 도구 개요"
slug: "00-intro"
description: "Cursor, Claude Code, Gemini CLI, Google Workspace CLI — 네 도구의 차이와 조합 방법"
order: 0
date: "2026-03-10"
level: 1
draft: false
---
# AI 코딩 도구 개요
> **이 챕터를 마치면** 네 도구(Cursor, Claude Code, Gemini CLI, Google Workspace CLI)의 차이를 알고 상황에 맞게 골라 쓸 수 있어요.
바이브코딩(Vibe Coding)이란 AI와 대화하듯 코딩하는 방식이에요.
직접 모든 코드를 타이핑하는 대신, **의도를 설명하면 AI가 코드를 작성**해 줘요.
2026년 현재 가장 많이 쓰이는 AI 코딩 도구는 네 가지예요.
---
## 도구 비교
| 항목 | Cursor | Claude Code | Gemini CLI | Google Workspace CLI |
|------|--------|-------------|------------|----------------------|
| **인터페이스** | GUI 에디터 | CLI 터미널 | CLI 터미널 | CLI 터미널 |
| **제작사** | Anysphere | Anthropic | Google | Google |
| **기반 모델** | Claude 3.7 / GPT-4o | Claude Sonnet 4.6 | Gemini 2.5 Pro | Discovery API + AI 스킬 |
| **무료 한도** | 월 2,000회 자동완성 | Pro/Max 구독 포함 | 무료 (분당 60요청) | OAuth·Workspace 계정 기준 |
| **컨텍스트 창** | 열린 파일 기준 | 프로젝트 전체 | 100만 토큰 | Drive·Docs·Sheets·Gmail |
| **자율 실행** | Agent 모드 | 기본 동작 | 제한적 | AI 에이전트 스킬 |
| **설치** | 앱 다운로드 | `npm i -g` | `npm i -g` | `npm i -g @googleworkspace/cli` |
---
## 각 도구의 강점
### Cursor — GUI 에디터
**언제 쓰나:** 파일 편집, UI 작업, 처음 시작하는 분
코드 에디터 안에 AI가 내장되어 있어요. 마우스로 클릭하고, 드래그하고, 시각적으로 확인하면서 작업할 수 있어서 **프로그래밍 경험이 없어도 바로 시작**할 수 있어요.
- **Chat (`Cmd+L`):** "이 함수가 왜 안 되지?" 질문
- **Inline Edit (`Cmd+K`):** 선택 영역만 수정
- **Composer (`Cmd+I`):** 여러 파일 동시 생성/수정
- **Agent 모드:** 터미널 명령 포함 자율 실행
---
### Claude Code — CLI 에이전트
**언제 쓰나:** 복잡한 기능 구현, 멀티파일 리팩토링, 자동화
터미널에서 실행하는 AI 에이전트예요. **프로젝트 전체를 이해하고 자율적으로 파일을 생성·수정·삭제**해 줘요. "Supabase 인증 추가해줘"라고 하면 필요한 모든 파일을 알아서 수정해요.
```bash
claude "회원가입 폼에 이메일 유효성 검사 추가해줘"
# → app/components/SignupForm.tsx 수정
# → lib/validation.ts 생성
# → 완료 후 결과 보고
```
---
### Gemini CLI — 대용량 분석 도구
**언제 쓰나:** 전체 코드 리뷰, 문서화, 빠른 리서치
Google의 CLI 도구예요. **100만 토큰 컨텍스트**로 대규모 코드베이스 전체를 한 번에 분석할 수 있어요. 무료로 사용할 수 있다는 것도 장점이에요.
```bash
# 전체 프로젝트 보안 리뷰
find . -name "*.ts" | xargs cat | gemini "보안 취약점을 찾아서 한국어로 설명해줘"
```
---
### Google Workspace CLI — 워크스페이스 연동 도구
**언제 쓰나:** Google Drive·Docs·Sheets·Gmail 연동, AI 에이전트와 연동
Google이 공개한 CLI 도구(**gws**)예요. **Drive, Docs, Sheets, Gmail, Calendar, Chat** 등을 터미널에서 다루고, AI 에이전트 스킬로 다른 도구와 조합할 수 있어요. 기획서·문서·스프레드시트를 코드와 함께 다룰 때 유용해요.
```bash
# Drive 파일 목록 조회
gws drive files list
# Docs 내용을 AI에 전달해 요약
gws docs get <doc-id> | claude "이 문서를 3문장으로 요약해줘"
```
---
## 2026 인기 튜토리얼 대본 분석 요약
아래 내용은 2025~2026년 인기 입문 영상(예: Cursor 설치/첫 프로젝트, Claude Code 초보자 튜토리얼)의 공통 패턴을 요약한 것입니다.
### 공통 성공 패턴 3가지
1. **설치보다 "첫 실행 성공"을 목표로 잡는다**
- 설치 자체는 10~20분 안에 끝나지만, 실제로는 "첫 프로젝트 실행"에서 막히는 경우가 많아요.
- 그래서 학습 순서를 **가입 → 설치 → 버전확인 → 첫 실행**으로 끊는 것이 효율적입니다.
2. **도구별 역할을 초기에 분리한다**
- Cursor: 화면 보면서 빠르게 수정/실험
- Claude Code: 멀티파일 작업/자동화
- Gemini CLI: 대규모 리뷰/요약
- GWS CLI: 문서·시트·메일을 워크플로우에 연결
- 초반에 역할이 섞이면 학습 피로가 급격히 커집니다.
3. **"작은 산출물 1개"를 빠르게 만든다**
- 인기 영상들은 대부분 첫 30분 안에 로그인 화면/기본 페이지 같은 결과물을 보여줘요.
- 이 커리큘럼도 같은 원칙으로 설계되어 있습니다.
### 초보자가 자주 막히는 지점
- 환경 변수/경로(PATH) 반영 누락으로 CLI 명령이 안 되는 문제
- 패키지 매니저(`npm`/`pnpm`) 혼용으로 설치 충돌
- 한 채팅에 너무 많은 요청을 몰아넣어 AI 컨텍스트가 흐려지는 문제
> **실전 팁:** "도구를 배우는 시간"보다 "작동하는 최소 결과를 만드는 시간"을 우선 확보하세요.
---
## 추천 조합 워크플로우
네 도구를 독립적으로 쓰는 것보다 **역할을 나눠서 조합**하면 훨씬 강력해요.
```
기획/설계 → Cursor (기획서, 파일 구조 초안)
문서·데이터 → Google Workspace CLI (Docs, Sheets 연동)
핵심 구현 → Claude Code (복잡한 기능, 멀티파일 작업)
리뷰/문서화 → Gemini CLI (전체 코드 검토, README 생성)
UI 세부 조정 → Cursor (컴포넌트 수정, 스타일 조정)
배포 자동화 → Claude Code (배포 스크립트, CI/CD 설정)
```
---
## 이 커리큘럼의 구성
| 모듈 | 내용 | 챕터 |
|------|------|------|
| **Module 1** | Cursor 바이브코딩 | 1~5 |
| **Module 2** | Claude Code 바이브코딩 | 6~9 |
| **Module 3** | Gemini CLI 바이브코딩 | 10~12 |
| **Module 4** | Google Workspace CLI 바이브코딩 | 13~15 |
| **Module 5** | 실전 프로젝트 (4종 통합) | 16~17 |
Module 1부터 순서대로 따라가거나, 이미 Cursor를 쓰고 있다면 Module 2부터 시작해도 돼요.
> **준비물:** GitHub 계정, Node.js 22+, pnpm, Git
> Module 1의 [회원 가입](./01-signup)과 [설치](./02-installation)를 먼저 완료해 보세요.
공개 문서 변환 코드 (HTML)
<hr>
<h2>title: "AI 코딩 도구 개요"
slug: "00-intro"
description: "Cursor, Claude Code, Gemini CLI, Google Workspace CLI — 네 도구의 차이와 조합 방법"
order: 0
date: "2026-03-10"
level: 1
draft: false</h2>
<h1>AI 코딩 도구 개요</h1>
<blockquote>
<p><strong>이 챕터를 마치면</strong> 네 도구(Cursor, Claude Code, Gemini CLI, Google Workspace CLI)의 차이를 알고 상황에 맞게 골라 쓸 수 있어요.</p>
</blockquote>
<p>바이브코딩(Vibe Coding)이란 AI와 대화하듯 코딩하는 방식이에요.
직접 모든 코드를 타이핑하는 대신, <strong>의도를 설명하면 AI가 코드를 작성</strong>해 줘요.</p>
<p>2026년 현재 가장 많이 쓰이는 AI 코딩 도구는 네 가지예요.</p>
<hr>
<h2>도구 비교</h2>
<table>
<thead>
<tr>
<th>항목</th>
<th>Cursor</th>
<th>Claude Code</th>
<th>Gemini CLI</th>
<th>Google Workspace CLI</th>
</tr>
</thead>
<tbody><tr>
<td><strong>인터페이스</strong></td>
<td>GUI 에디터</td>
<td>CLI 터미널</td>
<td>CLI 터미널</td>
<td>CLI 터미널</td>
</tr>
<tr>
<td><strong>제작사</strong></td>
<td>Anysphere</td>
<td>Anthropic</td>
<td>Google</td>
<td>Google</td>
</tr>
<tr>
<td><strong>기반 모델</strong></td>
<td>Claude 3.7 / GPT-4o</td>
<td>Claude Sonnet 4.6</td>
<td>Gemini 2.5 Pro</td>
<td>Discovery API + AI 스킬</td>
</tr>
<tr>
<td><strong>무료 한도</strong></td>
<td>월 2,000회 자동완성</td>
<td>Pro/Max 구독 포함</td>
<td>무료 (분당 60요청)</td>
<td>OAuth·Workspace 계정 기준</td>
</tr>
<tr>
<td><strong>컨텍스트 창</strong></td>
<td>열린 파일 기준</td>
<td>프로젝트 전체</td>
<td>100만 토큰</td>
<td>Drive·Docs·Sheets·Gmail</td>
</tr>
<tr>
<td><strong>자율 실행</strong></td>
<td>Agent 모드</td>
<td>기본 동작</td>
<td>제한적</td>
<td>AI 에이전트 스킬</td>
</tr>
<tr>
<td><strong>설치</strong></td>
<td>앱 다운로드</td>
<td><code>npm i -g</code></td>
<td><code>npm i -g</code></td>
<td><code>npm i -g @googleworkspace/cli</code></td>
</tr>
</tbody></table>
<hr>
<h2>각 도구의 강점</h2>
<h3>Cursor — GUI 에디터</h3>
<p><strong>언제 쓰나:</strong> 파일 편집, UI 작업, 처음 시작하는 분</p>
<p>코드 에디터 안에 AI가 내장되어 있어요. 마우스로 클릭하고, 드래그하고, 시각적으로 확인하면서 작업할 수 있어서 <strong>프로그래밍 경험이 없어도 바로 시작</strong>할 수 있어요.</p>
<ul>
<li><strong>Chat (<code>Cmd+L</code>):</strong> "이 함수가 왜 안 되지?" 질문</li>
<li><strong>Inline Edit (<code>Cmd+K</code>):</strong> 선택 영역만 수정</li>
<li><strong>Composer (<code>Cmd+I</code>):</strong> 여러 파일 동시 생성/수정</li>
<li><strong>Agent 모드:</strong> 터미널 명령 포함 자율 실행</li>
</ul>
<hr>
<h3>Claude Code — CLI 에이전트</h3>
<p><strong>언제 쓰나:</strong> 복잡한 기능 구현, 멀티파일 리팩토링, 자동화</p>
<p>터미널에서 실행하는 AI 에이전트예요. <strong>프로젝트 전체를 이해하고 자율적으로 파일을 생성·수정·삭제</strong>해 줘요. "Supabase 인증 추가해줘"라고 하면 필요한 모든 파일을 알아서 수정해요.</p>
<pre><code class="language-bash">claude "회원가입 폼에 이메일 유효성 검사 추가해줘"
# → app/components/SignupForm.tsx 수정
# → lib/validation.ts 생성
# → 완료 후 결과 보고
</code></pre>
<hr>
<h3>Gemini CLI — 대용량 분석 도구</h3>
<p><strong>언제 쓰나:</strong> 전체 코드 리뷰, 문서화, 빠른 리서치</p>
<p>Google의 CLI 도구예요. <strong>100만 토큰 컨텍스트</strong>로 대규모 코드베이스 전체를 한 번에 분석할 수 있어요. 무료로 사용할 수 있다는 것도 장점이에요.</p>
<pre><code class="language-bash"># 전체 프로젝트 보안 리뷰
find . -name "*.ts" | xargs cat | gemini "보안 취약점을 찾아서 한국어로 설명해줘"
</code></pre>
<hr>
<h3>Google Workspace CLI — 워크스페이스 연동 도구</h3>
<p><strong>언제 쓰나:</strong> Google Drive·Docs·Sheets·Gmail 연동, AI 에이전트와 연동</p>
<p>Google이 공개한 CLI 도구(<strong>gws</strong>)예요. <strong>Drive, Docs, Sheets, Gmail, Calendar, Chat</strong> 등을 터미널에서 다루고, AI 에이전트 스킬로 다른 도구와 조합할 수 있어요. 기획서·문서·스프레드시트를 코드와 함께 다룰 때 유용해요.</p>
<pre><code class="language-bash"># Drive 파일 목록 조회
gws drive files list
# Docs 내용을 AI에 전달해 요약
gws docs get <doc-id> | claude "이 문서를 3문장으로 요약해줘"
</code></pre>
<hr>
<h2>2026 인기 튜토리얼 대본 분석 요약</h2>
<p>아래 내용은 2025~2026년 인기 입문 영상(예: Cursor 설치/첫 프로젝트, Claude Code 초보자 튜토리얼)의 공통 패턴을 요약한 것입니다.</p>
<h3>공통 성공 패턴 3가지</h3>
<ol>
<li><p><strong>설치보다 "첫 실행 성공"을 목표로 잡는다</strong></p>
<ul>
<li>설치 자체는 10~20분 안에 끝나지만, 실제로는 "첫 프로젝트 실행"에서 막히는 경우가 많아요.</li>
<li>그래서 학습 순서를 <strong>가입 → 설치 → 버전확인 → 첫 실행</strong>으로 끊는 것이 효율적입니다.</li>
</ul>
</li>
<li><p><strong>도구별 역할을 초기에 분리한다</strong></p>
<ul>
<li>Cursor: 화면 보면서 빠르게 수정/실험</li>
<li>Claude Code: 멀티파일 작업/자동화</li>
<li>Gemini CLI: 대규모 리뷰/요약</li>
<li>GWS CLI: 문서·시트·메일을 워크플로우에 연결</li>
<li>초반에 역할이 섞이면 학습 피로가 급격히 커집니다.</li>
</ul>
</li>
<li><p><strong>"작은 산출물 1개"를 빠르게 만든다</strong></p>
<ul>
<li>인기 영상들은 대부분 첫 30분 안에 로그인 화면/기본 페이지 같은 결과물을 보여줘요.</li>
<li>이 커리큘럼도 같은 원칙으로 설계되어 있습니다.</li>
</ul>
</li>
</ol>
<h3>초보자가 자주 막히는 지점</h3>
<ul>
<li>환경 변수/경로(PATH) 반영 누락으로 CLI 명령이 안 되는 문제</li>
<li>패키지 매니저(<code>npm</code>/<code>pnpm</code>) 혼용으로 설치 충돌</li>
<li>한 채팅에 너무 많은 요청을 몰아넣어 AI 컨텍스트가 흐려지는 문제</li>
</ul>
<blockquote>
<p><strong>실전 팁:</strong> "도구를 배우는 시간"보다 "작동하는 최소 결과를 만드는 시간"을 우선 확보하세요.</p>
</blockquote>
<hr>
<h2>추천 조합 워크플로우</h2>
<p>네 도구를 독립적으로 쓰는 것보다 <strong>역할을 나눠서 조합</strong>하면 훨씬 강력해요.</p>
<pre><code>기획/설계 → Cursor (기획서, 파일 구조 초안)
문서·데이터 → Google Workspace CLI (Docs, Sheets 연동)
핵심 구현 → Claude Code (복잡한 기능, 멀티파일 작업)
리뷰/문서화 → Gemini CLI (전체 코드 검토, README 생성)
UI 세부 조정 → Cursor (컴포넌트 수정, 스타일 조정)
배포 자동화 → Claude Code (배포 스크립트, CI/CD 설정)
</code></pre>
<hr>
<h2>이 커리큘럼의 구성</h2>
<table>
<thead>
<tr>
<th>모듈</th>
<th>내용</th>
<th>챕터</th>
</tr>
</thead>
<tbody><tr>
<td><strong>Module 1</strong></td>
<td>Cursor 바이브코딩</td>
<td>1~5</td>
</tr>
<tr>
<td><strong>Module 2</strong></td>
<td>Claude Code 바이브코딩</td>
<td>6~9</td>
</tr>
<tr>
<td><strong>Module 3</strong></td>
<td>Gemini CLI 바이브코딩</td>
<td>10~12</td>
</tr>
<tr>
<td><strong>Module 4</strong></td>
<td>Google Workspace CLI 바이브코딩</td>
<td>13~15</td>
</tr>
<tr>
<td><strong>Module 5</strong></td>
<td>실전 프로젝트 (4종 통합)</td>
<td>16~17</td>
</tr>
</tbody></table>
<p>Module 1부터 순서대로 따라가거나, 이미 Cursor를 쓰고 있다면 Module 2부터 시작해도 돼요.</p>
<blockquote>
<p><strong>준비물:</strong> GitHub 계정, Node.js 22+, pnpm, Git
Module 1의 <a href="./01-signup">회원 가입</a>과 <a href="./02-installation">설치</a>를 먼저 완료해 보세요.</p>
</blockquote>