에이전틱 엔지니어의 길

동작하는 코드

지금까지 Claude Code를 하나의 세션에서 사용했습니다. 이제 여러 세션을 동시에 활용해봅시다.

터미널을 3개 열고 각각 Claude Code를 시작합니다:

터미널 1 — API 개발:

cd my-project
claude
> 사용자 인증 API를 구현해줘

터미널 2 — 테스트:

cd my-project
claude
> 기존 API의 테스트 커버리지를 높여줘

터미널 3 — 문서화:

cd my-project
claude
> API 문서를 작성해줘

각 세션이 독립적으로 작업하면서도, 같은 코드베이스를 공유합니다. Git 브랜치를 활용해서 충돌을 관리하세요.

직접 수정하기

--print 모드로 자동화 스크립트를 만들어봅시다:

#!/bin/bash
# daily-review.sh

echo "=== 일일 코드 리뷰 ==="
claude --print "어제 이후 변경된 파일을 리뷰하고 문제점을 정리해줘"

echo "=== 테스트 상태 ==="
claude --print "테스트를 실행하고 실패하는 것이 있으면 원인을 분석해줘"

echo "=== TODO 정리 ==="
claude --print "코드에 있는 TODO 주석을 모아서 우선순위를 매겨줘"

이 스크립트를 매일 아침 실행하면 프로젝트 상태를 자동으로 파악할 수 있습니다.

"왜?" — 코더에서 오케스트레이터로

에이전틱 엔지니어링은 코드를 직접 작성하는 것에서, AI 에이전트를 지휘해서 시스템을 만드는 것으로의 전환입니다.

전통적 개발 vs 에이전틱 개발

| 항목 | 전통적 | 에이전틱 | | --------- | -------------------- | ------------------------------- | | 코드 작성 | 개발자가 직접 타이핑 | AI가 생성, 개발자가 리뷰 | | 디버깅 | 개발자가 추적 | AI가 분석, 개발자가 판단 | | 테스트 | 개발자가 작성 | AI가 생성, 개발자가 검증 | | 설계 | 개발자가 결정 | AI가 분석 + 제안, 개발자가 결정 | | 역할 | 구현자 | 설계자 + 리뷰어 |

Claude Code SDK 활용

프로그래밍적으로 Claude Code를 호출할 수도 있습니다:

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

const result = await claude({
  prompt: "이 파일의 보안 취약점을 분석해줘",
  workingDirectory: "./my-project",
});

console.log(result.stdout);

이를 활용하면 CI/CD 파이프라인, 모니터링 시스템, 자동화 워크플로우에 Claude Code를 통합할 수 있습니다.

효과적인 에이전틱 워크플로우 설계 원칙

1. 작업을 분해하라 — 큰 작업을 독립적인 단위로 쪼개서 병렬 처리
2. 검증 지점을 만들어라 — 자동화와 수동 리뷰를 적절히 섞어라
3. 컨텍스트를 관리하라 — CLAUDE.md, 커스텀 명령어, MCP로 일관성 유지
4. 되돌릴 수 있게 하라 — Git 브랜치, 체크포인트로 안전망 확보
5. 점진적으로 자동화하라 — 반복되는 패턴을 발견하면 명령어나 스크립트로 만들어라

다음 단계

이 강의에서 배운 기법을 정리하면:

기초:    설치 → 기본 명령어 → 컨텍스트 관리
일상:    코드 작성 → 디버깅 → 테스트 → Git
설정:    CLAUDE.md → 커스텀 명령어 → 멀티파일
고급:    Plan/Think → MCP → GitHub 자동화
확장:    Hooks → Skills → 커스텀 에이전트 → Worktree → Headless/SDK
실전:    프로젝트 빌드 → 에이전틱 워크플로우

이 도구들을 조합해서 자신만의 개발 워크플로우를 만들어보세요. 정답은 없습니다 — 자기 프로젝트와 팀에 맞는 방식을 찾는 것이 핵심입니다.

심화 학습