클로드 코드 & 오픈클로를 읽고서

클로드 코드 & 오픈클로

요즘 한창 클로드 코드를 적극적으로 사용하고 있는 와중에 서평단을 지원하게 되었습니다. 클로드 코드 관련으로 나온 2권의 책을 같이 신청하면서 한 권이라도 되면 열심히 읽고서 후기로 작성하자라고 생각했는데 감사하게도(?) 2권이 같이 선정되는 예상치 못한 일이 발생했습니다. 길벗 출판사에 감사의 인사를 드리며 시작해 보도록 하겠습니다.

 

*해당 책은 출판사로부터 제공받아 직접 읽고 제 개인적인 평을 기록하였습니다.

목차

1부 | 이론편

1장 바이브 코딩: 코드 없이 만드는 세상

2장 AI 에이전트: 바이브 코딩과의 관계

3장 자동화: 왜 직접 에이전트를 만들어야 하는가

4장 클로드 코드: 에이전트를 만들고 실행하는 도구

5장 오픈클로: 외부 세계와 연결하는 손과 발

6장 클로드 코드 프롬프트 잘 쓰는 법

 

2부 | 준비편

1장 Node.js 설치

2장 파이썬 3 설치

3장 OpenAI API 키 발급: LLM 에이전트에서 활용

4장 Tabily API 키 발급: 웹 검색 에이전트에서 활용

5장 텔레그램 설정

6장 클로드 코드 설치

7장 오픈클로 설치

8장 커넥터로 Gmail Google Calendar 연결

 

3부 | 실습편

1장 개인 비서 & 라이프케어

1.1 여행 계획 설계

1.2 자연어 기반 자동 일정 관리

1.3 업무 & 커뮤니케이션 자동화

2장 업무 & 커뮤니케이션 자동화

2.1 메일 분류 및 답장 초안 작성

2.2 긴급 파일 전송 서비스

2.3 뉴스 및 채용 공고 모니터링

3장 금융 & 정보 모니터링

3.1 쇼핑 가격 추적 및 최저가 알림

3.2 최신 뉴스 기반 주식 영향 분석

3.3 환율 모니터링 및 환전 타이밍 알림

3.4 부동산 시세 평가 에이전트

3.5 SNS 트렌드 키워드 추적기

바이브 코딩의 탄생: 안드레이 카파시, 새로운 문을 열다

이 발언은 프로그래밍 세계에 큰 반향을 일으켰습니다. 세계 최고 수준의 AI 연구자가 코드를 직접 작성하지 않고 AI와 대화만으로 소프트웨어를 만든다고 공언한 것입니다. 기술이 마침내 누구나 개발자가 될 수 있는 임계점을 넘었다는 선언이었습니다.

바이브 코딩 vs 기존 개발, 본질적으로 다르다

바이브 코딩은 기존 개발 방식과 근본적으로 다릅니다. 단순히 더 빠른 개발이 아니라, 개발의 본질 자체가 달라집니다.

구분	기존 개발	바이브 코딩
역할 분담	기획자 > 개발자 분리	기획 = 개발 = 검증 동일
언어	프로그래밍 언어 문법 필수	자연어(한국어, 영어) 사용
디버깅	오류 메시지 직접 해석, 코드 수정	AI가 오류 자동 수정
개발 시간	수 시간 ~ 수 개월	수 분 ~ 수 시간
수정 용이성	코드 구조를 이해한 후 수정	즉시 수정
필요 학습	프로그래밍 언어별로 수년간 학습	원하는 것을 설명하는 능력 필요
핵심 역량	프로그래밍 실력	업무 도메인 지식 + 정확한 지시와 설명

• 차이 1. 역할의 벽이 사라진다
• 차이 2. 실패 비용이 극적으로 낮아진다
• 차이 3. 필요한 전문성이 바뀐다
• 차이 4. 개발의 리듬이 달라진다

이 책에서의 바이브 코딩 방식

실습을 할 때 코드는 한 줄도 직접 작성하지 않습니다. 모든 코드는 클로드 코드가 생성하고 실행합니다. 이때 사람의 역할은 원하는 것을 설명하고, 결과를 검증하고, 방향을 제시하는 것입니다.

단계	내가 하는 일	클로드 코드가 하는 일
1단계	'여행 플래너 에이전트 만들어줘'라고 요청	요구사항 분석 후 에이전트 파일 자동 생성
2단계	생성된 에이전트 파일 구조 확인	에이전트 자동 실행 및 결과 생성
3단계	실행 결과 화면 확인	오류 발생 시 스스로 원인 분석 후 코드 수정
4단계	'코스 순서 바꿔 줘'라고 요청	에이전트 파일 수정 후 재실행
5단계	최종 결과 승인	에이전트 워크플로 연결 및 완성

챗봇과 에이전트: '말하는 것'과 '행동하는 것'의 차이

챗봇은 '입력 > 출력'의 단순한 구조를 가집니다. 사용자가 질문하면 AI가 답변을 텍스트로 반환합니다.

에이전트는 '지시 > 계획 > 실행 > 완료'의 복잡한 루프를 갖습니다. 에

비교 항목	챗봇	에이전트
결과물	텍스트 응답	실행 완료된 작업
도구 사용	없음 또는 제한적	다양한 외부 도구 적극 활용
자율 판단	단계마다 사람의 개입 필요	스스로 다음 행동 결정
작동 방식	1회 요청 > 1회 응답	목표 달성까지 반복 실행(루프)
기억	현재 대화 위주	장기 기억, 작업 이력 유지
오류 대응	사람이 직접 해결	스스로 재시도, 대안 탐색
상황 예시	'파스타 레시피 알려 줘' > 텍스트 출력	"냉장고 재료로 파스타 만들고 재고관리 업데이트"  > 결과물 완성

기성 자동화 도구의 구조적 한계: 왜 직접 만들어야 하는가?

• 미리 정해진 조합만 가능
• 지능적 판단 능력의 부재
• 로컬 파일 시스템 접근 불가

비교 항목	Zapier/Make	노션 AI	RPA 도구	직접 만든 에이전트
맞춤 기능 구현	제한적	매우 제한	제한적	완전 자유
지능적 판단	규칙 기반만	일부 가능	규칙 기반만	LLM 수준
로컬 파일 접근	불가	불가	가능(복잡)	완전 가능
월 비용	수만 ~ 수십만 원	구독료 별도	수십만 원~	API 비용만
데이터 위치	외부 서버	외부 서버	로컬 혹은 외부 서버	내 PC
설정 방식	GUI 클릭	GUI 클릭	GUI 클릭	자연어 대화

나만의 에이전트 제작 과정: 의도가 코드가 되는 5단계

클로드 코드와 함께 에이전트를 만드는 과정을 5단계로 살펴보겠습니다. 예시로는 매일 아침 관심 뉴스를 수집해서 중요한 것만 메일로 받는 에이전트를 만든다고 가정합시다.

• 1단계: 의도 전달 - 원하는 것을 설명한다
• 2단계: 계획 확인 - 클로드 코드의 설계 검토
• 3단계: 자동 생성 - 파일이 만들어진다
• 4단계: 실행 및 검증 - 동작 확인
• 5단계: 피드백 및 개선 - 대화로 수정

단계	이름	독자의 역할	클로드 코드의 역할
1단계	의도 전달	원하는 기능 설명	요구사항 분석
2단계	계획 확인	설계 방향 검토 및 승인	파일 구조 설계
3단계	자동 생성	결과물 확인	에이전트 파일 자동 작성
4단계	실행 및 검증	실행 결과 확인	openclaw run + 자동 디버깅
5단계	피드백 및 개선	개선 사항을 말로 설명	파일 수정 + 재실행

에이전트가 원하는 대로 동작할 때까지 5단계 사이클을 반복합니다. 보통 2 ~ 4번의 사이클이면 대부분의 에이전트가 완성됩니다.

실습별로 필요한 항목

• Node.js
• 파이썬 3
• 클로드 코드
• 오픈클로
• OpenAI API 키
• Gmail
• Google Calendar
• Tavily 웹 검색
• 텔레그램(선택)

Node.js 설치

Node.js — Node.js® 다운로드

파이썬 3 설치

Python 3.14.4를 설치하면 됩니다.

Download Python

OpenAI API 키 발급: LLM 에이전트에서 활용

무료 버전으로는 실습을 진행하기 어렵습니다. Credit을 구매해서 진행해야 한다는 점을 알립니다.

OpenAI Platform

Tavily API 키 발급: 웹 검색 에이전트에서 활용

웹 검색은 에이전트가 인터넷에서 실시간으로 정보를 검색할 수 있게 해 주는 기능입니다. 뉴스 수집, 상품 정보 조사, 최신 데이터 확인 등에 사용됩니다.

Tavily API Platform

텔레그램 설정

텔레그램 데스크톱

클로드 코드 설치 준비를 위한 Git for Windows 설치

Git - Install for Windows

클로드 코드 설치

윈도우 사용자는 파워셸에서 설치를 진행합니다. 먼저 시작 메뉴에서 'PowerShell'을 검색하거나 Win + X 키를 누른 뒤 Windows PowerShell을 선택합니다. 그리고 아래의 커맨드를 입력하면 설치가 진행됩니다.

irm https://claude.ai/install.ps1 | iex

설치 이후에 설치 경로를 환경 변수로 등록해야 합니다. 이를 위해 Windows 검색에서 시스템 환경 변수 편집을 입력하여 검색한 후  등록합니다.

오픈클로 설치

PowerShell을 관리자 권한으로 실행한 뒤 아래 명령어를 입력합니다. 실행 주 질문이 나타나면 예를 선택합니다.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

이제 다음 명령어를 입력하여 오픈클로를 설치합니다.

npm install -g openclaw@latest; openclaw --version

정리하면서

클로드 코드 & 오픈클로를 읽으면서 자세한 설명과 그림이 빼곡하게 수록되어 있어서 천천히 따라가면서 진행하기에 안성맞춤이었습니다. 아직 실습까지는 진행하지는 못했지만 기본적인 준비과정을 완료한 상태여서 실제 실습 과정도 시간이 된다면 올려보도록 하겠습니다.

관련 깃허브 링크

실습에 필요한 CLAUDE.md 파일이 있는 깃허브 링크를 첨부합니다.

GitHub - gilbutITbook/080514: 클로드 코드 & 오픈클로 실습 파일

도서 링크

클로드 코드 & 오픈클로 | 서지영 | 길벗 - 예스24