Claude Code 최신 업데이트: Auto Memory·Batch·Ralph Loop 완벽 가이드

Claude Code, 이제 ‘기억’하고 ‘반복’하며 ‘어디서나’ 일한다

여러분, 요즘 Claude Code를 보면 진화가 정말 빠릅니다. 앤트로픽(Anthropic)의 Claude Code는 최근 대규모 업데이트를 거치면서 ‘일회성 답변 도구’에서 벗어났는데요. 이제는 세션 간 기억을 유지하고, 대규모 작업을 병렬로 처리하고, 어디서든 작업을 이어갈 수 있는 AI 페어 프로그래머에 가까워졌다고 봅니다.

이번 글에서는 최근 추가된 4가지 핵심 기능, Auto Memory, Simplify & Batch, Remote Control, Ralph Loop을 실무 관점에서 하나씩 짚어 보겠습니다. 각 기능이 왜 필요한지, 어떤 원리로 작동하는지, 실제 프로젝트에서 어떻게 써야 효율이 올라가는지를 구체적인 시나리오와 함께 정리합니다. 작업 방식이 꽤 달라지니까 끝까지 보면 좋겠습니다.

핵심 요약: 이 글에서 얻을 수 있는 것

• Auto Memory: 세션 간 기억 자동 저장
• Simplify: 코드 품질·재사용성·효율성 병렬 검토
• Batch: 대규모 작업을 5~30개 단위로 분해하여 병렬 실행
• Remote Control: 로컬 세션을 브라우저·모바일에서 원격 접속
• Ralph Loop: 성공 기준 만족까지 무한 반복 자동화

---

1. Auto Memory: ‘잊지 않는’ AI 페어 프로그래머

기존 문제: 세션마다 리셋되는 컨텍스트

기존 Claude Code는 세션이 종료되면 대화 히스토리와 학습 내용을 전부 잃어버렸습니다. CLAUDE.md 파일에 명시적으로 작성한 규칙만 다음 세션에서도 유지되었기 때문에, 개발자는 매번 동일한 프로젝트 구조를 설명하고, 같은 실수를 반복하며, 동일한 설정(포트 번호, 빌드 명령어 등)을 다시 알려줘야 했습니다.

Auto Memory의 등장: 자동 학습과 누적 기억

Auto Memory는 Claude Code가 작업 중 스스로 배운 내용을 자동으로 기록하고, 다음 세션에서 자동으로 불러오는 기능입니다. 예를 들어:

• “이 프로젝트는 bun을 패키지 매니저로 사용하며, npm은 금지되어 있다”
• “CI/CD 파이프라인에서 테스트 실패 시 Slack 알림이 발송된다”
• “데이터베이스 마이그레이션은 반드시 별도 커밋으로 분리해야 한다”

이런 암묵지(tacit knowledge)를 Claude Code가 작업 과정에서 자동으로 포착하여 .claude/projects/{프로젝트}/memory/MEMORY.md에 저장합니다.

CLAUDE.md vs Auto Memory: 역할의 차이

특성	CLAUDE.md	Auto Memory
작성 주체	개발자(명시적)	Claude Code(자동)
내용 성격	규칙·표준·컨벤션(“이렇게 해라”)	경험·팁·메모(“이렇게 하면 잘 되더라”)
팀 공유	O (저장소에 커밋)	X (개인 로컬에만 존재)
변경 빈도	낮음 (팀 합의 필요)	높음 (세션마다 누적)

정리하면, CLAUDE.md는 팀의 공식 문서처럼 “절대 지켜야 할 규칙”을 담습니다. 반면 Auto Memory는 개인 노트처럼 “이번 프로젝트에서 유용했던 정보”를 누적하는 쪽이죠.

활성화 및 제어

Auto Memory는 기본적으로 활성화되어 있습니다. 비활성화하려면 터미널에서:

/memory

명령어를 입력하면 토글 UI가 나타나며, 여기서 ON/OFF를 전환할 수 있습니다.

파일 구조와 200줄 규칙

Auto Memory의 메인 파일은 memory/MEMORY.md입니다. 이 파일은 모든 세션 시작 시 자동으로 로드되지만, 최대 200줄까지만 읽힙니다. 왜 200줄로 제한했을까요?

• 컨텍스트 윈도우 최적화: 대규모 언어 모델(Large Language Model, LLM)의 컨텍스트 윈도우는 한정되어 있습니다. 매 세션마다 수천 줄의 메모리를 로드하면 실제 작업 코드를 분석할 여유가 줄어듭니다.
• 핵심 인덱스 파일 역할: MEMORY.md는 “전체 메모리의 목차”로 기능하며, 상세 내용은 별도 마크다운 파일(feature-x-tips.md, database-migration-notes.md 등)로 분리됩니다.
• 링크 기반 확장: 200줄을 초과하는 메모리는 MEMORY.md에 링크 형태로만 등재되고, Claude Code가 필요할 때 해당 파일을 추가로 읽습니다.

수동으로 메모리 추가하기

자동 학습 외에도, 중요한 정보를 즉시 기록하고 싶다면:

"이 설정을 메모리에 저장해줘"

같은 프롬프트를 입력하면 Claude Code가 해당 내용을 MEMORY.md에 추가합니다.

실무 활용 시나리오

• 프로젝트 온보딩 단축: 새 팀원이 합류했을 때, Auto Memory가 누적한 프로젝트 히스토리를 참고하면 “이 프로젝트에서 자주 발생하는 이슈”를 빠르게 파악할 수 있습니다.
• 재발 방지: 과거 세션에서 해결한 버그가 다시 발생했을 때, Auto Memory에 “이전에 X 방법으로 해결”이라는 기록이 있으면 동일한 시행착오를 반복하지 않습니다.
• 개인화된 워크플로: 특정 개발자가 선호하는 코드 스타일이나 디버깅 방법을 Claude Code가 학습하여, 점차 개인화된 페어 프로그래밍 경험을 제공합니다.

---

2. Simplify & Batch: 병렬 리뷰와 대규모 자동화

Simplify 스킬: 코드 정제를 3개 관점에서 동시에

기능을 구현하거나 버그를 수정한 직후, 코드를 재사용성·품질·효율성 관점에서 리뷰하고 싶다면 /simplify 명령어를 실행합니다.

동작 원리: 3개 서브 에이전트의 병렬 실행

1. 재사용성 검토 에이전트: 중복 코드 패턴을 탐지하고, 공통 유틸 함수나 커스텀 훅으로 추출 가능한지 분석합니다.
2. 품질 검토 에이전트: 네이밍 컨벤션, 타입 안정성, 에러 핸들링, 테스트 커버리지를 평가하여 개선 방안을 제시합니다.
3. 효율성 검토 에이전트: 불필요한 렌더링, 비효율적인 루프, 메모리 누수 가능성 등을 점검하고 최적화 코드를 제안합니다.

이 3개 에이전트가 병렬로 실행되면서 각자의 발견 사항을 메인 에이전트에 보고합니다. 그러면 메인 에이전트가 이를 종합해서 최종 수정 사항을 적용해 주는 거죠.

사용 예시

/simplify

또는 특정 영역에 집중하고 싶다면:

/simplify 성능 최적화에 집중해줘

언제 사용해야 하나?

• 새 모듈/파일 생성 후
• 변경 파일 5개 이상 작업 후
• PR 생성 직전 (필수)
• 복잡한 비즈니스 로직 추가 후

단순 설정 변경이나 문서 수정에는 불필요합니다.

Batch 스킬: 대규모 변경을 병렬로 처리하기

Batch는 코드베이스 전체에 걸친 반복 작업(예: 모든 컴포넌트에 PropTypes 추가, 전체 모듈에 단위 테스트 생성)을 자동화하는 스킬입니다.

동작 워크플로

1. 코드베이스 탐색: 프로젝트 구조, 의존성, 기존 테스트 설정을 분석합니다.
2. 작업 단위 분해: 요청 사항을 5~30개의 독립적인 작업 단위로 쪼갭니다. 예를 들어 “모든 API 엔드포인트에 단위 테스트 추가” 요청은 엔드포인트별로 분리됩니다.
3. 계획 승인 요청: 사용자에게 작업 계획을 제시하고 승인을 받습니다.
4. 병렬 실행: 각 작업 단위마다 별도의 서브 에이전트가 생성되고, Git Worktree를 통해 독립된 디렉토리에서 동시에 작업합니다.
5. 자동 PR 생성: 각 작업이 완료되면 테스트를 실행하고, 성공 시 자동으로 Pull Request를 생성합니다.

Git Worktree란?

Git Worktree는 하나의 Git 저장소에서 여러 작업 디렉토리를 동시에 운영하는 기능입니다. 기존에는 git checkout으로 브랜치를 전환하면 전체 디렉토리 내용이 바뀌었지만, Git Worktree를 사용하면:

• main 브랜치는 /project/main에
• feature/add-tests-api 브랜치는 /project/worktrees/feature-add-tests-api에
• feature/add-tests-db 브랜치는 /project/worktrees/feature-add-tests-db에

각각 별도 디렉토리로 존재하여, 동시에 여러 브랜치를 열어두고 작업할 수 있습니다. 이는 병렬 서브 에이전트 실행 시 필수적입니다.

사용 예시: 전체 모듈에 단위 테스트 추가

/batch 모든 서비스 레이어 함수에 Jest 단위 테스트를 추가하되, 각 테스트는 모킹 없이 실제 데이터베이스를 사용해

실행 결과:

• Claude Code가 7개 서비스 모듈을 발견
• 각 모듈마다 서브 에이전트 생성
• 7개 Git Worktree에서 병렬로 테스트 작성
• 각 Worktree에서 테스트 실행 후 성공하면 PR 자동 생성

언제 사용하나?

• 전체 컴포넌트에 공통 속성 추가
• 레거시 코드베이스를 최신 API로 마이그레이션
• 모든 페이지에 SEO 메타태그 삽입
• 전사 디자인 시스템 적용

작은 규모(파일 3개 이하)에는 오버킬입니다.

---

3. Remote Control: 개발 환경을 주머니에

기존 한계: 로컬에 묶인 세션

기존 Claude Code는 로컬 터미널에서만 실행되었습니다. 집에서 작업하다가 카페로 이동하면 세션이 끊기고, 스마트폰에서 코드를 확인하려면 GitHub 웹 UI를 써야 했습니다.

Remote Control: 어디서나 이어서 작업하기

Remote Control은 로컬 Claude Code 세션을 HTTP 서버로 노출하여, 브라우저·스마트폰·태블릿 등 어디서나 접속할 수 있게 합니다.

활성화 방법

/remote-control

또는 축약형:

/rc

실행하면 다음과 같은 메시지가 출력됩니다:

Remote Control 활성화됨
HTTP 세션: http://localhost:3000/session/abc123xyz

이 URL을 브라우저에서 열면, 로컬에서 실행 중인 Claude Code 세션에 원격으로 접속됩니다.

동작 원리

• 로컬 파일 시스템 접근: 원격 세션에서도 로컬의 모든 파일을 읽고 쓸 수 있습니다.
• MCP 서버 공유: 로컬에 설치한 MCP 서버(예: Figma, GitHub, Slack 통합)도 원격에서 사용 가능합니다.
• 대화 동기화: 터미널에서 입력한 프롬프트가 브라우저에 즉시 반영되며, 역도 마찬가지입니다.

실무 활용 시나리오

• 외출 중 긴급 수정: 회의 중 버그 리포트를 받았을 때, 스마트폰에서 Remote Control에 접속하여 “이 에러 로그 분석해줘”라고 요청하면, 로컬 환경의 전체 컨텍스트를 바탕으로 답변을 받을 수 있습니다.
• 멀티 디바이스 워크플로: 집 데스크톱에서 개발 서버를 띄워두고, 침대에서 태블릿으로 코드 리뷰 및 리팩토링 요청.
• 팀 협업: 팀원에게 임시로 URL을 공유하여, 내 로컬 환경을 기반으로 페어 프로그래밍(단, 보안 주의 필요).

주의사항

• Max 플랜 전용: 2026년 4월 기준, Remote Control은 Max 플랜 구독자만 사용 가능합니다.
• 보안: HTTP 세션 URL에는 인증 토큰이 포함되어 있지만, 공개 네트워크에서 공유 시 주의하세요. 민감한 프로젝트는 VPN이나 SSH 터널을 함께 사용하는 것이 안전합니다.

기존 대안과의 비교

저도 예전에는 SSH + Tailscale + tmux 조합으로 원격 터미널 접속을 구성했습니다. 그런데 이게 설정이 복잡하고, 모바일에서 터미널 UI도 불편했거든요. Remote Control은 이 번거로운 과정을 /rc 명령어 하나로 대체합니다.

---

4. Ralph Loop: ‘될 때까지’ 반복하는 AI

철학: 명확한 성공 기준이 있다면, AI가 알아서 끝내게 하라

Ralph Loop를 한 문장으로 말하면 “될 때까지 해”입니다. “모든 테스트가 통과할 때까지”, “빌드 에러가 0이 될 때까지”, “Lighthouse 점수가 90점 이상일 때까지” 같은 명확한 성공 기준이 있는 작업을, AI가 알아서 반복 수행하게 만드는 기능이죠.

탄생 배경: 호주 개발자의 실험에서 공식 플러그인으로

2025년 6월, 호주 오픈소스 개발자 Jeffrey Huntley가 트위터에 5줄짜리 Bash 무한 루프 스크립트를 공개했습니다:

while true; do
  echo "계속 개선해줘" | claude-code
done

이 단순한 아이디어는 “AI가 작업을 중간에 멈추지 않고, 완벽할 때까지 계속하게 하자”는 철학에서 출발했습니다. 이후 Jeffrey는 이 루프로 Curlstrang이라는 Z세대 슬랭 기반 프로그래밍 언어 전체를 개발해 화제를 모았고, 2025년 12월 앤트로픽(Anthropic)의 엔지니어가 공식 플러그인으로 채택했습니다.

동작 원리

1. 초기 프롬프트 실행: 사용자가 /ralph-loop 명령어로 작업을 시작합니다.
2. 작업 수행: Claude Code가 코드를 작성하거나 테스트를 실행합니다.
3. 종료 시도 감지: Claude Code가 “작업이 완료되었습니다”라고 보고하려는 순간, Stop Hook이 개입하여 종료를 차단합니다.
4. 상태 평가: 이전 작업 결과(파일 변경, Git diff, 테스트 출력)를 분석하여 성공 기준을 만족했는지 확인합니다.
5. 재시도 또는 종료:
   • 성공 기준 미달 → 동일 프롬프트를 다시 실행 (최대 반복 횟수까지)
   • 성공 기준 충족 → 루프 종료

명령어 문법

/ralph-loop "작업 설명" --max-iterations 20 --completion-prompt "done"

파라미터 설명

• 작업 설명: 반복 수행할 작업 내용
• --max-iterations: 최대 반복 횟수 (비용 폭주 방지용 안전장치)
• --completion-prompt: 성공 시 Claude Code가 출력해야 하는 트리거 워드 (예: “done”, “완료”, “성공”)

실전 예시: Y Combinator 해커톤 케이스

Y Combinator 해커톤에서 한 팀은 Ralph Loop을 밤새 실행했습니다. 원래 5만 달러 규모의 계약이었는데, “여섯 개의 이전 장소를 생성”하는 작업을 API 비용 단 $297로 완료했다고 합니다.

언제 사용해야 하나?

적합한 경우

• 명확한 성공 기준: “모든 E2E 테스트 통과”, “ESLint 에러 0개”, “Webpack 번들 크기 2MB 이하”
• 반복 개선 필요: 초기 구현이 불완전해도, 피드백 루프를 통해 점진적으로 개선 가능한 작업
• 장시간 무인 실행 가능: 자기 전에 돌려두고, 다음 날 아침 확인하는 식의 워크플로

부적합한 경우

• 설계 판단 필요: “어떤 아키텍처가 더 나은가?” 같은 주관적 결정
• 1회성 작업: 한 번의 요청으로 끝나는 간단한 수정
• 외부 승인 필요: 디자이너나 PM의 피드백을 받아야 하는 작업

프롬프트 작성 팁

성공 기준을 프롬프트에 명시하고, 완료 시 트리거 워드를 출력하도록 지시합니다:

/ralph-loop "모든 React 컴포넌트에 Storybook 스토리를 추가하고, 각 스토리가 에러 없이 렌더링되는지 확인해. 모든 스토리가 성공하면 'done'을 출력해" --max-iterations 15 --completion-prompt "done"

이렇게 하면 Claude Code는:

1. 첫 번째 컴포넌트의 스토리를 작성하고 Storybook 실행
2. 에러 발견 시 수정 후 재실행
3. 성공하면 다음 컴포넌트로 이동
4. 모든 컴포넌트 완료 시 “done” 출력 → 루프 종료

비용 관리

--max-iterations를 반드시 설정하세요. 설정하지 않으면 무제한 루프가 돌 수 있으며, API 비용이 수백 달러에 달할 수 있습니다. 일반적으로:

• 소규모 작업(파일 10개 이하): --max-iterations 10
• 중규모 작업(파일 50개 이하): --max-iterations 20
• 대규모 작업(전체 프로젝트 리팩토링): --max-iterations 50 + 비용 모니터링 필수

---

종합: 4가지 기능을 조합한 실무 워크플로

이 4가지 기능은 개별적으로도 강력하지만, 조합하면 시너지가 극대화됩니다. 예를 들어:

시나리오: 레거시 프로젝트 전체 TypeScript 마이그레이션

1. Batch로 전체 파일을 .js → .ts 변환 작업 단위로 분해 (병렬 실행)
2. Ralph Loop로 각 파일의 타입 에러가 0이 될 때까지 자동 수정
3. Simplify로 마이그레이션 완료 후 타입 정의 정제
4. Auto Memory가 “이 프로젝트의 타입 컨벤션은 strict mode + no implicit any” 학습
5. Remote Control로 퇴근 후 집에서 결과 확인 및 최종 리뷰

---

마치며: Claude Code는 이제 ‘도구’가 아닌 ‘동료’

정리하면 이렇습니다. Auto Memory는 세션 간 기억을 유지하고, Simplify/Batch는 반복 작업을 자동화하고, Remote Control은 공간 제약을 없애고, Ralph Loop는 시간 제약까지 허뭅니다. 제가 말하고 싶은 건, Claude Code가 이제 “질문-답변” 도구를 넘어섰다는 점입니다. 프로젝트의 컨텍스트를 이해하고, 대규모 작업을 병렬로 처리하고, 24시간 어디서나 함께 일하는 AI 페어 프로그래머에 가까워졌다고 봅니다.

다음 프로젝트에서는 이 4가지 기능을 한 번씩 꼭 써 보면 좋겠습니다. 특히 Ralph Loop으로 장시간 작업을 자동화하고, Batch로 대규모 변경을 병렬 처리해 보면, AI 시대의 개발 워크플로가 어떻게 달라지는지 직접 체감하실 수 있을 거예요.

---

관련 영상

이 글과 연결된 영상은 개발동생 유튜브 채널에서 보기에서 확인할 수 있습니다.