사전 준비 & 자료실

시작 전에 준비할 것

키가 없어도 시연과 사례로 끝까지 따라올 수 있습니다. 직접 해보려면 아래 순서로 준비합니다.


누구에게 무엇이 필요한가

보기만 할 때직접 해볼 때
계정필요 없음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를 부를 수 있습니다.

  1. OpenRouter에 가입하고 크레딧을 충전합니다. Jev는 입력 100만 토큰당 0.042달러, 출력은 무료라 실습 정도는 아주 적은 금액으로 충분합니다(요청 한 번에 1센트의 수백분의 일 수준).
  2. OpenRouter에서 API 키를 만들고 환경 변수 OPENROUTER_API_KEY에 넣어 둡니다. 키를 채팅이나 코드 파일에 그대로 붙여 넣지 않습니다.
  3. 모델 이름은 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

공식 자료

접근 방식, 가격, 메뉴 이름은 초기 공개 단계라 자주 바뀝니다. 2026년 10월 12일 공식 문서 기준이며, 실습 전에 공식 문서에서 한 번 더 확인하세요.

시작하기
01. Jev는 무엇이 다른가
이어보기 →