Claude Code, 설치부터 Headless 자동화까지

node --version   # v18.x 이상이어야 합니다
git --version    # 2.x 이상 권장

npm install -g @anthropic-ai/claude-code

claude --version

claude doctor

mkdir -p ~/claude-lab/ch1/src && cd ~/claude-lab/ch1

cat > package.json << 'EOF'
{
  "name": "user-service-lab",
  "version": "1.0.0",
  "description": "Claude Code Workshop Chapter 1 sample project",
  "type": "module",
  "scripts": {
    "test": "node test.js"
  }
}
EOF

cat > src/users.js << 'EOF'
// 사용자 데이터 저장소
// 주의: 일부 사용자는 profile 필드가 없음 (마이그레이션 미수행 상황)
export const users = [
  { id: 1, name: "Kim", profile: { email: "kim@example.com", plan: "pro" } },
  { id: 2, name: "Lee", profile: { email: "lee@example.com", plan: "free" } },
  { id: 3, name: "Park" }
];
EOF

cat > src/userService.js << 'EOF'
import { users } from "./users.js";

export function getUser(id) {
  return users.find((u) => u.id === id);
}

export function getUserPlan(id) {
  const user = getUser(id);
  return user.profile.plan;
}
EOF

cat > test.js << 'EOF'
import { getUserPlan } from "./src/userService.js";

function check(name, fn, expected) {
  const actual = fn();
  console.log(`${name}: ${actual === expected ? "PASS" : `FAIL (got ${actual})`}`);
}

check("Test 1 - pro 플랜 사용자", () => getUserPlan(1), "pro");
check("Test 2 - free 플랜 사용자", () => getUserPlan(2), "free");
check("Test 3 - profile 없는 사용자", () => getUserPlan(3), "unknown");
EOF

git init -q
git add -A
git commit -q -m "chore: initial lab project" \
  || git -c user.name="lab" -c user.email="lab@example.com" commit -q -m "chore: initial lab project"

ls -R

cd ~/claude-lab/ch1
claude

cat > CLAUDE.md << 'EOF'
# Project: user-service-lab

## Project Overview
Claude Code 워크샵 실습용 사용자 서비스 모듈.
사용자 조회와 요금제(plan) 확인 기능을 제공한다.

## Tech Stack
- Node.js 18+ (ES Modules), 외부 의존성 없음

## Commands
- 테스트: npm test

## Conventions
- ES Modules(import/export)만 사용, CommonJS 금지
- 존재하지 않는 데이터는 예외를 던지지 말고 기본값을 반환
- 모든 수정에는 test.js의 테스트 통과가 동반되어야 함

## Don't
- src/users.js의 데이터 구조를 임의로 변경하지 않기
- 새 npm 패키지를 추가하지 않기
EOF
cat CLAUDE.md

claude

npm test

cd ~/claude-lab/ch1
npm test

claude -p "이 프로젝트의 구조와 목적을 3줄로 요약해 주세요" --output-format text

git log --oneline | claude -p "이 커밋 히스토리를 한 문단으로 요약해 주세요"

claude -p "src 디렉토리의 코드 품질 이슈를 분석해 주세요" \
  --allowed-tools "Read,Grep,Glob" \
  --output-format json > report.json

# jq가 있다면
jq '.' report.json | head -30

cat > review.sh << 'EOF'
#!/bin/bash
DIFF=$(git diff HEAD~1)
echo "$DIFF" | claude -p "이 diff를 코드 리뷰해 주세요. 심각도별로 정리해 주세요." \
  --allowed-tools "" --output-format text > review.md
EOF
chmod +x review.sh
./review.sh
cat review.md