AI 에이전트 중급: 원리와 설계
AI 에이전트 중급 코스는 클로드 코드나 코덱스 같은 도구 이름과 상관없이 통하는 에이전트의 작동 원리와 설계 방법을 12가지 개념으로 정리한 코스입니다. 에이전트를 몇 번 써 본 뒤 결과가 왜 매번 다른지, 어디까지 맡겨도 되는지, 비용은 왜 이렇게 나오는지가 궁금해진 분들을 위해 만들었습니다.
화면과 명령어 및 권한 조건은 제품마다 다릅니다. 모델이 도구를 요청하고 프로그램이 실행한 결과를 다시 확인한다는 공통 원리부터 살펴봅니다. 이 코스는 그 구조를 먼저 잡고, 각 도구의 사용법은 기존 입문 코스로 연결합니다.
📝 처음이라면 모임 메모 하나부터
준비물은 메모장뿐입니다. 이 안내의 가상 자료인 ‘10월 12일 오후 2시, 준비물 책 한 권’을 날짜와 시각, 장소, 준비물 순서의 세 줄로 정리해 봅니다. 장소는 자료에 없으므로 미정이어야 합니다. 이후 지침 파일 수업에서 원문에 없는 항목을 채우지 않는 규칙을 적고 검수 수업에서 결과를 원자료와 대조합니다.
날짜와 시각 및 준비물이 유지되고 장소를 지어내지 않았는지 확인합니다. 틀렸다면 근거 없는 장소를 미정으로 고치고 다시 읽습니다. 다음 연습에서는 원문에 ‘도서관 2층’을 추가해 장소만 바뀌는지 봅니다. 무엇을 확인해서 고쳤는지 설명할 수 있으면 첫 학습을 마친 것입니다.
이 과정은 개념과 판단 연습입니다. 실제 AI 도구를 실행하려면 해당 제품의 설치와 계정 및 사용량 조건을 별도로 확인합니다. 아래 모든 개념을 먼저 끝낼 필요는 없습니다.
📚 다루는 개념 12가지
- 작동 원리: AI 에이전트 뜻, 에이전트 루프와 도구 호출, 멀티 에이전트 오케스트레이션
- 지침과 작업 환경: AGENTS.md와 CLAUDE.md, intent.md, 하네스 엔지니어링
- 믿고 맡길 수 있는지 확인하기: 보상 해킹, 장기 과제와 컴퓨터 조작의 한계, 에이전트 검수와 평가
- 자료와 비용: RAG, 프롬프트 캐시, BYOK와 API 비용 구조
처음에는 위 모임 메모 경로를 따라가고 나머지는 필요할 때 고릅니다. 자료에서 답을 찾고 싶으면 RAG, 비용을 확인하고 싶으면 BYOK와 프롬프트 캐시, 긴 일을 이어 가고 싶으면 장기 과제 수업으로 갑니다. 요금과 한도, 지원 여부처럼 바뀌는 사실에는 편마다 확인한 날짜를 붙였습니다.
❓ 자주 묻는 질문
에이전트를 직접 만들지 않아도 이 코스가 필요한가요?
이미 제공되는 도구를 쓸 때도 요청과 실제 실행 및 완료 보고를 구분하는 데 도움이 됩니다. 메모장만 쓰는 연습으로 시작할 수 있고 특정 설정 파일이나 여러 작업자 실행이 필수는 아닙니다.
클로드 코드 입문 코스와 무엇이 다른가요?
클로드 코드 입문 코스는 설치와 메모리, 서브에이전트, 훅처럼 클로드 코드의 기능 사용법을 다룹니다. 이 코스는 그 기능들이 왜 그렇게 설계되었는지를 도구와 상관없는 원리로 설명하고, 해당 기능의 사용법은 입문 코스의 편으로 연결합니다.
어느 편부터 읽으면 되나요?
에이전트라는 말 자체가 낯설다면 첫 두 편부터 읽습니다. 결과가 들쭉날쭉한 것이 고민이라면 하네스 엔지니어링과 검수와 평가 편을, 비용이 고민이라면 프롬프트 캐시와 BYOK 편을 먼저 봐도 됩니다.
🔗 함께 보는 코스
- 비개발자를 위한 Claude Code: 이 코스에서 원리로 다룬 메모리, 서브에이전트, 훅의 실제 사용법을 다룹니다
- 클로드 기초 교육: 컨텍스트 윈도우와 할루시네이션처럼 에이전트의 한계를 이해하는 데 필요한 모델의 성질을 다룹니다
- 바이브코딩 기초지식: 에이전트에게 코드 작업을 맡기기 전에 알아 둘 개발 환경의 기본을 다룹니다
세 줄로 먼저 읽기
이번 방문에서 한 편은 바로 볼 수 있습니다.
AI 에이전트(AI Agent) 뜻과 챗봇, 워크플로의 차이
목표와 중간 결과를 바탕으로 모델이 다음 행동과 도구 사용을 정하는 AI 시스템입니다. 실제 실행은 연결된 프로그램이 맡으며 완료 여부와 중단 조건을 확인해야 합니다.
에이전트 루프와 도구 호출(Tool Calling) 원리
모델의 도구 요청을 프로그램이 실행하고 결과를 돌려준 뒤 모델이 다음 행동을 정하는 반복 구조입니다. 완료 응답뿐 아니라 오류와 사용 한도 및 중단 조건도 구분해 처리합니다.
AGENTS.md와 CLAUDE.md(에이전트 지침 파일) 뜻과 작성법
에이전트 지침 파일은 AI가 작업할 때 참고할 규칙을 모은 문서입니다. AGENTS.md는 여러 코딩 도구가 지원하는 공개 형식이고 CLAUDE.md는 Claude Code의 지침 파일이며 실제 로드 조건은 도구와 설정에 따라 다릅니다.
intent.md 뜻과 작성법: 왜 하는지를 적는 파일
intent.md는 코드를 쓰기 전에 무엇을 왜 만들지와 누가 영향을 받는지, 아직 정하지 못한 것을 적어 두는 일감 단위 문서입니다. 앤트로픽이 2026년 8월 공개한 AI 네이티브 개발 플레이북의 첫 단계 문서입니다.
하네스 엔지니어링(Harness Engineering) 뜻과 구성
하네스 엔지니어링은 AI 에이전트가 일하는 환경과 규칙, 결과를 확인하고 고치게 하는 장치를 설계하는 일입니다. 에이전트를 모델과 하네스의 합으로 보고, 모델을 뺀 나머지 전부를 다룹니다.
멀티 에이전트 오케스트레이션(Multi-Agent Orchestration) 뜻과 설계
멀티 에이전트 오케스트레이션은 여러 에이전트의 작업과 정보 전달 및 결과 확인을 조율하는 일입니다. 메인이 작업자에게 일을 나눠 맡기고 합치는 구조가 대표적인 예입니다.
보상 해킹(Reward Hacking) 뜻과 테스트 통과 편법
보상 해킹은 AI가 목표 달성을 판정하는 장치의 빈틈을 이용해 실제로 일을 해내지 않고도 높은 점수나 통과 판정을 받아 내는 현상입니다. 목표의 문구는 지키고 의도는 어기는 명세 악용의 한 형태입니다.
장기 과제(Long-Horizon Task)와 컴퓨터 조작 에이전트의 한계
장기 과제는 여러 단계에 걸쳐 앞선 조건과 결과를 유지하며 이어 가야 하는 작업입니다. 일정 시간이나 도구 호출 수 하나로 모든 작업을 구분하지 않으며 실제 결과와 상태를 중간에 확인해야 합니다.
RAG(검색 증강 생성) 뜻과 파인튜닝의 차이
RAG는 질문에 관련된 자료를 검색해 모델의 답변 입력에 붙이는 방식입니다. 모델을 추가 학습시키는 파인튜닝과 달리 답할 때 참고할 정보를 가져옵니다.
프롬프트 캐시(Prompt Caching) 뜻과 비용이 줄어드는 조건
프롬프트 캐시는 요청 앞부분의 계산 결과를 보관해 같은 앞부분을 다시 처리할 때 재사용하는 기능입니다. 실제 적중과 요금은 모델과 요청 및 보관 조건에 따라 다릅니다.
에이전트 검수와 평가: 자기 검수 편향과 별도 검수자
에이전트 검수는 결과물 하나가 기준에 맞는지 확인하는 일이고, 에이전트 평가는 여러 과제를 반복해 돌려 에이전트를 얼마나 믿을 수 있는지 측정하는 일입니다. 자기 검수의 편향을 줄이기 위해 검수 자료와 기준을 따로 구성할 수 있습니다.
BYOK(내 키 가져오기) 뜻과 AI 비용 구조: 구독과 종량제
AI 도구에서 BYOK는 내가 모델 제공자에게 받은 API 키를 등록해 쓰는 방식입니다. 모델 사용료와 도구 이용료의 청구 범위를 각각 확인해야 합니다.

