🧠
STEP 07
Claude Code로 에이전트 만들기
한 번 시키면 스스로 판단하고, 도구를 쓰고, 끝까지 해내는 AI. 에이전트의 개념과 만드는 법.
에이전트가 뭔가요
보통 AI는 *한 번 묻고 한 번 답합니다.* 에이전트(Agent)는 다릅니다. 목표를 주면 스스로:
1. 계획하고
2. 도구를 사용하고 (검색, 파일 읽기, API 호출…)
3. 결과를 보고 다음 행동을 결정하고
4. 목표에 닿을 때까지 반복합니다
비유: 직원에게 "이번 달 매출 정리해서 보고서 만들어줘"라고 하면, 알아서 데이터 찾고, 계산하고, 정리해서 가져옵니다. 그게 에이전트입니다.
사실 Claude Code 자체가 에이전트입니다. "이 버그 고쳐줘" 하면 파일을 뒤지고, 고치고, 테스트하고, 안 되면 다시 시도하죠.
무엇을 만들 수 있나
- 매일 뉴스 모아 요약해주는 에이전트
- 고객 문의를 읽고 분류·초안 답변하는 에이전트
- 경쟁사 가격을 확인해 알려주는 에이전트
만드는 법 — 3가지를 정하면 됩니다
에이전트 설계는 결국 세 가지입니다.
- 목적: 무엇을 이루게 할 것인가
- 도구: 무엇을 쓸 수 있게 할 것인가 (웹검색, DB, API…)
- 멈춤 조건: 언제 끝났다고 볼 것인가
Claude Code에게:
"고객 문의 이메일을 읽고, 종류별로 분류한 다음, 답변 초안을 만드는 에이전트를 만들어줘. 우리 FAQ를 참고하고, 애매하면 '사람 확인 필요'로 표시하게."
Claude Code가 Claude Agent SDK로 뼈대를 잡고, 도구를 연결하고, 반복 루프를 만들어 줍니다.
더 깊이
- 프로그래밍으로 직접 만들고 싶다면 Claude Agent SDK(개발자용)가 있습니다. "Agent SDK로 ~하는 에이전트 만들어줘"라고 하면 됩니다.
- 여러 에이전트를 협업시키는 것도 가능합니다: "찾는 에이전트 / 검증하는 에이전트 / 정리하는 에이전트로 나눠줘."
자세 하나
에이전트의 품질은 코드가 아니라 얼마나 목적과 경계를 분명히 말했는가에서 갈립니다. 무엇을, 어디까지, 무슨 도구로. 그 명료함이 곧 실력입니다.
다음, 마지막: 왜 상상력이 2026년 가장 중요한 능력인가.
📖 쉬운 용어 사전
어려운 말은 없습니다. 헷갈리면 여기를 보세요.
Claude Code — 자연어로 말하면 코드·파일·배포까지 해주는 AI 도구
호스팅 (Hosting) — 만든 사이트를 인터넷에 올려 주소를 주는 것 (예: Vercel)
데이터베이스 (Database) — 정보를 저장하고 기억하는 곳 (예: Supabase)
배포 (Deploy) — 만든 걸 실제 인터넷에 띄워 사람들이 쓰게 하는 것
API — 다른 서비스의 기능을 내 사이트에서 가져다 쓰는 연결 통로
API 키 (Key) — 그 API를 쓸 수 있게 해주는 비밀 열쇠
SaaS — 구독형 소프트웨어 — 설치 없이 인터넷으로 쓰는 서비스
크론 (Cron) — 정해진 시각마다 자동으로 작업을 실행하는 예약 기능
에이전트 (Agent) — 목표를 주면 스스로 판단·도구사용·반복해 끝내는 AI
환경변수 (Env) — API 키 같은 비밀값을 코드에 노출 않고 안전히 보관하는 곳
DNS — 도메인 주소를 실제 서버로 연결해주는 인터넷 전화번호부
프레임워크 (Framework) — 웹사이트를 빠르게 만들게 도와주는 기본 뼈대 (예: Next.js)