Workflow

https://code.claude.com/docs/ko/how-claude-code-works

Claude Code의 작동 방식 - Claude Code Docs

 

🛠️ Claude Code 워크플로우: AI와 개발자가 협업하는 '일의 흐름'

안녕하세요! 오늘은 Claude Code를 단순한 챗봇이 아닌, 진정한 'AI 에이전트'로 만들어주는 핵심 개념인 워크플로우(Workflow)를 파헤쳐 보겠습니다. 🌊

 

1. 워크플로우란 무엇인가요? 🧐

Claude Code에서 워크플로우는 "사용자의 목표를 달성하기 위해 AI가 수행하는 일련의 사고 및 실행 과정"을 의미합니다.

일반적인 AI는 질문에 답만 하고 끝내지만, Claude Code의 워크플로우는 [상황 파악 → 계획 수립 → 도구 실행 → 결과 검토]라는 능동적인 루프를 반복합니다. 이를 전문 용어로 '에이전틱 워크플로우(Agentic Workflow)'라고 부릅니다.

 

2. Claude Code 워크플로우의 4단계 루프 🔄

Claude Code는 하나의 요청을 처리할 때 내부적으로 다음과 같은 단계를 거칩니다.

단계	수행 내용	비유
1. 이해 (Analyze)	사용자의 의도와 현재 코드베이스 상황을 파악합니다.	"어디가 고장 났는지 확인하기"
2. 계획 (Plan)	어떤 파일을 수정하고 어떤 명령어를 실행할지 전략을 세웁니다.	"수리 설계도 그리기"
3. 실행 (Act)	실제 파일 수정, 테스트 실행, 검색 등 도구를 사용합니다.	"직접 렌치 들고 수리하기"
4. 관찰 (Observe)	실행 결과를 확인하고 성공 여부를 판단합니다. 실패 시 1단계로 회귀!	"수리 후 시동 걸어보기"

 

3. 워크플로우의 실전 예시 💻

사용자가 "로그인 API에 유효성 검사 로직 추가하고 테스트해줘"라고 요청했을 때의 워크플로우입니다.

1. 🔍 탐색: grep이나 ls 와 같은 도구(Tools)를 사용해 관련 컨트롤러와 테스트 코드를 찾습니다.
2. 📝 수정: 발견된 소스 코드에 유효성 검사 로직을 삽입합니다.
3. ⚙️ 검증: 터미널에서 npm test나 pytest 같은 테스트 명령어를 직접 실행합니다.
4. 🛠️ 수정(반복): 테스트 실패 시 에러 로그를 읽고 코드를 다시 고칩니다.
5. 🏁 완료: 모든 테스트가 통과되면 사용자에게 최종 결과를 보고합니다.

4. 개발자가 알아야 할 워크플로우의 특징 ✨

✅ 자율적인 도구 사용 (Tool Use)

워크플로우 도중 Claude는 스스로 판단하여 터미널 명령어를 실행합니다. 사용자는 매번 명령어를 가르쳐줄 필요 없이, Claude가 제안하는 동작을 승인(y)하기만 하면 됩니다.

✅ 컨텍스트 유지

워크플로우가 진행되는 동안 모든 과정은 '세션'에 기록됩니다. 이전 단계에서 확인한 정보가 다음 단계의 판단 근거가 되어 매우 정교한 작업이 가능해집니다.

✅ 실패로부터의 학습

명령어 실행 결과 에러가 발생하면, 워크플로우는 중단되지 않고 그 에러를 새로운 정보(컨텍스트)로 받아들여 즉시 수정 계획을 수립합니다. 🔄

 

5. 마무리하며 🏁

Claude Code의 워크플로우는 개발자의 '생각하는 방식'을 그대로 복제해 놓은 것과 같습니다. 우리가 코드를 짜고, 저장하고, 빌드하고, 에러를 확인하는 그 일련의 흐름을 AI가 대신 수행해 주는 것이죠.

이 워크플로우를 잘 이해하고 Claude에게 명확한 목표를 던져준다면, 여러분의 개발 생산성은 상상 이상으로 높아질 것입니다! 🚀✨