에이전틱 코딩이란? 자동화의 개념 | 클로드 코드 에이전틱 자동화

에이전틱 코딩 — 자동완성을 넘어 자율 실행으로

GitHub Copilot이 등장했을 때 사람들은 "AI가 코드를 완성해준다"고 놀랐습니다. 에이전틱 코딩은 그보다 한 단계 더 나아갑니다. 코드를 완성하는 것이 아니라, 작업 자체를 완수합니다. 파일을 열고, 수정하고, 테스트를 실행하고, 에러를 확인하고, 다시 수정하고, 커밋까지 — 이 모든 과정을 Claude Code가 자율적으로 수행합니다. 개발자는 목표를 주고 결과를 검토합니다.

에이전틱(Agentic)이라는 단어는 agency(자율성, 주도권)에서 왔습니다. AI가 단순히 다음 토큰을 예측하는 것이 아니라, 목표를 향해 스스로 계획하고 실행하는 주체가 된다는 의미입니다.

기존 AI 코딩 도구와의 근본적 차이

자동완성 도구 (Copilot inline suggestions): 커서 위치의 다음 코드를 예측. 사람이 타이핑을 주도하고 AI가 제안. 컨텍스트는 현재 파일 위주.
채팅형 도구 (ChatGPT, Copilot Chat): 질문하면 코드를 보여줌. 사람이 코드를 복사해 붙여넣어야 함. 파일 시스템 접근 불가.
에이전틱 도구 (Claude Code): 목표를 주면 파일을 직접 읽고 수정. 터미널 명령을 실행해 결과 확인. 에러가 나면 스스로 디버깅. 작업이 완료될 때까지 여러 단계를 자율 반복.

이 차이는 결과물의 질이 아니라 작업 방식의 차이입니다. 에이전틱 도구는 프로젝트 전체를 이해하고 일관되게 작업합니다.

Claude Code의 에이전틱 루프

Claude Code가 작업을 수행하는 내부 흐름을 이해하면 더 효과적으로 활용할 수 있습니다.

1. Read (읽기)
   - CLAUDE.md, 관련 파일들을 읽어 컨텍스트 구성
   - "어떤 패턴을 쓰고 있는가?" 파악

2. Plan (계획)
   - 작업을 하위 단계로 분해
   - 어떤 파일을 수정해야 하는지 파악

3. Act (실행)
   - 파일 편집 (Edit 도구)
   - 터미널 명령 실행 (Bash 도구)
   - 파일 생성/검색 (Write, Glob 도구)

4. Observe (관찰)
   - 실행 결과 확인 (테스트 통과? 에러 있음?)
   - 계획 조정 필요 여부 판단

5. Repeat (반복)
   - 완료 기준을 충족할 때까지 3-4 반복

실제로 어떤 작업이 가능한가

에이전틱 코딩으로 실제로 할 수 있는 작업의 범위를 구체적으로 이해하는 것이 중요합니다.

레거시 코드 마이그레이션: "JavaScript 파일들을 TypeScript로 변환해줘. 타입 추론 가능한 곳은 추론하고, 불분명한 곳은 unknown으로 표시" — 수십 개 파일을 일관되게 변환.
테스트 작성: "커버리지가 없는 유틸 함수들에 단위 테스트 작성해줘. 엣지 케이스 포함, Jest 사용" — 코드를 분석해 의미 있는 테스트 생성.
리팩터링: "중복된 API 호출 패턴을 커스텀 훅으로 추출해줘. 3곳 이상에서 반복되는 패턴만" — 코드베이스 전체를 스캔 후 일관 적용.
버그 조사: "프로덕션 로그에서 'Cannot read property of undefined' 에러가 발생함. 관련 코드 찾아서 원인 파악하고 수정해줘" — 에러 역추적부터 수정까지.

에이전틱 자동화의 두 가지 모드

Claude Code는 크게 두 가지 방식으로 사용됩니다.

대화형(Interactive) 모드: claude 명령으로 REPL 시작. 사람과 주고받으며 작업. 중간 결과를 보고 방향 수정 가능. 새로운 기능 개발, 복잡한 버그 수정에 적합.
자동화(Headless) 모드: claude -p "작업 내용" --output-format json 형태로 스크립트에서 호출. CI/CD 파이프라인, 스케줄 작업, Git 훅에서 사용. 이 시리즈에서 주로 다룰 내용입니다.

# 자동화 모드 기본 예시
claude -p "src/utils/*.ts 파일들의 JSDoc 주석을 영어로 통일해줘" \
  --allowedTools "Read,Edit,Glob" \
  --output-format json

에이전틱 코딩의 핵심 전환: 개발자의 역할이 "코드를 작성하는 사람"에서 "작업을 설계하고 결과를 검증하는 사람"으로 바뀝니다. 코드 타이핑 속도보다 좋은 목표를 정의하는 능력이 더 중요해집니다.

핵심 정리

에이전틱 코딩은 코드 완성이 아니라 작업 완수 — Read-Plan-Act-Observe 루프로 목표를 향해 자율 반복 실행
레거시 마이그레이션·테스트 작성·리팩터링·버그 조사 등 시간 소모적 반복 작업이 주요 활용 영역
대화형 모드(개발·탐색)와 자동화 모드(CI/CD·스케줄)의 두 가지 사용 패턴 이해가 자동화 설계의 기초

관련 검색어 · 클로드 코드 · Claude Code · 에이전틱 코딩 · 헤드리스 모드 · claude -p 명령어 · 비대화형 AI 자동화 · AI 코딩 자동화 개념