01. Claude Code란 무엇인가
- Claude Code가 "무엇을 하는 도구"인지 한 문장으로 설명할 수 있다
- 채팅형 AI, 코드 자동완성과 에이전틱 코딩이 어떻게 다른지 이해한다
- Claude Code가 동작하는 기본 원리(에이전트 루프)를 머릿속에 그릴 수 있다
- 어떤 작업에 잘 맞고, 어떤 점을 조심해야 하는지 감을 잡는다
한 문장으로 말하면
Claude Code는 터미널·IDE·앱 안에서 동작하면서, 당신의 실제 코드베이스를 직접 읽고·수정하고·명령을 실행하는 AI 코딩 에이전트입니다. 브라우저 채팅창에 코드를 복사해 붙여넣는 방식이 아니라, 당신의 개발 환경 안에서 파일 구조를 보고 실제 파일을 고칩니다.
비유: 세 종류의 조력자
새 기능을 추가해야 하는 상황을 떠올려 봅시다. 도움을 줄 수 있는 조력자는 크게 세 부류입니다.
| 조력자 유형 | 비유 | 대표 도구 |
|---|---|---|
| 채팅형 AI | 전화로 조언해주는 선배. 코드를 불러주면 듣고 답해주지만, 내 화면은 못 본다 | 브라우저 챗봇 |
| 인라인 자동완성 | 어깨너머로 다음 단어를 속삭여주는 동료. 지금 보는 한 파일은 잘 돕지만 전체 그림은 모른다 | 에디터 자동완성 |
| 에이전틱 코딩 에이전트 | 내 작업 폴더를 직접 받아, 여러 파일을 오가며 스스로 작업하고 결과를 보고하는 주니어 개발자 | Claude Code |
세 번째가 Claude Code입니다. 단순히 "코드를 제안"하는 게 아니라, 파일을 읽고, 여러 파일에 걸친 수정을 하고, 테스트나 빌드 명령을 직접 실행하고, 그 결과를 보고 다음 행동을 정합니다.
에이전틱(agentic)이란?
"에이전틱"은 AI가 목표를 받아, 스스로 도구를 골라 가며, 여러 단계를 거쳐 일을 완수하려 시도하는 방식을 말합니다. 핵심은 "한 번 답하고 끝"이 아니라 루프(loop) 를 돈다는 점입니다.
flowchart LR
A[사용자 목표<br/>'auth.test.ts의 실패 테스트 고쳐줘']:::user --> B{에이전트 루프}:::agent
B --> C[도구 선택<br/>파일 읽기]:::tool
C --> D[테스트 실행]:::tool
D --> E{결과 확인}:::agent
E -->|아직 실패| B
E -->|통과| F[완료 보고]:::result
classDef user fill:#FFE082,stroke:#F9A825,color:#000
classDef agent fill:#80DEEA,stroke:#00ACC1,color:#000
classDef tool fill:#90CAF9,stroke:#1E88E5,color:#000
classDef result fill:#A5D6A7,stroke:#43A047,color:#000
이 "모델 호출 → 도구 실행 → 결과 확인 → 반복"의 단순한 루프가 Claude Code의 심장입니다. 겉보기에 복잡한 기능들(메모리·권한·스킬·서브에이전트 등)은 모두 이 루프 주변에서 "모델이 무엇을 보고, 무엇을 할 수 있는지"를 조절하는 장치입니다.
무엇이 다른가: 실제 환경 안에서 동작한다
Claude Code가 채팅형 도구와 결정적으로 다른 점은 당신의 실제 작업 디렉터리(working directory)를 컨텍스트로 삼는다는 것입니다. 프로젝트 폴더에서 실행하면 파일 구조를 스캔하고, README나 설정 파일을 읽어 기술 스택을 파악한 뒤 작업을 시작합니다.
그래서 Claude Code는 git, docker, make 같은 기존 커맨드라인 도구들과 자연스럽게 어울립니다. 별도 에디터 플러그인 없이도 터미널 워크플로우에 그대로 끼어들 수 있습니다.
📌 핵심: 채팅형 AI는 "내가 보여준 것"만 알지만, Claude Code는 "내 프로젝트 전체"를 직접 열어볼 수 있습니다. 이 차이가 멀티파일 작업에서 큰 격차를 만듭니다.
어디서 돌아가나 (제공 채널)
Claude Code는 한 곳에만 있지 않습니다. 같은 핵심 엔진이 여러 표면(surface)으로 제공됩니다.
| 채널 | 설명 |
|---|---|
| CLI | 터미널에서 claude 실행. 모든 기능의 기준이 되는 표면 |
| VS Code 확장 / JetBrains 플러그인 | 에디터 안에서 시각적 diff와 함께 사용 |
| 데스크톱 앱 | macOS·Windows용 GUI. 터미널 없이 사용 (Linux 미지원) |
| Web | claude.ai/code. 로컬 파일시스템을 건드리지 않는 유일한 채널 |
| Agent SDK | TypeScript·Python으로 같은 엔진을 코드에서 호출 |
| GitHub Action / App | CI 파이프라인·PR 자동화 |
CLI가 "기준 표면"이고, 나머지 채널은 그 도구 집합의 일부를 각자의 방식으로 비춰주는 거울이라고 생각하면 됩니다. 채널별 사용법은 17장에서 다룹니다.
어떤 작업에 잘 맞나
- 여러 파일에 걸친 리팩터링·기능 추가
- 낯선 코드베이스 탐색과 "이 코드 뭐 하는 거야?" 질문
- 반복적인 보일러플레이트 생성
- 테스트 작성·실패 테스트 수리
- Git 커밋·PR 초안 작성
- 그리고 — 이름과 달리 — 코드가 아닌 문서·자료 정리 작업까지 (이 부분은 20장에서 다시 언급)
⚠️ 처음부터 알아둘 주의점
Claude Code는 당신의 파일시스템에 직접 접근하고, 명령을 실행할 수 있는 자율적 도구입니다. 강력한 만큼 위험도 따라옵니다. 2026년에는 충분한 감독 없이 AI 에이전트에게 인프라 명령 접근을 허용했다가 작업물을 잃은 사례들이 보고되었습니다.
그래서 Claude Code는 기본적으로 행동 전에 사용자에게 승인을 묻는 권한 모델을 갖고 있습니다(→ 8장). 그리고 가장 중요한 안전장치는 의외로 단순합니다: Git으로 버전 관리를 하고, 큰 작업 전에 체크포인트 커밋을 남기는 것(→ 18장).
💡 팁: "AI가 다 해주니 검토는 대충" 이 아니라, "AI가 빠르게 초안을 내주니 나는 검토에 집중" 이 올바른 마음가짐입니다. 자율성과 감독의 균형이 이 안내서 전체를 관통하는 주제입니다.
이 장에서 배운 것
- Claude Code는 실제 코드베이스를 직접 읽고·수정·실행하는 에이전틱 코딩 에이전트다.
- 채팅형(전체 그림 모름)·자동완성형(한 파일만)과 달리, 프로젝트 전체를 컨텍스트로 삼는다.
- 동작의 심장은 "모델 호출 → 도구 실행 → 결과 확인 → 반복"의 단순한 에이전트 루프다.
- CLI를 기준으로 IDE·데스크톱·Web·SDK·GitHub 등 여러 채널로 제공된다.
- 강력한 만큼 권한 승인과 Git 버전 관리로 감독하는 것이 중요하다.
✍️ 확인 문제
- Claude Code와 일반 채팅형 AI의 가장 본질적인 차이를 한 문장으로 설명해 보세요.
- "에이전틱"이라는 말의 핵심인 루프는 어떤 단계들로 이루어지나요?
- Claude Code를 쓸 때 가장 기본적이면서 중요한 안전장치 두 가지는 무엇일까요?
다음 장: 02. 설치와 인증 — 실제로 내 컴퓨터에 깔고 로그인해 봅니다.