AI 에이전트: 개념부터 나만의 에이전트 구축 단계별 가이드

모두가 AI 에이전트에 대해 이야기하고 있습니다. 하지만 대부분의 사람에게 에이전트가 정확히 무엇인지 물어보면 "자율적으로 작업을 수행하는 AI"라는 모호한 답변만 돌아옵니다.

실제 모습은 그보다 훨씬 유용합니다. 에이전트는 하나의 범주가 아닙니다. 그것은 스펙트럼입니다.

이 가이드는 다양한 AI 도구가 그 스펙트럼 중 어디에 위치하는지, 기본적인 LLM 상호작용과 진정한 에이전틱 워크플로우를 구분하는 요소는 무엇인지, 그리고 Claude Code로 나만의 에이전트를 만들고 코드를 직접 작성하지 않고도 Telegram에 연결하는 방법을 설명합니다.

본격적으로 시작하기 전에, X에서 저를 팔로우하고 제가 방금 만든 Telegram 채널에 가입해 주세요. 두 채널 모두 무료입니다. 매일 더 많은 AI 콘텐츠를 게시합니다.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp

무언가를 에이전트로 만드는 요소

Claude에게 "오늘 뭐 올릴까?"라고 묻는 것은 에이전트가 아닙니다. 그건 채팅입니다.

Claude에게 "지금 AI 분야에서 트렌딩 중인 세 가지 주제를 찾고, 그중 참여율이 가장 높을 주제를 골라 내 스타일로 게시글을 작성한 후 파일로 저장해 줘"라고 말하고, Claude가 당신이 아무것도 건드리지 않아도 이 모든 작업을 수행한다면, 그것이 바로 에이전트입니다.

차이점은 모델이 아닙니다. 그 주변의 구조입니다.

에이전트는 일반 채팅에는 없는 세 가지를 가지고 있습니다. 스스로 호출할 수 있는 도구: 검색, 파일 시스템, 코드 실행, 외부 API. 단일 세션 내에서 뿐만 아니라 작업 전반에 걸쳐 지속되는 메모리. 그리고 하나의 응답을 생성할 때까지가 아니라 작업이 완료될 때까지 계속 실행되는 루프.

이 세 가지를 더 많이 추가할수록, 당신의 개입은 줄어듭니다. 그것이 핵심 아이디어입니다.

스펙트럼: 채팅에서 에이전트까지

한쪽 끝에는 기본 채팅이 있습니다. 당신이 질문하고, Claude가 답하며, 세션이 종료됩니다. 도구도 없고, 지속적인 목표도 없으며, 세상에서 실제로 행동할 능력도 없습니다.

한 단계 위: 도구가 활성화된 Claude. Claude가 답변하기 전에 웹을 검색하거나, 첨부 파일을 읽거나, 이미지를 생성할 때, 이미 약간의 에이전트성을 띱니다. 당신이 단계별로 지시하지 않았지만, 스스로 필요하다고 판단한 것입니다.

더 위로: 다단계 워크플로우. 당신이 목표를 주면 Claude가 그것을 단계로 나누고, 각 단계를 실행하며, 결과를 확인하고, 완성된 출력물을 제공합니다. 단계 사이에 당신은 개입하지 않습니다.

최상위: 완전 자율 에이전트. 에이전트는 일정에 따라 실행되고, 입력을 모니터링하며, 외부 서비스를 호출하고, 인간의 개입 없이 복잡한 작업을 완료합니다. 당신은 목표를 한 번 설정하고 출력물을 확인합니다.

최하위와 최상위의 차이는 다른 모델이 아닙니다. 모델을 둘러싼 것, 즉 호출할 수 있는 도구, 맥락을 전달하는 메모리, 작업이 끝날 때까지 계속 실행되는 루프입니다.

오늘 구축할 수 있는 에이전트 유형

오늘날 에이전트가 실제로 어떤 모습일 수 있는지 감을 잡기 위해 아래에 몇 가지 예시를 준비했습니다. 이것이 한계는 아닙니다. 당신의 특정 상황에 맞는 어떤 것이든 구축할 수 있습니다.연구 에이전트: 주제에 대한 정보를 수집하고, 여러 소스를 읽고, 중요한 내용을 추출하여 구조화된 요약을 제공합니다. 질문을 주면 수동으로 컴파일하는 데 몇 시간이 걸렸을 답변을 제공합니다.

작문 에이전트: 당신이 정의한 시스템에 따라 콘텐츠를 작성합니다. 당신의 어조, 형식, 대상 독자, 주제를 제공하세요. 모든 문장을 관리하지 않고 초안 작성, 재작성, 편집을 처리합니다.

코드 에이전트: 코드를 작성하고, 실행하고, 오류를 읽고, 수정하고, 계속 진행합니다. 코드가 수행해야 할 작업을 설명하세요. 에이전트가 구현 및 디버깅 루프를 처리합니다.

비즈니스 에이전트: 반복적인 업무 작업(이메일 초안 작성, 고객 요청 처리, 리드 자격 평가, 보고서 생성)을 처리합니다. 규칙을 정의하면 자동 파일럿으로 실행됩니다.

개인 에이전트: 일정 관리, 작업 구성, 브리핑 준비, 매일 수동으로 수행하는 계획 작업을 처리합니다.

첫 번째 에이전트 구축 - 여기서 시작하세요

Claude Code를 사용하여 원격 서버에서 실행되고 Claude를 두뇌로 사용하는 Telegram 봇을 구축할 것입니다. Claude Code가 모든 코드를 작성합니다. 당신은 원하는 것을 평범한 영어로 설명하기만 하면 됩니다. 설정이 완료되면 모든 봇과의 통신이 Telegram을 통해 직접 이루어집니다.

전체 설정에는 약 10-20분이 소요됩니다. 코딩 방법을 알 필요가 없습니다.

시스템 프롬프트 템플릿 - 프롬프트 2에 붙여넣기

아래 설정에서 프롬프트 2를 실행할 때, 어떤 종류의 에이전트를 원하는지 설명해야 합니다. 바로 사용할 수 있는 템플릿입니다. 적합한 것을 복사하여 프롬프트 2의 "에이전트는 다음과 같아야 합니다:" 부분에 붙여넣으면 Claude Code가 해당 에이전트를 구축합니다. 상황에 맞게 세부 사항을 조정하세요.

연구 에이전트

1당신은 연구 에이전트입니다. 당신의 임무는 제가 주는 모든 주제에 대한 정보를 수집, 분석 및 종합하는 것입니다.
2
3연구 작업이 주어지면:
41. 답변해야 할 가장 중요한 하위 질문 3-5개를 식별하세요.
52. 각 질문에 대한 정보를 검색하세요.
63. 각 출처의 품질과 관련성을 평가하세요.
74. 질문에 직접적으로 답하는 내용만 추출하세요.
85. 주요 발견 사항, 뒷받침 증거, 채울 수 없었던 격차를 포함한 구조화된 요약을 제공하세요.
9
10형식: 제목, 글머리 기호, 명확한 섹션을 사용하세요.
11무언가 확실하지 않으면 명시적으로 그렇게 말하세요.
12불필요한 내용을 추가하지 마세요. 모든 문장에는 정보가 포함되어야 합니다.

작문 에이전트

1당신은 작문 에이전트입니다. 당신은 제 목소리와 스타일로 콘텐츠를 작성합니다.
2
3내 스타일:
4- 대화체, 직설적, 형식적인 언어 없음
5- 짧은 문장과 문단
6- 모호한 주장 대신 구체적인 숫자와 예시
7- 항상 독자가 해야 하거나 생각해야 할 것으로 끝맺음
8
9작문 작업이 주어지면:
101. 제공되지 않은 경우 주제, 대상 독자, 원하는 길이를 물어보세요.
112. 첫 번째 초안을 작성하세요.
123. 내 스타일 규칙에 따라 검토하세요.
134. 게시할 준비가 된 최종 버전을 제공하세요.
14
15불필요한 서론을 추가하지 마세요. 가장 중요한 요점부터 시작하세요.

코드 에이전트

1당신은 코드 에이전트입니다. 당신의 임무는 코드를 작성, 디버그 및 개선하는 것입니다.
2
3코딩 작업이 주어지면:
41. 코드가 수행해야 하는 작업에 대한 이해를 확인하세요.
52. 명확한 주석과 함께 솔루션을 작성하세요.
63. 모든 예외 사항이나 잠재적 실패를 식별하세요.
74. 오류가 있는 경우 도움을 요청하기 전에 체계적으로 디버그하세요.
8
9규칙:
10- 의미 있는 변수 이름으로 깔끔하고 읽기 쉬운 코드를 작성하세요.
11- 항상 오류 처리를 포함하세요.
12- 각 주요 섹션이 수행하는 작업을 평이한 언어로 설명하세요.
13- 요구 사항이 확실하지 않으면 진행하기 전에 명확히 하는 질문을 하나 하세요.

비즈니스 이메일 에이전트

1당신은 비즈니스 이메일 에이전트입니다. 당신은 저를 대신하여 전문적인 이메일을 작성합니다.
2
3내 커뮤니케이션 스타일:
4- 직설적이고 정중함
5- 불필요한 형식 없음
6- 첫 문장에서 요점을 전달함
7- 명확한 다음 단계로 마무리함
8
9이메일 작업이 주어지면:
101. 이메일의 목표를 식별하세요 (정보 제공, 요청, 후속 조치, 확인).
112. 이메일의 목적을 반영하는 제목 줄을 작성하세요.
123. 최대 3-5개의 짧은 문단으로 이메일을 초안 작성하세요.
134. 하나의 명확한 실행 항목 또는 다음 단계로 끝내세요.
14
15항상 작성 완료된 이메일을 작성하고, 빈칸을 채워야 하는 템플릿은 작성하지 마세요.

개인 계획 에이전트

1당신은 나의 개인 계획 에이전트입니다. 당신은 제 업무를 정리하고, 작업의 우선순위를 정하며, 제 주간 계획을 세우는 것을 돕습니다.
2
3제가 작업이나 목표를 공유하면:
41. 긴급한 것과 중요한 것을 식별하세요.
52. 종속성을 기반으로 현실적인 순서를 제안하세요.
63. 각 작업에 필요한 예상 시간을 추정하세요.
74. 위임하거나 제거할 수 있는 것을 표시하세요.
8
9제가 프로젝트를 설명하면:
10- 구체적인 다음 행동으로 나누세요.
11- 가장 먼저 해야 할 가장 중요한 한 가지를 식별하세요.
12- 제가 따를 수 있는 간단한 체크리스트를 만드세요.
13
14모든 것을 실용적으로 유지하세요. 동기 부여를 위한 내용은 넣지 마세요. 계획만 제공하세요.

시작하기 전에 필요한 것

1 - console.anthropic.com의 Claude API 키. 이는 개발자 키로, 고정 월 사용료가 아닌 사용량에 따라 비용을 지불합니다. 하루 50개의 메시지를 보내는 개인 봇의 경우 선택한 모델에 따라 월 1-5달러의 비용이 듭니다.

2 - BotFather의 Telegram 봇 토큰.

3 - Linux를 실행하는 VPS. 개인 Telegram 봇의 경우 강력한 성능은 필요하지 않습니다. CPU 1개, RAM 1GB, 스토리지 20GB면 충분합니다. DigitalOcean, Hetzner 또는 Vultr의 기본 요금제면 충분하며 월 약 4달러에서 6달러 정도입니다. 서버가 준비되면 터미널에서 npm i -g @anthropic-ai/claude-code 를 실행하여 Claude Code를 설치하세요.

봇에 사용할 Claude 모델과 실제 비용:

대부분의 개인 봇의 경우 Sonnet 4.6이 적절한 선택입니다. 모든 작업에 충분히 강력하고 일일 사용에 적합한 가격입니다. 비용을 최소화하려면 Haiku 4.5를 사용하세요. Opus 4.8은 답변 품질이 중요한 복잡한 분석 에이전트에만 적합합니다.

첫 번째 에이전트 구축 - 1단계

VPS 터미널을 열고 Claude Code를 실행하세요. 이 프롬프트를 붙여넣으면 모든 것이 구축됩니다.

에이전트에 성격 부여하기

1Claude API를 두뇌로 사용하는 Telegram 봇을 구축해 주세요.
2
3요구 사항:
4- 언어: Python
5- Telegram 라이브러리: python-telegram-bot
6- Claude 모델: claude-sonnet-4-6
7- 봇은 메시지를 수신하여 Claude API로 보내고 Claude의 응답을 Telegram으로 반환합니다.
8- 사용자별 대화 기록을 유지합니다. 각 사용자는 세션 내에서 자신의 컨텍스트를 갖습니다.
9- 봇을 소개하는 /start 명령어를 추가하세요.
10- 해당 사용자의 대화 기록을 초기화하는 /clear 명령어를 추가하세요.
11
12필요한 모든 파일을 생성하세요: 메인 봇 파일, requirements.txt, API 키용 .env 파일 템플릿.
13어떤 API 키도 하드코딩하지 마세요. 환경 변수에서 읽어오세요.

백그라운드 서비스로 배포하기

1이 봇이 내 Linux VPS에서 자동으로 실행되고 충돌 시 다시 시작되도록 systemd 서비스 파일을 생성하세요.
2
3서비스는 다음을 수행해야 합니다:
4- 서버 부팅 시 자동으로 시작
5- 충돌 시 자동으로 다시 시작
6- 프로젝트 폴더의 .env 파일에서 환경 변수 로드
7- 나중에 확인할 수 있도록 로그를 파일에 저장
8
9서비스를 설치하고, 시작하고, 실행 중인지 확인하고, 로그를 보기 위한 정확한 터미널 명령어도 작성해 주세요.

세션 간 지속 메모리 추가하기

1봇이 다시 시작되면 대화 기록이 사라집니다. 이 문제를 해결하세요.
2
3각 메시지 후에 각 사용자의 대화 기록을 디스크의 JSON 파일에 저장하세요. 봇이 시작될 때 자동으로 다시 로드하세요.
4
5최대 기록 길이를 추가하세요. 사용자당 마지막 20개의 메시지만 유지하여 컨텍스트 창이 너무 길어지지 않도록 하세요.

Claude Code 봇에 스킬 추가하기

스킬은 시간이 지남에 따라 봇에 추가하는 기능입니다. 각 스킬은 Claude Code에 제공하는 새로운 프롬프트이며, Claude Code가 이를 작동시키는 코드를 작성합니다. 다음은 가장 유용한 스킬들입니다.

스킬: 웹 검색

에이전트가 메모리에서만 답변하는 대신 실시간 정보를 조회할 수 있습니다.

1Tavily API를 사용하여 봇에 웹 검색 기능을 추가하세요.
2
3사용자가 뉴스, 가격, 최근 사건과 같은 최신 정보가 필요한 것을 물으면 봇이 자동으로 웹을 검색하고 결과를 응답에 포함시킵니다.
4
5봇은 언제 검색하고 언제 메모리에서 답변할지 스스로 결정해야 합니다. .env 파일 템플릿에 TAVILY_API_KEY를 추가하세요.
6
7이를 깔끔하게 구현하려면 Claude의 도구 사용 기능을 활용하세요.

스킬: 메모 저장

에이전트가 당신이 말하는 모든 것(아이디어, 작업, 연구 결과)을 파일에 저장하고 나중에 검색할 수 있습니다.

1봇에 메모 저장 기능을 추가하세요.
2
3사용자가 "저장해 줘", "기억해 줘", 또는 "메모:"라고 말하면 봇은 타임스탬프와 함께 내용을 notes.txt 파일에 저장합니다.
4
5마지막 10개의 저장된 메모를 반환하는 /notes 명령어를 추가하세요.
6저장된 모든 메모를 삭제하는 /clearnotes 명령어를 추가하세요.

스킬: 내 계정으로만 제한하기

기본적으로 봇을 찾는 사람은 누구나 봇을 사용하여 API 크레딧을 소비할 수 있습니다. 이 기능은 나만 사용할 수 있도록 잠급니다.

1봇에 사용자 제한을 추가하여 나만 사용할 수 있도록 하세요.
2
3내 Telegram 사용자 ID를 ALLOWED_USER_ID로 .env 파일에 추가하세요.
4다른 사람이 봇에게 메시지를 보내면 "이 봇은 비공개입니다."라고 응답하고 해당 사용자의 모든 추가 메시지를 무시합니다.
5
6봇 자체를 통하거나 다른 방법을 통해 내 Telegram 사용자 ID를 찾는 방법도 추가하세요.

스킬: API 비용 추적

Claude API는 토큰당 비용을 청구합니다. 이 기능은 간단한 비용 추적기를 추가하여 지출 금액을 항상 알 수 있도록 합니다.

1봇에 기본 비용 추적 기능을 추가하세요.
2
3각 Claude API 응답 후에 사용된 입력 토큰 수와 출력 토큰 수를 기록하세요.
4costs.json 파일에 누계를 유지하세요.
5
6다음을 보여주는 /costs 명령어를 추가하세요: 오늘 사용된 총 토큰 수, 전체 기간 동안 사용된 총 토큰 수, claude-sonnet-4-6 가격을 기준으로 한 예상 비용(USD).

스킬: 예정된 일일 브리핑

에이전트가 당신이 묻지 않아도 매일 아침 메시지를 보냅니다.

1봇에 예정된 일일 브리핑을 추가하세요.
2
3매일 오전 8:00에 봇이 다음 내용이 포함된 메시지를 보냅니다:
41. 동기 부여 한 줄 (짧고, 촌스럽지 않은)
52. 오늘의 최우선 순위를 확인하라는 알림
63. 생산성 또는 AI에 대한 무작위 유용한 사실 하나
7
8.env 파일의 내 Telegram 사용자 ID로 보내세요.
9이 기능을 구현하려면 schedule 또는 APScheduler 라이브러리를 사용하세요.

설정 후 알아두면 유용한 사항

에이전트의 성격을 업데이트하는 방법. 메인 봇 파일을 열고 상단의 시스템 프롬프트 변수를 찾아 변경한 후 파일을 저장하고 sudo systemctl restart your-bot-name 으로 서비스를 다시 시작하세요. 새 성격이 즉시 적용됩니다.

봇이 실행 중인지 확인하는 방법. 터미널에서 sudo systemctl status your-bot-name 를 실행하세요. "active (running)"이라고 표시되면 정상 작동 중입니다. "failed"라고 표시되면 로그를 확인하세요.

로그를 읽는 방법. journalctl -u your-bot-name -n 50 를 실행하여 마지막 50줄을 확인하세요. 문제가 발생했을 때 오류 메시지를 찾을 수 있는 곳입니다.

새 스킬을 추가하는 방법. 프로젝트 폴더에서 Claude Code를 열고 원하는 것을 설명하세요: "봇에 X 기능을 추가해 줘." Claude Code가 기존 코드를 읽고 새 기능을 깔끔하게 추가하며 다시 시작이 필요한지 알려줍니다.

모든 에이전트가 가진 메모리 문제

이것은 사람들이 가장 자주 겪는 문제입니다. 에이전트는 세션 간, 긴 작업 도중, 너무 많은 메시지 이후에 컨텍스트를 잃고 실수를 하거나 이미 수행한 작업을 반복하기 시작합니다.

이 문제는 세 가지 방식으로 발생합니다:

긴 작업은 결국 Claude의 컨텍스트 제한을 초과하게 되고, 에이전트는 대화의 시작 부분(원래 목표, 이미 내린 결정, 설정한 제약 조건)을 잃기 시작합니다. -

세션을 종료하고 새 세션을 열면 에이전트는 처음부터 다시 시작합니다. -

에이전트가 작업 중간에 중단되면 중단된 지점을 알 방법이 없습니다.

네 가지 방법으로 이 문제를 해결할 수 있습니다:

에이전트에게 주요 단계 후에 진행 상황 노트를 작성하도록 지시하세요: 완료된 작업, 결정된 사항, 아직 수행해야 할 작업. 다음 세션 시작 시 해당 노트를 붙여넣어 전체 컨텍스트를 복원하세요. -

10-15개 메시지마다 에이전트에게 현재 위치를 요약하도록 요청하세요. 이렇게 하면 컨텍스트가 오버플로되기 전에 압축하도록 강제합니다. -

대화가 너무 길어지기 전에 에이전트에게 모든 것을 짧은 요약으로 압축하고 거기서부터 계속하도록 요청하세요. 스레드는 그대로 유지됩니다. -

봇 코드의 시스템 프롬프트에 에이전트가 항상 필요로 하는 핵심 사실을 직접 추가하세요. Claude는 모든 대화 시작 시 이를 읽으므로, 아무리 길어져도 해당 정보는 항상 컨텍스트에 있습니다.

체크포인트 프롬프트

1계속하기 전에 간단한 체크포인트를 작성하세요:
21. 지금까지 완료한 것은 무엇인가요?
32. 이 세션의 주요 결정 또는 발견 사항은 무엇인가요?
43. 아직 완료해야 할 것은 무엇인가요?
54. 새 세션에서 이 작업을 계속하는 데 필요한 컨텍스트는 무엇인가요?
6
7200단어 미만으로 유지하세요.

메모리 파일 프롬프트

1각 주요 단계를 완료한 후 다음 형식으로 메모리를 기록하세요:
2
3완료된 단계: [수행한 작업]
4주요 결정: [내린 선택과 그 이유]
5현재 상태: [작업의 현재 진행 상황]
6다음 단계: [다음에 수행해야 할 작업]
7
8이 메모는 컨텍스트를 잃지 않고 새 세션에서 작업을 재개하는 데 사용됩니다.

컨텍스트 복구 프롬프트

1이전 세션의 작업을 재개합니다. 다음은 컨텍스트입니다:
2
3[여기에 메모리 노트를 붙여넣으세요]
4
5이를 바탕으로:
61. 현재 위치에 대한 이해를 확인하세요.
72. 다음 단계를 식별하세요.
83. 계속하는 데 필요한 질문을 하세요.
9
10이미 완료된 작업을 반복하지 마세요.

롤링 요약 프롬프트

1대화가 길어지고 있습니다. 중요한 모든 것을 요약으로 압축하세요:
2
31. 원래 목표
42. 완료된 작업과 발견된 사항
53. 내린 주요 결정
64. 아직 수행해야 할 작업
7
8요약을 작성한 후 거기서부터 계속하세요. 이 요약을 새로운 시작점으로 취급하세요.

이제 에이전트가 무엇인지, 무엇을 할 수 있는지, 그리고 직접 하나를 구축하는 방법을 알게 되었습니다. 이 가이드가 도움이 되었기를 바랍니다.

AI 분야의 모든 최신 소식을 놓치지 않으려면 X와 Telegram에서 저를 팔로우하세요.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp