Claude 마스터 가이드 2편에서는 에이전트가 작동하는 4대 핵심 아키텍처, Traditional Chatbot과의 구체적 차이, 그리고 에이전트의 헌법인 CLAUDE.md 파일 작성법을 초보자의 눈높이로 상세히 학습합니다.
1. 에이전트의 4대 작업 아키텍처 (Agent Architecture)
Claude 에이전트가 단발성 대화를 넘어서 스스로 완료 조건을 달성하는 4단계 내부 프로세스입니다.
Input Context ──> Agentic Reasoning ──> Tool Execution ──> Verification Loop
(맥락 주입) (추론 및 계획) (도구 실행) (자동 검증)
- Input Context (입력 맥락 주입): 프로젝트 소스 코드,
CLAUDE.md행동 강령, 참고 레퍼런스 문서를 에이전트 메모리에 주입합니다. - Agentic Reasoning (추론 및 단계별 계획): 거대한 요구사항을 여러 개의 작은 실행 과제로 분정하고 우선순위를 세웁니다.
- Tool Execution (실제 도구 구동): 파일 수정, 터미널 명령어 실행, 외부 API 연동 도구를 직접 구동합니다.
- Verification Loop (자가 검증 루프): 빌드, 린트, 단위 테스트 스크립트를 구동하여 자신이 작업한 결과가 정상인지 검증합니다.
2. 대화형 챗봇 vs 에이전틱 워크플로우 대조표
| 비교 항목 | 대화형 챗봇 (Traditional Chat) | 에이전틱 워크플로우 (Agentic Workflow) |
|---|---|---|
| 작업 목표 | 텍스트 대화 메세지 렌더링 | 앤드투앤드 과제 완수 (파일 저장 및 배포) |
| 작업 방식 | 사람의 질문 ➔ AI 답변 (1:1 단순 대화) | 목표 설정 ➔ AI 추론 ➔ 도구 실행 ➔ 자가 검증 |
| 오류 처리 | 사람이 오타나 에러를 찾아 다시 질의 | 에이전트가 테스트 에러 로그를 읽고 스스로 코드 수정 |
| 자산 보존 | 대화 창을 닫으면 사용한 내용이 상실됨 | CLAUDE.md 및 skills/로 프로젝트 자산에 완전 보존 |
3. 에이전트의 헌법: CLAUDE.md 정밀 작성 튜토리얼
프로젝트 루트 디렉토리에 CLAUDE.md 파일을 만들어 두면, Claude는 작업을 시작할 때마다 이 지침을 최우선으로 준수합니다.
초보자용 CLAUDE.md 소스 코드 풀 예시
# CLAUDE.md - StudyFlow 프로젝트 에이전트 행동 지침서
## 1. 프로젝트 기본 정보
- 이 프로젝트는 Vanilla CSS와 JavaScript 기반의 AI 학습 웹 플랫폼입니다.
## 2. 개발 및 검증 명령어 (Commands)
- 로컬 실행: `npm run dev`
- 단위 테스트: `npm test`
- 배포 명령어: `npx wrangler deploy`
## 3. 코드 작성 스타일 규정 (Code Style & Rules)
- 모든 변수와 함수명은 영문 캐멀케이스(camelCase)를 사용합니다.
- HTML 태그 작성 시 접근성을 위해 반드시 `aria-label` 속성을 지정합니다.
- 테스트를 통과하지 못한 코드는 절대로 커밋하거나 배포하지 않습니다.
- 파일 수정 전 영향을 받는 상위 모듈 3개를 먼저 파악하고 작업하세요.