클로드코드-핵심기능5가지

 

 

클로드 코드 핵심 기능 5가지 총정리 (2026)

클로드 코드(Claude Code)는 앤트로픽(Anthropic)이 만든 에이전트형 AI 코딩 도구예요. 단순히 다음 줄 코드를 추천해 주는 자동완성과 달리, 코드베이스를 스스로 읽고 여러 파일을 고치고 테스트나 git 같은 명령까지 직접 실행해 결과를 검증하는 점이 가장 큰 차이랍니다. 이 글에서는 그 핵심 기능을 다섯 가지 축으로 나눠, 무엇을 하는 도구이고 왜 쓸 만한지 차근차근 풀어 볼게요.

먼저 짚어 둘 점이 하나 있어요. 앤트로픽이 공식적으로 "핵심 기능은 정확히 이 다섯 가지"라고 못 박은 건 아니에요. 공식 자료에 흩어진 기능들을 이해하기 쉽게 다섯 갈래로 묶은 정리라고 생각해 주시면 돼요. 대신 각 기능의 사실 관계는 앤트로픽 공식 문서와 공식 블로그를 바탕으로 적었답니다.

클로드 코드는 어떤 도구일까요?

클로드 코드는 터미널을 기본 무대로 삼는 코딩 도구예요. 같은 엔진이 VS Code·JetBrains 같은 IDE, 데스크톱 앱, 웹 브라우저에서도 똑같이 동작한답니다. 어디서 실행하든 작동 원리는 하나로 이어져요.

그 원리를 앤트로픽 공식 문서는 에이전트 루프(agentic loop)라고 불러요. 쉽게 말하면, 작업을 받으면 ① 맥락을 모으고(gather context) ② 행동하고(take action) ③ 결과를 검증하는(verify results) 세 단계를 계속 반복하는 거예요. 한 번 도구를 써서 나온 결과가 다음 판단의 근거가 되고, 그렇게 수십 개의 행동을 사슬처럼 이어 가지요. 이 루프 위에서 추론을 맡는 건 클로드 모델이에요.

핵심 기능 1. 코드베이스를 이해하고 여러 파일을 함께 고쳐요

클로드 코드의 가장 근본적인 기능은 프로젝트 전체를 스스로 탐색해 맥락을 만들고, 여러 파일에 걸쳐 일관되게 고치는 것이에요. 지금 열려 있는 파일만 보는 인라인 코드 어시스턴트와 달리, 디렉터리를 검색해 모듈들이 어떻게 연결되는지까지 이해한 다음 작업한답니다.

예를 들어 "인증 버그를 고쳐줘"라고 부탁하면 어떻게 움직일까요? 공식 문서가 든 예시를 따라가 볼게요.

먼저, 관련 파일을 검색해 찾아요.
그다음, 여러 파일을 읽어 맥락을 파악해요.
이어서, 파일들에 걸쳐 서로 맞물린 수정을 가해요.
마지막으로, 테스트를 돌려 제대로 고쳐졌는지 검증해요.

"실패하는 테스트를 고쳐줘" 같은 작업도 비슷해요. 테스트를 돌려 무엇이 실패하는지 확인하고, 에러 출력을 읽고, 관련 소스를 검색·이해한 뒤 고치고, 다시 테스트를 돌려 확인하는 식이에요. 새 기능을 만들거나 여러 파일을 한꺼번에 손보는 리팩터처럼 손이 많이 가는 작업도 이렇게 처리해요.

이런 에이전트성을 가능하게 하는 건 내장 도구들이에요. 공식 문서는 이를 다섯 갈래로 정리해요.

• 파일 작업: 파일 읽기, 코드 편집, 새 파일 생성, 이름 변경·재구성
• 검색: 패턴으로 파일 찾기(glob), 정규식으로 내용 검색(grep), 코드베이스 탐색
• 실행: 셸 명령 실행, 서버 기동, 테스트 실행, git 사용
• 웹: 웹 검색, 문서 가져오기, 에러 메시지 조회
• 코드 인텔리전스: 편집 후 타입 에러·경고 확인, 정의로 점프, 참조 찾기

이 가운데 코드 인텔리전스는 언어별 플러그인이나 LSP가 있어야 동작한다는 점만 기억해 두면 돼요.

참고로 추론을 맡는 모델은 작업에 따라 골라 쓸 수 있어요. 대부분의 코딩은 Sonnet이, 복잡한 아키텍처 판단은 Opus가 더 강하다고 알려져 있고, 세션 중에 /model 명령으로 바꿀 수 있답니다. 다만 2026년 6월 시점에 "기본 모델이 정확히 무엇인지"는 이 글의 자료 범위에서는 단정하기 어려워서, 모델 이름까지 못 박지는 않을게요.

핵심 기능 2. 터미널·git·GitHub를 직접 실행해요

두 번째 기능은 "터미널에서 할 수 있는 일이라면 무엇이든" 직접 해 준다는 점이에요. 빌드 도구, git, 패키지 매니저, 시스템 유틸리티, 스크립트까지, 사람이 명령줄에서 할 수 있는 일을 클로드 코드가 대신 실행할 수 있어요.

여기서 편한 점은 복잡한 명령 문법을 외우지 않아도 된다는 거예요. git이나 Kubernetes 명령을 일일이 기억하지 않고 원하는 바를 말로 설명하면, GitHub CLI 같은 도구를 올바른 문법으로 알아서 실행해 준답니다.

특히 git과 GitHub 작업을 자동으로 묶어 줘요. 변경을 스테이징하고, 커밋 메시지를 쓰고, 브랜치를 만들고, PR을 여는 일까지 연동돼 있어요. 예를 들어 이렇게요.

claude "commit my changes with a descriptive message"

여기서 한발 더 나아가, CI 환경에서는 GitHub Actions나 GitLab CI/CD와 붙여 코드 리뷰·이슈 분류를 자동화할 수 있어요. 모든 PR에 자동 코드 리뷰를 달아 둘 수도 있고요. 에러를 읽고 코드를 고친 다음 모두 통과할 때까지 테스트 스위트를 다시 돌리는 반복 루프도, GitHub·GitLab 파이프라인을 지켜보면서 이어 가요.

또 하나 눈여겨볼 점은 클로드 코드가 다른 도구와 파이프로 이어 붙이도록(composable) 설계됐다는 거예요. 유닉스 철학처럼 작은 도구를 조합하는 방식이지요. 예를 들면 이렇게 쓸 수 있어요.

tail -200 app.log | claude -p "이상 징후가 보이면 Slack으로 알려줘"
git diff main --name-only | claude -p "변경된 파일들의 보안 이슈를 리뷰해줘"

실행 환경도 골라 쓸 수 있어요. ① 내 머신에서 도는 로컬(기본값), ② 앤트로픽이 관리하는 클라우드 VM, ③ 코드는 로컬에서 돌고 브라우저로 제어하는 Remote Control 중에서 상황에 맞게 선택하면 돼요. 여기에 /schedule(정기 실행), 데스크톱 예약 작업, /loop(세션 내 반복) 같은 방식으로 정기 작업까지 맡길 수 있답니다.

핵심 기능 3. 되돌리기와 권한 모드로 안전하게 통제해요

자율성이 커질수록 "잘못된 변경을 어떻게 되돌리고, 위험한 행동을 어떻게 막을까"가 중요해져요. 세 번째 기능은 바로 이 안전장치예요. 이 기능들은 2025년 9월 29일 발표된 자율성 강화 업데이트에서 크게 보강됐답니다.

체크포인트로 언제든 되돌릴 수 있어요

체크포인트는 변경 직전에 코드 상태를 자동으로 저장해 두는 기능이에요. 무언가 잘못됐다 싶으면 Esc를 두 번 누르거나 /rewind 명령으로 이전 상태로 즉시 돌아갈 수 있어요. 코드만, 대화 기록만, 또는 둘 다 복원하는 것도 고를 수 있고요. 앤트로픽은 "언제든 되돌릴 수 있다는 걸 알기에 더 야심찬 대규모 작업을 시도하게 된다"고 설명해요.

다만 이 되돌리기에는 분명한 한계가 있으니 알아 두면 좋아요. 체크포인트는 세션 안에서만 유효하고 git과는 별개이며, 파일 변경만 되돌려요. 그래서 데이터베이스·API·배포처럼 원격 시스템에 영향을 주는 행동은 체크포인트로 되돌릴 수 없어요. 바로 그 때문에 외부에 부수효과를 남기는 명령은 실행하기 전에 사용자에게 한 번 물어본답니다.

권한 모드로 행동을 통제해요

Shift+Tab으로 순환하는 권한 모드도 행동 통제의 핵심이에요. 상황에 따라 단계를 바꿔 가며 쓰면 돼요.

• Default: 파일 편집과 셸 명령을 실행하기 전에 매번 확인해요.
• Auto-accept edits: 파일 편집과 mkdir·mv 같은 일반 파일시스템 명령은 묻지 않고 실행하고, 그 외 명령은 여전히 확인해요.
• Plan mode: 소스 파일을 고치지 않고 탐색·계획만 제안해요(자세한 건 기능 4에서 다룰게요).
• Auto mode: 모든 행동을 백그라운드 안전성 검사로 평가하면서 자율로 실행해요. 다만 이 모드는 현재 리서치 프리뷰 단계라는 점을 감안해 주세요.

여기에 더해, .claude/settings.json에 npm test나 git status처럼 믿을 만한 명령을 미리 허용해 두면 매번 묻지 않게 할 수 있어요. 권한은 조직 전체 정책부터 개인 설정까지 계층적으로 범위를 정할 수 있고요.

그리고 대화 기록은 ~/.claude/projects/ 아래에 평문(JSONL) 파일로 저장돼요. 덕분에 되돌리기(rewind)뿐 아니라 이어가기(resume), 갈라내기(fork)도 가능해요. --continue나 --resume은 같은 세션을 이어 가고, --fork-session이나 /branch는 기록을 복사해 새 세션을 만들어 준답니다.

핵심 기능 4. 서브에이전트와 플랜 모드로 작업을 나눠요

네 번째는 복잡한 작업을 잘게 나누고, 맥락을 깔끔하게 격리하고, 코딩 전에 계획부터 세우는 기능들이에요.

서브에이전트로 맥락을 격리해요

서브에이전트(Subagents)는 각자 독립된 컨텍스트 윈도, 자체 시스템 프롬프트, 범위가 한정된 도구·권한을 가진 별도의 클로드 인스턴스예요. 리드(부모) 세션이 작업을 위임하면, 서브에이전트가 따로 떨어진 상태에서 일하고 요약만 부모에게 돌려줘요. 그래서 수십 개 파일을 읽어야 하는 조사 작업을 맡겨도 메인 대화의 맥락이 어지러워지지 않아요. 공식 블로그는 한 에이전트가 프론트엔드를 만드는 동안 다른 에이전트가 백엔드 API를 띄우는 식의 병렬 작업을 예로 들었답니다.

에이전트 팀은 서로 메시지를 주고받아요

에이전트 팀(Agent teams)은 서브에이전트와 결이 조금 달라요. 완전히 독립적인 여러 클로드 코드 세션이 서로 직접 메시지를 주고받으며 공유 작업 목록으로 자율 조율하는 방식이에요. 경쟁하는 가설을 함께 따져 보는 조사, 병렬 코드 리뷰, 각자 다른 부분을 맡는 기능 개발에 잘 맞아요.

둘을 언제 나눠 쓰면 좋을까요? 결과(요약)만 받으면 충분하고 비용을 낮추고 싶을 때는 서브에이전트가, 팀원들이 서로 발견을 공유하고 반박하며 조율해야 할 때는 에이전트 팀이 어울려요. 다만 에이전트 팀은 팀원마다 별도 클로드 인스턴스라 토큰 비용이 더 들고, 공식 문서가 실험적(experimental)이며 기본은 비활성화라고 밝힌 기능이라는 점은 기억해 두면 좋아요.

플랜 모드로 조사와 코딩을 분리해요

플랜 모드(Plan mode)는 소스 파일을 고치지 않고 코드베이스를 탐색해 계획을 먼저 제안하는 모드예요. Shift+Tab을 두 번 누르면 들어가요. 이 상태에서는 Read·Grep·Glob·Bash 같은 탐색 도구는 쓸 수 있지만, Write·Edit처럼 파일을 바꾸는 도구는 도구 수준에서 막혀 있어요. 말 그대로 읽기 전용이지요. 복잡한 문제일수록 조사와 코딩을 분리하면 더 나은 결과가 나오기 때문이에요. 한 2026년 기술 매체는 플랜 모드와 worktree, 서브에이전트를 함께 쓰는 조합을 두고 고품질·고처리량 작업의 토대라고 평가하기도 했답니다.

병렬 세션(worktrees)으로 여러 작업을 동시에

세션은 디렉터리에 묶이는 구조예요. 그래서 git worktree로 브랜치마다 디렉터리를 따로 만들면, 여러 클로드 세션을 동시에 병렬로 돌릴 수 있어요. 백그라운드에서 도는 에이전트들을 한 화면에서 지켜보는 agent view도 제공된답니다.

핵심 기능 5. CLAUDE.md·스킬·MCP·훅으로 확장해요

마지막은 동작을 입맛대로 맞춤화하는 확장성이에요. 내장 도구만으로도 대부분의 코딩은 처리되지만, 클로드 코드는 에이전트 루프의 서로 다른 지점에 끼워 넣는 확장 레이어로 동작을 바꿀 수 있어요. 네 가지를 차례로 볼게요.

CLAUDE.md(메모리)는 프로젝트 루트에 두는 마크다운 파일이에요. 매 세션이 시작될 때 전체 내용이 통째로 로드돼요. 코딩 표준, 아키텍처 결정, 선호 라이브러리, 리뷰 체크리스트처럼 "항상 이렇게 해라"는 규칙에 잘 맞아요. 공식 문서는 200줄 이하로 짧게 유지하고, 그보다 길어지면 스킬이나 .claude/rules/로 나누길 권해요. 클로드가 빌드 명령이나 디버깅 인사이트를 스스로 저장하는 auto memory(MEMORY.md)도 세션 시작 때 일부가 로드된답니다.

스킬(Skills)은 지식·워크플로·지침을 담은 마크다운 파일로, 가장 유연한 확장이에요. /deploy처럼 명령으로 직접 부르거나, 관련될 때 클로드가 알아서 불러와요. 설명만 세션 시작 때 로드되고 본문은 실제로 쓸 때 로드돼서 컨텍스트 비용이 낮아요. /code-review·/batch·/debug 같은 스킬이 기본으로 제공되기도 해요.

MCP(Model Context Protocol)는 AI 도구를 외부 데이터·서비스에 잇는 개방형 표준이에요. MCP를 붙이면 클로드 코드가 Google Drive의 문서를 읽거나, Jira 티켓을 갱신하거나, Slack 데이터를 가져오거나, 데이터베이스를 조회하고 브라우저를 제어할 수 있어요. 세션 시작 때는 도구 이름만 로드하고 전체 스키마는 필요할 때 불러오는 방식이라, 안 쓰는 MCP 도구가 컨텍스트를 많이 잡아먹지도 않아요.

훅(Hooks)은 도구 실행, 세션 경계, 프롬프트 제출, 권한 요청 같은 생애주기 이벤트에 맞춰 셸 명령·HTTP 요청·LLM 프롬프트·서브에이전트를 발화시키는 장치예요. 매 파일 편집 뒤 자동 포매팅, 커밋 전 린트 실행, rm -rf / 같은 위험 명령 차단처럼 "항상 같은 방식으로, 추론 없이" 일어나야 하는 동작에 잘 맞아요. 여기서 공식 문서가 강조하는 한마디가 중요해요. CLAUDE.md나 스킬에 "절대 .env를 수정하지 마라"라고 적는 건 요청일 뿐 보장이 아니고, PreToolUse 훅으로 막아야 비로소 강제(enforcement)가 된다는 거예요.

이 확장들을 한 묶음으로 패키징한 게 플러그인·마켓플레이스예요. 스킬·훅·서브에이전트·MCP 서버를 하나의 설치 단위로 묶어, 여러 레포에서 같은 설정을 재사용하거나 팀에 배포할 때 쓴답니다. 플러그인 스킬은 /my-plugin:review처럼 네임스페이스가 붙어서 여러 플러그인이 충돌 없이 공존할 수 있어요.

정리하면

클로드 코드는 코드를 한 줄씩 추천해 주는 도구가 아니라, 맥락을 모으고 행동하고 검증하는 에이전트 루프 위에서 코드베이스 전체를 다루는 코딩 동료에 가까워요. 지금까지 살펴본 다섯 가지를 한 번 더 짚어 볼게요.

1. 코드베이스 이해와 다중 파일 작업 — 프로젝트 전체를 보고 여러 파일을 함께 고쳐요.
2. 터미널·git·GitHub 통합 실행 — 명령을 직접 실행하고 PR·CI까지 자동화해요.
3. 체크포인트와 권한 모드 — 되돌리기와 단계별 권한으로 안전하게 통제해요.
4. 서브에이전트·에이전트 팀·플랜 모드 — 작업을 나누고 계획부터 세워요.
5. CLAUDE.md·스킬·MCP·훅 — 동작을 입맛대로 확장하고 강제해요.

처음에는 기능이 많아 보여 낯설 수 있어요. 그래도 권한 모드를 Default로 두고 작은 작업부터 맡겨 보면, 에이전트 루프가 어떻게 돌아가는지 금방 감이 잡힐 거예요. 그러고 나서 체크포인트로 마음 편히 더 큰 작업에 도전하고, 익숙해지면 스킬이나 훅으로 나만의 워크플로를 더해 가면 된답니다.