모든 엔지니어가 알아야 할 Claude Code의 12가지 핵심 기능

 

 

 

요즘 많은 개발자들이 AI 코딩 도구를 사용하고 계실텐데요...

 

오늘은 엔지니어라면 꼭 알아야 할 Claude Code의 12가지 핵심 기능을 알아보겠습니다.

 

 

1. CLAUDE.md - 프로젝트의 장기 기억

 

Claude Code는 세션을 시작할 때마다 프로젝트 루트의 CLAUDE.md 파일을 자동으로 읽습니다.

여기에 코딩 컨벤션, 아키텍처 규칙, 자주 쓰는 명령어 등을 적어두면 매번 설명할 필요가 없어요.

 

예를 들면 이런 내용을 담을 수 있어요:

- "이 프로젝트는 Minimal API 패턴을 사용한다"

- "테스트는 항상 xUnit을 써야 한다"

- "Swagger 대신 Scalar를 사용한다"

 

`/init` 명령어를 실행하면 현재 코드베이스를 분석해서 자동으로 CLAUDE.md를 생성해 주기도 합니다. 정말 편리하죠?

 

 

2. 권한(Permissions) - Claude가 할 수 있는 것과 없는 것

 

Claude가 마음대로 파일을 삭제하거나 외부 서비스에 접근하는 걸 원하지 않으시죠?

권한 시스템이 바로 이걸 제어합니다.

 

Shift+Tab을 누르면 세 가지 모드를 순환할 수 있어요:

모드	특징
Normal	파일 편집, 쉘 명령 실행 전 매번 확인 요청
Auto-accept	파일 편집은 자동 승인, 외부 영향 명령만 확인
Plan Mode	읽기 전용만 허용, 계획 수립 후 승인 필요

`.claude/settings.json`에서 신뢰하는 명령어(예: `npm test`, `git status`)를 미리 허용해두면 작업 흐름이 훨씬 부드러워집니다.

 

 

3. 계획 모드(Plan Mode) - 실행 전에 먼저 생각하기

 

복잡한 리팩토링이나 여러 파일에 걸친 변경 작업을 할 때, Claude가 바로 코드를 수정하면 문제가 생길 수 있어요.

 

Plan Mode는 Claude가 코드베이스를 읽고 분석하되, 어떠한 파일도 수정하지 않는 읽기 전용 상태입니다.

Claude는 코드를 탐색하고 구조를 파악한 뒤 실행 계획을 markdown 파일로 작성해요.

 

이 계획을 검토하고 수정한 다음, 승인을 눌러야 실제로 작업이 시작됩니다.

여러 결정이 연속으로 쌓이는 복잡한 작업에서 오류 확률을 크게 줄여주는 기능이에요.

 

 

4. 체크포인트(Checkpoints) - 언제든 되돌리기

 

Claude가 파일을 편집하기 전에 자동으로 스냅샷을 저장합니다.

무언가 잘못됐다 싶으면? Esc를 두 번 누르거나 `/rewind` 명령어로 즉시 이전 상태로 복원!

 

코드 복원, 대화 복원, 또는 둘 다 복원하는 옵션을 선택할 수 있어요.

 

체크포인트는 git과는 별개로 로컬 세션에만 유지됩니다.

데이터베이스 변경이나 외부 API 호출 같은 외부 영향은 되돌릴 수 없으니 주의하세요.

 

 

5. 스킬(Skills) - 재사용 가능한 워크플로 파일

 

같은 긴 프롬프트를 매번 복붙하고 계신가요?

Skills는 그 반복을 끝내는 기능입니다.

 

`.claude/skills/review/SKILL.md`처럼 마크다운 파일을 만들어두면 `/review` 슬래시 명령어로 즉시 호출할 수 있어요.

 

Claude는 관련 작업을 감지하면 자동으로 스킬을 로드하기도 합니다.

코드 리뷰, 배포 스크립트, 문서화 워크플로 등 팀 전체가 쓰는 작업을 표준화하기 딱 좋습니다!

 

 

6. 훅(Hooks) - 생명주기 이벤트에 자동 반응

 

Claude가 특정 도구를 사용하는 전후에 자동으로 스크립트를 실행하는 기능입니다.

 

활용 예시:

- `PreToolUse` — Claude가 파일을 편집하기 전에 린터 실행

- `PostToolUse` — 코드 변경 후 자동으로 테스트 실행

- 작업 완료 시 데스크탑 알림 발송

 

반복적인 품질 검사나 CI 파이프라인 연동에 정말 유용한 기능이에요.

Claude가 코드를 변경할 때마다 자동으로 테스트가 돌아간다고 생각해보세요!

 

 

7. MCP - 외부 도구와 연결하는 만능 어댑터

 

Model Context Protocol(MCP)은 Claude Code를 외부 서비스에 연결하는 표준 프로토콜입니다.

일종의 AI용 USB-C 같은 개념이에요.

 

한 줄 명령어로 설치하고 바로 쓸 수 있어요:

 

claude mcp add playwright npx @playwright/mcp@latest

 

 

GitHub, Jira, PostgreSQL, Slack, 파일 시스템 등 수많은 서비스가 MCP 서버로 제공되고 있어요.

"최근 Jira 이슈 가져와서 수정해줘" 같은 자연어 명령이 가능해집니다!

 

 

8. 플러그인(Plugins) - 팀 설정을 패키지로 공유

 

스킬, MCP 서버, 훅을 하나의 패키지로 묶어서 배포하는 기능입니다.

 

팀장이 만든 표준 개발 환경 설정을 신입 개발자가 한 번에 설치할 수 있어요.

`claude plugin install [플러그인명]` 한 줄로 팀 전체의 워크플로를 통일시킬 수 있습니다.

 

오픈소스 플러그인 생태계도 활발하게 성장 중이어서, GitHub Actions 연동, Playwright 테스트 자동화 등 다양한 플러그인을 바로 가져다 쓸 수 있어요.

 

 

9. 컨텍스트(Context) - Claude에게 필요한 정보 관리

 

Claude의 컨텍스트 창에는 대화 내역, 파일 내용, 명령어 출력, CLAUDE.md, 스킬, 시스템 지침 등이 담깁니다.

 

작업 중 관련 파일을 추가하거나 `/context` 명령어로 현재 컨텍스트 창 상태를 직접 관리할 수 있어요.

 

컨텍스트가 가득 차면 응답 품질이 떨어질 수 있어요. 주기적으로 정리해주는 게 좋습니다!

 

 

10. 슬래시 명령어(Slash Commands) - 자주 쓰는 작업의 단축키

 

`/`를 입력하면 저장된 명령어 목록이 자동완성으로 표시됩니다.

 

기본 내장 명령어도 있고, 직접 만든 커스텀 명령어도 쓸 수 있어요:

명령어	기능
/init	CLAUDE.md 자동 생성
/compact	대화 압축으로 토큰 절약
/rewind	체크포인트로 복원
/plan	플랜 모드 진입
/review	코드 리뷰 (커스텀 스킬)

`.claude/commands/` 폴더에 마크다운 파일을 만들면 나만의 명령어를 추가할 수 있습니다.

 

 

11. 압축(Compaction) - 토큰 절약으로 긴 세션 유지

 

대화가 길어지면 컨텍스트 창이 가득 차서 세션이 끊기거나 응답 품질이 저하됩니다.

/compact 명령어를 실행하면 긴 대화를 요약해서 토큰을 크게 절약할 수 있어요.

 

자동 압축 기능도 있어서 컨텍스트가 한계에 가까워지면 Claude가 스스로 요약을 생성합니다.

압축 후에도 호출된 스킬들은 일정 토큰 예산 안에서 자동으로 재첨부됩니다.

 

 

12. 서브에이전트(Subagents) - 병렬 작업으로 속도 UP!

 

복잡한 프로젝트에서 가장 강력한 기능입니다!

 

서브에이전트는 메인 세션과 독립된 컨텍스트 창을 가진 별도의 Claude 인스턴스예요.

여러 서브에이전트를 동시에 병렬로 실행할 수 있습니다.

 

예를 들어:

- 에이전트 A → 백엔드 API 구축

- 에이전트 B → 프론트엔드 컴포넌트 작성

- 에이전트 C → 테스트 코드 커버리지 확보

 

세 에이전트가 동시에 작업하고 결과만 메인 세션으로 보고합니다.

대규모 리팩토링이나 멀티 스텝 워크플로를 분할해서 처리할 때 개발 속도가 획기적으로 빨라져요!

 

 

 

마무리하며...

 

Claude Code는 단순히 "코드를 짜주는 AI"가 아닙니다.

CLAUDE.md로 프로젝트 컨텍스트를 기억하고, Plan Mode로 신중하게 계획하고, Checkpoints로 안전망을 만들고, Subagents로 병렬 작업을 처리하는 진정한 에이전트 개발 플랫폼이에요.

 

이 12가지 기능을 하나씩 적용해나가다 보면, 어느 순간 혼자서는 하루 종일 걸릴 작업을 몇 시간 안에 처리하고 있는 자신을 발견하게 될 거예요.

 

 

 

 

#ClaudeCode #Anthropic #AI코딩 #개발생산성 #에이전트AI #CLAUDE_md #MCP #서브에이전트 #플랜모드 #체크포인트 #개발자 #소프트웨어엔지니어링