클로드 코드(Claude Code)는 Anthropic이 만든 에이전트형 코딩 도구입니다. 코드베이스를 직접 읽고, 파일을 편집하고, 명령을 실행하며, 개발 도구들과 통합됩니다. 터미널, IDE, 데스크톱 앱, 웹 브라우저 어디서든 사용할 수 있습니다.
이 글은 클로드 코드가 제공하는 모든 핵심 기능을 한 페이지에 모아 간단히 설명하는 것이 목표입니다. 각 항목의 자세한 사용법·예제·설정 방법은 추후 항목별 별도 글에서 다룰 예정입니다.
본 글의 모든 정보는 Anthropic 공식 문서와 확장 기능 개요 문서를 기반으로 작성되었습니다.
1. 클로드 코드를 사용할 수 있는 환경 (Surfaces)
클로드 코드는 어디서나 동일한 엔진으로 동작하며, CLAUDE.md, 설정, MCP 서버가 모든 환경에서 공유됩니다.
- 터미널 CLI — 가장 본격적인 환경입니다. 터미널에서 직접 파일을 편집하고 명령을 실행합니다.
- VS Code 확장 — 인라인 diff, @-멘션, 플랜 리뷰, 대화 기록을 에디터에서 바로 사용할 수 있습니다. Cursor에서도 설치 가능합니다.
- JetBrains 플러그인 — IntelliJ IDEA, PyCharm, WebStorm 등에서 인터랙티브 diff 뷰와 선택 영역 컨텍스트 공유를 제공합니다.
- 데스크톱 앱 — IDE나 터미널 밖에서 독립 실행됩니다. diff 시각 검토, 여러 세션 병렬 실행, 작업 예약, 클라우드 세션 시작이 가능합니다. (macOS, Windows x64, Windows ARM64 지원)
- 웹 브라우저 (claude.ai/code) — 로컬 설정 없이 브라우저에서 실행됩니다. 장시간 작업을 원격으로 돌리거나, 로컬에 없는 레포에서 작업할 수 있습니다. iOS 앱에서도 사용 가능합니다.
- Chrome 확장 (베타) — 브라우저에서 직접 웹 애플리케이션을 디버깅합니다.
- Slack 통합 — Slack에서
@Claude를 멘션해 버그 리포트를 PR로 받을 수 있습니다.
2. 핵심 확장 기능 (Extensions)
확장 기능들은 클로드 코드의 에이전트 루프 곳곳에 끼어들어 동작을 커스터마이즈합니다. 공식 문서는 다음 7가지를 핵심 확장으로 분류하고 있습니다.
2-1. CLAUDE.md — 프로젝트 영구 컨텍스트
CLAUDE.md는 프로젝트 루트에 두는 마크다운 파일입니다. 세션이 시작될 때마다 자동으로 클로드 컨텍스트에 로드됩니다. 코딩 표준, 아키텍처 결정, 선호 라이브러리, 리뷰 체크리스트 등 "항상 알고 있어야 할 규칙"을 적습니다.
- 사용자(user), 프로젝트(project), 관리자(managed) 등 여러 레벨에서 정의 가능하며, 모두 누적적으로 컨텍스트에 들어갑니다.
- 공식 문서는 CLAUDE.md를 200줄 이하로 유지할 것을 권장합니다. 내용이 늘어나면 참고 자료는 스킬로, 경로별 규칙은
.claude/rules/로 분리하는 것이 좋습니다. - 클로드가 작업 도중 학습한 빌드 명령이나 디버깅 인사이트는 auto memory 기능을 통해 사용자가 직접 적지 않아도 세션 간에 저장됩니다.
2-2. Skills — 재사용 가능한 지식과 워크플로우
Skills는 마크다운 파일 형태의 재사용 가능한 지식·워크플로우 묶음입니다. 공식 문서가 "확장 기능 중 가장 유연하다"고 표현하는 핵심 기능입니다.
- 두 가지 유형: 클로드가 세션 내내 활용하는 참고형(reference) 스킬(예: API 스타일 가이드)과 사용자가 명령으로 실행하는 액션형(action) 스킬(예:
/deploy배포 워크플로우)이 있습니다. - 호출 방식:
/<이름>형태의 슬래시 명령으로 직접 실행하거나, 클로드가 상황에 맞다고 판단해 자동으로 로드합니다. - 컨텍스트 비용: 기본적으로 세션 시작 시에는 스킬의 설명만 로드되고, 실제 사용될 때 전체 내용이 로드됩니다.
disable-model-invocation: true로 설정하면 사용자가 직접 호출하기 전까지 컨텍스트를 0으로 유지할 수 있습니다. - 클로드 코드에는
/simplify,/batch,/debug같은 번들 스킬이 기본 탑재되어 있습니다.
2-3. Subagents — 격리된 컨텍스트의 작업자
Subagents(서브에이전트)는 별도의 컨텍스트 윈도우에서 작업을 수행하고 요약 결과만 메인 대화에 반환하는 작업자입니다.
- 메인 대화 컨텍스트가 가득 차거나, 수십 개 파일을 읽는 작업처럼 중간 산출물이 보일 필요가 없을 때 적합합니다.
- 메인 세션의 대화 기록이나 이미 호출한 스킬을 자동으로 상속받지 않습니다. 필요한 스킬은
skills:필드에 명시해야 합니다. - 커스텀 서브에이전트는
.claude/agents/(프로젝트) 또는~/.claude/agents/(개인)에 마크다운 파일로 정의합니다.
2-4. Agent Teams — 다중 세션 협업 (실험적)
Agent teams(에이전트 팀)는 여러 개의 독립적인 클로드 코드 세션이 서로 메시지를 주고받으며 협업하는 기능입니다.
- 서브에이전트가 메인에게만 결과를 보고하는 것과 달리, 팀원끼리 직접 통신하고 공유 작업 목록을 통해 자율적으로 조율합니다.
- 경쟁 가설이 있는 리서치, 보안·성능·테스트를 동시에 검토하는 병렬 코드 리뷰, 각자 다른 부분을 담당하는 신기능 개발에 적합합니다.
- 현재 실험적(experimental) 기능이며 기본적으로 비활성화되어 있습니다. 토큰 비용도 서브에이전트보다 높습니다(각 팀원이 별도의 클로드 인스턴스).
2-5. MCP (Model Context Protocol) — 외부 서비스 연결
MCP는 AI 도구를 외부 데이터 소스에 연결하기 위한 개방 표준 프로토콜입니다. MCP를 통해 클로드 코드는 데이터베이스 쿼리, Slack 게시, Jira 티켓 업데이트, Google Drive 디자인 문서 읽기 같은 작업을 수행할 수 있습니다.
- 세션 시작 시에는 도구 이름만 로드되고, 실제 호출될 때 JSON 스키마가 로드됩니다(컨텍스트 효율).
/mcp명령으로 연결 상태와 서버별 토큰 사용량을 확인할 수 있습니다.- 공식 MCP 서버 레지스트리는 github.com/modelcontextprotocol/servers에서 볼 수 있습니다.
2-6. Hooks — 이벤트 기반 자동화 스크립트
Hooks(훅)는 클로드 코드의 특정 라이프사이클 이벤트에서 자동 실행되는 결정론적 셸 스크립트입니다. LLM이 개입하지 않으므로 동작이 예측 가능합니다.
- 대표적인 사용 예: 파일 편집 후 자동 포매팅, 커밋 전 린트 실행, MCP를 통한 Slack 알림 전송 등이 있습니다.
- 주요 이벤트로는
PreToolUse(도구 실행 전),PostToolUse(도구 실행 후),PreCompact/PostCompact(컨텍스트 압축 전후),PermissionRequest(권한 다이얼로그 표시 시),InstructionsLoaded(CLAUDE.md 로드 시) 등이 있습니다. - 컨텍스트 비용이 0이며(외부 스크립트),
.claude/settings.json에 정의합니다.
2-7. Plugins & Marketplaces — 패키징과 배포
Plugins(플러그인)는 스킬, 훅, 서브에이전트, MCP 서버를 하나의 설치 가능한 단위로 묶는 패키징 계층입니다. 동일한 설정을 여러 레포에서 재사용하거나 다른 사람에게 배포할 때 사용합니다.
- 플러그인 스킬은
/my-plugin:review형태로 네임스페이스가 지정되어 다른 플러그인과 충돌하지 않습니다. - Marketplaces(마켓플레이스)는 플러그인 컬렉션을 호스팅·배포하는 채널입니다.
3. 권한 모드 (Permission Modes)
권한 모드는 클로드가 액션을 실행하기 전에 사용자에게 얼마나 자주 묻는지를 결정합니다. 터미널에서는 Shift+Tab으로 모드를 순환할 수 있습니다.
| 모드 | 묻지 않고 가능한 작업 | 적합한 상황 |
|---|---|---|
default |
파일 읽기 | 시작할 때, 민감한 작업 |
acceptEdits |
파일 읽기·편집 | 리뷰하면서 코드 반복 작성 |
plan |
파일 읽기 | 코드베이스 탐색, 리팩터링 계획 |
auto |
모든 액션(백그라운드 분류기 검사) | 장시간 작업, 프롬프트 피로 감소 |
dontAsk |
사전 승인된 도구만 | 잠긴 환경, CI 파이프라인 |
bypassPermissions |
모든 액션, 검사 없음 | 격리된 컨테이너·VM 전용 |
auto 모드는 Team, Enterprise, API 플랜에서만 제공되며, 별도의 분류기 모델이 각 액션을 검토해 작업 범위를 벗어나거나 프롬프트 인젝션으로 보이는 동작을 차단합니다. bypassPermissions는 안전 장치가 없으므로 격리 환경에서만 사용해야 합니다.
4. 슬래시 명령 (Slash Commands)
슬래시 명령은 세션 안에서 클로드 코드를 제어하는 명령입니다. /를 입력하면 사용 가능한 모든 명령 목록이 표시됩니다. 명령은 두 종류로 나뉩니다.
- 번들 스킬:
/simplify,/batch,/debug같은 기본 탑재 스킬입니다. 사용자가 만든 스킬과 동일한 메커니즘으로 동작합니다. - 빌트인 명령: CLI에 직접 코딩된 명령입니다.
/clear(대화 초기화),/model(모델 변경),/mcp(MCP 상태 확인),/permissions(권한 확인),/help(도움말),/plan(플랜 모드 단발 실행),/schedule(루틴 생성) 등이 있습니다.
명령 가용성은 플랫폼·플랜·환경에 따라 다릅니다. 예를 들어 /desktop은 macOS와 Windows에서만 표시되고, /upgrade는 Pro·Max 플랜에서만 표시됩니다.
5. 자동화·스케줄링·원격 작업 기능
5-1. Routines — 클라우드 스케줄링
Routines(루틴)은 Anthropic이 관리하는 인프라에서 정해진 일정에 따라 실행되는 작업입니다. 컴퓨터를 꺼도 동작합니다. 아침 PR 리뷰, 야간 CI 실패 분석, 주간 의존성 감사 같은 반복 작업에 적합합니다. API 호출이나 GitHub 이벤트로도 트리거할 수 있습니다. 웹·데스크톱·CLI(/schedule)에서 생성할 수 있습니다.
5-2. Desktop scheduled tasks — 로컬 스케줄링
데스크톱 예약 작업은 사용자 컴퓨터에서 직접 실행되어 로컬 파일과 도구에 접근할 수 있습니다.
5-3. /loop (번들 스킬)
/loop은 번들 스킬 형태로 제공되며, CLI 세션 내에서 동일한 프롬프트를 반복 실행해 빠르게 폴링할 때 사용합니다(예: /loop 5m check if the deploy finished).
5-4. Remote Control
Remote Control(원격 제어)을 사용하면 휴대폰이나 다른 브라우저에서 로컬 세션을 이어서 작업할 수 있습니다.
5-5. Channels
Channels(채널)은 Telegram, Discord, iMessage, 또는 자체 웹훅에서 발생한 이벤트를 클로드 코드 세션에 전달합니다.
5-6. Computer use (프리뷰)
Computer use는 클로드가 사용자 컴퓨터의 화면을 보고 마우스·키보드를 직접 조작할 수 있게 해주는 프리뷰 기능입니다.
6. CI/CD 및 코드 리뷰 통합
- GitHub Actions — 코드 리뷰와 이슈 분류를 자동화합니다.
- GitLab CI/CD — GitLab 환경에서 동일한 자동화를 제공합니다.
- GitHub Code Review — 모든 PR에 자동 코드 리뷰를 적용합니다.
CLI는 Unix 철학을 따라 다른 도구와 파이프·체이닝이 자유롭습니다. 예를 들어 tail -200 app.log | claude -p "Slack me if you see any anomalies"처럼 로그를 파이프로 넘겨 분석시킬 수 있습니다.
7. 안전·세션 관리 기능
7-1. Sandboxing — OS 레벨 격리
Sandboxing(샌드박싱)은 Bash 명령과 그 자식 프로세스가 정의된 경계를 넘어가지 못하도록 OS 레벨에서 강제하는 기능입니다. macOS는 Seatbelt를 사용해 별도 설치 없이 작동하며, Linux와 WSL2에서는 bubblewrap과 socat을 먼저 설치해야 합니다. /sandbox 명령으로 활성화합니다. 권한 시스템과 함께 **다층 방어(defense-in-depth)**를 구성합니다.
7-2. Checkpointing — 대화·코드 되돌리기
Checkpointing(체크포인팅)은 /rewind 명령으로 대화나 코드를 이전 시점으로 되돌릴 수 있게 해줍니다. 클로드가 잘못된 방향으로 갔을 때 빠르게 복구할 수 있습니다.
7-3. Background tasks — 백그라운드 작업 관리
/tasks 명령(별칭 /bashes)으로 백그라운드에서 실행 중인 작업들을 나열하고 관리할 수 있습니다.
7-4. Output styles — 응답 스타일 커스터마이즈
Output styles(출력 스타일)을 통해 클로드의 응답 형식을 사용자 취향에 맞게 조정할 수 있습니다. /config에서 변경합니다.
7-5. Fast mode — 빠른 응답 모드
/fast 명령으로 Fast mode를 토글할 수 있습니다. 응답 속도를 우선시합니다.
7-6. Voice dictation — 음성 입력
/voice 명령으로 푸시-투-토크 음성 받아쓰기 기능을 켤 수 있습니다(Claude.ai 계정 필요).
8. Agent SDK — 커스텀 에이전트 빌드
Agent SDK는 클로드 코드의 도구와 기능을 활용한 자체 에이전트를 직접 만들 수 있게 해주는 SDK입니다. 오케스트레이션, 도구 접근, 권한을 완전히 제어할 수 있습니다. 특정 도메인에 특화된 워크플로우를 구축할 때 사용합니다.
9. .claude 디렉토리 — 모든 설정의 중심
.claude 디렉토리는 프로젝트별 클로드 코드 설정이 저장되는 곳입니다. 주요 하위 항목은 다음과 같습니다.
.claude/settings.json— 모델, 권한, 환경변수, 훅, MCP 서버 설정.claude/commands/— 커스텀 슬래시 명령 (레거시 형식).claude/skills/<이름>/SKILL.md— 커스텀 스킬 (권장 형식).claude/agents/— 커스텀 서브에이전트.claude/rules/— 경로별 규칙
전역 설정은 ~/.claude/ 아래에 동일한 구조로 저장되며, 프로젝트 설정이 충돌 시 우선합니다.
10. 기능별 컨텍스트 비용 요약
공식 문서가 정리한 컨텍스트 로딩 전략입니다.
| 기능 | 로드 시점 | 로드되는 내용 | 컨텍스트 비용 |
|---|---|---|---|
| CLAUDE.md | 세션 시작 | 전체 내용 | 매 요청마다 |
| Skills | 세션 시작 + 사용 시 | 시작 시 설명만, 사용 시 전체 | 낮음 (설명만 매 요청) |
| MCP 서버 | 세션 시작 | 도구 이름만, 스키마는 필요 시 | 도구 사용 전까지 낮음 |
| Subagents | 스폰 시 | 지정된 스킬과 함께 새 컨텍스트 | 메인 세션과 격리 |
| Hooks | 트리거 시 | 없음 (외부 실행) | 0 (출력 반환 시 제외) |
11. 기능을 언제 추가해야 할까
공식 문서가 권장하는 트리거 기반 도입 순서입니다.
| 트리거 | 추가할 기능 |
|---|---|
| 클로드가 같은 컨벤션·명령을 두 번 틀립니다 | CLAUDE.md에 추가 |
| 작업 시작 시 같은 프롬프트를 반복 입력합니다 | 사용자 호출 스킬로 저장 |
| 같은 절차서·플레이북을 세 번째 붙여넣고 있습니다 | 스킬로 캡처 |
| 클로드가 못 보는 브라우저 탭에서 데이터를 계속 복사합니다 | MCP 서버로 연결 |
| 사이드 작업이 주 대화를 출력으로 가득 채웁니다 | 서브에이전트로 분리 |
| 매번 자동으로 일어났으면 하는 일이 있습니다 | 훅 작성 |
| 두 번째 레포에 동일한 설정이 필요합니다 | 플러그인으로 패키징 |
마치며
클로드 코드는 단일 도구가 아니라 여러 환경(Surfaces)에서 동작하는 7가지 핵심 확장(CLAUDE.md, Skills, Subagents, Agent teams, MCP, Hooks, Plugins) + 권한 모드 + 자동화·스케줄링 + 안전·세션 관리 + Agent SDK가 결합된 플랫폼입니다. 공식 문서가 강조하듯, 처음부터 모든 것을 설정할 필요는 없습니다. 트리거가 생기면 그때 도입하시면 됩니다.
이 글에서는 각 기능의 정체와 역할만 빠르게 훑어보았습니다. 다음 글들에서는 항목별로 실제 설치·설정 방법, 예제 코드, 실수하기 쉬운 부분을 자세히 다룰 예정입니다.
참고 링크