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

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

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

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

본격적으로 시작하기 전에, X에서 저를 팔로우해 주세요.

X -

https://x.com/ai_rohitt

무엇이 에이전트를 만드는가

Claude에게 "오늘 뭐라고 포스트해야 할까?"라고 묻는 것은 에이전트가 아닙니다. 그것은 채팅입니다.

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

차이는 모델이 아닙니다. 그것을 둘러싼 구조입니다.

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

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

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

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

한 단계 위: 도구가 활성화된 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 파일 템플릿.
13API 키를 하드코딩하지 마세요. 환경 변수에서 읽어오세요.

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

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시에 봇이 다음 내용이 포함된 메시지를 보냅니다:
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에서 저를 팔로우하세요.

X - https://x.com/ai_rohitt