5분 안에 첫 마이크로빌드 실행하기

Source: CircleCI Blog

AI 코딩 에이전트는 대부분의 팀이 검증할 수 있는 속도보다 더 빠르게 코드를 생성합니다. 에이전트와 CI 사이에 검증 단계가 없으면 모든 문제는 푸시 후에 잡히게 되고, 피드백은 에이전트가 컨텍스트를 잃은 뒤에 도착합니다. 에이전트는 작업 중에 일관된 피드백이 필요하므로 작은 실패를 로컬에서 바로 수정하고 CI는 코드가 프로덕션으로 이동하는 데 집중할 수 있습니다.

이 튜토리얼에서는 Chunk sidecars를 설정하고 첫 번째 microbuild를 실행합니다. 이는 에이전트가 일시 중지될 때 자동으로 트리거되는 범위 지정 검증으로, CI를 그대로 반영한 환경에서 몇 초 안에 변경 사항을 테스트하고 에이전트가 즉시 수정할 수 있는 기회를 제공합니다. 몇 개의 터미널 명령만으로 가벼운 검증 루프를 에이전트에 연결하여 AI‑generated 커밋이 더 높은 신뢰성을 가지고 적용되도록 할 수 있습니다.

Prerequisites

• macOS, WSL, 또는 Homebrew가 설치된 Linux
• Claude Code (또는 선호하는 AI 코딩 에이전트)
• CircleCI 계정(무료 플랜 포함) 및 personal API token

💡 Note: 개인 API 토큰만 필요합니다. Chunk는 VCS 연결이나 프로젝트 가져오기 설정이 필요 없으므로, 새 CircleCI 가입만으로도 즉시 마이크로빌드를 실행할 수 있습니다.

설정

1. Homebrew를 통해 Chunk CLI를 설치합니다:

   brew install CircleCI-Public/circleci/chunk

2. React 데모 저장소를 복제하고 해당 디렉터리로 이동합니다:

   git clone https://github.com/CircleCI-Public/circleci-demo-javascript-react-app
   cd circleci-demo-javascript-react-app

3. CircleCI 개인 API 토큰으로 Chunk를 인증합니다 (CLI가 토큰을 입력하라는 프롬프트를 표시하고 로컬에 저장합니다):

   chunk auth set circleci

4. 프로젝트 디렉터리에서 Chunk를 초기화합니다:

   chunk init

   이 명령은 프로젝트를 스캔하고 npm + Jest 스택을 감지하여 npm test를 검증 명령으로 등록합니다. 또한 Claude Code에 작은 훅을 설치하여 에이전트가 각 응답 후 자동으로 해당 검증을 실행하도록 합니다.

실패 심기

src/App.js 파일을 열고 render() 메서드의 가장 위에 의도적인 오류를 추가합니다:

throw new Error('intentional failure for demo');

이렇게 하면 테스트 스위트가 깨끗한 스택 트레이스와 함께 강제 종료됩니다.

마이크로빌드 실행

Claude Code에서 입력:

validate on the sidecar

chunk-sidecar 스킬이 작동합니다. 첫 실행 시 어느 CircleCI 조직을 사용할지 묻습니다(조직 ID는 app.circleci.com → Organization Settings → Overview에서 확인할 수 있습니다). 그런 다음 마이크로VM에서 원격으로 테스트를 실행하고, 실패를 가로채어 오류 로그를 Claude에 반환합니다.

에이전트는 스택 트레이스를 읽고, src/App.js를 열어 throw를 삭제하고, 다시 동기화한 뒤 재검증합니다.

단일 프롬프트만으로 에이전트는 전체 동기화, 설치, 테스트, 수정 및 재검증 사이클을 조율합니다.

검증 루프 내부

• chunk init가 package.json에서 npm + Jest 스택을 감지하고 npm test를 검증 게이트로 등록했습니다. .chunk/config.json와 .claude/settings.json을 리포지토리에 추가했습니다.
• 보안 Linux 마이크로VM이 약 1초 만에 CircleCI 계정에서 시작되었습니다. 그 위에 Node.js가 설치되었습니다(≈ 13 초 일회성 비용). chunk sidecar snapshot create --name node-react를 실행하면 해당 상태를 재사용 가능한 이미지로 고정시켜 향후 마이크로빌드에서 설치 단계를 제거할 수 있습니다.
• chunk sidecar sync는 작업 트리를 복사했으며, 스테이징되지 않은 편집 내용도 포함하여 사이드카의 /workspace/circleci-demo-javascript-react-app에 복사했습니다. git 커밋, 푸시, 풀 리퀘스트가 필요하지 않았으며, 원격 트리는 필요에 따라 로컬 트리를 그대로 반영합니다.
• Jest 테스트가 실패하면, 실패 출력이 에이전트 컨텍스트로 반환되었습니다. 에이전트는 src/App.js를 로컬에서 수정하고, 다시 동기화한 뒤 검증을 재실행했습니다—전체 CI 실행이 필요하지 않았습니다.

실제 프로젝트에서 Chunk 사이드카 사용해 보기

약 5분 정도면 Chunk가 새로 설치된 상태에서 에이전트 기반 검증 루프가 작동하는 단계까지 진행됩니다. 코드를 작성하고 원격 빌드를 기다리는 사이의 컨텍스트 전환 대신, 빠른 반복 작업이 에이전트가 존재하는 곳에서 바로 이루어집니다.

Microbuild는 무료 티어를 포함한 모든 CircleCI 플랜에 포함되어 있습니다. 계정에 가입하세요, Chunk CLI를 설치하고 chunk init을 자신의 프로젝트 중 하나에서 실행해 보세요. 일상적인 개발 루프에 얼마나 쉽게 통합되는지 확인할 수 있습니다.