AI 서재
책으로 읽는 AI서재
한 권을 고르고, 목차에서 차례대로 읽을 수 있게 정리했습니다.
PDF 다운로드 책
다국어로 읽는 대학생 교양 인공지능
한국어 원문과 외국어 번역을 함께 실은 유학생용 교재입니다. 각 책 소개 페이지에서 PDF를 받을 수 있습니다.
[AI서재] 3장 클로드 코드, 누구나 쓸 수 있다
클로드 코드 완전정복
3장 클로드 코드, 누구나 쓸 수 있다
김경진 변호사
도입
매일 아침 카페에서 노트북을 펼치는 프리랜서 컨설턴트가 있습니다. 그는 n8n으로 클라이언트의 이메일 자동 분류 시스템을 만들어 왔고, Zapier로 CRM 데이터를 구글 시트에 동기화하는 워크플로우도 수십 개 운영합니다. 자동화의 맛을 충분히 본 사람입니다. 그런데 요즘 클라이언트들이 묻기 시작합니다.
"에이전트형 AI로 할 수 있는 건 없나요?" 그는 에이전틱이라는 단어를 들을 때마다 슬쩍 불안해집니다. 코딩을 배워야 하나, 파이썬부터 시작해야 하나. 그런데 막상 클로드 코드를 열어 보니, 그가 입력하는 것은 코드가 아니라 한국어 문장이었습니다.
n8n·Zapier 경험자가 가진 숨겨진 강점
에이전트 작업 흐름이 주목받으면서, 기존 자동화 도구 경험이 쓸모없어지는 것 아닌가 하는 걱정이 생길 수 있습니다. 정반대입니다. n8n이나 Zapier로 워크플로우를 만들어 본 사람은 에이전트 시스템을 다룰 때 결정적인 이점을 가집니다.
웹훅(웹훅)이 무엇인지 압니다. API가 어떻게 작동하는지 감각적으로 이해합니다. 데이터가 한 노드에서 다른 노드로 흘러가는 구조를 머릿속에 그릴 수 있습니다. 이 기초가 없는 사람이 에이전틱 도구에 뛰어들면, 에이전트가 만들어 놓은 결과물이 좋은 것인지 나쁜 것인지 판별할 수 없습니다. 에이전트가 잘못된 판단을 내렸을 때, 그것이 잘못되었다는 사실 자체를 알아차리지 못합니다.
자동화의 기본 원리를 체득한 사람은 에이전트에게 지시할 때도 정확합니다. "이 웹사이트에서 리드를 긁어줘"라는 막연한 요청 대신, "이 URL에서 영업직 채용 공고를 웹 정보 수집하되, 직종·지역·경력 필드를 포함해서 엑셀로 정리하고, 200건까지만 가져와"라고 말합니다. 에이전트는 이런 구체적 지시를 받았을 때 훨씬 나은 결과를 내놓습니다.
기초 없이 뛰어들면 생기는 함정: 웹훅을 모르면 실수를 못 본다
에이전트 작업 흐름 시장이 뜨거워지면서, 자동화 경험 없이 곧바로 클로드 코드에 뛰어드는 사람이 늘고 있습니다. "코딩 필요 없이 앱을 만들 수 있다"는 메시지에 끌려서입니다. 클로드 코드가 개발자가 아닌 사람에게 강력한 도구인 것은 분명합니다. 하지만 기초 개념을 완전히 건너뛰면 위험합니다.
에이전트에게 "리드 스크래퍼를 만들어줘"라고 지시했다고 가정해 보겠습니다. 에이전트는 열심히 코드를 작성하고, 도구를 만들고, 워크플로우를 구성합니다. 결과물이 나옵니다. 그런데 그 결과물이 정말로 괜찮은 것인지, 보안에 취약한 부분은 없는지, 데이터를 올바르게 처리하고 있는지 어떻게 판단할 수 있을까요.
웹훅이 무엇인지 모르는 사람은 에이전트가 웹훅 설정을 잘못해도 알아차리지 못합니다. API 호출의 기본 구조를 모르는 사람은 에이전트가 불필요한 API 호출을 반복하며 비용을 낭비해도 깨닫지 못합니다.
이 책은 코딩 경험이 없는 독자를 위해 쓰였습니다. 프로그래밍 언어를 배우라는 이야기가 아닙니다. 다만, 자동화의 기본 개념 — 데이터가 어디서 어디로 흐르는지, 트리거가 무엇인지, API 키가 왜 필요한지 — 을 이해하는 것이 에이전트 작업 흐름을 제대로 다루는 데 필수라는 점을 강조합니다. 이 책의 앞부분에서 그 기초를 함께 다질 것입니다.
코딩을 모른 채 코딩 도구를 다루는 시대의 도래
전통적으로 소프트웨어를 만들려면 프로그래밍 언어를 배워야 했습니다. 변수를 선언하고, 반복문을 쓰고, 함수를 정의하는 법을 익혀야 했습니다. 그 과정이 진입 장벽이었습니다. n8n과 Zapier가 그 장벽을 한 단계 낮췄습니다. 노드를 드래그 앤 드롭으로 연결하면 워크플로우가 만들어졌으니까요. 수동 코딩에 비해 구축 시간이 획기적으로 줄었습니다.
클로드 코드는 그 장벽을 한 단계 더 낮춥니다. 드래그 앤 드롭조차 필요 없습니다. 자연어로 원하는 것을 설명하면, 에이전트가 코드를 작성하고, 파일을 생성하고, 오류를 수정합니다. 사용자는 파이썬 코드를 읽을 줄 몰라도 됩니다. 에이전트가 만든 도구(Tool) 파일은 .py 확장자를 달고 있지만, 사용자가 그 안의 코드를 직접 편집할 일은 거의 없습니다.
사용자의 역할은 관리자, 감독자, 아키텍트에 가깝습니다. 무엇을 만들지 결정하고, 결과물을 검토하고, 방향을 수정하는 것입니다.
이 변화의 속도를 실감하려면 타임라인을 보면 됩니다. 수동 코딩으로 자동화 시스템을 만드는 데 걸리던 시간을 기준선으로 잡으면, 코드 없이 쓰는 도구의 등장으로 구축 시간이 크게 단축되었고, 에이전틱 도구의 등장으로 다시 한번 대폭 줄어들었습니다. 이 추세는 가속하고 있습니다.
클로드 코드가 제공하는 말로 하는 제어의 힘
클로드 코드에서 워크플로우를 만드는 과정은, 지시를 잘하는 사람이 결과를 잘 받는 과정입니다. "경쟁사를 분석해줘"라고 말하면 에이전트는 일단 무언가를 만들어 냅니다. 하지만 "우리 회사는 AI 리드 생성 플랫폼이고, 주 타깃은 마케팅 에이전시이며, 월 구독료는 200에서 500달러 범위입니다.
경쟁사의 가격 정책, 핵심 기능, 타깃 시장을 비교 분석해서, 우리 로고와 브랜드 색상이 적용된 PDF 보고서로 만들어줘"라고 말하면 결과물의 수준이 완전히 달라집니다.
에이전트와의 소통에서 핵심은 두 가지입니다. 목표를 구체적으로 서술하는 것, 그리고 완료 기준을 명확히 하는 것입니다. "잠재 고객 목록을 만들어줘"보다 "미국과 유럽의 영업직 채용 공고 500건을 웹 정보 수집해서, 직종·지역·연봉 컬럼이 포함된 엑셀 파일로 저장해줘"가 낫습니다. 에이전트는 후자의 지시에서 언제 작업을 멈춰야 하는지, 어떤 데이터를 수집해야 하는지 분명하게 파악합니다.
n8n에서 노드의 파라미터를 하나하나 설정하던 작업이, 클로드 코드에서는 자연어 한 단락으로 대체됩니다. API 문서를 읽고, 올바른 엔드포인트를 찾고, JSON을 구조화하는 일을 에이전트가 대신합니다. 사용자에게 남는 것은 "무엇을 원하는가"를 정확하게 표현하는 능력이며, 그것이야말로 코딩보다 더 보편적이고 훈련 가능한 기술입니다.
프리랜서 컨설턴트는 카페에서 첫 번째 에이전트 작업 흐름을 완성합니다. n8n에서 3시간 걸리던 워크플로우를 클로드 코드에서는 20분 만에 만들었습니다. 에이전트가 생성한 파이썬 코드를 한 줄도 읽지 않았지만, 결과물은 정확했습니다. 그는 노트북을 닫으며 생각합니다. 이 도구의 진짜 힘은 코드를 작성하는 데 있지 않습니다.
내가 무엇을 원하는지 명확하게 말할 수 있느냐에 있습니다. 그리고 그건, 자동화를 몇 년간 해온 자신에게 이미 익숙한 근육이었습니다.
[그림 3-01: 자동화 구축 시간의 변화 타임라인. 수동 코딩 → 코드 없이 쓰는 도구(n8n, Zapier) → 에이전틱 도구(클로드 코드)로 이행하면서 구축 시간이 단계적으로 단축되는 과정을 보여주는 도표.]
이 책이 잠시라도 당신 곁에 머물렀다면, 다음 이야기가 세상에 나올 수 있도록 후원해 주세요.
(자발적 후원 부탁 구좌 : 농협 302-1096-0948-81 예금주 : 김경진)