<aside> 🎯 Claude Code CLI와 Anthropic SDK로 에이전트를 구성하는 세 가지 방식을 비교합니다. 논문 작성 워크플로우를 시나리오로, CLI → SDK(CLI호출) → SDK(API) 순서로 실습합니다.

</aside>

0. 세 가지 방식 한눈에 비교

구분	① CLI 직접 사용	② SDK에서 CLI 호출	③ SDK API 직접 호출
본질	터미널에서 대화형 지시	Python이 CLI를 서브프로세스로 실행	Python이 Claude API를 직접 호출
에이전트	Claude 자체가 에이전트	CLI가 에이전트, 코드가 오케스트레이터	내가 에이전트 루프를 설계
도구(파일/실행)	내장 자동 제공	CLI 내장 도구 자동	직접 정의·구현 필요
코드 작성량	없음	적음 (subprocess)	많음 (tool 정의 등)
자동화	셸 스크립트 수준	Python으로 완전 자동화	Python으로 완전 자동화
비용	Claude Code 구독	Claude Code 구독	API 토큰 과금 (종량제)
세밀한 제어	프롬프트로 간접	프롬프트 + 코드 분기	완전한 코드 제어
적합한 상황	탐색·일회성 작업	CLI 장점 + 자동화	프로덕션·고도 커스텀

Part 1. CLI로 논문 작업하기

<aside> ⌨️ CLI는 Claude 자체가 에이전트입니다. 파일 읽기·수정·코드 실행·Git 커밋까지 대화로 지시합니다.

</aside>

1-1. 환경 설정

# Claude Code 설치 및 실행
npm install -g @anthropic-ai/claude-code
cd ~/my-paper  # 논문 프로젝트 디렉토리
claude

1-2. CLAUDE.md로 에이전트 행동 정의

CLAUDE.md를 프로젝트 루트에 두면 CLI가 자동으로 읽고 따릅니다.

# CLAUDE.md

## 프로젝트 개요
LaTeX 기반 학술 논문 프로젝트.

## 구조
- paper/main.tex : 논문 본문
- paper/refs.bib : 참고문헌
- scripts/plot.py : Figure 생성 스크립트
- results/ : 실험 결과 데이터

## 작업 규칙
- LaTeX 수정 시 컴파일 확인: pdflatex main.tex
- Figure 수정 후 scripts/plot.py 실행
- 커밋 메시지는 한국어로

1-3. 논문 작성 워크플로우 (대화형)

Step 1 — 관련 연구 분석

> refs.bib에서 주요 논문들을 읽고
  연구 흐름을 시간순으로 분류해서 정리해줘

→ Claude가 bib를 읽고 분류 체계를 제안합니다.

Step 2 — Related Work 작성

> 방금 분석 결과를 바탕으로
  main.tex의 Related Work 섹션을 업데이트해줘.
  기존 내용은 유지하되 빠진 분류를 추가해.

Step 3 — 실험 Figure 생성

> results/ 폴더의 데이터를 분석해서
  scripts/plot.py에 비교 실험 시각화 함수를 추가하고
  실행해서 Figure를 생성해줘