바이브코딩으로 붙여 보기
코드를 직접 짜지 않아도 됩니다. Claude Code에 Jev 스킬을 설치하고, 무엇을 판단하고 결과를 어떻게 쓸지만 말로 정해 주면 됩니다.
먼저 보기 · Jev가 클릭할 곳을 고르는 장면
AI가 구글 항공권 사이트에서 취리히 → 런던 편도 항공편을 7초 만에 검색하는 영상입니다. 오른쪽 목록(편도 → 취리히 → 런던 → 9월 20일 → 검색)이 AI가 차례로 해낸 단계입니다.
- "이 화면에서 다음에 어디를 누를까?"는 Jev가 고릅니다. 화면에 있는 버튼과 입력 칸 중 하나를 고르는 일이라 02장의 고르기(Choice)와 같은 원리입니다.
- 입력 칸에 넣을 글자(예: London)는 글을 쓸 줄 아는 다른 작은 AI가 만듭니다. Jev는 글을 쓰지 않기 때문입니다.
판단은 빠른 Jev가, 글자는 다른 AI가 나눠 맡아서 사람이 하는 것보다 빨리 끝났습니다. 03장의 "판단만 Jev에게"를 실제로 보여 주는 예입니다.
준비 · 스킬 설치
터미널에서 아래 두 줄을 실행합니다. 자세한 준비는 자료실에 있습니다.
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai
바이브코딩 요청 쓰는 법
원하는 것: 어떤 자료를 판단할지, 왜 필요한지.
Jev에게 물을 질문: 방식(고르기·점수·예/아니오)과 선택지 설명까지.
기준과 결과: 확률이 얼마면 무엇을 할지, 결과를 어디에 어떤 모양으로 남길지.
지킬 것: 키는 환경 변수로만, 보내기·지우기 같은 실행은 빼기.
🧪 2부 실습 · 문의 분류기 만들기
무엇을 만드는지 그림으로 먼저 봅니다.




시나리오 — 작은 온라인 가게에 고객 문의가 하루 50개쯤 옵니다. 급한 것부터 답하고 싶습니다. 판단은 Jev가, 정리는 코드가 합니다. OpenRouter 키를 준비했다면 그대로 따라 하고, 없다면 진행자 시연을 보면서 요청문만 내 상황에 맞게 고쳐 둡니다.
Claude Code에 연습용 문의를 만들어 달라고 합니다. 실제 고객 정보는 쓰지 않습니다.
고객 문의 연습 데이터 50개를 inbox.csv로 만들어줘. 결제, 기술, 환불, 기타가 섞이게 하고, 그중 10개쯤은 급한 내용으로 해줘. 나중에 Jev 판단과 비교할 수 있게 정답 칸(종류, 급함)도 따로 넣어줘. 실제 사람 이름이나 연락처는 넣지 마.
아래 요청을 그대로 보내거나, 내 일에 맞게 질문과 기준만 바꿔 보냅니다.
/typesafe:typesafe-ai 스킬을 참고해서 작은 문의 분류기를 만들어줘.
원하는 것: inbox.csv에 있는 고객 문의 50개를 분류하고 싶어.
판단은 Jev에게 맡겨줘. OpenRouter의 Decisions 주소(https://openrouter.ai/api/alpha/decisions)로 typesafe/jev-1.13 모델을 불러줘. 질문은 두 개야.
- 종류(Choice): 결제(돈이 빠져나가거나 결제가 안 됨) / 기술(연결·오류·설정) / 환불 / 기타
- 급함(Noul): 이 메시지는 오늘 안에 답해야 하는 급한 내용인가?
받을 결과: result.csv에 원문, 종류, 종류 확신도, 급함 확률, 처리 결과 칸을 만들어줘.
기준: 급함 확률 0.8 이상이면 ‘바로 답장’, 0.4~0.8이면 ‘확인 필요’, 그 아래는 ‘오늘 중 처리’로 적어줘.
지켜줘: API 키는 OPENROUTER_API_KEY 환경 변수에서만 읽고 코드에 적지 마. 답장을 쓰거나 보내는 기능은 만들지 마.
Jev에는 정답 칸을 보내지 말고, 다 만들면 실행 방법과 결과 예시 5줄, 정답과 비교한 결과를 보여줘.
정답과 다르게 나온 문의를 직접 읽어 봅니다. 기준 숫자를 바꾸기 전에, 무엇을 급하다고 볼지와 선택지마다 무엇이 들어가는지 설명을 먼저 고칩니다. 아래는 실제로 보낸 수정 요청입니다.
‘오늘 중 처리’로 간 문의 중에 2주째 환불이 안 된 건처럼 사실 급한 게 있었어. 급함 질문의 설명에 ‘약속한 처리가 오래 늦어져 고객이 이미 기다리고 있는 경우’와 ‘개인정보·데이터 유실처럼 피해가 커질 수 있는 경우’를 급한 경우로 추가하고, 결제 설명에는 영수증·세금계산서·결제 수단 변경도 넣어줘. 다시 실행해서 처리 결과나 종류가 바뀐 문의만 표로 보여줘.
실제로 돌려 본 결과
2026년 10월 12일, 위 요청 세 개를 Claude Code에 그대로 보내 끝까지 실행했습니다(OpenRouter, typesafe/jev-1.13).
| 단계 | 걸린 시간 | 결과 |
|---|---|---|
| 미션 1 · 연습 문의 만들기 | 측정 안 함 | 50건(결제 14, 기술 14, 환불 12, 기타 10), 급한 문의 10건, 정답 칸 포함 |
| 미션 2 · 분류기 만들고 실행 | 1분 35초(Jev 판단 50건은 5초) | 급함: 급한 10건 중 7건 바로 답장, 2건 확인 필요, 1건 놓침(2주째 환불 미처리). 급하지 않은 40건은 모두 오늘 중 처리. 종류: 50건 중 43건 정답 |
| 미션 3 · 설명 고치고 다시 실행 | 34초 | 급함: 급한 10건이 모두 오늘 중 처리를 벗어남(9건 바로 답장, 1건 확인 필요), 급하지 않은 40건은 그대로. 종류: 46건 정답 |
50건을 두 번 판단한 Jev 비용은 요청당 비용으로 계산하면 1센트에 훨씬 못 미칩니다.
여기서 배울 것
- 기준 숫자보다 설명이 먼저입니다. 0.8이라는 기준은 그대로 두고 "무엇을 급하다고 볼지" 설명만 고쳤는데 놓친 건이 사라졌습니다. 영수증·세금계산서를 결제 설명에 넣자 종류 정답도 3건 늘었습니다.
- 확신도가 높아도 틀릴 수 있습니다. 처음 종류를 잘못 고른 7건 중 4건은 확신도가 0.8 이상이었습니다. 확신도만으로 틀린 것을 걸러낼 수는 없으니, 처음에는 정답이 있는 연습 자료로 확인합니다.
- 경계에 있는 문의는 남습니다. "결제 페이지 오류"는 결제일까 기술일까처럼 사람도 헷갈리는 건은 고친 뒤에도 갈렸습니다. 이런 건은 "확인 필요"로 사람이 봅니다.
- Claude Code는 공식 문서를 읽고 Jev 질문 문장을 영어로, 선택지 이름은 한국어로 썼습니다. 공식 문서에 Jev가 영어에서 가장 정확하다고 나와 있기 때문입니다.
코드는 이렇게 생겼습니다
Claude Code가 만드는 코드의 핵심은 이렇게 "글(state)과 질문(questions)을 보내고 확률을 받는" 한 번의 요청입니다. 직접 짤 필요는 없지만 무엇을 주고받는지 봐 두면 수정 요청이 쉬워집니다.
curl https://openrouter.ai/api/alpha/decisions \
-H "Authorization: Bearer $OPENROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "typesafe/jev-1.13",
"state": {"message": "쇼핑몰 앱에 로그인이 안 돼요. 비밀번호를 바꿨는데도 계속 오류가 나요. 오늘 밤 할인 끝나기 전에 꼭 주문해야 하는데 빨리 도와주세요."},
"questions": {
"urgent": {"type": "noul", "instructions": "이 메시지는 급한 내용인가?"}
}
}'
2026년 10월 12일 이 요청을 실제로 보낸 응답입니다. noul이 "예"일 확률이고, 요청 한 번 비용은 0.000014달러였습니다.
{
"model": "typesafe/jev-1.13-20260917",
"answers": {
"urgent": {"type": "noul", "noul": 0.93}
},
"usage": {"input_tokens": 340, "output_tokens": 20, "cost": 0.00001428},
"provider": "TypeSafe"
}
TypeSafe에서 직접 쓴다면 Python SDK로 같은 일을 이렇게 합니다.
from typesafe_sdk import Noul, TypeSafeClient
client = TypeSafeClient() # TYPESAFE_API_KEY 환경 변수를 읽습니다
r = client.system_one(
state="쇼핑몰 앱에 로그인이 안 돼요. 비밀번호를 바꿨는데도 계속 오류가 나요.",
questions={"urgent": Noul(instructions="이 메시지는 급한 내용인가?")},
)
print(r.answers["urgent"].noul) # 예일 확률(0~1)
막힐 때
TypeSafe 키를 만들 수 없어요
TypeSafe 직접 사용은 승인 전에는 키를 만들 수 없습니다. OpenRouter 키로 바꿔 쓰면 신청 없이 바로 됩니다.
OpenRouter에서 오류가 나요
채팅용 주소(/api/v1/chat/completions)로 보내지 않았는지 확인합니다. Jev는 판단 전용 주소(/api/alpha/decisions)로만 받습니다. 크레딧이 0이어도 실패합니다.
스킬 이름을 불러도 반응이 없어요
설치 방법에 따라 이름이 다릅니다. claude plugin install로 설치했다면 /typesafe:typesafe-ai, 프로젝트 폴더에 스킬로 넣었다면 /typesafe-ai입니다. 이름이 헷갈리면 "typesafe-ai 스킬을 참고해서"라고 문장으로 써도 됩니다.
결과가 생각과 달라요
선택지 설명을 먼저 고칩니다. "결제"처럼 이름만 있으면 헷갈리기 쉽습니다. 무엇이 결제이고 무엇이 환불인지 한 줄씩 적어 다시 실행합니다.
확률이 0.5 근처로 많이 나와요
Jev가 확신하지 못한다는 뜻입니다. 질문을 더 구체적으로 바꾸거나, 그 구간은 사람이 보도록 "확인 필요"로 두는 게 맞습니다.
Claude Code가 키를 코드에 넣으려고 해요
"API 키는 OPENROUTER_API_KEY 환경 변수에서만 읽어"라고 다시 말합니다. 키가 들어간 파일은 공유하지 않습니다.
무엇을 판단할지, 어떤 방식으로 물을지, 확률이 얼마면 무엇을 할지. 이 세 가지만 정해서 Claude Code에 말하면 됩니다.
더 만들어 보고 싶다면 더 해보기 · Jev 사례 모음에서 다른 사람들이 만든 것과 따라 만들 요청문을 고릅니다.