Claude Code 동작 방식 3가지 모드와 내부 도구 정리

⚙️

Claude Code 사용하기 3강

Claude Code가 프로젝트 전체를 이해하고 작업하는 방식

프로젝트 전체를 이해한다

❌ 일반 AI: 복사한 코드 조각만 봄

→

✅ Claude Code: 폴더 전체를 탐색해서 구조 파악

파일 간의 관계, 구조, 의존성을 파악한 뒤 작업하기 때문에 훨씬 정확합니다.

기본 상호작용 패턴

자연어로 요청

“로그인 기능 구현해줘”, “에러 원인 분석해줘” 처럼 한국어로 지시

Claude의 동작

현재 폴더 구조 스캔 → 관련 파일 열기 → 수정/생성 계획 수립 → 코드 제안

승인/실행

“이 변경을 적용할까요?” 확인 → 수락하면 파일에 실제 반영

추가 지시

“테스트도 돌려줘”, “여기 좀 바꿔줘” 처럼 이어서 대화

팁: @ 문법으로 특정 파일·폴더를 콕 집어 컨텍스트에 포함시킬 수 있습니다. “이 파일 기준으로 수정해줘” 같은 세밀한 지시가 가능합니다.

3가지 모드

Shift+Tab으로 전환합니다.

기본값

🛡️

Normal

매 변경마다 승인 필요

처음 쓸 때, 중요한 코드 수정

Shift+Tab 1번

⚡

Auto-Accept

파일 수정·생성 자동 승인

대량 리팩토링, 변수명 일괄 변경

Shift+Tab 2번

📋

Plan

읽기 전용, 계획만 수립

새 코드베이스 분석, 영향도 파악

사용하는 내부 도구들

Claude Code는 작업을 위해 내부적으로 여러 도구를 사용합니다. 직접 신경 쓸 필요는 없지만, 알아두면 동작을 이해하기 쉽습니다.

📖

Read

파일 내용 읽기

✏️

Write

새 파일 만들기

🔧

Edit

기존 파일 수정

💻

Bash

터미널 명령어 실행

🔍

Glob / Grep

파일 찾기, 코드 검색

🤖

Agent

서브에이전트로 병렬 처리

서브에이전트 병렬 처리

큰 작업을 하면 Claude Code는 서브에이전트(보조원)를 여러 개 띄워서 동시에 처리합니다.

요청

“이 프로젝트의 API 엔드포인트를 전부 찾아서 문서화해줘”

↓

🔍 라우터 파일 검색

🔍 컨트롤러 파일 분석

🔍 미들웨어 구조 파악

↓

결과

API 문서 작성 완료

여러 에이전트가 동시에 탐색하고 분석하기 때문에 프로젝트가 커도 빠릅니다.

IDE 연동

터미널뿐 아니라 에디터 안에서 바로 Claude Code를 띄울 수도 있습니다.

🟦

VS Code

확장 프로그램 “Claude Code” 설치

🟧

IntelliJ / WebStorm

전용 플러그인 설치, Command+Esc 등 단축키로 실행

IDE 플러그인을 설치하면 에디터에서 코드를 보면서 바로 Claude에게 지시할 수 있습니다.

이전 강의설치와 첫 실행 다음 강의CLI 명령어와 단축키

💻 Claude Code 사용하기3 / 11강