시작 전에 준비할 것
키가 없어도 시연과 사례로 끝까지 따라올 수 있습니다. 직접 해보려면 아래 순서로 준비합니다.
누구에게 무엇이 필요한가
| 보기만 할 때 | 직접 해볼 때 | |
|---|---|---|
| 계정 | 필요 없음 | OpenRouter API 키 + 크레딧(추천) 또는 TypeSafe 사용 승인 + API 키 |
| 코드 없이 써 보기 | - | Playground(웹 화면에서 글을 넣고 질문) |
| 바이브코딩 | - | Claude Code(또는 skills를 지원하는 코딩 에이전트) + Jev 스킬 |
| 직접 코딩 | - | Python 3.10 이상 + typesafe-sdk |
1. API 키 만들기 · OpenRouter로 바로 (추천)
OpenRouter는 여러 회사의 AI 모델을 키 하나로 쓰게 해 주는 서비스입니다. 2026년 9월 18일부터 Jev를 제공하고 있어, TypeSafe 대기자 명단이나 계정 없이 OpenRouter 키만으로 Jev를 부를 수 있습니다.
- OpenRouter에 가입하고 크레딧을 충전합니다. Jev는 입력 100만 토큰당 0.042달러, 출력은 무료라 실습 정도는 아주 적은 금액으로 충분합니다(요청 한 번에 1센트의 수백분의 일 수준).
- OpenRouter에서 API 키를 만들고 환경 변수
OPENROUTER_API_KEY에 넣어 둡니다. 키를 채팅이나 코드 파일에 그대로 붙여 넣지 않습니다. - 모델 이름은
typesafe/jev-1.13(버전 고정) 또는~typesafe/jev-latest(항상 최신)입니다.
export OPENROUTER_API_KEY="여기에_발급받은_키"
★ 채팅용 주소로 보내면 안 됩니다. Jev는 글을 쓰는 모델이 아니라서 OpenRouter의 채팅 주소(/api/v1/chat/completions)가 아니라 판단 전용 주소
https://openrouter.ai/api/alpha/decisions로 보냅니다. 이 주소는 아직 알파 단계라 바뀔 수 있습니다.
TypeSafe에서 직접 쓰려면
API 키 페이지(console.typesafe.ai/keys)에서 키를 만들고 TYPESAFE_API_KEY에 넣습니다. 초기 공개 단계라 사용 승인 전에는 키를 만들 수 없습니다.
2. 코드 없이 먼저 써 보기
TypeSafe 승인을 받았다면 Playground(console.typesafe.ai/playground)에 글을 붙여 넣고 "이 메시지는 급한 내용인가?" 같은 질문을 추가하면 Jev의 답을 바로 볼 수 있습니다.
3. Claude Code에 Jev 스킬 설치
TypeSafe가 공개한 스킬을 설치하면 Claude Code가 최신 문서와 예제를 찾아 Jev를 붙이는 코드를 짭니다.
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai
설치 후 Claude Code에서 /typesafe:typesafe-ai로 직접 부를 수 있습니다. 다른 코딩 에이전트는 아래 명령으로 설치하고, 물어보면 쓰는 에이전트를 고릅니다(기본은 현재 프로젝트에만 설치, -g를 붙이면 전체).
npx skills add typesafe-ai/skills --skill typesafe-ai
4. 첫 요청 보내 보기 (OpenRouter)
터미널에 아래를 붙여 넣으면 "급한 메시지인가?"에 대한 Jev의 답(예일 확률)이 돌아옵니다.
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": "이 메시지는 급한 내용인가?"}
}
}'
TypeSafe에서 직접 쓴다면 Python SDK를 설치합니다.
pip install typesafe-sdk
공식 자료
- OpenRouter Jev 튜토리얼 · OpenRouter Jev 모델 페이지
- 공식 문서 · Quick Start · 질문 방식(Primitives)
- Jev 스킬(GitHub) · Python SDK(GitHub)
- 사례 모음: typesafeai.org/cases(TypeSafe와 관계없는 독립 사이트) · jevbest 쇼케이스
접근 방식, 가격, 메뉴 이름은 초기 공개 단계라 자주 바뀝니다. 2026년 10월 12일 공식 문서 기준이며, 실습 전에 공식 문서에서 한 번 더 확인하세요.