에이전트 모드란?

Claude Code는 단순히 질문에 답하는 게 아니에요.에이전트 모드에서는 목표를 이해하고, 계획을 세우고, 여러 단계를 알아서 실행해요. 파일 읽기, 수정, 테스트, 결과 확인까지 전부 자동으로 진행해요.

에이전트 모드 활용

/plan
로그인 기능에 소셜 로그인(Google, Kakao)을 추가해줘.
기존 이메일 로그인은 유지하면서 추가해야 해.

전체 테스트를 백그라운드로 돌려줘.
그 동안 나는 README 업데이트를 할게.

사용자: "인증 모듈을 리팩토링해줘"

Claude (메인):
  ├─ 서브에이전트 1: 현재 인증 코드 분석
  ├─ 서브에이전트 2: 의존성 파일 탐색
  └─ 서브에이전트 3: 테스트 파일 확인
  → 결과 종합 후 리팩토링 실행

효과적인 프롬프트

Claude에게 일을 잘 시키려면, 뭘 왜 어떻게 해줘라고 구체적으로 말하는 게 중요해요.

Claude Agent SDK (개발자용)

@anthropic-ai/claude-code 패키지를 사용하면 Claude Code의 에이전트 기능을 여러분의 코드에서 직접 호출할 수 있어요.

설치

기본 사용

import { claude } from "@anthropic-ai/claude-code";

const result = await claude({
  prompt: "src 폴더의 구조를 분석하고 요약해줘",
  options: {
    maxTurns: 10,
    allowedTools: ["Read", "Glob", "Grep"],
  },
});

console.log(result.stdout);

주요 옵션

팁