주요 기능 살펴보기

주요 기능 살펴보기

Claude Agent SDK가 주는 가장 큰 가치는 Claude Code의 강력한 기능을 그대로 라이브러리에서 쓸 수 있다는 점이에요. 어떤 기능이 있는지 하나씩 볼게요.

출처: https://docs.claude.com/en/api/agent-sdk/overview

가장 기본은 내장 도구(built-in tools)예요. 파일을 읽고·쓰고·편집하고, 셸 명령을 실행하고, 웹을 검색하는 기능이 들어 있어서 에이전트가 실제 일을 할 수 있어요. 그다음으로 Hooks는 에이전트 생명주기의 특정 지점(예: 도구 호출 전/후)에서 내 커스텀 코드를 실행하게 해 줘요.

Subagents는 전문화된 부에이전트를 만들어 집중 태스크에 맡기는 기능이고, MCP는 Model Context Protocol로 외부 도구와 데이터 소스를 붙이는 표준 경로예요. Permissions로는 어떤 도구가 자동 실행되고 어떤 도구가 사람 승인을 받아야 하는지 통제할 수 있어요.

세션(Sessions)은 여러 번의 대화를 거쳐도 컨텍스트를 유지해 주고, 나중에 이어(resume)나 분기(fork)할 수 있게 해 줘요. 이건 장기 실행 에이전트를 만들 때 특히 중요해요.

// 개념: SDK에서 에이전트를 만들고 실행
import { query } from '@anthropic-ai/claude-agent-sdk';

const result = await query({
  prompt: '이 코드에서 버그를 찾아 고쳐줘',
  // options: cwd, allowedTools, permissions 등
});
console.log(result.text);

Skills·Commands·Memory는 프로젝트의 .claude/ 디렉터리와 ~/.claude/에서 Claude Code와 동일하게 자동 로드돼요. Plugins는 스킬·에이전트·훅·MCP 서버를 패키지로 묶어 로컬 경로로 불러오는 기능이에요.

더 알아보기