도입

모니터 왼쪽에는 빈 폴더가 하나 열려 있습니다. 파일이 하나도 없는 깨끗한 프로젝트입니다. 모니터 오른쪽에는 작은 게 아이콘이 달린 채팅창이 보입니다. 이것이 클로드 코드의 에이전트 인터페이스입니다. 이 빈 폴더와 채팅창만으로, 지금부터 경쟁사 분석 보고서를 자동으로 생성하는 워크플로우를 구축할 것입니다. 코드를 한 줄도 직접 작성하지 않고요.

VS Code 설치와 클로드 코드 확장 프로그램 연결

클로드 코드를 사용하려면 먼저 비주얼 스튜디오 코드(Visual Studio Code, 이하 VS Code)를 설치해야 합니다. VS Code는 통합 개발 환경(IDE)이라는 도구인데, 개발자들이 코드를 작성하고 관리하는 작업 공간이라고 생각하면 됩니다. 무료로 내려받을 수 있으며, 윈도우와 맥 모두에서 작동합니다.

설치가 끝나면 VS Code를 열어 봅니다. 화면 왼쪽 세로 메뉴바에서 사각형 네 개가 모인 아이콘을 찾습니다. 확장(Extensions) 메뉴입니다. 이 아이콘을 클릭하면 검색창이 나타나고, 여기에 "Claude Code"를 입력합니다. 앤트로픽(Anthropic)이 배포한 공식 확장 프로그램이 상단에 표시됩니다.

이 확장을 설치하면 VS Code 안에서 클로드 코드 에이전트와 대화할 수 있는 창구가 열립니다.

설치 버튼을 누르면 곧바로 앤트로픽 계정 로그인을 요청합니다. 클로드 코드를 사용하려면 유료 구독이 필요합니다. 프로(Pro) 플랜은 월 17달러(한화 약 2만 3천 원)부터 시작하며, 클로드 코드와 최신 오퍼스(Opus) 모델을 포함합니다. 사용량이 늘어나면 맥스(Max) 플랜으로 업그레이드할 수 있습니다.

맥스 플랜은 사용 한도가 높아서, 여러 워크플로우를 동시에 구축하거나 긴 대화를 이어갈 때 유리합니다.

[그림 4-01: VS Code 왼쪽 확장 메뉴에서 Claude Code를 검색한 화면. Install 버튼이 강조 표시되어 있다.]

프로젝트 폴더 열기와 에이전트 인터페이스 이해

클로드 코드 확장이 설치되면, 화면 오른쪽 상단에 작은 앤트로픽 로고 버튼이 나타납니다. 하지만 이 버튼을 누르기 전에 먼저 프로젝트 폴더를 열어야 합니다. 왼쪽 메뉴에서 탐색기(Explorer) 아이콘을 클릭하면 "아직 폴더를 열지 않았습니다"라는 메시지가 보입니다.

컴퓨터의 바탕화면이나 문서 폴더에 빈 폴더를 하나 만듭니다. "첫번째_워크플로우"라는 이름이면 충분합니다. VS Code에서 이 폴더를 열면, 왼쪽 탐색기에 폴더 이름이 표시되고 그 아래는 텅 비어 있습니다. 이 빈 공간이 앞으로 에이전트가 만들어내는 파일들로 채워질 것입니다.

이제 오른쪽 상단의 앤트로픽 로고 버튼을 클릭합니다. 환영 화면이 뜨면 닫아 줍니다. 화면이 두 영역으로 나뉩니다. 왼쪽은 파일 탐색기, 오른쪽은 에이전트와의 대화창입니다. 이 대화창은 카카오톡이나 챗GPT 인터페이스와 비슷합니다. 메시지를 입력하고 전송하면, 에이전트가 생각하고, 행동하고, 결과를 보여줍니다. 왼쪽에서는 에이전트가 실시간으로 생성하는 파일과 폴더를 확인할 수 있습니다.

[그림 4-02: VS Code 화면 분할. 왼쪽 파일 탐색기에 빈 프로젝트 폴더, 오른쪽에 클로드 코드 채팅 인터페이스가 표시된 화면.]

계획 모드로 에이전트와 대화하기: 경쟁사 분석 워크플로우 기획

대화창 하단에 모드 선택 옵션이 있습니다. 네 가지 모드 중 "계획 모드(Plan Mode)"를 선택합니다. 계획 모드에서 에이전트는 코드를 작성하거나 파일을 만들지 않습니다. 대신 계획을 세우고, 질문을 던지고, 접근 방식을 제안합니다. 집을 짓기 전에 설계도를 먼저 그리는 것과 같습니다.

에이전트에게 이렇게 말합니다.

"경쟁사 분석 워크플로우를 만들고 싶어. 최종 결과물은 우리 회사 로고와 브랜드 색상이 적용된 PDF 보고서야. 우리 회사 정보를 입력하면, 에이전트가 경쟁사를 찾아서 분석하고, 기회 영역과 개선점을 정리해 줬으면 해. 계획을 세워줘. 질문이 있으면 해."

이 메시지를 보내면 에이전트는 생각하기 시작합니다. 대화창에 에이전트의 사고 과정이 실시간으로 표시됩니다. "기존 워크플로우와 도구를 탐색합니다", "브랜딩과 PDF 생성 방법을 조사합니다" 같은 메시지가 흐릅니다. 잠시 뒤, 에이전트가 질문을 던집니다.

에이전트의 질문은 구체적입니다. "경쟁사를 어떻게 식별할까요? 직접 목록을 주시겠습니까, 아니면 제가 자동으로 발견하게 할까요?" "어떤 측면을 분석할까요? 가격 정책, 제품 기능, 마케팅 메시지 중 선택하거나 전부 분석할 수 있습니다." "보고서를 얼마나 자주 만들까요? 월간, 주간, 필요할 때?" 이런 질문에 하나씩 답하면, 에이전트는 답변을 반영하여 계획을 다듬습니다.

계획이 완성되면 에이전트가 전체 구현 계획서를 보여줍니다. 어떤 기술을 사용할 것인지(클로드 소네트 모델, 파이어크롤 API, 리포트랩 PDF 생성 라이브러리), 어떤 폴더 구조로 정리할 것인지, 어떤 도구 파일을 만들 것인지가 모두 정리되어 있습니다. 비용 추정도 포함됩니다. 첫 실행에 약 1.5달러, 이후 반복 실행은 캐싱된 데이터 덕분에 비용이 절감됩니다.

[그림 4-03: 에이전트가 제시한 경쟁사 분석 워크플로우 구현 계획서. 기술 스택, 파일 구조, 비용 추정이 포함된 화면.]

브랜드 자산 투입: 로고와 색상 가이드라인 반영

계획을 승인하기 전에 한 가지를 조정합니다. 에이전트가 임의의 색상과 타이포그래피를 적용하는 대신, 실제 회사 브랜드를 반영하도록 하는 것입니다.

컴퓨터에 저장된 회사 로고 파일(PNG 형식)과 브랜드 가이드라인 이미지를 왼쪽 파일 탐색기 영역으로 드래그합니다. 파일이 프로젝트 폴더에 추가됩니다. 그런 다음 에이전트에게 말합니다.

"방금 로고 파일과 브랜드 가이드라인을 넣었어. 이 파일들을 확인하고, 로고와 색상과 타이포그래피를 PDF 보고서에 반영해줘."

에이전트는 투입된 이미지를 분석합니다. 로고를 인식하고, 브랜드 가이드라인에서 주 색상, 보조 색상, 서체 정보를 추출합니다. "로고를 확인했습니다. 브랜드 색상을 추출하여 PDF에 적용하겠습니다"라는 응답과 함께, 계획서가 업데이트됩니다. 이제 계획을 승인합니다.

워크플로우 실행과 PDF 보고서 생성

계획 승인 후, 에이전트는 투두 리스트(To-Do List)를 생성하고 작업을 시작합니다. 왼쪽 파일 탐색기에 폴더와 파일이 하나씩 나타나기 시작합니다. brand_assets 폴더가 생기고, workflows 폴더 안에 경쟁사 분석 워크플로우 파일이 만들어지고, tools 폴더 안에 다섯 개의 파이썬 도구 파일이 생성됩니다.

비즈니스 정보 수집, 경쟁사 발견, 경쟁사 조사, 경쟁사 분석, PDF 보고서 생성 — 각각 하나의 독립된 도구입니다.

에이전트가 회사 정보를 물어옵니다. "주요 타깃 시장은 무엇입니까?" "가격대는 어떻게 되나요?" "핵심 차별화 요소가 있습니까?" 이 질문에 답하면, 에이전트는 business_profile.json이라는 파일을 만들어 회사 정보를 저장합니다. 다음에 이 워크플로우를 실행할 때는 같은 질문을 반복하지 않습니다. 에이전트가 이미 알고 있기 때문입니다.

이어서 에이전트는 자동으로 경쟁사를 탐색합니다. 웹을 검색하고, 경쟁사 목록을 만들고, 각 경쟁사의 제품·가격·강점을 조사합니다. 조사 결과가 competitors 폴더에 경쟁사별 개별 파일로 저장됩니다. 분석이 끝나면 최종 PDF 보고서가 생성됩니다.

[그림 4-04: 워크플로우 실행 후 왼쪽 파일 탐색기에 생성된 폴더 구조. brand_assets, workflows, tools, competitors 폴더와 그 안의 파일들이 보인다.]

오류 수정과 반복 개선: 로고 미표시 문제 해결 사례

첫 번째 결과물이 완벽할 가능성은 낮습니다. 이것은 실패가 아니라 구축 과정의 자연스러운 일부입니다.

PDF 보고서를 열어 봅니다. 브랜드 색상과 타이포그래피가 적용되어 있습니다. 경쟁사 프로필, 위협 수준 분류, 전략적 권고사항이 정리되어 있습니다. 그런데 로고가 보이지 않습니다. 가격 분석 차트도 빠져 있습니다.

에이전트에게 말합니다.

"보고서 괜찮은데, 로고가 안 보여. 아마 흰색 배경 위에 흰색 로고라서 그런 것 같아. 차트도 없어. 확인하고 고쳐줘."

에이전트는 문제를 진단합니다. "PDF 생성기에 몇 가지 문제가 있습니다"라고 응답하고, 문제 목록을 나열합니다. 그런 다음 도구 파일의 코드를 수정합니다. 로고 배경에 컬러 패드를 추가하고, 차트 생성 로직을 보완합니다. 수정된 도구로 보고서를 다시 생성합니다. 이때 경쟁사 데이터를 다시 수집하지는 않습니다. 이전 실행에서 캐싱한 데이터를 재활용합니다.

두 번째 보고서를 열면, 로고가 선명하게 보이고 가격 분석 차트가 포함되어 있습니다. 이 과정이 자가 치유입니다. 사람이 오류를 알려주면, 에이전트가 원인을 파악하고, 코드를 수정하고, 워크플로우를 갱신하여 같은 오류가 반복되지 않도록 만듭니다.

여기서부터는 미세 조정의 영역입니다. "경쟁사 프로필에 더 자세한 정보를 넣어줘", "권고사항을 세 개에서 다섯 개로 늘려줘" 같은 요청을 자연어로 전달하면, 에이전트가 반영합니다. 워크플로우를 여러 차례 실행하고 수정 의견을 줄수록, 결과물의 품질이 올라갑니다.

비용 분석: 첫 실행 1.43달러의 의미

이 워크플로우의 첫 실행 비용은 약 1.43달러(한화 약 2천 원)였습니다. 경쟁사 8곳을 조사하고, 각 경쟁사의 제품·가격·마케팅 전략을 분석하고, 브랜드가 적용된 PDF 보고서를 생성하는 전체 과정에 들어간 API 비용입니다.

이 작업을 사람이 수동으로 수행한다면 어떨까요. 경쟁사 웹사이트를 하나씩 방문하고, 정보를 정리하고, 엑셀이나 파워포인트로 보고서를 만드는 데 최소 반나절, 길면 하루가 소요됩니다. 시간당 인건비를 고려하면, 2천 원은 파격적인 투자 수익률입니다.

반복 실행의 비용은 더 낮습니다. 경쟁사 기본 정보와 회사 프로필이 이미 저장되어 있기 때문에, 에이전트는 변동 사항만 확인합니다. 데이터 캐싱 덕분에 API 호출 횟수가 줄어들고, 비용도 자연스럽게 절감됩니다.

이 비용 구조는 에이전트 작업 흐름의 경제적 매력을 압축해서 보여줍니다. 처음 한 번의 구축에 시간과 비용을 투입하면, 이후에는 낮은 비용으로 반복 실행이 가능합니다. 그리고 이 "처음 한 번의 구축"조차, 에이전트가 대부분의 작업을 수행하기 때문에 소요 시간이 짧습니다.

PDF 보고서가 화면에 열려 있습니다. 회사 로고가 좌측 상단에 선명하게 찍혀 있고, 경쟁사별 위협 수준이 색상으로 구분되어 있으며, 가격 분석 차트가 데이터를 시각적으로 보여줍니다. 이 보고서를 만드는 데 사용한 모든 도구와 워크플로우는 프로젝트 폴더에 남아 있습니다.

다음 달에 "이번 달 경쟁 분석 돌려줘"라고 한 마디만 하면, 에이전트는 워크플로우를 읽고, 도구를 실행하고, 최신 데이터가 반영된 새 보고서를 내놓을 것입니다. 그런데 이 워크플로우를 돌리기 위해 에이전트에게 준 지시서, 그러니까 에이전트의 업무 매뉴얼이라 할 수 있는 그 문서를 어떻게 작성해야 하는지 살펴보겠습니다.

[그림 4-05: 완성된 경쟁사 분석 PDF 보고서. 회사 로고, 브랜드 색상, 경쟁사 프로필, 가격 분석 차트가 포함된 보고서의 주요 페이지.]

[도표 03-01: 에이전트 작업 흐름의 구축-실행-개선 사이클. 계획 모드(계획) → 구축(구축) → 검증(검증) → 수정 의견(수정) → 반복이 순환하는 흐름도.]