커뮤니티 입장하기

도구가 바뀌어도 통하는 원리

12개 개념, 총 학습 약 199분

AI 에이전트 중급: 원리와 설계

AI 에이전트 중급 코스는 클로드 코드나 코덱스 같은 도구 이름과 상관없이 통하는 에이전트의 작동 원리와 설계 방법을 12가지 개념으로 정리한 코스입니다. 에이전트를 몇 번 써 본 뒤 결과가 왜 매번 다른지, 어디까지 맡겨도 되는지, 비용은 왜 이렇게 나오는지가 궁금해진 분들을 위해 만들었습니다.

도구의 화면과 명령어는 몇 달마다 바뀌지만 그 아래의 구조는 잘 바뀌지 않습니다. 모델이 도구를 요청하고 프로그램이 실행하는 반복, 그 반복을 감싸는 지침과 검사, 반복할수록 늘어나는 비용이 어느 도구에서나 같은 모양으로 나타납니다. 이 코스는 그 구조를 먼저 잡고, 각 도구의 사용법은 기존 입문 코스로 연결합니다.

📚 다루는 개념 12가지

앞의 두 묶음은 순서대로 읽는 편이 이해가 빠르고, 뒤의 두 묶음은 필요한 편부터 골라 읽어도 됩니다. 요금과 한도, 지원 여부처럼 바뀌는 사실에는 편마다 확인한 날짜를 붙였습니다.

❓ 자주 묻는 질문

에이전트를 직접 만들지 않아도 이 코스가 필요한가요?

필요합니다. 이미 만들어진 에이전트를 쓰더라도 지침 파일을 어떻게 쓸지, 어디서 사람이 확인할지, 캐시가 깨지지 않게 어떻게 작업할지는 쓰는 사람이 정합니다. 코드를 짜는 편은 없고, 설정 파일과 요청 예시를 보며 따라갈 수 있습니다.

클로드 코드 입문 코스와 무엇이 다른가요?

클로드 코드 입문 코스는 설치와 메모리, 서브에이전트, 훅처럼 클로드 코드의 기능 사용법을 다룹니다. 이 코스는 그 기능들이 왜 그렇게 설계되었는지를 도구와 상관없는 원리로 설명하고, 해당 기능의 사용법은 입문 코스의 편으로 연결합니다.

어느 편부터 읽으면 되나요?

에이전트라는 말 자체가 낯설다면 첫 두 편부터 읽습니다. 결과가 들쭉날쭉한 것이 고민이라면 하네스 엔지니어링과 검수와 평가 편을, 비용이 고민이라면 프롬프트 캐시와 BYOK 편을 먼저 봐도 됩니다.

🔗 함께 보는 코스

  • 비개발자를 위한 Claude Code: 이 코스에서 원리로 다룬 메모리, 서브에이전트, 훅의 실제 사용법을 다룹니다
  • 클로드 기초 교육: 컨텍스트 윈도우와 할루시네이션처럼 에이전트의 한계를 이해하는 데 필요한 모델의 성질을 다룹니다
  • 바이브코딩 기초지식: 에이전트에게 코드 작업을 맡기기 전에 알아 둘 개발 환경의 기본을 다룹니다
12개 개념총 학습 약 199분

3줄 요약

이번 방문에서 한 편은 바로 볼 수 있습니다.

1

AI 에이전트(AI Agent) 뜻과 챗봇, 워크플로의 차이

AI 에이전트는 목표를 받으면 도구를 호출하고 그 결과를 보고 다음 행동을 스스로 정하는 과정을 일이 끝날 때까지 되풀이하는 AI 시스템입니다. 순서가 코드로 정해진 워크플로와 달리 다음 단계를 모델이 고릅니다.

17분→
2

에이전트 루프와 도구 호출(Tool Calling) 원리

에이전트 루프는 모델이 도구 호출을 요청하면 프로그램이 실행하고 그 결과를 모델에게 돌려주는 왕복을 모델이 끝났다고 답할 때까지 되풀이하는 구조입니다. 모델은 무엇을 실행할지 적은 요청만 내보내고 실제 실행은 바깥 프로그램이 맡습니다.

18분→
3

AGENTS.md와 CLAUDE.md(에이전트 지침 파일) 뜻과 작성법

에이전트 지침 파일은 AI 에이전트가 작업을 시작할 때 자동으로 읽어 들이는 프로젝트 안내문이고, AGENTS.md는 여러 코딩 에이전트가 함께 읽도록 만든 공개 형식입니다. CLAUDE.md는 클로드 코드가 기본으로 읽는 같은 성격의 파일입니다.

18분→
4

intent.md 뜻과 작성법: 왜 하는지를 적는 파일

intent.md는 코드를 쓰기 전에 무엇을 왜 만들지와 누가 영향을 받는지, 아직 정하지 못한 것을 적어 두는 일감 단위 문서입니다. 앤트로픽이 2026년 8월 공개한 AI 네이티브 개발 플레이북의 첫 단계 문서입니다.

16분→
5

하네스 엔지니어링(Harness Engineering) 뜻과 구성

하네스 엔지니어링은 AI 에이전트가 일하는 환경과 규칙, 결과를 확인하고 고치게 하는 장치를 설계하는 일입니다. 에이전트를 모델과 하네스의 합으로 보고, 모델을 뺀 나머지 전부를 다룹니다.

17분→
6

멀티 에이전트 오케스트레이션(Multi-Agent Orchestration) 뜻과 설계

멀티 에이전트 오케스트레이션은 메인 에이전트가 일을 나눠 작업자 에이전트에게 맡기고 돌아온 결과를 모아 합치는 구조입니다. 작업자는 각자 따로 된 컨텍스트에서 일하고 요약한 결과만 돌려줍니다.

18분→
7

보상 해킹(Reward Hacking) 뜻과 테스트 통과 편법

보상 해킹은 AI가 목표 달성을 판정하는 장치의 빈틈을 이용해 실제로 일을 해내지 않고도 높은 점수나 통과 판정을 받아 내는 현상입니다. 목표의 문구는 지키고 의도는 어기는 명세 악용의 한 형태입니다.

17분→
8

장기 과제(Long-Horizon Task)와 컴퓨터 조작 에이전트의 한계

장기 과제는 사람이 한 시간 넘게 걸리는 일처럼 에이전트가 수백 번의 도구 호출을 이어 가야 끝나는 작업입니다. 짧은 과제에서 높은 점수를 내는 모델도 과제가 길어지면 제약을 놓치고 중간에 바뀐 정보를 반영하지 못해 성공률이 크게 떨어집니다.

17분→
9

RAG(검색 증강 생성) 뜻과 파인튜닝의 차이

RAG(Retrieval-Augmented Generation, 검색 증강 생성)는 모델이 답을 만들기 전에 학습 데이터 밖의 자료를 찾아 질문에 붙여 주는 방식입니다. 모델 자체를 바꾸는 파인튜닝과 달리 모델에 들어가는 입력만 바꿉니다.

15분→
10

프롬프트 캐시(Prompt Caching) 뜻과 비용이 줄어드는 조건

프롬프트 캐시는 이미 보낸 요청의 앞부분을 서버가 계산해 보관했다가, 다음 요청의 앞부분이 똑같으면 다시 계산하지 않고 꺼내 쓰는 기능입니다. 적중한 부분의 입력 요금은 원래 단가의 10분의 1 이하로 내려갑니다.

15분→
11

에이전트 검수와 평가: 자기 검수 편향과 별도 검수자

에이전트 검수는 결과물 하나가 기준에 맞는지 확인하는 일이고, 에이전트 평가는 여러 과제를 반복해 돌려 에이전트를 얼마나 믿을 수 있는지 측정하는 일입니다. 결과물을 만든 쪽이 스스로 검수하면 점수를 후하게 주는 경향이 있어 검수를 따로 떼어 둡니다.

16분→
12

BYOK(내 키 가져오기) 뜻과 AI 비용 구조: 구독과 종량제

BYOK(Bring Your Own Key)는 도구가 정한 구독 대신 내가 모델 제공자에게서 받은 API 키를 등록해 쓰는 방식입니다. 요금은 도구가 아니라 제공자에게 쓴 토큰만큼 직접 냅니다.

15분→