07. 왜 CLI인가¶

VS Code 익스텐션이 아닌 터미널 CLI를 선택해야 하는 이유입니다.

익스텐션의 한계¶

VS Code의 Claude 익스텐션(Copilot, Continue 등)은 편리하긴 한데, 에디터 안에 갇혀 있어요.

VS Code 익스텐션:
  [에디터] ← 여기서만 동작
     ↓
  파일 편집, 자동완성, 인라인 제안

Claude Code CLI:
  [터미널] → 시스템 전체에 접근
     ↓
  파일 편집 + git + npm + docker + 브라우저 + DB + ...

CLI가 좋은 5가지 이유¶

1. 시스템 전체 접근¶

CLI는 터미널에서 동작하므로 OS가 할 수 있는 모든 것을 할 수 있습니다.

# 익스텐션으로는 불가능한 것들
git log --oneline -10          # git 히스토리 조회
docker ps                       # 컨테이너 상태 확인
curl https://api.example.com    # API 테스트
psql -c "SELECT * FROM users"   # DB 직접 조회

2. 멀티 인스턴스 병렬 작업¶

터미널을 여러 개 열면 독립적인 Claude 세션이 동시에 작동합니다.

터미널 1: claude  → "프론트엔드 컴포넌트 만들어줘"
터미널 2: claude  → "백엔드 API 만들어줘"
터미널 3: claude  → "테스트 코드 작성해줘"

각 세션이 독립적이므로 서로 간섭 없이 병렬 작업이 가능합니다. tmux나 iTerm2 분할 창을 쓰면 더 편합니다.

3. 파이프라인과 조합¶

Unix 철학처럼 다른 도구와 자유롭게 조합할 수 있습니다.

# git diff를 Claude에게 리뷰 요청
git diff | claude "이 변경사항 리뷰해줘"

# 에러 로그 분석
cat error.log | claude "이 에러 패턴 분석해줘"

# 비대화형 모드로 자동화
claude -p "package.json 읽고 보안 취약점 확인해줘" --output-format json

4. 프로젝트 컨텍스트 자동 인식¶

CLI를 프로젝트 루트에서 실행하면 자동으로 프로젝트를 이해합니다.

CLAUDE.md 읽기
package.json, tsconfig.json 등 설정 파일 인식
.claude/ 폴더의 에이전트, 스킬, 훅 자동 로드
git 히스토리 접근

5. 확장성¶

oh-my-claudecode 같은 플러그인으로 얼마든지 확장할 수 있어요.

익스텐션	CLI
에디터가 제공하는 API 내에서만 확장	시스템 전체를 활용한 확장
다른 에디터로 이동 시 처음부터	어떤 환경에서든 동일하게 동작
에디터 업데이트에 종속	독립적으로 업데이트

이미지 활용하기¶

Claude Code는 멀티모달을 지원합니다. 이미지를 직접 전달해서 분석이나 구현, 디버깅에 쓸 수 있어요.

방법 1: 클립보드 붙여넣기 (Ctrl+V / Cmd+V)¶

스크린샷을 찍은 후 터미널에서 바로 붙여넣으면 됩니다.

1. 스크린샷 캡처 (Cmd+Shift+4 등)
2. Claude Code 터미널에서 Ctrl+V (또는 Cmd+V)
3. 이미지가 자동으로 첨부됨
4. "이 에러 화면 분석해줘" 입력

방법 2: 드래그 앤 드롭¶

파일 탐색기에서 이미지를 터미널로 직접 드래그:

1. Finder/탐색기에서 이미지 파일 선택
2. Claude Code 터미널 창으로 드래그 앤 드롭
3. 파일 경로가 자동으로 입력됨

활용 예시¶

[에러 스크린샷 붙여넣기]
> 이 에러 화면 보고 원인 분석해줘

[Figma 디자인 캡처 붙여넣기]
> 이 디자인대로 React 컴포넌트 만들어줘

[아키텍처 다이어그램 붙여넣기]
> 이 구조에서 병목이 될 수 있는 부분 찾아줘

실전 팁: 터미널 세팅¶

tmux로 분할 작업¶

# 3개 패널로 분할
tmux new-session -s work
# Ctrl+B, % → 세로 분할
# Ctrl+B, " → 가로 분할

# 각 패널에서 claude 실행
# 패널 1: 구현
# 패널 2: 테스트
# 패널 3: 리뷰

iTerm2 (macOS)¶

Cmd+D: 세로 분할
Cmd+Shift+D: 가로 분할
각 패널에서 독립적으로 claude 실행

비교 요약¶

항목	VS Code 익스텐션	Claude Code CLI
접근 범위	에디터 내부	시스템 전체
병렬 작업	단일 세션	멀티 인스턴스
도구 연동	에디터 API 한정	모든 CLI 도구
자동화	제한적	파이프라인, 스크립트
이미지 입력	일부 지원	Ctrl+V, 드래그앤드롭
플러그인	에디터 종속	독립적 확장
환경 이동	에디터별 재설정	어디서든 동일

다음 단계¶

CLI의 장점을 이해했다면 08. oh-my-claudecode 활용 가이드에서 CLI를 끝까지 써먹는 법을 알아보세요.