클로드 AI 에이전트 만들기: claude.md·플래닝 모드·워크플로 파일로 코드 없이 자동화

핵심 메시지

• AI 활용에는 3단계가 있다. 1단계는 질문·답변의 단순 채팅, 2단계는 결과물을 만들게 하는 빌더 모드, 3단계는 목표만 주면 스스로 단계를 쪼개 실행하는 에이전트 작업이다.
• 진짜 에이전트는 한 번의 응답이 아니라 과정을 따른다. 맥락 수집→계획→단계별 실행→자기 검토 순서로 움직이고, 불확실하면 추측하지 않고 먼저 질문한다.
• 클로드 데스크톱 앱의 코드 워크스페이스는 별도 개발 환경 없이 프로젝트·파일·워크플로를 다룰 수 있어 코드 한 줄 없이 에이전트를 만들 수 있다.
• 가장 중요한 파일은 claude.md다. 프로젝트 맥락·나에 대한 정보·규칙·폴더 구조를 한 번 적어두면 매 세션마다 클로드가 읽어 일관된 결과를 낸다.
• 도구보다 워크플로 파일(작업 절차서)이 더 중요하다. 잘 설계된 절차와 기본 도구가, 허술한 절차와 고급 연동보다 매번 낫다.

쉽게 이해하기

영상은 많은 사람이 클로드를 “고급 검색엔진”처럼 쓰며 1단계에 머물러 있다고 지적한다. 질문하고 답을 복사하는 방식을 넘어, 목표를 통째로 맡기면 스스로 단계를 설계하고 실행하는 3단계 ‘에이전트 작업’으로 올라설 수 있다는 것이 핵심이다.

발표자는 3단계를 구분한다. 1단계 채팅은 정의·요약·설명을 받는 가장 제한적인 사용, 2단계 빌더 모드는 스크립트·이메일·문서 분석 같은 결과물을 만들게 하되 모든 단계를 사람이 직접 관리하는 방식, 3단계 에이전트 작업은 목표(완결된 결과)를 주면 클로드가 단계를 쪼개고 필요하면 질문하며 스스로 검토까지 마치는 방식이다.

실제 구축은 클로드 데스크톱 앱의 코드 워크스페이스에서 프로젝트 폴더를 만드는 데서 시작한다. 가장 먼저 만들 파일은 claude.md로, “claude.md 파일을 만들어줘”라고 채팅에 입력하면 클로드가 생성해준다. 이 파일에는 프로젝트 맥락, 나에 대한 정보(배경·청중·말투), 규칙(예: 복잡한 작업 전 최소 3개의 확인 질문, 실행 전 계획 제시), 폴더 구조를 적는다.

발표자는 ‘플래닝 모드’를 습관으로 강조한다. 에이전트가 곧장 실행하게 두지 말고 항상 계획을 먼저 보여달라고 해, 2분간 검토로 뒤에서 10분의 수정 비용을 아끼라는 것이다. claude.md 규칙에 “다단계 작업은 먼저 서면 계획을 제시하고 승인을 기다린다”는 한 줄을 넣으면 기본 동작이 된다.

에이전트 시스템은 세 요소로 이뤄진다. 작업 절차를 평문으로 적은 워크플로 파일, 조정자 역할을 하는 클로드, 파일 읽기·생성·정리 같은 워크스페이스 내장 도구다. 발표자는 가장 중요한 것은 도구가 아니라 워크플로 파일이며, 지능은 기술 스택이 아니라 ‘지시문’에 있다고 말한다.

예시로 리서치 에이전트(주제를 주면 범위·청중·깊이를 먼저 묻고, 계획을 세운 뒤 조사·정리해 보고서를 출력 폴더에 저장)와 리퍼포징 에이전트(긴 스크립트 하나를 넣으면 숏폼 3개와 SNS 패키지를 만들어 PDF로 출력)를 직접 시연한다.

주요 인사이트

• 에이전트와 ‘똑똑한 프롬프트’의 차이는 세 가지다. 메시지 단발 응답이 아니라 과정을 따르고, 불확실하면 멈춰 질문하며, 실행 전 명확화를 거친다. 나쁜 AI 결과 대부분은 모델이 의도를 오해한 데서 나온다.
• claude.md를 건너뛰는 것이 첫 번째 실수다. 이 파일이 없으면 매 세션이 0에서 시작해 품질이 들쭉날쭉해지고, 결과를 고치는 시간이 절약 시간을 잡아먹는다.
• 목표가 모호하면 위키백과 같은 일반적 결과가 나온다. “마케팅 분야 비개발자가 콘텐츠 제작에 AI 에이전트를 어떻게 쓰는가”처럼 구체적일수록 결과가 쓸 만해진다.
• 한 번에 모든 것을 만들려다 다섯 개의 반쪽짜리 시스템을 갖게 되는 것이 흔한 실패다. 하나의 워크플로를 신뢰할 수 있을 때까지 돌린 뒤 다음으로 넘어가야 한다.
• 지속되는 작업 공간의 맥락이 복리처럼 쌓인다. 결과물이 나온 뒤에도 처음부터 다시 시작하지 않고 “요약을 3개 포인트로 줄여줘”처럼 부분만 빠르게 다듬을 수 있다.

자주 묻는 질문

관련 AI 소식