촌놈 개발자 이야기

오픈소스 코딩 에이전트 Cline의 CLI(cline)를 실무에서 쓸 때 필요한 설치 방법, 인증 유형, 전체 명령어·플래그·슬래시 명령·환경변수·설정 파일을 한 번에 정리했습니다. Cline CLI는 VS Code 확장과 동일한 코어(Controller, StateManager, Task 실행 엔진)를 공유하기 때문에 Plan/Act 모드, MCP 서버, 규칙(rules), 스킬(skills), 프로바이더 설정이 모든 표면에서 동일하게 동작합니다.

1. 설치

# npm으로 설치 (권장, 전역)
npm install -g cline
# 기타 패키지 매니저
pnpm add -g cline
yarn global add cline
bun add -g cline

# 버전 확인
cline --version
cline -V
cline version

# 최신 버전으로 업데이트
cline update
npm update -g cline
# 나이틀리(사전 릴리즈) 빌드 설치
npm i -g cline@nightly

2. 인증 유형

Cline은 특정 벤더에 종속되지 않고 여러 인증 방식을 지원합니다. 크게 (1) Cline 계정으로 OAuth 로그인, (2) 구독형 로그인(ChatGPT 구독 등), (3) 프로바이더 API 키 직접 등록 세 가지로 나뉩니다.

# 대화형 인증 설정 (가장 쉬운 방법)
cline auth
# → Sign in with Cline / Sign in with ChatGPT Subscription /
#    Sign in with OCA / Use your own API key 중 선택하는 TUI가 열림

# Cline 계정으로 OAuth 로그인 (브라우저 인증)
cline auth cline

# 프로바이더 API 키를 직접 지정해서 비대화형으로 인증
cline auth --provider anthropic --apikey sk-ant-... --modelid claude-sonnet-4-6
cline auth --provider openai --apikey sk-...

# 이번 실행 한정으로 키를 임시 오버라이드 (저장되지 않음)
cline -k sk-ant-... "간단한 작업 실행"

# 환경변수로 키를 지정하는 방법
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...
cline

3. 기본 실행 방법

# 인자 없이 실행 → 대화형 TUI 세션 시작
cline

# 프롬프트를 바로 전달 (act 모드 + auto-approve 기본 활성화)
cline "signup 폼에 입력값 검증 추가해줘"

# Plan 모드로 시작 (실행 전 계획부터 확인)
cline -p "인증 모듈 리팩터링 계획을 세워줘"
cline --plan "마이그레이션 계획 설계"

# stdin으로 파이프해서 전달
echo "테스트 실패 원인을 찾아 고쳐줘" | cline
git diff origin/main | cline "이 변경사항을 리뷰해줘"
cat README.md | cline "설치 단계만 요약해줘"

# JSON 스트림으로 출력 (스크립트/CI 파이프라인용)
cline --json "TODO 주석을 전부 나열해줘" | jq -r 'select(.type=="say") | .text'

# 특정 세션 재개
cline --id abc123 "이어서 에러 핸들링도 추가해줘"

# 백그라운드 허브에서 작업만 던져놓고 빠져나오기 (zen 모드)
cline -z "인증 모듈 리팩터링하고 유닛 테스트도 추가해줘"
cline --zen "..."

4. 전체 최상위(top-level) 명령어

5. 전역 옵션(플래그) 전체 정리

6. 세부 명령어별 옵션

plugin — 플러그인 관리

cline plugin install <source>   # 플러그인 설치
cline plugin i <source>         # 축약형

# npm 패키지에서 설치
cline plugin install @org/postgres
# git 저장소에서 설치
cline plugin install https://github.com/cline/typescript-lsp-plugin.git
# 로컬 경로에서 설치
cline plugin install ./my-plugin

connect — 메시징 플랫폼 연동

# Telegram 연결
cline connect telegram -k $BOT_TOKEN
# Slack 연결 (웹훅 방식)
cline connect slack --bot-token $SLACK_TOKEN --signing-secret $SECRET --base-url $URL
# Slack 연결 (소켓 모드)
cline connect slack --bot-token $SLACK_TOKEN --app-token $SLACK_APP_TOKEN

Slack, Discord, Telegram, Google Chat, WhatsApp, Linear 등을 지원하며, 각 대화 스레드가 하나의 독립된 에이전트 세션에 매핑됩니다.

schedule — 예약 작업

# 매일 평일 오전 9시에 PR 요약 실행
cline schedule create "PR summary" \
  --cron "0 9 * * MON-FRI" \
  --prompt "열려 있는 PR과 리뷰 상태를 모두 나열해줘" \
  --workspace /path/to/repo

예약된 에이전트는 터미널 세션과 무관하게 재시작 후에도 유지되며, --delivery-adapter, --delivery-bot, --delivery-thread 옵션으로 결과를 특정 채팅 채널로 전달할 수 있습니다.

멀티 에이전트 / 워크트리 관련 플래그

# 여러 전문 에이전트를 조율하는 팀 세션 시작
cline --team-name release-prep "..."
# 작업별로 격리된 git worktree를 만들어 그 안에서 실행
cline --worktree "flat config로 마이그레이션"

7. 슬래시 명령어 (대화형 TUI 전용)

키보드 단축키

8. 명령 실행 권한 제어

# 에이전트가 실행할 수 있는 셸 명령을 제한
export CLINE_COMMAND_PERMISSIONS='{"allow": ["npm *", "git *"], "deny": ["rm -rf *", "sudo *"]}'

9. 환경 변수

10. 설정 파일 & 디렉토리 구조

~/.cline/
  data/
    settings/
      providers.json     # API 키 및 프로바이더 설정
      rules/              # 전역 규칙
      skills/             # 전역 스킬
    teams/                 # 팀 상태
    sessions/              # 세션 DB (SQLite)
    logs/
      hub-daemon.log       # 허브 로그
  plugins/                 # 전역 플러그인
    _installed/            # `cline plugin install`로 관리됨

.cline/                    # 프로젝트 루트
  rules/                   # 프로젝트 규칙
  skills/                  # 프로젝트 스킬
  hooks/                   # 라이프사이클 훅
  plugins/                 # 프로젝트 플러그인
  mcp.json                 # MCP 서버 설정
  agents.yaml              # 에이전트 정의

11. JSON 출력 형식 (헤드리스/CI 연동용)

# --json 사용 시 각 메시지가 한 줄짜리 JSON 객체로 출력됨
cline --json "TODO 주석을 전부 나열해줘"
# {"type": "say", "text": "파일을 생성하겠습니다.", "ts": 1760501486669, "say": "text"}

# jq로 텍스트만 추출
cline --json "체인지로그를 요약해줘" | jq -r '.text'

12. CI/CD·자동화 연동 예시

# GitHub Actions 등에서 완전 자동으로 실행
cline --auto-approve true "린트 에러를 고치고 테스트를 통과시켜줘"

# 타임아웃을 걸어 무한 대기 방지
cline --timeout 600 "전체 테스트 스위트를 실행해줘"

# 커밋 diff를 파이프해서 자동 코드리뷰
git diff origin/main | cline --auto-approve true "이 변경사항의 이슈를 리뷰해줘"

# 훅 페이로드 처리 (라이프사이클 훅에서 호출)
cat payload.json | cline hook

13. 유용한 조합 정리

마무리

Cline CLI는 VS Code 확장과 완전히 동일한 에이전트 코어를 공유한다는 점이 가장 큰 특징으로, 프로바이더·규칙·MCP 설정을 한 번만 해두면 터미널·에디터(ACP)·Slack 같은 메신저까지 그대로 이어집니다. 처음에는 cline auth로 원하는 인증 방식을 연결하고, 기본값인 Act 모드로 바로 시작하거나 -p로 Plan 모드를 거친 뒤, 자동화가 필요해지면 --auto-approve·--zen·schedule·CLINE_COMMAND_PERMISSIONS를 프로젝트 성격에 맞게 조합해가는 흐름을 추천합니다.