AI 서비스 AI Agent Vercel AI SDK 프로그래밍 부업 외주 스킬 Sandbox

Vercel 직접 알려주는 AI 코딩 Agent Harness 만들기, 부업 엔지니어의 진짜 돈벌이 강의

Richardson2026-01-152026-09-11

Vercel Academy가 강좌 하나를 통째로 풀었다. 《Build Your Own AI Coding Agent Harness》. “처음부터 진짜 일하는 AI 코딩 Agent 프레임워크를 손으로 만든다”는 주제를 뼛속까지 쪼개서 설명한다. API 세 개 끼워넣고 데모 돌리는 수준이 아니라, 도구 루프, 컨텍스트 가지치기, 서브에이전트 위임, 라이프사이클 관리 같은 단단한 뼈를 직접 깐다.

AI 외주 현금화하려는 엔지니어한테 이 강좌는 갈림길 신호다. Cursor로 코드 짜는 사람은 넘치지만, “커스텀 Agent 프레임워크” 납품할 줄 아는 사람은 일반 외주보다 단가가 확실히 높다.

먼저 짚기: Agent Harness가 정확히 뭔데

Agent Harness는 AI가 알아서 일하고, 알아서 컨텍스트 관리하고, 알아서 안전 지키게 만드는 비계다. AI한테 프로젝트 매니저 + 안전요원 + 메모장을 동시에 달아주는 격. Harness 없으면 AI는 그냥 수다 떠는 모델이고, Harness 붙이면 초급 직원처럼 업무 받고, 실행하고, 보고하고, 에러 나면 사람한테 돌아온다.

이 강좌에서 쓰는 3종 세트는 역할이 깔끔하다:

AI SDK: AI가 말하게 한다 (모델 호출, 텍스트 생성)
Vercel Sandbox: AI가 손대게 한다 (격리 환경에서 명령어 안전 실행)
just-bash: AI가听话하게 한다 (표준화된 도구 인터페이스로 Agent의 shell 행동을 통제)

셋이 합쳐지면 Agent 공장 하나가 완성된다.

아픈 지점: 왜 네가 짠 Agent는 항상 데모급인가

Joel Hooks가 강좌 도입에서 업계 민망한 현실을 찌른다 — “도구 세 개짜리 루프는 그냥 데모다. 진짜 일 시킬 때 문제가 터진다”. Agent한테 5000줄짜리 파일 읽으라고 시키면 통째로 컨텍스트에 박아버리고 다시는 못 뱉는다. bash 권한 줬더니 rm -rf로 운영 DB 날린다. 20단계 연속 작업 시키면 10단계에서 자기가 뭘 하던지 까먹는다.

클라이언트는 껍데기에 돈을 주지 않는다. Agent가 진짜 일 끝까지 해내는지에 돈을 준다.市面上 90% “AI 코딩 어시스턴트 튜토리얼”이 prompt 포장법, GPT API 연결법, 화려한 프론트엔드 만드는 법만 가르친다. 근데 기업이 실제로 돈 내고 사는 건 Agent가 작업 체인 전체를 안전하게 끝까지 돌리는 능력이다 — 이건 파라미터 튜닝으로 안 풀리는 아키텍처 결함이다.

Vercel이 이 강좌로 노리는 건 명확하다. Agent Harness를 장난감 스크립트가 아니라 진지한 엔지니어링 제품으로 다루는 것.

기회: Agent 엔지니어가 가장 희귀한 외주 자원이 되고 있다

지금 외주 시장이 양극화되고 있다. 한쪽 끝은 Cursor로 코드 자동완성만 하는 “AI 사용자” — 저가 경쟁. 반대쪽 끝은 “AI Agent 커스텀 솔루션” 납품하는 엔지니어 — 단가가 일반 외주보다 확실히 높고, 클라이언트가 줄 선다.

왜? 기업이 진짜 원하는 건 “코드 자동완성”이 아니라 “업무 흐름 자동화”이기 때문이다. 이커머스 사장이 필요한 건 Python 스크립트 짜주는 게 아니라, 경쟁사 가격 자동 크롤링하고, Listing 카피 자동 생성하고, A/B 테스트 자동 돌리고, 리포트 자동 뽑아주는 Agent다. 이런 건 Agent Harness 아키텍처 아는 사람만 가능하다.

⚠️ 출처 글에 따르면 Upwork의 “AI agent customization” 카테고리 프로젝트 평균 단가가 수천 달러 수준이라 하나, 독립 검증은 안 됐다.

경로 1: 강좌 핵심 모듈 통째로 씹어먹고 기술 해자 쌓기

강좌 커리큘럼에서 제일 돈 되는 모듈들. 하나씩 깐다. 각 모듈은 “문제 → 해법 → 비유” 세 문장으로 끝낸다:

도구 루프 (Tool Loop): Agent의 심장.

문제: 도구 호출 실패, 타임아웃, 동시성 충돌 시 Agent가 그대로 죽음.
해법: AI SDK의 stopWhen 조건으로 루프 종료 제어, maxSteps로 최대 단계 제한, 재시도 자동 처리.
비유: 공장 컨베이어의 박자 제어기 — 공정 하나 에러 나면 멈추고, 불량품이 다음 단계로 넘어가지 않음.

도구 설계 (Tool Design): 도구 입자도가 Agent 능력 상한을 결정.

문제: 너무 뭉뚱그리면 Agent가細 작업 못 하고, 너무 잘게 쪼개면 도구 호출 미로에서 헤맨다.
비법: “파일 시스템 조작”을 read, write, edit, glob, grep 다섯 개 원자 도구로 쪼갠다. 만능 bash 하나로 주지 않는다.
비유: 직원한테 차고 통째로 주는 게 아니라 드라이버, 렌치, 드릴 같은 전용 공구를 나눠주는 것.

샌드박스 추상화 (Sandbox Abstraction): 안전의 핵심.

문제: Agent가 bash 권한 받으면 rm -rf로 운영 DB 날릴 수 있음.
해법: Vercel Sandbox가 격리 실행 환경을 제공, Agent가 안에서 뭘 해도 호스트는 안전.
비유: 화학 실험실의 흄후드 — 터져도 흄후드 안에서 끝나고, 건물 전체가 날아가지 않음.

컨텍스트 가지치기 (Context Pruning): 5000줄 파일 통째로 prompt에 박으면 안 됨.

문제: AI가 5000줄 읽으면 머리 터지고, 옛날 대화가 새 판단을 오염시킴.
해법: prepareStep 훅으로 매 단계 실행 전 컨텍스트 다듬고, 최근 N단계만 유지 + 옛 내용 요약 압축.
비유: 방 정리 — 안 쓰는 건 창고에 넣고, 책상 위엔 오늘 쓸 것만 남기는 것.

서브에이전트 위임 (Subagent Delegation): 복잡한 작업은 반드시 분해.

문제: 단일 Agent가 멀티모듈 작업 처리하면 컨텍스트 폭발, 책임 혼란.
해법: 메인 Agent는 계획, 서브 Agent는 특정 모듈 실행, 결과는 메인에 합산.
비유: 프로젝트 매니저가 프론트/백/테스트한테 일 나눠주고, 본인은 진척이랑 리스크만 보는 것.

라이프사이클 관리 (Lifecycle Management): Agent는 시작, 실행, 일시정지, 복구, 종료 모든 상태에서 정밀 관리가 필요.

문제: 긴 작업 중간에 네트워크 끊김, 사용자 취소, 모델 타임아웃 — Agent 상태 다 날아감.
해법: 각 상태를 직렬화 저장, 중단점 재개와 사람 개입 지원.
비유: 게임 세이브 — 죽으면 최근 세이브 지점부터 읽고, 처음부터 안 해도 됨.

경로 2: 강좌 기술 스택으로 외주 받고 샘플 사례 만들기

강좌 다 듣는 게终点이 아니라 시작이다. Vercel AI SDK + Vercel Sandbox + just-bash 콤보를 바로 써서 첫 실 프로젝트 받아야 한다.

가장 빠른 현금화 경로는 Fiverr, Upwork, 크몽에 서비스 하나 걸어두는 것: “Vercel 기술 스택으로 AI Agent 커스텀 제작해드립니다”. 첫 3개 클라이언트는 반값 아니면 무료로 하고 사례와 평가 받아낸다.

⚠️ 출처 글에 따르면 무료 3건 예상 소요 시간은 Agent 복잡도에 따라 며칠~몇 주, 독립 검증 안 됨. 사례를后续 유료 클라이언트로 전환할 수 있느냐가 가치 판단 기준.

샘플 사례 고르는데 기준이 있다. “챗봇 하나 만들어주세요” 같은 진부한 수요 받지 말고, “운영 업무 흐름 자동화해 주세요” 같은 고가치 수요 받아라. 예시:

크로스보더 셀러한테 Agent 하나 만들어서 Amazon 리뷰 자동 모니터링, 부정 리뷰 키워드 추출, 개선 제안 생성, Slack 자동推送.
인스타/블로그 크리에이터한테 Agent 하나 만들어서 대상 계정 글 자동 크롤링, 바이럴 패턴 분석,选题 리스트 자동 생성.
1인 개발자한테 Agent 하나 만들어서 GitHub Issues 자동 모니터링, 우선순위 자동 분류, PR 초안 자동 생성.

⚠️ 출처 글에 따르면 이런 프로젝트 견적 범위는 수만 위안 수준, 독립 검증 안 됨.

콜드 스타트: 클라이언트 파이프라인 없을 때 뚫는 법

기업 클라이언트 자원이 없는 게 대부분 사람의 진짜 출발점. 구체적 채널 3개:

커뮤니티 글引流: 개발자 커뮤니티, 디시, 브런치에 사례 글 올린다. 제목 템플릿 “Vercel AI SDK로 XX行业 Agent 만들었는데, 월 XX시간 인건비 절약”, 30초 데모 영상 첨부. 트래픽 오르면 클라이언트가 먼저 DM.
무료 시공换取 testimonial: 지인 소개 소규모 클라이언트한테 첫 프로젝트는 5만원만 받되, 추천사 한 단락 + 사례 공개 권한 확보.
阶梯报价 전략: 5만원 소규모(단일 모듈 Agent) → 30만원 중규모(멀티모듈 워크플로우) → 300만원 대규모(풀 커스텀 + 6개월 유지보수). 단계 올라갈 때마다 전 단계 사례가 뒷받침되어야 함.

경로 3: 강좌 콘텐츠 2차 가공해서自媒体 현금화

Vercel 강좌는 영어고 진입장벽 높다. 그게 정확히 네 정보차红利다.

강좌를 10~15편 시리즈로 쪼개서 블로그, 유튜브, 브런치에 올린다. 제목 예시: “Vercel 내부 강좌 유출: AI Agent 프레임워크 진짜 쓰는 법”, “도구 루프 세 개는 장난감, 진짜 Agent엔 이 다섯 모듈이 필요”, “컨텍스트 가지치기: Agent 기억력 잃지 않게 하는 핵심 기술”.

각 영상 5~8분, 기술 포인트 하나 깊게, 코드 데모 필수. 구체적 운영 제안:

1편은 도구 루프 해부, 코드 데모 3개 (AI SDK의 generateText + tools 설정, stopWhen 사용법, prepareStep 컨텍스트 다듬기 예시), 7분 내외.
제목 A/B 테스트: “Vercel 내부 강좌 유출” vs “AI Agent 프레임워크 손코딩 가이드” 각각 1만원 광고 집행해서 CTR 비교, 높은 쪽 템플릿批量复用.

현금화 라인 3층: 1층은 프로그래밍 교육 광고, 2층은 강좌 판매 (시리즈 묶어서 《AI Agent 엔지니어 실전》), 3층은 고급 컨설팅 (기업 Agent 팀 구축 도와주기). ⚠️ 출처 글에 따르면 만 팔로어 계정 프로그래밍 교육 광고 단건报价 천 원대, 독립 검증 안 됨.

길 선택 가이드: 어느 경로가 너한테 맞나

재직 프로그래머가 부업: 경로 2 + 경로 3 라이트 버전. 주말에 소규모 1~~2건 외주 받으면서 과정 짧은 영상으로 블로그 올리고, 월 50만~~100만 목표.
프리랜서가 월 500만 노림: 경로 2 풀投入. 콜드 스타트 3개월, 앞 3개월은 클라이언트 가리지 말고 사례만 쌓고, 4개월차부터 고가치 클라이언트만 골라서 객단가 300만 이상 목표.
학생 / 전직 준비생: 경로 1로 강좌 통째로 씹고, 데모 프로젝트 5개 만들어서 GitHub에 포트폴리오 쌓고, 6개월 후에 외주 고려.

사례: Joel Hooks의 강좌 자체가 샘플이다

Joel Hooks는 Vercel Academy 강좌 저자이자 《Build Your Own AI Coding Agent Harness》의 메인 강사다. 본인 자체가 “Agent 엔지니어 현금화” 살아있는 사례다 — 고퀄 기술 튜토리얼 꾸준히 내면서 개발자 커뮤니티에서 강한 개인 브랜드 구축, 강좌 콘텐츠가 2차 확산 많이 됨.

그 전략 平移 가능: 기술 스택은 Vercel AI SDK 중심, 납품물은 “코드 스니펫”이 아니라 “실행 가능한 Agent 시스템”. 이게 지금 Agent 외주 시장에서 제일 희귀한 공급이다.

⚠️ 다른 1인 개발자 구체 수입 데이터(월 5만 달러, 6개월 만에 팔로어 12만 등)는 소재 패키지에 검증 가능한 출처가 없어서 본문에서 구체 수치 인용 안 함.

제로 베이스 입문 경로

Node.js / Type스크립트도 안 만져본 입문자라면 이 순서대로:

1개월 차: Node.js 기초 + TypeScript 문법 + LLM 기초 개념 (token이 뭔지, prompt가 뭔지, function calling이 뭔지). 추천 한글 자료: 캡틴판교 TypeScript, 《AI 엔지니어 핸드북》.
2개월 차: 강좌에서 “도구 루프” 모듈 하나만 깐다. AI SDK 공식 문서 quickstart로 데모 돌림.
3개월 차: “샌드박스 추상화” 모듈 추가, 폴더 자동 정리하는 Agent 하나 만듦.
4개월 차부터: 경로 2나 경로 3으로 현금화 시도.

현실적 기대치: 1개월 차엔 도구 루프 모듈 하나만. 한꺼번에 다 끝내려 하지 마라. 하루 2시간 투자하면 30일 후 최소 작동 Agent 체인 하나는 뚝딱 만들 수 있다.