핵심 개념
기준일: 2026-07-13 난이도: 초급 공식 기준: How Claude Code works, Tools reference, Extend Claude Code
Claude Code는 질문에 답만 하는 채팅이 아니라 코드를 읽고, 계획하고, 도구를 호출하고, 결과를 다시 확인하는 agentic coding tool입니다. 사용자는 목표와 제약을 주고, Claude는 권한 범위 안에서 반복적으로 작업합니다.
핵심 개념
Agentic loop
Claude는 보통 다음 순서를 반복합니다.
- 요청과 현재 context를 해석합니다.
- 필요한 파일·명령·외부 도구를 선택합니다.
- permission rule과 사용자 승인을 거쳐 도구를 실행합니다.
- 결과를 읽고 다음 행동 또는 완료 여부를 판단합니다.
도구 한 번의 성공이 작업 완료를 뜻하지 않습니다. 테스트, diff, 실제 실행 결과가 목표를 충족하는지 확인해야 합니다.
Context
Context에는 대화, 읽은 파일, tool 결과, CLAUDE.md와 rules, 활성 Skills 등이 들어갑니다. 긴 세션에서는 자동 compaction이 일어날 수 있으므로 영구 규칙은 대화에만 두지 말고 적절한 파일에 저장합니다.
공식 Context window 페이지와 /context를 사용하면 무엇이 로드됐는지 점검할 수 있습니다.
Tools와 permissions
Read, Edit, Bash, Agent 같은 built-in tool 이름은 permission rule, subagent tool list, hook matcher에서 사용하는 정확한 식별자입니다. MCP는 외부 tool을 추가하고, Skills는 기존 Skill tool로 재사용 가능한 지침을 불러옵니다.
Permissions와 sandboxing은 역할이 다릅니다.
- Permissions: 어떤 tool·파일·domain 접근을 요청·허용·차단할지 결정합니다.
- Sandboxing: Bash와 child process의 filesystem·network 접근을 OS 수준에서 제한합니다.
둘을 함께 사용해야 prompt injection이나 잘못된 명령에 대한 방어가 단단해집니다.
선택 기준
| 요구 | 사용 기능 |
|---|---|
| 프로젝트 전반의 지속 지침 | CLAUDE.md, .claude/rules/ |
| 반복 가능한 작업 절차 | Skills |
| 독립 context의 전문 작업 | Subagents |
| 작업 전후 자동 검사 | Hooks |
| 외부 서비스와 tool 연결 | MCP |
| 여러 확장 요소를 함께 배포 | Plugins |
공식 Features overview는 이 선택을 위한 기준 문서입니다. 프로젝트에 자체 workflow 형식을 만들기 전에 공식 기능으로 해결되는지 먼저 확인합니다.
실습
작은 읽기 전용 작업으로 agentic loop를 관찰합니다.
이 저장소의 테스트 실행 방법을 찾아줘.
파일은 수정하지 말고 package script와 관련 문서를 읽은 뒤,
실행할 명령과 예상되는 검증 범위를 먼저 설명해줘.
그다음 실행과 판단까지 요청합니다.
가장 좁은 관련 테스트를 실행해줘.
실패하면 원인을 추측하지 말고 오류, 관련 파일, 재현 명령을 근거로 정리해줘.
도구에 입력할 프롬프트
이 작업에 필요한 Claude Code 확장 방식을 선택해줘.
CLAUDE.md, Rules, Skills, Subagents, Hooks, MCP, Plugins를 비교하고,
가장 작은 공식 기능 하나로 해결 가능한지 먼저 판단해줘.
공식 문서에 없는 파일 형식이나 설정 키는 제안하지 마.
체크리스트
- 목표와 완료 조건을 구체적으로 적었다.
- Claude가 읽은 context와 실제 설정 source를 확인했다.
- tool 권한과 sandbox 경계를 구분했다.
- 실행 결과를 테스트·diff·실제 동작으로 검증했다.
- 반복 지침을 적절한 공식 확장 표면에 저장했다.
- 공식 문서에 없는 구성 형식을 만들지 않았다.
다음 단계
- CLAUDE.md 설정에서 지속 지침을 작성합니다.
- 스킬 시스템에서 반복 작업을 재사용합니다.
- 권한 관리와 샌드박싱에서 실행 경계를 설계합니다.