Cline 가이드

VS Code에서 사용하는 자율 AI 코딩 에이전트 Cline 완전 가이드. GitHub 61K+·설치 5M+, v3.81 기준 Memory Bank·Sub-Agents·MCP Marketplace·YOLO 모드 포함.

빠른 시작 (2026-04 기준)
# 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 생태계 최강의 자율 에이전트로 자리잡았습니다.

2026-04 기준 주요 지표
  • 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을 이렇게 이해하면 됩니다
  • 자율 실행형 도구: 답변을 주는 것보다 실제로 파일과 명령을 만지는 쪽에 무게가 있습니다.
  • 승인 중심 운영: 강력한 만큼 중요한 변경은 승인 단계를 두고 쓰는 편이 안전합니다.
  • 복잡한 작업용: 설치, 수정, 실행, 디버깅이 한 번에 묶인 작업에서 특히 유용합니다.
1. 목표 전달 "버그 수정하고 테스트까지" 2. 계획 수립 파일 / 명령 / 순서 정리 3. 승인 확인 중요 수정 / 설치 / 명령 실행 전 확인 4. 실행과 검증 파일 편집 / 터미널 / 브라우저 결과 확인 후 반복 문제가 남으면 목표를 더 잘게 나눠 다시 진행

그림: Cline 자율 실행 흐름을 단순화한 기본 버전

자율 에이전트란?

일반적인 AI 코딩 도구는 사용자가 요청할 때마다 응답합니다. 하지만 자율 에이전트는:

  • 계획 수립: 복잡한 작업을 단계별로 분해
  • 자율 실행: 각 단계를 스스로 실행
  • 에러 처리: 실패 시 자동으로 수정 시도
  • 승인 요청: 중요한 작업은 사용자 확인 요청
Cline 에이전트 자율 AI 코딩 에이전트 ① 사용자 요청 자연어 입력 ② 작업 계획 수립 Task Planning ③ 파일 시스템 조작 File Operations ④ 터미널 실행 Terminal Commands ⑤ 브라우저 제어 선택적 (Browser) ⑥ 결과 검증 Verification ⑦ 승인 요청 위험 작업 시 확인 ⑧ 완료 / 재시도 Complete or Retry 재시도 승인 필요 선택적 경로
Cline 자율 에이전트 워크플로우: 사용자 요청부터 완료까지의 순환 흐름

핵심 기능 (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 ✅ 높음
AI 코딩 도구 자율성 수준 비교 낮음 높음 자율성 수준 → GitHub Copilot 자동완성 20% Continue.dev 채팅 + 편집 35% Cursor 멀티파일 편집 50% Aider Git 자동 커밋 65% Cline ★ 자율 에이전트 85% Codex 비동기 에이전트 90%
AI 코딩 도구별 자율성 수준 비교 — Cline은 자율 에이전트로서 높은 자율성을 제공

설치

클라이언트 설치

방법 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를 사용하면 프로젝트의 아키텍처 결정, 코딩 규칙, 설계 패턴을 마크다운 파일로 저장하여 세션이 새로 시작되어도 컨텍스트가 유지됩니다.

Markdown (.cline/memory/project.md)
# 프로젝트 아키텍처

## 기술 스택
- 백엔드: 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 모델
Cline 대화
# Memory Bank 초기화
💬 "Memory Bank를 초기화하고 현재 프로젝트 구조를 기록해줘."
→ Cline이 프로젝트를 분석하고 .cline/memory/ 파일 생성

# 새 세션에서도 컨텍스트 유지
💬 "우리 프로젝트 규칙대로 사용자 프로필 API 추가해줘."
→ Memory Bank를 읽어 기존 스타일·규칙대로 코드 생성
Memory Bank 활용 팁
  • 프로젝트 시작 시 "Memory Bank 초기화해줘"로 기초 컨텍스트 설정
  • 주요 아키텍처 결정이 있을 때마다 "Memory Bank 업데이트해줘"로 갱신
  • .cline/memory/ 폴더를 Git에 커밋하면 팀원 전체가 동일한 컨텍스트 공유
  • 신규 팀원 온보딩 시 Memory Bank가 프로젝트 문서 역할도 수행

Sub-Agents와 Boomerang Tasks

v3.58부터 Cline은 네이티브 Sub-Agents를 지원합니다. 오케스트레이터(Orchestrator) 에이전트가 복잡한 작업을 서브태스크로 분해하고, 각 서브에이전트가 독립적인 컨텍스트 윈도우에서 작업한 뒤 결과를 반환합니다. 이 패턴을 Boomerang Tasks라고 부릅니다.

Cline Sub-Agents 사용 예시
💬 "대규모 리팩토링: 기존 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/ 업데이트 완료 → 검증 결과 반환

✅ 오케스트레이터가 결과 통합 및 최종 검토
Sub-Agents 권장 모델 조합
역할 권장 모델 이유
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에게 제공합니다.

MCP 서버 설치 및 사용
# 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

처음부터 끝까지 설정하고 실행까지 해줘."

안전 사용 팁

  1. 중요 프로젝트는 Git 사용
    git init
    git add .
    git commit -m "Before Cline changes"
  2. 자동 승인 주의
    • 개발 초기: Auto Approve ON (빠른 프로토타입)
    • 중요 작업: Auto Approve OFF (안전)
  3. 대화 분할
    # 복잡한 작업은 단계별로
    1단계: "프로젝트 초기 설정만 해줘"
    2단계: "이제 인증 기능 추가해줘"
    3단계: "테스트 작성해줘"

가격 정책

가격 정책 요약 (2026-04)

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 안전 운영 루프 계획 → 승인 → 실행 → 결과 확인 실패 시 재계획, 반복 횟수 제한으로 비용 통제 모든 세션은 Git diff 검토 후 종료

그림: 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 모드는 빠른 프로토타이핑에, 수동 승인 모드는 중요 코드베이스에 사용하여 자율성과 안전성의 균형을 맞추세요.