[AI활용] Claude Code 기본 구조 이해하기 — Agent · Skill · Context 개념 완전 정리

 

 

[ kt cloud FE개발팀 강민호 님 ]

📋 요약

이 글에서는 Claude Code의 핵심 구성 요소인 Agent, Skill, Context의 개념을
시스템 아키텍처 관점에서 다룹니다.
프롬프트 의존 방식의 한계를 넘어 AI 활용을 조직 차원에서
표준화하고 안정적으로 운영할 수 있는 구조적 기반을 정리합니다.

#ClaudeCode #AI에이전트 #LLMOps #프롬프트엔지니어링 #AI아키텍처

 

---

시리즈 2를 시작하며

Image: AI-Generated Content

 

시리즈 1에서는 왜 코딩 AI를 개인의 생산성 도구가 아니라 팀과 조직의 개발 아키텍처로 바라봐야 하는지를 다뤘다.

이제 질문은 다음 단계로 넘어간다.

그렇다면
Claude Code는 어떤 구조를 전제로 설계된 시스템인가?

 

이 글의 목적은 단순하다.
Claude Code에서 반복적으로 등장하는 Agent · Skill · Context라는 개념을 대화용 용어가 아니라 시스템 구성 요소로 정의하는 것이다.

---

Claude Code는 왜 ‘대화형 AI’가 아닌가

Image: AI-Generated Content

 

Claude Code를 처음 접하면 일반적인 Chat 기반 AI와 비슷해 보일 수 있다.

하지만 공식 문서를 읽다 보면, Claude Code는 AI를 대화 상대로 설명하지 않는다.

 

대신 이런 단어들이 반복된다.

• Agent
• Execution
• Task
• Workflow
• Responsibility

즉, Claude Code는 AI를 말을 잘하는 존재가 아니라 일을 수행하는 실행 주체로 전제한다.

이 차이가 이후 모든 구조를 결정한다.

---

Agent란 무엇인가

Image: AI-Generated Content

역할(Role)을 가진 실행 주체

Agent는 Claude Code 아키텍처의 핵심 단위다. Agent를 한 문장으로 정의하면 다음과 같다.

Agent는 특정 역할과 책임을 가진 실행 주체다.

 

중요한 점은 Agent가 다음과 같은 존재가 아니라는 것이다.

• 단순 프롬프트 ❌
• 대화 세션 ❌
• 범용 AI 인스턴스 ❌

Agent는 항상 다음을 전제로 한다.

• 어떤 역할을 수행하는가
• 어떤 작업(Task)을 담당하는가
• 어떤 입력과 출력을 가지는가

예를 들어, PR 리뷰 Agent, 문서 생성 Agent, 리팩토링 Agent 처럼 역할 단위로 정의된다.

📌 공식 문서에서는 이러한 Agent를 단일 AI가 아니라 여러 Agent가 협업하는 구조로 확장할 수 있음을 전제한다.

---

Skill이란 무엇인가

Image: AI-Generated Content

재사용 가능한 작업 단위

Agent가 “누구인가”라면, Skill은 “무엇을 할 수 있는가”에 해당한다.

Claude Code에서 Skill은 다음처럼 정의할 수 있다.

Skill은 Agent가 사용하는 재사용 가능한 작업 단위다.

 

여기서 중요한 점은, Skill이 “잘 작성된 프롬프트”와는 다르다는 것이다.

 

프롬프트는 다음과 같은 한계를 가진다.

• 개인에게 종속된다
• 버전 관리가 어렵다
• 테스트가 불가능하다
• 재사용이 불안정하다

반면 Skill은,

• 코드처럼 관리되고
• 설치 가능하며
• 버전 관리가 가능하고
• 여러 Agent에서 재사용된다

공식 문서에서도 Skill은 npm 패키지와 유사한 개념으로 설명된다.

즉, Skill은 AI 활용의 최소 실행 단위이자 조직 차원의 공유 자산이 된다.

---

Context란 무엇인가

Image: AI-Generated Content

의도적으로 설계된 정보 경계

Context는 종종 오해된다. Context = 프롬프트를 길게 쓰는 것” 이라는 인식 때문이다.

하지만 Claude Code에서 Context는 전혀 다르다.

Context는 Agent가 작업을 수행하기 위해
의도적으로 제공되는 제한된 정보 공간이다.

 

Context의 핵심은 제한이다.

• 모든 정보를 주지 않는다
• 필요한 정보만 제공한다
• 역할에 맞는 범위만 허용한다

이는 다음을 가능하게 한다.

• 예측 가능한 결과
• 일관된 실행
• 불필요한 토큰 낭비 방지

Prompt가 즉흥적 대화라면, Context는 설계된 실행 환경이다.

---

Agent · Skill · Context는 어떻게 연결되는가

Image: AI-Generated Content

 

이 세 가지는 독립적인 개념이 아니다. 항상 함께 작동한다.

구조적으로 표현하면 다음과 같다.

Agent
 ├─ uses → Skill
 └─ operates within → Context

• Agent는 역할과 책임을 가진다
• Skill은 Agent가 수행할 수 있는 기능이다
• Context는 그 기능이 실행되는 정보 경계다

이 구조 덕분에 Claude Code는 AI를 하나의 “똑똑한 존재”가 아니라 역할 분리된 시스템으로 다룰 수 있다.

왜 “프롬프트만 잘 쓰면 된다”는 말이 틀렸는가

프롬프트는 표준이 될 수 없다.

• 개인마다 다르고
• 공유되지 않으며
• 재현되지 않고
• 책임 분리가 불가능하다

Claude Code가 지향하는 것은 프롬프트를 더 잘 쓰는 방법이 아니다.

프롬프트에 의존하지 않아도 AI를 안정적으로 활용할 수 있는 구조다.

 

Agent · Skill · Context는 그 구조를 가능하게 만드는 최소 단위다.

---

시리즈 2를 마치며

이 글에서는 Claude Code의 핵심 개념을 대화 방식이 아니라 시스템 구조의 관점에서 정리했다.

• Agent는 역할을 가진 실행 주체
• Skill은 재사용 가능한 작업 단위
• Context는 설계된 정보 경계

이제 개념은 충분하다.

다음 글에서는 이 구조가 실제 실무에서 어떻게 사용되는지를 다룬다.

 

---

❓ 자주 묻는 질문 (FAQ)

Q. 이 구조가 실제 실무에 어떤 의미를 가지는가?

A. 프롬프트 중심 활용의 한계를 넘어서, AI 사용을 표준화할 수 있는 기반이 된다. Agent·Skill·Context 구조를 전제로 하면, 누가 실행해도 같은 결과가 나오는 AI 작업 흐름을 설계할 수 있고, 이는 곧 팀 단위·조직 단위의 AI 활용으로 확장될 수 있다.

---

📚 관련/출처

Claude Code Official Docs Claude Code overview - Claude Code Docs Claude Code – Skills Extend Claude with skills - Claude Code Docs Claude Code – Sub-agents Create custom subagents - Claude Code Docs