Skip to content

1.2-what-is-claude-code.md

Latest commit

 

History

History
270 lines (177 loc) · 10.6 KB

1.2-what-is-claude-code.md

File metadata and controls

270 lines (177 loc) · 10.6 KB
Raw
chapter 1.2
title Claude Code: 왜 CLI인가
claude_model claude-opus-4-8
last_updated 2026-05-19

Claude Code: 왜 CLI인가

Claude Code는 무엇인가

Claude Code는 터미널 기반 AI 코딩 에이전트다.

명령어 라인에서 Claude AI와 대화하면서, 프로젝트의 파일들을 직접 읽고, 분석하고, 수정할 수 있다. 웹 인터페이스를 거치지 않는다. 터미널에서 모든 게 일어난다.

PM은 코딩을 하지 않는다. 그럼 왜 PM이 Claude Code를 써야 할까?

파일 기반의 업무 때문이다.

데이터 분석, 문서 작성, 시나리오 시뮬레이션, 메트릭 해석 - 이 모든 것이 파일로 남는다. CSV, 마크다운, JSON, 스프레드시트 export...

Claude Code는 이 모든 파일을 한 번에 이해할 수 있는 유일한 방식이다.

본 가이드의 기준 모델 사양 (2026-05)

항목 값
모델 ID claude-opus-4-8
컨텍스트 윈도우 1M 토큰 (standard pricing, long-context premium 없음)
최대 출력 토큰 128k
Files API 지원 (beta — files-api-2025-04-14 헤더, create-once · use-many)
Prompt Caching 지원 (안정 영역 캐싱으로 비용 절감)
Adaptive Thinking 지원 (effort 파라미터 기본값 high)
이미지 입력 해상도 긴 변 최대 2576px (좌표는 리사이즈/패딩 후 기준)
File-system memory CLAUDE.md + auto memory로 세션 간 학습 유지

이 사양은 본 가이드 전반에서 가정하는 기준입니다. 챕터 2.2 (모드/effort) · 3.2.2 (4.7 시대 CLAUDE.md) 에서 각 사양을 어떻게 활용하는지 다룹니다.

위 수치는 platform.claude.com 모델 개요를 기준으로 합니다. 가격·사양은 변동될 수 있으니 실제 결정 전에는 공식 문서를 한 번 더 확인하세요.

두 가지 입구: 터미널이 무섭다면

"터미널 기반"이라는 말에 멈칫했다면, 그게 정상입니다. 다행히 Claude Code에 들어가는 문은 하나가 아닙니다. 공식적으로 **여러 환경(surface)**에서 같은 엔진을 쓸 수 있고, CLAUDE.md·설정·연결한 도구가 그 환경들 사이에서 공유됩니다.

입구 (a) — 터미널 CLI

검은 화면에 명령어를 입력하는 방식입니다. 가장 기능이 풍부하고, 이 가이드의 예시 대부분이 이 화면을 기준으로 합니다. 익숙해지면 가장 빠르지만, 처음엔 부담스러울 수 있습니다.

입구 (b) — 데스크톱 앱 / IDE 안에서 (검은 화면 없이)

터미널을 한 번도 안 열어도 됩니다. 비개발자라면 이쪽부터 시작하는 편이 마음이 편합니다.

  • 데스크톱 앱: 별도 프로그램을 설치해 클릭으로 실행합니다. 변경 사항(diff)을 눈으로 비교하고, 여러 작업을 나란히 돌릴 수 있습니다.
  • VS Code · Cursor 확장: 코드 편집기 안에서 Claude Code 패널을 띄워 씁니다. 변경 내용이 편집기 화면에 그대로 표시됩니다.
  • JetBrains 플러그인: IntelliJ · PyCharm · WebStorm 등에서 동일하게 동작합니다.

🖼️ 스크린샷 자리: 데스크톱 앱의 Code 탭 첫 화면 (폴더 선택 + 입력창)

어느 입구로 들어가든 같은 Claude Code입니다. 터미널이 부담되면 (b)로 시작했다가, 익숙해지면 (a)로 옮겨가면 됩니다. 환경을 바꿔도 작업과 설정은 따라옵니다.

무터미널 미니 워크스루

검은 화면 없이 첫 결과물을 만들어보는 흐름입니다 (데스크톱 앱 / IDE 확장 기준, 일반 예시):

  1. 앱(또는 편집기의 Claude Code 패널)을 실행합니다.
  2. 작업할 폴더를 선택합니다. Claude는 이 폴더 안의 파일만 봅니다.
  3. 한 줄로 요청합니다. 예: 이 폴더의 회의록을 읽고 할 일 목록을 만들어줘
  4. Claude가 행동하기 전에 권한을 물어봅니다 (Ask). 파일을 만들거나 고치기 직전에 "이렇게 하려는데 괜찮나요?"를 보여주고, 당신이 **Allow(허용)**를 눌러야 진행합니다.
  5. 허용하면 파일이 실제로 생기는 것을 화면에서 확인합니다.

안전장치가 핵심입니다.

  • 행동 전 승인: Claude는 파일 수정·명령 실행 같은 행동을 하기 전에 먼저 물어봅니다. 모르고 지나가는 일이 없습니다.
  • Esc로 중단: 진행 중인 작업이 마음에 안 들면 언제든 멈출 수 있습니다.

"AI가 내 파일을 마음대로 건드리면 어쩌지?"라는 걱정은, 이 승인 단계가 막아줍니다. 처음에는 모든 요청을 하나씩 확인하면서 감을 잡는 걸 권합니다.

일반 챗봇과 무엇이 다른가

기능 일반 챗봇 (ChatGPT 등) Claude Code
파일 읽기·쓰기 불가 가능
터미널 명령 실행 불가 가능
프로젝트 컨텍스트 유지 대화 내 임시 CLAUDE.md로 세션 간 보존
팀 설정 공유 불가 레포에 커밋 가능

ChatGPT / Copilot과의 핵심 차이점

1. 파일 시스템 직접 접근 (@참조로 전체 컨텍스트)

ChatGPT에서는 파일을 복사-붙여넣기 해야 한다. 크기 제한이 있고, 번거롭다.

Claude Code에서는:

$ claude
> @./data/user-interviews.md 이 인터뷰들에서 공통 테마를 추출해줘

@ 기호로 파일을 참조하면, Claude가 그 파일을 자동으로 읽는다. 여러 파일도 된다:

> @./reports/q4-metrics.csv @./strategy/goals.md
  우리 Q4 성과를 목표 대비 분석해줘

프로젝트 전체 컨텍스트가 한 번에 가능하다.

2. 에이전트 실행 (병렬 작업, 커스텀 역할)

ChatGPT는 대화형이다. 당신이 한 번 물어보면, 하나의 답변을 얻는다.

Claude Code는 에이전트처럼 행동할 수 있다. 자율적으로:

  • 여러 파일을 순차적으로 분석
  • 계산 결과를 임시 파일에 저장
  • 그 결과를 바탕으로 다음 단계 실행
  • 최종 결과를 정리된 문서로 생성
> 회의록 폴더의 모든 파일을 읽고, 각각의 액션 아이템을 추출한 후,
  담당자별로 정렬된 JSON 파일을 만들어줘

Claude가 자동으로:
  1. 폴더의 모든 .md 파일 목록 생성
  2. 각 파일 읽음
  3. 액션 아이템 추출
  4. 담당자별 분류
  5. action-items.json 생성

이건 ChatGPT에서는 불가능하다. 너가 매번 파일을 주고 정렬해야 한다.

3. 프로젝트 메모리 (CLAUDE.md로 세션 간 일관성)

지난 주에 만든 분석을 오늘 다시 할 때, 처음부터 설명할 필요가 없다.

Claude Code는 프로젝트에 CLAUDE.md 파일을 만들 수 있다. 이 파일에 저장되는 것들:

  • 프로젝트의 전략과 가정
  • 이전 분석의 주요 결론
  • 진행 중인 의사결정 항목
  • 팀의 역할과 책임

다음에 같은 프로젝트를 열면:

$ cd my-product
$ claude
> @CLAUDE.md 지난번 논의를 상기시켜줘

Claude: 지난주 당신은 다음을 결정했습니다:
  - Target user: 스타트업 창업자 (20-40세)
  - Primary metric: DAU 증가율
  - Risk: 경쟁사 X의 가격 경쟁
  ...

세션이 끝나도 컨텍스트가 유지된다.

4. 코드 실행 & 배포 (바이브 코딩 → 실제 프로덕트)

ChatGPT에서 "파이썬으로 이 분석을 해줘"라고 하면, 코드를 보여준다. 넌 그걸 복사해서 돌려야 한다.

Claude Code는 코드를 자동으로 실행할 수 있다. 로컬 터미널에서.

$ claude
> @./raw-data.csv 이 데이터를 정규화하고,
  시각화 스크립트를 만든 후 실행해줘

Claude가:
  1. data_analysis.py 작성
  2. 자동 실행
  3. 결과 이미지 생성
  4. visualization.html 작성 후 브라우저 열기

생각에서 결과까지의 시간이 극도로 단축된다.

PM에게 CLI가 왜 중요한가

파일 기반 작업의 이점 3가지:

  1. 버전 관리 가능: 모든 분석, 문서, 메모가 git으로 추적된다. "어제 뭐라고 했지?"의 답이 명확하다.

  2. 재현 가능: 같은 입력으로 같은 결과가 나온다. 엑셀처럼 '어라, 이게 왜 바뀌었지?'가 없다.

  3. 팀과 공유 가능: 마크다운, CSV, JSON - 모두 텍스트다. 슬랙, 깃허브, 노션에 그대로 넣을 수 있다.

실제 터미널 화면

Claude Code를 처음 열면 이렇게 보인다:

$ claude

╭─────────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code!                              │
│   Type /help for available commands                     │
│   /exit to quit                                          │
╰─────────────────────────────────────────────────────────╯

Welcome back! Last session: 2026-02-20 18:43
Project: my-product-2026

>

여기서 대화를 시작한다. 예를 들어:

> @meeting-notes.md 이 회의록에서 액션 아이템을 추출하고
  담당자별로 정리해줘

Claude: 회의록을 분석했습니다. 총 12개의 액션 아이템을 발견했습니다.

[액션 아이템 분석 진행 중...]

✓ action-items.json 파일 생성됨
✓ action-items-by-owner.md 파일 생성됨

결과:
- 박준호 (제품): 경쟁사 분석 리포트 (마감일: 2026-02-28)
- 이지은 (엔지니어링): API 스펙 검토 (마감일: 2026-02-24)
- 김지현 (마케팅): 타겟 고객층 인터뷰 계획 (마감일: 2026-02-25)
...

생성된 파일을 확인하려면: cat action-items.json

>

이 과정에서 일어난 것:

  1. Claude가 meeting-notes.md를 읽음
  2. 액션 아이템 식별
  3. 담당자 이름으로 분류
  4. 새로운 파일 2개 생성
  5. 결과 요약해서 터미널에 출력

모든 게 클릭이 아닌 명령과 결과로 이루어진다.

다음 단계

이제 알았다. Claude Code가 뭔지.

다음은 설치하고, 첫 대화를 나누는 법이다.

그 다음으로, 어떤 도구가 어디에 쓰이는지 한눈에 보고 싶다면 도구 지도를 참고하세요.

© 2026 김생근 (Sanguine Kim) | AI Agent Lead & AI Tutor 본 자료는 CC BY-NC 4.0 라이선스를 따릅니다. 교육·학술 목적 자유 이용 가능 | 상업적 이용 시 별도 라이선스 필요 강의·기업 교육·상업적 활용 문의: kimsanguine@gmail.com