Cline 가이드
VS Code에서 사용하는 자율 AI 코딩 에이전트 Cline 완전 가이드. GitHub 61K+·설치 5M+, v3.81 기준 Memory Bank·Sub-Agents·MCP Marketplace·YOLO 모드 포함.
# 1. VS Code에서 Cline 확장 설치
Extensions (Ctrl+Shift+X) → "Cline" 검색 → Install
# 2. API 키 설정 (최고 성능: Claude Opus 4.7)
Cline 사이드바 → Settings → Anthropic → API Key 입력
→ Model: claude-opus-4-7-20251016
# 3. Plan 모드로 안전하게 시작
Cline 사이드바 → Plan 모드 선택
"React 블로그 앱 만들어줘. 전체 기능 구현."
→ 계획 검토 후 Act 모드로 실행 (또는 YOLO 모드로 자동 전환)
소개
Cline (이전 이름: Claude Dev)은 단순한 코드 생성을 넘어 파일 시스템 조작, 터미널 명령 실행, 브라우저 제어까지 가능한 자율 AI 에이전트입니다. 2026년 4월 기준 GitHub Stars 61,000+, VS Code 설치 5M+, 최신 버전 v3.81.0 (2026-04-24)으로 활발하게 개발 중입니다. Memory Bank, Sub-Agents, MCP Marketplace 등 고급 기능을 갖춘 VS Code 생태계 최강의 자율 에이전트로 자리잡았습니다.
- GitHub Stars: 61,000+ (오픈소스, MIT 라이선스)
- VS Code 설치: 5,000,000+
- 최신 버전: v3.81.0 (2026-04-24)
- Sub-Agents 지원: v3.58부터 네이티브 지원
- SWE-bench Verified: Claude Sonnet 4.5 기준 ~59.8% (모델 의존적)
- MCP Marketplace: 100+ 사전 빌드 MCP 서버
- 자율 실행형 도구: 답변을 주는 것보다 실제로 파일과 명령을 만지는 쪽에 무게가 있습니다.
- 승인 중심 운영: 강력한 만큼 중요한 변경은 승인 단계를 두고 쓰는 편이 안전합니다.
- 복잡한 작업용: 설치, 수정, 실행, 디버깅이 한 번에 묶인 작업에서 특히 유용합니다.
그림: Cline 자율 실행 흐름을 단순화한 기본 버전
자율 에이전트란?
일반적인 AI 코딩 도구는 사용자가 요청할 때마다 응답합니다. 하지만 자율 에이전트는:
- 계획 수립: 복잡한 작업을 단계별로 분해
- 자율 실행: 각 단계를 스스로 실행
- 에러 처리: 실패 시 자동으로 수정 시도
- 승인 요청: 중요한 작업은 사용자 확인 요청
핵심 기능 (v3.81 기준)
| 기능 | 설명 | 버전 |
|---|---|---|
| 파일 편집 | 파일 생성, 수정, 삭제 (자율) | 기본 |
| 터미널 실행 | npm install, git commit 등 자동 실행 | 기본 |
| 브라우저 제어 | Claude Computer Use 기반 스크린샷·클릭·폼 입력 | 기본 |
| Plan/Act 모드 | 계획 수립(Plan)과 실행(Act)을 분리, YOLO 모드로 자동 전환 가능 | 기본 |
| Memory Bank ★ | 프로젝트 컨텍스트(설계 결정, 규칙, 패턴)를 마크다운으로 세션 간 유지 | 최신 |
| Sub-Agents ★ | 병렬 서브에이전트 생성 및 Boomerang Tasks 오케스트레이션 | v3.58+ |
| MCP Marketplace ★ | 100+ 사전 빌드 MCP 서버 원클릭 설치 (DB, API, 브라우저 등) | 최신 |
| 승인 시스템 | 위험한 작업은 사용자 확인, Auto Approve 설정 가능 | 기본 |
| Checkpoints | 실행 중간 상태 저장 및 롤백 | 기본 |
다른 도구와의 차이점
| 도구 | 자율성 | 터미널 실행 | 브라우저 제어 |
|---|---|---|---|
| Cline | ✅ 높음 | ✅ | ✅ |
| Continue | ❌ 수동 | 제한적 | ❌ |
| Cursor | ❌ 수동 | 제한적 | ❌ |
| Claude CLI | ✅ 높음 | ❌ | ❌ |
설치
클라이언트 설치
방법 1: 마켓플레이스
1. VS Code 열기
2. Extensions (Cmd/Ctrl + Shift + X)
3. "Cline" 검색
4. Install
5. Reload
방법 2: 다른 클라이언트
# 공식 설치 문서 기준 지원 표면
- Cursor
- Windsurf
- JetBrains
- CLI
API 키 설정
Cline은 Anthropic, OpenAI, Google 모델을 지원합니다. 아래는 Anthropic 기준 예시입니다.
1. API 키 발급 (Anthropic 예시)
1. https://console.anthropic.com 접속
2. "Get API Keys" 클릭
3. API 키 생성 및 복사
4. 키 형식: sk-ant-api03-xxxxxxx
2. Cline에 API 키 입력
# 방법 1: Cline UI
1. Cline 사이드바 열기 (좌측 아이콘)
2. Settings (톱니바퀴 아이콘)
3. API Provider: Anthropic
4. API Key 입력
5. Model: claude-sonnet-4-6
# 방법 2: 환경 변수
export ANTHROPIC_API_KEY="sk-ant-api03-xxx"
첫 실행
# 1. Cline 사이드바 열기
좌측 아이콘 클릭 또는 Cmd/Ctrl + Shift + P → "Cline: Open"
# 2. 첫 요청
💬 You: "안녕! 간단한 테스트로 hello.txt 파일 만들어줘."
🤖 Cline: "hello.txt를 생성하겠습니다."
# 승인 요청
[Cline] 📝 Write to file: hello.txt
승인하시겠습니까? (예/아니오)
# Y 누르면 파일 생성됨
Settings에서 "Auto Approve" 옵션을 켜면 파일 읽기/쓰기를 자동 승인합니다. (개발 중에는 편리하지만 주의 필요)
기본 사용법
간단한 작업
파일 생성
💬 You: "Python으로 간단한 계산기 만들어줘. calculator.py 파일로."
🤖 Cline: "calculator.py를 생성하겠습니다."
# Cline이 자동으로:
1. 파일 생성 (calculator.py)
2. 코드 작성 (덧셈, 뺄셈, 곱셈, 나눗셈)
3. 사용 예제 주석 추가
✅ 완료!
파일 수정
💬 You: "calculator.py에 제곱 기능 추가해줘."
🤖 Cline: "파일을 읽고 수정하겠습니다."
# Cline이 자동으로:
1. 파일 읽기
2. power() 함수 추가
3. 파일 저장
✅ 완료! power() 함수를 추가했습니다.
복잡한 작업
전체 프로젝트 생성
💬 You: "React + TypeScript 투두 앱 만들어줘.
필요한 것:
- Create React App 설정
- TypeScript 타입 정의
- 컴포넌트 (TodoList, TodoItem, AddTodo)
- 로컬 스토리지 저장
- Tailwind CSS 스타일링
모든 설정과 코드 작성해줘."
🤖 Cline: "React 투두 앱을 생성하겠습니다."
# Cline이 자율적으로:
Step 1: 프로젝트 생성
→ npx create-react-app todo-app --template typescript
Step 2: Tailwind 설치
→ npm install -D tailwindcss postcss autoprefixer
→ npx tailwindcss init -p
Step 3: 파일 생성
→ src/types/todo.ts
→ src/components/TodoList.tsx
→ src/components/TodoItem.tsx
→ src/components/AddTodo.tsx
→ src/hooks/useTodos.ts
→ src/utils/localStorage.ts
Step 4: 설정 파일 수정
→ tailwind.config.js
→ src/index.css
Step 5: 앱 통합
→ src/App.tsx
Step 6: 테스트
→ npm start
✅ 완료! 브라우저에서 http://localhost:3000 확인하세요.
자율 작동 방식
Cline은 작업을 단계별로 분해하고 각 단계를 자율적으로 실행합니다.
💬 You: "사용자 인증 시스템 추가해줘."
🤖 Cline의 내부 계획:
1. 현재 프로젝트 구조 파악
→ package.json 읽기
→ 사용 중인 프레임워크 확인
2. 필요한 패키지 설치
→ npm install jsonwebtoken bcrypt express-session
3. 파일 생성
→ auth/jwt.js (JWT 유틸리티)
→ middleware/auth.js (인증 미들웨어)
→ routes/auth.js (인증 라우트)
→ models/User.js (사용자 모델)
4. 기존 파일 수정
→ server.js (라우트 연결)
→ .env (환경 변수)
5. 테스트
→ 서버 재시작
→ API 테스트 (curl)
# 각 단계마다 승인 요청 또는 자동 실행
승인 시스템
Cline은 중요한 작업 전에 사용자 승인을 요청합니다.
| 작업 | 승인 필요 |
|---|---|
| 파일 읽기 | 설정에 따라 |
| 파일 쓰기 | ✅ |
| 파일 삭제 | ✅ |
| 터미널 명령 | ✅ |
| 브라우저 열기 | ✅ |
# 승인 요청 예시
[Cline] 🔧 Execute command:
npm install express mongoose
package.json을 수정하고 의존성을 설치합니다.
승인하시겠습니까? (예/아니오/수정)
Y → 실행
n → 취소
edit → 명령어 수정 후 실행
고급 기능
터미널 제어
Cline은 터미널 명령을 실행하고 출력을 읽어 다음 단계를 결정합니다.
💬 You: "npm test 실행하고 실패한 테스트 수정해줘."
🤖 Cline:
Step 1: 테스트 실행
→ npm test
Output:
FAIL src/utils/math.test.js
● sum › should add two numbers
Expected: 5, Received: 4
Step 2: 분석
→ src/utils/math.js 읽기
→ 버그 발견: return a + b; → return a + b - 1;
Step 3: 수정
→ src/utils/math.js 수정
Step 4: 재실행
→ npm test
✅ 모든 테스트 통과!
브라우저 제어
Cline은 Puppeteer를 사용하여 브라우저를 제어할 수 있습니다.
💬 You: "앱 실행하고 스크린샷 찍어줘. 버그 있으면 수정."
🤖 Cline:
Step 1: 서버 시작
→ npm start (백그라운드)
Step 2: 브라우저 열기
→ http://localhost:3000
Step 3: 스크린샷
→ screenshot.png 저장
Step 4: 시각적 분석
→ 버튼이 화면 밖으로 나감 (CSS 문제)
Step 5: 수정
→ styles.css 수정
Step 6: 재확인
→ 브라우저 새로고침, 스크린샷
✅ UI 수정 완료!
컨텍스트 인식
Cline은 프로젝트 구조를 이해하고 파일 간 의존성을 파악합니다.
💬 You: "API 엔드포인트 추가해줘. /api/users"
🤖 Cline의 컨텍스트 이해:
1. 프로젝트 타입 파악
→ package.json 읽기 → Express 사용 중
2. 기존 구조 확인
→ routes/ 디렉토리 있음
→ server.js에서 라우트 연결 방식 확인
3. 데이터베이스 확인
→ models/ 디렉토리 확인 → Mongoose 사용 중
4. 일관된 코드 생성
→ routes/users.js 생성 (기존 스타일 따름)
→ models/User.js 생성 (기존 스키마 패턴 따름)
→ server.js 수정 (기존 라우트 연결 방식 따름)
✅ 프로젝트 스타일에 맞게 통합 완료!
기억 및 히스토리
Cline은 대화 히스토리를 저장하고 이전 작업을 참조합니다.
💬 You: "React 컴포넌트 만들어줘. Button."
🤖 Cline: "Button.tsx를 생성했습니다."
💬 You: "이 버튼에 hover 효과 추가해줘."
🤖 Cline: "Button.tsx에 hover 스타일을 추가했습니다."
# "이 버튼" = Button.tsx (컨텍스트 이해)
💬 You: "테스트 코드도 작성해줘."
🤖 Cline: "Button.test.tsx를 생성했습니다."
# Button 컴포넌트에 대한 테스트 (암묵적 이해)
Plan/Act 모드
Cline은 Plan 모드와 Act 모드를 분리하여 전략 수립과 실행을 구분합니다. 이를 통해 AI가 코드를 수정하기 전에 먼저 요구사항을 분석하고 단계별 계획을 세울 수 있습니다.
Plan 모드
Plan 모드에서 AI는 요구사항을 분석하고 단계별 실행 계획을 수립합니다. 파일 수정이나 명령 실행 없이 순수하게 전략만 세웁니다.
💬 You (Plan 모드): "사용자 인증 시스템 추가해줘."
🤖 Cline (Plan):
# 분석 결과:
- 현재 Express + MongoDB 프로젝트
- 기존 라우트 구조: routes/ 디렉토리
- 인증 미들웨어 없음
# 실행 계획:
1. bcrypt, jsonwebtoken 패키지 설치
2. models/User.js 생성 (Mongoose 스키마)
3. middleware/auth.js 생성 (JWT 검증)
4. routes/auth.js 생성 (회원가입/로그인)
5. server.js 수정 (라우트 연결)
6. .env에 JWT_SECRET 추가
7. 테스트 실행
→ 계획을 승인하면 Act 모드로 전환
Act 모드
Act 모드에서는 Plan 모드에서 수립한 계획을 실제로 실행합니다. 각 단계마다 사용자 승인을 요청합니다.
🤖 Cline (Act):
Step 1/7: 패키지 설치
→ npm install bcrypt jsonwebtoken
[승인?] Y
Step 2/7: 사용자 모델 생성
→ models/User.js 생성
[승인?] Y
# ... 계획대로 순차 실행
✅ 7/7 단계 완료!
멀티 모델 전략
Plan 모드와 Act 모드에 서로 다른 모델을 사용하면 비용과 품질을 동시에 최적화할 수 있습니다.
| 모드 | 권장 모델 (2026-04) | 이유 | 비용 |
|---|---|---|---|
| Plan 모드 | Claude Opus 4.7 ★ / GPT-5.5 | 복잡한 추론·분석·오케스트레이션에 최강 | $5/$25~30 |
| Act 모드 | Claude Sonnet / GPT-5.5 | 빠른 실행에 적합한 균형 모델 | 중간 |
| Sub-Agent | Claude Haiku / 저비용 모델 | 반복·단순 서브태스크 비용 최소화 | 낮음 |
# Cline Settings → 모드별 모델 설정 (2026-04 권장)
Plan Mode Model: claude-opus-4-7-20251016 # 전략 수립 (최고 품질)
Act Mode Model: claude-sonnet-4-6 # 실행 (속도 + 비용 균형)
# OpenAI 조합
Plan Mode Model: gpt-5.5 # SWE-bench 88.7%, 1M 컨텍스트
Act Mode Model: gpt-5.5 # 또는 저비용 모델로 전환
# Sub-Agent에 별도 모델 지정 (고급)
Orchestrator: claude-opus-4-7 # 오케스트레이션
Sub-Agents: claude-haiku # 실행 서브태스크
YOLO 모드
YOLO(You Only Live Once) 모드를 활성화하면 Plan → Act 전환 시 매번 승인 없이 에이전트가 자동으로 실행을 이어갑니다. 빠른 프로토타이핑에 편리하지만 중요 코드베이스에서는 주의가 필요합니다.
# Cline Settings → Plan/Act Mode
YOLO Mode: true # Plan 완료 후 자동으로 Act 실행
# 또는 대화 중 토글
💬 "/yolo" # YOLO 모드 ON/OFF 토글
Checkpoints와 복구
자율 실행 중간 상태를 저장해 두고, 잘못된 편집이나 과한 변경이 발생했을 때 빠르게 되돌아갈 수 있습니다.
# 권장 흐름
1. Plan 모드로 변경 범위 검토
2. Act 모드로 실행
3. 큰 단계가 끝날 때마다 Checkpoint 저장
4. 결과가 나쁘면 이전 Checkpoint로 복구
신규 핵심 기능 (2026)
Memory Bank
Memory Bank는 Cline의 가장 중요한 2026년 신기능 중 하나입니다. AI는 대화 창이 닫히면 컨텍스트를 잃지만, Memory Bank를 사용하면 프로젝트의 아키텍처 결정, 코딩 규칙, 설계 패턴을 마크다운 파일로 저장하여 세션이 새로 시작되어도 컨텍스트가 유지됩니다.
# 프로젝트 아키텍처
## 기술 스택
- 백엔드: FastAPI + Python 3.12
- 프론트엔드: Next.js 15 + TypeScript
- 데이터베이스: PostgreSQL + SQLAlchemy 2.0
- 인증: JWT + OAuth2
## 코딩 규칙
- 모든 함수는 type hint 필수
- 에러는 커스텀 Exception 클래스 사용
- 테스트: pytest + coverage 80% 이상
- 커밋: conventional commits 형식
## 폴더 구조
backend/
app/
api/ # FastAPI 라우터
services/ # 비즈니스 로직
models/ # SQLAlchemy 모델
# Memory Bank 초기화
💬 "Memory Bank를 초기화하고 현재 프로젝트 구조를 기록해줘."
→ Cline이 프로젝트를 분석하고 .cline/memory/ 파일 생성
# 새 세션에서도 컨텍스트 유지
💬 "우리 프로젝트 규칙대로 사용자 프로필 API 추가해줘."
→ Memory Bank를 읽어 기존 스타일·규칙대로 코드 생성
- 프로젝트 시작 시 "Memory Bank 초기화해줘"로 기초 컨텍스트 설정
- 주요 아키텍처 결정이 있을 때마다 "Memory Bank 업데이트해줘"로 갱신
- .cline/memory/ 폴더를 Git에 커밋하면 팀원 전체가 동일한 컨텍스트 공유
- 신규 팀원 온보딩 시 Memory Bank가 프로젝트 문서 역할도 수행
Sub-Agents와 Boomerang Tasks
v3.58부터 Cline은 네이티브 Sub-Agents를 지원합니다. 오케스트레이터(Orchestrator) 에이전트가 복잡한 작업을 서브태스크로 분해하고, 각 서브에이전트가 독립적인 컨텍스트 윈도우에서 작업한 뒤 결과를 반환합니다. 이 패턴을 Boomerang Tasks라고 부릅니다.
💬 "대규모 리팩토링: 기존 REST API를 GraphQL로 전환해줘.
백엔드와 프론트엔드를 병렬로 작업해."
🤖 Orchestrator (Claude Opus 4.7):
# 태스크 분해
→ Sub-Agent 1: 백엔드 GraphQL 스키마 설계 및 resolvers 구현
→ Sub-Agent 2: 프론트엔드 Apollo Client 설정 및 쿼리 변환
→ Sub-Agent 3: 테스트 코드 업데이트 및 검증
# 각 Sub-Agent가 독립 컨텍스트에서 작업
→ Agent 1: backend/ 작업 완료 → Orchestrator에 결과 반환
→ Agent 2: frontend/ 작업 완료 → Orchestrator에 결과 반환
→ Agent 3: tests/ 업데이트 완료 → 검증 결과 반환
✅ 오케스트레이터가 결과 통합 및 최종 검토
| 역할 | 권장 모델 | 이유 |
|---|---|---|
| Orchestrator | Claude Opus 4.7 또는 GPT-5.5 | 복잡한 계획 수립, 결과 통합에 최고 성능 |
| Sub-Agent | Claude Sonnet 또는 GPT-5.5 | 실행 속도·비용 균형 |
| 간단 서브태스크 | Claude Haiku | 반복·단순 작업 비용 최소화 |
MCP Marketplace
Cline은 MCP(Model Context Protocol) Marketplace를 내장하여 100개 이상의 사전 빌드된 MCP 서버를 원클릭으로 설치할 수 있습니다. 데이터베이스 연동, API 통합, 브라우저 자동화 등 다양한 도구를 AI에게 제공합니다.
# Cline 사이드바 → MCP Marketplace → 검색 → Install
# 또는 opencode.json 수동 설정
# 인기 MCP 서버 예시
- @modelcontextprotocol/server-filesystem # 파일 시스템
- @modelcontextprotocol/server-postgres # PostgreSQL 직접 쿼리
- @modelcontextprotocol/server-github # GitHub 이슈/PR 조작
- @browserbase/mcp-server-browserbase # 클라우드 브라우저 자동화
- @modelcontextprotocol/server-slack # Slack 메시지
- @modelcontextprotocol/server-puppeteer # 로컬 브라우저 제어
# MCP 설치 후 Cline에서 자연어로 사용
💬 "PostgreSQL DB에서 users 테이블을 조회해서 비활성 사용자 목록 뽑아줘."
💬 "GitHub에서 'bug' 라벨이 붙은 이슈 목록 가져와서 우선순위 정리해줘."
실전 워크플로우
새 프로젝트 시작
💬 You: "Next.js 13 블로그 프로젝트 만들어줘.
요구사항:
- TypeScript
- App Router
- Tailwind CSS
- Prisma + PostgreSQL
- 마크다운 블로그 글
- 관리자 페이지
처음부터 끝까지 설정하고 실행까지 해줘."
🤖 Cline: "Next.js 블로그를 생성하겠습니다."
# Cline이 자동으로 수행:
1. 프로젝트 생성
→ npx create-next-app@latest blog --typescript --tailwind --app
2. Prisma 설정
→ npm install prisma @prisma/client
→ npx prisma init
→ prisma/schema.prisma 작성
3. 데이터베이스 연결
→ .env 파일 생성
→ DATABASE_URL 설정
4. 파일 생성 (20개 이상)
→ app/page.tsx (홈)
→ app/blog/[slug]/page.tsx (블로그 글)
→ app/admin/page.tsx (관리자)
→ components/ (여러 컴포넌트)
→ lib/prisma.ts
→ lib/markdown.ts
5. 데이터베이스 마이그레이션
→ npx prisma migrate dev
6. 샘플 데이터 생성
→ prisma/seed.ts
→ npm run seed
7. 실행 및 테스트
→ npm run dev
→ 브라우저 열기
→ 스크린샷
✅ 완료! 전체 블로그 시스템이 준비되었습니다.
기능 추가
💬 You: "블로그에 댓글 기능 추가해줘.
- 비회원도 작성 가능 (이름, 이메일 입력)
- 대댓글 지원
- 관리자 승인 시스템"
🤖 Cline:
1. 기존 코드 분석
→ Prisma 스키마 확인
→ 라우트 구조 파악
2. 데이터베이스 스키마 수정
→ prisma/schema.prisma (Comment 모델 추가)
→ npx prisma migrate dev
3. API 라우트 생성
→ app/api/comments/route.ts
→ app/api/comments/[id]/route.ts
4. 컴포넌트 생성
→ components/CommentForm.tsx
→ components/CommentList.tsx
→ components/CommentItem.tsx
5. 블로그 글 페이지 통합
→ app/blog/[slug]/page.tsx 수정
6. 관리자 페이지 추가
→ app/admin/comments/page.tsx
7. 테스트
→ npm run dev
→ 브라우저에서 댓글 작성 테스트
✅ 댓글 시스템 완료!
디버깅
💬 You: "앱 실행했는데 에러 나. 고쳐줘."
🤖 Cline:
Step 1: 앱 실행
→ npm run dev
Error Output:
Error: Cannot find module 'react-markdown'
at Module._resolveFilename
Step 2: 문제 진단
→ 패키지가 설치되지 않음
Step 3: 수정
→ npm install react-markdown
Step 4: 재실행
→ npm run dev
New Error:
TypeError: Cannot read property 'map' of undefined
at BlogList.tsx:15
Step 5: 파일 확인
→ BlogList.tsx 읽기
→ posts 배열 null 체크 누락
Step 6: 수정
→ Optional chaining 추가
Step 7: 재실행
→ npm run dev
✅ 앱이 정상 작동합니다!
리팩토링
💬 You: "코드 품질 개선해줘.
- TypeScript strict 모드
- ESLint 에러 수정
- 중복 코드 제거
- 성능 최적화"
🤖 Cline:
1. TypeScript 설정 강화
→ tsconfig.json (strict: true)
→ 모든 타입 에러 수정
2. ESLint 실행
→ npm run lint
→ 모든 경고 수정
3. 중복 코드 분석
→ 유사한 컴포넌트 발견
→ 공통 컴포넌트로 추출
4. 성능 최적화
→ React.memo 추가
→ useMemo, useCallback 적용
→ 이미지 최적화 (Next.js Image)
5. 테스트
→ npm run build
→ 빌드 성공 확인
✅ 코드 품질 개선 완료!
설정
API 제공자 설정
# Cline Settings → API Provider 설정
# 최고 성능: Claude Opus 4.7
API Provider: Anthropic
Model: claude-opus-4-7-20251016
API Key: sk-ant-api03-xxx
# OpenAI: GPT-5.5
API Provider: OpenAI
Model: gpt-5.5
API Key: sk-xxx
# 지원 제공자 전체 목록
- Anthropic (Claude Opus/Sonnet/Haiku)
- OpenAI (GPT-5.5, GPT-4o)
- Google (Gemini 3.1 Pro)
- AWS Bedrock, Azure OpenAI, GCP Vertex
- OpenRouter (다중 모델 라우팅)
- Groq, Cerebras (빠른 추론)
- Ollama (로컬 무료)
동작 설정
| 설정 | 설명 |
|---|---|
| Auto Approve Read | 파일 읽기 자동 승인 |
| Auto Approve Write | 파일 쓰기 자동 승인 (주의) |
| Auto Execute | 터미널 명령 자동 실행 (주의) |
| Max Iterations | 자율 작업 최대 반복 횟수 |
| Browser Enabled | 브라우저 제어 활성화 |
Auto Approve Write와 Auto Execute를 켜면 Cline이 파일을 자유롭게 수정하고 명령을 실행합니다. 개발 중에는 편리하지만, 중요한 프로젝트에서는 수동 승인 권장!
커스텀 지시사항
# Cline Settings → Custom Instructions
프로젝트 규칙:
- TypeScript strict 모드 사용
- 함수형 컴포넌트 (React Hooks)
- Tailwind CSS로 스타일링
- 모든 함수에 JSDoc 주석
- 에러 처리 필수
- 테스트 코드 작성
네이밍 규칙:
- 컴포넌트: PascalCase
- 함수: camelCase
- 상수: UPPER_SNAKE_CASE
파일 구조:
src/
components/
hooks/
utils/
types/
다른 도구와 비교
vs Continue
| 특징 | Cline | Continue |
|---|---|---|
| 자율성 | ✅ 높음 (에이전트) | ❌ 낮음 (수동) |
| 터미널 실행 | ✅ 완전 제어 | 제한적 |
| 브라우저 | ✅ | ❌ |
| 학습 곡선 | 중간 | 낮음 |
| 가격 | 종량제 (API) / Teams $20/월 | 무료 (Ollama) |
vs Codex
Codex는 앱/웹/CLI에서 작업 단위로 실행되는 코딩 에이전트이며, Cline은 VS Code 내부에서 실행되는 에이전트입니다. 워크플로우와 승인 흐름이 다르므로 팀 규칙에 맞게 선택하세요. 자세한 흐름은 Codex 가이드를 참고하세요.
| 특징 | Cline | Codex |
|---|---|---|
| 환경 | VS Code 확장 | 앱/웹/CLI |
| 실행 범위 | 로컬 파일/터미널 중심 | 작업 단위 샌드박스 + 로컬 CLI |
| 승인 흐름 | 파일/명령 승인 토글 | 작업 단위 승인 + 변경 제안 |
| 계정/키 | API 키 기반 | 계정 로그인 또는 API 키 |
| 강점 | IDE 내 자동 실행/자율 작업 | 분리된 작업 공간 + 다중 표면 |
vs Cursor vs Claude Code (2026-04)
| 특징 | Cline | Cursor | Claude Code |
|---|---|---|---|
| GitHub Stars | 61,000+ | IDE (비공개) | 71,000+ |
| 환경 | VS Code 확장 | 별도 IDE | 터미널/IDE 에이전트 |
| LLM 지원 | BYOK (모든 제공자) | 다중 (내장) | Claude 전용 |
| SWE-bench | ~59.8% (Sonnet 4.5 기준) | ~65% (추정) | ~80.8% |
| 자율성 | ✅ 높음 (에이전트) | 중간 | ✅ 높음 |
| Memory Bank | ✅ | 제한적 | CLAUDE.md 방식 |
| Sub-Agents | ✅ v3.58+ | ❌ | ❌ |
| MCP 지원 | ✅ Marketplace 100+ | 제한적 | ✅ |
| 브라우저 제어 | ✅ Computer Use | ❌ | ❌ |
| 가격 | $0 + API 비용 / Teams $20/user | $20/월~ | $20~200/월 또는 API |
| 오픈소스 | ✅ MIT | ❌ | ❌ |
Cline을 사용해야 하는 경우
- 복잡한 프로젝트를 빠르게 시작하고 싶음
- AI가 자율적으로 작업하길 원함
- 터미널 명령 자동 실행 필요
- 브라우저 테스트 자동화 필요
- VS Code 환경 유지하면서 강력한 AI 도구 사용
Cline을 사용하지 말아야 하는 경우
- 완전 무료 솔루션 필요 → Continue + Ollama
- 수동 제어 선호 → Cursor, Continue
- 간단한 코드 편집만 필요 → Continue
- 터미널 명령어만 필요 → GitHub Copilot CLI
팁과 트릭
효과적인 프롬프트
❌ 나쁜 예
💬 You: "앱 만들어줘."
너무 모호함. Cline이 여러 번 질문해야 함.
✅ 좋은 예
💬 You: "React + TypeScript 투두 앱 만들어줘.
기능:
- 할 일 추가/삭제/완료
- 로컬 스토리지 저장
- 필터 (전체/진행중/완료)
기술 스택:
- Create React App (TypeScript)
- Tailwind CSS
- React Hooks
처음부터 끝까지 설정하고 실행까지 해줘."
안전 사용 팁
- 중요 프로젝트는 Git 사용
git init git add . git commit -m "Before Cline changes" - 자동 승인 주의
- 개발 초기: Auto Approve ON (빠른 프로토타입)
- 중요 작업: Auto Approve OFF (안전)
- 대화 분할
# 복잡한 작업은 단계별로 1단계: "프로젝트 초기 설정만 해줘" 2단계: "이제 인증 기능 추가해줘" 3단계: "테스트 작성해줘"
가격 정책
Cline 플랫폼 자체는 무료(오픈소스)이며, 추론 비용은 선택한 API 제공자에게 직접 청구됩니다. Teams 플랜은 협업·관리 기능을 추가하며, 처음 10석은 영구 무료입니다.
| 플랜 | 가격 | 특징 | 적합 대상 |
|---|---|---|---|
| Individual (BYOK) | $0 (도구 무료) | 모든 기능, API 비용은 제공자 직과금 | 개인 개발자, 투명한 비용 추적 |
| Teams | $20/user/월 (첫 10석 무료) | 팀 관리, 공유 설정, 협업 기능 | 소규모~중규모 팀 |
| Enterprise | 별도 문의 | SSO, 감사 로그, 전용 지원, 모델 정책 | 대기업, 보안·컴플라이언스 요구 |
비용 최적화
- 명확한 요청: 모호한 요청은 재시도로 이어져 비용 증가
- Plan/Act 분리: Plan은 고성능 모델, Act는 균형 모델로 비용 절감
- Auto Approve: 승인 과정을 줄여 API 호출 감소
- 대화 초기화: 불필요한 컨텍스트 제거
운영 플레이북
Cline은 자율 실행 범위가 넓기 때문에 기능보다 운영 가드레일이 먼저입니다. 승인 정책, 모델 티어, 예산 한도를 사전에 정해두면 사고와 비용 급증을 크게 줄일 수 있습니다.
승인 정책 매트릭스
| 작업 종류 | 기본 정책 | 권장 운영 |
|---|---|---|
| 파일 생성/수정 | 조건부 자동 승인 | 핵심 디렉토리 외 자동 승인 허용 |
| 의존성 설치 | 수동 승인 | 잠금 파일 변경은 항상 리뷰 |
| 터미널 명령 실행 | 수동 승인 | 삭제/권한 변경 명령은 2인 검토 |
| 브라우저 제어 테스트 | 자동 승인 가능 | 실서비스 URL 대상은 제한 |
팀 운영 템플릿
# Cline 팀 운영 규칙 (예시)
- Auto Approve 기본값: OFF
- 허용 디렉토리: src/, tests/, docs/
- 제한 디렉토리: infra/, migrations/, .github/workflows/
- 패키지 설치/삭제: 리뷰어 승인 필수
- 모델 기본값: 중간 티어
- 고성능 모델: 릴리즈 직전/장애 대응 시에만 허용
- 세션 시작 전: git status 깨끗한지 확인
- 세션 종료 전: 변경 요약 + 테스트 결과 기록
비용 통제 전략
- 긴 작업은 1회 대형 요청보다 단계 분할 요청이 비용 안정적
- 실패 재시도 루프를 막기 위해 최대 재시도 횟수 기준 설정
- 간단 작업은 저비용 모델, 복잡 작업만 상위 모델 사용
- 주간 기준으로 \"요청 수 대비 성공률\" 추적
그림: Cline 자율 실행을 위한 승인 중심 운영 루프
트러블슈팅
일반적인 문제
❌ Cline이 응답하지 않음
해결:
- API 키 확인
- 네트워크 연결 확인
- VS Code 재시작
- Cline 확장 재설치
❌ 파일이 생성되지 않음
해결:
- 워크스페이스 폴더가 열려 있는지 확인
- 파일 쓰기 권한 확인
- 승인 요청을 놓치지 않았는지 확인
❌ 터미널 명령이 실행되지 않음
해결:
# Settings 확인
Terminal Integration: Enabled
# VS Code 터미널 활성화
View → Terminal
❌ 브라우저 제어 실패
해결:
# Puppeteer 설치
npm install -g puppeteer
# Settings에서 브라우저 활성화
Browser Enabled: true
핵심 정리
- Cline은 GitHub 61K+·VS Code 설치 5M+, v3.81.0 기준 VS Code 생태계 최강의 자율 AI 코딩 에이전트입니다.
- Memory Bank로 세션 간 프로젝트 컨텍스트를 유지하여 팀 전체가 일관된 코딩 규칙을 공유할 수 있습니다.
- Sub-Agents / Boomerang Tasks(v3.58+)로 복잡한 작업을 병렬 서브태스크로 분해하여 대규모 리팩토링에 활용하세요.
- MCP Marketplace에서 100+ 서버를 원클릭으로 설치하면 DB, GitHub, 브라우저 등을 AI가 직접 조작합니다.
- 최고 성능은 Claude Opus 4.7(Plan 모드) + Claude Sonnet(Act 모드) 조합이며, SWE-bench 59.8%(Sonnet 4.5 기준, 모델 의존적)입니다.
- 플랫폼 자체는 MIT 오픈소스·무료이며, 추론 비용은 선택한 API 제공자에게 투명하게 청구됩니다. Teams 플랜 첫 10석은 무료.
- 강력한 자율 실행 범위 때문에 승인 정책, 허용 디렉토리, 최대 재시도 횟수를 팀 규칙으로 사전에 정해두는 것이 안전합니다.
- YOLO 모드는 빠른 프로토타이핑에, 수동 승인 모드는 중요 코드베이스에 사용하여 자율성과 안전성의 균형을 맞추세요.