장금상선 부산 계열사 대상 Zoom 시범강의

Claude Code 컴퓨터에서 움직이는 AI 에이전트

LLM에서 Agent로, 업무를 맡기는 법

샘플 데이터만 사용 Plan -> 실행 -> 검증
귀여운 해운 업무 캐릭터와 Claude 캐릭터가 함께 일하는 커버 이미지

Agenda

오늘은 LLM에서 Agent로 갑니다

01LLM의 장점과 한계잘하는 일과 막히는 지점
02Agent가 되는 조건목표, 환경, 도구, 실행, 피드백
03Claude Code 위임 루프읽기 -> 계획 -> 만들기 -> 검증 -> 권한
04두 가지 위임 시연메모 웹앱, 데이터 대시보드
05심화 주제와 Delegation명령, 스킬, MCP, 플러그인, Subagents

LLM

LLM은 맥락을 보고 답을 만듭니다

잘하는 일 막히는 지점 Agent가 필요한 이유
요약긴 내용을 짧게 정리
분류항목을 기준별로 나누기
초안메일, 보고서, 설명문 시작점
설명복잡한 개념을 쉬운 말로 변환
문장 개선톤과 목적에 맞게 다듬기
표 변환텍스트를 표 형태로 정리
아이디어여러 후보와 표현 제안
번역문맥을 반영한 자연스러운 변환

Limits

LLM은 답하지만 혼자 실행하지는 못합니다

환각확인하지 않은 내용을 그럴듯하게 말함
실행 불가방법은 말하지만 직접 작업하지 않음
환경 모름현재 폴더와 파일 상태를 보지 못함
반복성 부족실행 결과를 보고 루프를 돌기 어려움

이제 질문이 바뀝니다. “답을 잘하나?”보다 “일을 맡길 수 있나?”를 봅니다.

Why Agent

답변하는 AI에서 실행하는 AI로

채팅형 LLM

1
답변 생성
설명과 초안을 제공
2
사람이 실행
복사, 저장, 실행, 확인

Agent

1
환경을 봄
파일, 폴더, 로그 확인
2
도구로 실행
만들고, 돌리고, 검증

Evolution

LLM에 실행 능력을 붙이면 Agent

진화 그림 구성 요소 한계 보완
LLM + 목표 + 환경 + 도구 + 실행 + 피드백
LLM 캐릭터가 목표, 환경, 도구, 실행, 피드백을 얻으며 Agent로 진화하는 귀여운 이미지

Agent Anatomy

Agent가 되려면 무엇이 필요한가

목표무엇을 끝내야 하는가
환경어떤 파일과 상태를 볼 수 있는가
도구어떤 명령과 앱을 쓸 수 있는가
실행실제로 만들고 수정하는가
피드백결과를 보고 판단을 고치는가
권한어디까지 허용되는가
기록무엇을 했는지 남는가
검증완료를 어떻게 확인하는가

Problem -> Structure

Agent는 이 빈틈을 메웁니다

환각근거 확인과 검증
실행 불가도구와 명령 실행
환경 모름파일, 폴더, 로그 접근
반복성 부족피드백 루프
LLM의 문제를 Agent 구조로 해결하는 귀여운 설명 이미지

Claude Code

Claude Code는 내 폴더에서 일하는 Agent

채팅형 AIClaude Code
답변 생성파일 읽기와 수정
사람이 복사/붙여넣기작업 폴더에서 실행
현재 폴더 모름폴더 구조 파악
결과 확인은 사람명령과 파일로 검증
Claude Code가 폴더 읽기, 계획, 수정, 실행, 검증을 하는 귀여운 작업공간 이미지

How It Works

기능이 아니라 위임 순서로 봅니다

1 읽기 2 계획 3 만들기 4 검증 5 권한

“일을 맡기려면 먼저 상황을 알게 하고, 다음에 범위를 정하고, 마지막에 결과를 확인해야 합니다.”

Delegation Loop 01

자료를 읽혀야 추측이 줄어듭니다

읽기 계획 만들기 검증 권한 
처음에 볼 것
- 폴더 구조 살펴보기
- 파일 내용 요약하기
- 데이터 열과 형식 파악하기
- 기존 규칙 찾기

첫 질문

“이 폴더의 구성과 주요 파일을 먼저 설명해줘.”

Delegation Loop 02

계획을 보면 일의 방향이 보입니다

읽기 계획 만들기 검증 권한
어떤 파일을 만들지
어떤 파일을 수정할지
어떤 명령을 실행할지
어떻게 검증할지

계획은 멈추는 단계가 아니라, 맡길 범위를 맞추는 단계입니다.

Delegation Loop 03

대화가 아니라 결과물을 만듭니다

읽기 계획 만들기 검증 권한
Markdown요약, 보고, 강의 노트
CSV할 일, 표, 데이터 정리
HTML웹앱, 대시보드, 발표자료
Script반복 처리 자동화

Delegation Loop 04

맡긴 일은 검증까지 봐야 합니다

읽기 계획 만들기 검증 권한
ls outputs/ rg "샘플|가상" demo/ open dashboard.html OK file exists OK sample data only OK rendered successfully

Delegation Loop 05

권한은 얼마나 맡길지 정하는 장치입니다

읽기 계획 만들기 검증 권한
기본 읽기만 자동, 수정과 명령은 확인
Plan 분석과 계획 중심, 수정 전 멈춤
Auto 안전 검사와 함께 긴 작업 자동 진행
Danger 모든 확인 생략, 격리 환경 전용

업무가 민감할수록 권한은 좁게, 샘플 작업일수록 조금 넓게 둡니다.

Demo 1

샘플 메모를 웹앱으로 바꿉니다

메모 웹앱 루프 확인 CSV 대시보드 값 검증
입력가상 회의 메모 텍스트
처리요약, 이슈, 할 일, 담당자 분리
출력브라우저에서 열리는 HTML 웹앱
샘플 회의 메모가 웹앱 화면으로 정리되는 귀여운 이미지

Demo 1 Flow

메모 정리도 Plan -> Build -> Verify

Plan만들 화면과 기준 확인
BuildHTML, CSS, JS 생성
Open브라우저에서 화면 확인
Verify샘플 데이터와 항목 누락 확인
샘플 회의 메모를 읽고, 요약/할 일/이슈/담당자를 볼 수 있는 단일 HTML 웹앱을 만들어줘. 실제 회사 데이터로 보일 만한 내용은 넣지 마.

Demo 2

샘플 CSV를 대시보드로 바꿉니다

입력가상 CSV 데이터
처리지표, 표, 차트, 필터 구성
출력단일 HTML 대시보드
샘플 CSV 파일이 대시보드로 변환되는 귀여운 이미지

Demo 2 Verify

대시보드는 숫자가 맞아야 합니다

CSV 행 수가 맞는가
합계와 평균이 맞는가
차트 값이 표와 일치하는가
실제 회사명이나 민감 정보가 없는가
브라우저에서 화면이 깨지지 않는가
생성 파일 경로가 명확한가

Context

결국 Claude Code는 컨텍스트 관리 도구입니다

왜 컨텍스트가 핵심인가

LLM의 결과 품질은 곧 입력된 컨텍스트의 품질입니다. 좋은 답을 받으려면, 좋은 정보를 적절한 시점에 넣어줘야 합니다.

Claude Code가 하는 일

필요한 파일을 골라 읽기
상황에 맞는 규칙을 자동 주입
불필요한 정보는 잘라내기
결과를 다시 컨텍스트로 환원
Claude 캐릭터가 다양한 문서, 규칙, 도구에서 필요한 정보만 골라 컨텍스트 상자에 담는 귀여운 이미지

Context Map

컨텍스트를 다루는 여섯 가지 장치

CLAUDE.md항상 지킬 규칙
커스텀 커맨드반복 요청의 단축어
Skills절차와 기준 묶음
MCP외부 도구 연결
Plugins도구 묶음 설치
Subagents별도 컨텍스트의 작업자

모두 같은 목적입니다 — 매번 설명하지 않아도 Agent가 알 수 있게.

CLAUDE.md

같은 파일도 위치에 따라 적용 범위가 다릅니다

글로벌~/.claude/CLAUDE.md모든 프로젝트
프로젝트<repo>/CLAUDE.md해당 레포
서브폴더<repo>/sub/CLAUDE.md특정 모듈

글로벌에 둘 것

개인 작업 스타일·톤
기본 도구(uv, bun 등)
전역 안전 규칙

프로젝트에 둘 것

폴더 구조와 네이밍
도메인 용어와 정책
샘플 데이터 사용 원칙

docs.claude.com/en/docs/claude-code/memory

CLAUDE.md Best Practice

짧게, 명령형으로, 왜 그런지 같이

# 장금상선 프로젝트 규칙
- 실제 회사 데이터·고객명 사용 금지
  · 데모용 합성 데이터만 사용
- 수정 전 계획을 먼저 제시
  · 큰 변경은 승인 후 진행
- 결과는 파일로 남기고 경로를 보고
- 검증 결과를 마지막에 요약

체크리스트

짧게 — 한 줄 한 규칙
명령형 — "하지 마", "반드시"
왜인지 함께 — 엣지 케이스 판단용
파일·도구에서 알 수 있는 건 생략
자주 깨지는 약속을 우선 적기

Advanced 01

자주 쓰는 요청은 명령어로

Command Skills MCP Plugins Subagents

쓸 때

반복되는 보고 형식
정해진 검증 절차
매번 쓰는 작업 지시
“샘플 데이터를 점검하고, 누락/중복/민감정보 여부를 같은 형식으로 보고해줘.”

docs.claude.com/en/docs/claude-code/slash-commands

Advanced 02

반복 절차는 Skill로 묶습니다

Command Skills MCP Plugins Subagents
언제특정 작업이 반복될 때
무엇을절차, 기준, 스크립트 묶음
효과매번 설명하지 않아도 됨
예시이미지 생성, PPT, Notion 동기화

예: NomaDamas/k-skill 한 줄 연결 → 한국인용 86개 스킬을 한 번에 컨텍스트에 붙입니다.

docs.claude.com/en/docs/agents-and-tools/agent-skills/overview

Advanced 03

MCP는 외부 도구를 연결합니다

Command Skills MCP Plugins Subagents
파일 저장소Drive, 문서, 폴더
업무 시스템Notion, 캘린더, DB
검색 도구자료 수집과 검증
사내 도구권한 설계 후 연결

도구를 붙일수록 권한과 로그를 더 꼼꼼히 봐야 합니다.

docs.claude.com/en/docs/claude-code/mcp

Advanced 04

Plugin은 업무용 도구 세트입니다

Command Skills MCP Plugins Subagents

Plugin이란?

Skills, MCP 서버, 앱 연결, 설정을 한 번에 설치하는 패키지입니다.

묶이는 것

Skills
MCP 서버
앱 연결
도구 설정

개별 기능을 하나씩 붙이는 대신, 업무 목적에 맞는 세트를 통째로 추가합니다.

docs.claude.com/en/docs/claude-code/plugins

Advanced 05

Subagent는 별도 컨텍스트의 작업자입니다

Command Skills MCP Plugins Subagents
새 컨텍스트메인 대화를 어지럽히지 않음
병렬 작업독립 작업을 나눠 동시에 진행
특화 역할리서치, 분석, 테스트, 코딩
도구·권한역할별 접근 범위 설정

긴 리서치와 로그 탐색은 따로 맡기고, 메인 대화에는 요약 결과만 가져옵니다.

docs.claude.com/en/docs/claude-code/sub-agents

Delegation

Claude Code는 업무를 맡기는 도구입니다

반복 정리 업무를 맡긴다
초안과 구조화를 맡긴다
검증 기준은 사람이 잡는다
판단과 커뮤니케이션에 시간을 쓴다

목표는 AI 자랑이 아니라 생산성 향상입니다.

사람이 Claude Agent에게 업무 일부를 위임하는 귀여운 이미지

Closing

잘 맡기면, 일하는 속도가 달라집니다

오늘 가져갈 한 문장

Agent는 업무 일부를 맡기는 도구입니다.

강사 메모

반복 업무는 맡기고, 사람은 판단에 시간을 씁니다.

Claude Code 시범강의 · 샘플 데이터 기반