클로드(Claude) SDK로 나만의 AI 에이전트, 5줄 코드로 뚝딱!

발표자는 클로드 에이전트 SDK를 통해 클로드 코드(Claude Code)가 제공하는 다양한 기능을 상속받아 사용할 수 있다고 설명한다. 파일 읽기/쓰기, Bash 명령어 실행, 웹 검색(Web Search), 웹 쿼리(Web Fetch) 등, 에이전트 개발에 필요한 기본적인 도구들을 SDK가 제공하며, 권한 설정(Permissions), 서브 에이전트 생성(Sub-agent), MCP 서버 연결(MCP Server) 등의 기능도 지원한다고 강조한다.

영상에서는 단 5줄의 파이썬(Python) 코드로 간단한 AI 에이전트를 만들 수 있음을 보여준다. Query를 import하고, 프롬프트(Prompt)를 사용하여 호출한 후, 스트리밍된 모든 메시지를 출력하는 방식으로 구현된다. 이처럼 간단한 코드로 클로드 코드(Claude Code)의 기능을 활용할 수 있으며, 실제 클로드 코드(Claude Code)가 사용하는 하네스(Harness)를 그대로 사용할 수 있다는 점을 강조한다.

발표자는 SDK 클라이언트(Client)를 사용하여 대화형 AI 에이전트를 구축하는 방법을 설명한다. 클라이언트를 열고, 메시지를 보내고, 응답을 읽는 과정을 반복함으로써, 사용자와의 상호작용(Interaction)을 구현할 수 있다. 예를 들어, 좋아하는 음식을 질문하면, SDK가 내장한 메모리(Memory)를 통해 이전에 언급한 정보를 기억하고 답변하는 기능을 시연한다.

영상에서는 클로드 에이전트 SDK를 통해 커스텀 툴(Custom Tool)을 연동하는 방법을 소개한다. MCP 서버(MCP Server)를 사용하여 툴을 래핑(Wrapping)하고, SDK에 연결하는 방식으로 구현된다. @add_tool 데코레이터(Decorator)를 사용하여 툴의 이름, 설명, 입력 스키마(Schema)를 정의하고, 에이전트 옵션에 서버를 전달한 후, 툴에 대한 권한을 미리 승인하는 과정을 거친다. 이를 통해 데이터베이스 호출(Database Call), API 요청(API Request) 등, 다양한 기능을 에이전트에 추가할 수 있다.

발표자는 에이전트의 동작 방식을 제어하는 시스템 프롬프트(System Prompt)와 클로드 코드(Claude Code) 프리셋에 대해 설명한다. 기본적으로 에이전트는 클로드 코드(Claude Code)와 다른 방식으로 작동하지만, 클로드 코드(Claude Code)의 코딩 가이드라인(Coding Guidelines), 응답 스타일(Response Style), 프로젝트 컨텍스트(Project Context)를 사용하려면 프리셋을 선택해야 한다고 강조한다. 이를 통해, 고객 지원 에이전트(Customer Support Agent)와 같이 코딩 도구가 아닌 다른 용도로 에이전트를 활용할 수 있다.