Jev API 연동 스킬 만들기: Aside 초보자를 위한 설치·인증·자동 적용 가이드

JEV 설치 가이드: 데스크톱 Codex에 판단 도구 연결하고 실제 호출 확인하기

JEV는 분류·참거짓·점수 판단을 정해진 형식으로 반환하는 TypeSafe의 AI 모델입니다. 이 글에서는 Windows의 로컬 Codex 에이전트에 JEV 실행기를 설치하고, 새로운 대화에서 실제 API 호출이 일어나는지 확인합니다. 기준일은 2026년 10월 1일입니다.

검증한 환경은 로컬 도구를 실행할 수 있는 Codex 데스크톱입니다. 일반 ChatGPT 데스크톱의 모든 대화에 자동 적용되는 설치법은 아닙니다. 데스크톱 창에 표시되더라도 클라우드에서 실행되는 작업에는 이 구성을 적용하지 않습니다.

1. JEV는 어떤 일을 하나요?

고객이 “같은 주문이 두 번 결제됐습니다. 오늘 안에 해결해 주세요”라고 문의했다고 가정해 봅시다. 필요한 판단은 두 가지입니다. 어떤 종류의 문의인지, 그리고 정해진 기준에 따라 긴급한지입니다. JEV에는 판단할 자료인 state와 질문인 questions를 전달합니다. 결과는 프로그램에서 바로 다룰 수 있는 구조로 돌아옵니다.

판단 방식	하는 일	활용 예
Choice	후보 중 하나를 선택하고 후보별 확률과 confidence를 반환	결제·기술지원·기타 분류
Noul	질문에 대한 Yes 확률을 0~1로 반환	오늘까지 해결해 달라는 요청인가?
Score	단계별 평가 기준에 따른 점수와 분포를 반환	답변이 요구사항을 얼마나 충족하는가?

TypeSafe는 이러한 구조화된 판단 방식을 SystemOne이라고 부릅니다. 작은 판단을 나누고, 같은 자료에 대한 독립적인 질문을 함께 요청한 뒤, 결과에 따른 처리는 코드나 에이전트가 담당하는 구조입니다.

적용 이점은 판단 기준을 명시하고, 결과 형식을 일정하게 유지하며, 호출 기록을 남길 수 있다는 점입니다. 고객 문의 분류, 자료의 관련성 확인, 주장과 근거의 일치 여부 검토 등에 사용할 수 있습니다. 다만 판단 품질은 자료와 기준에 영향을 받으며, 일반 GPT보다 항상 정확하거나 저렴하다는 사실을 이번 실험으로 입증한 것은 아닙니다.

confidence 1.0을 정답률 100%로 해석하면 안 됩니다. 공식 문서의 confidence는 결과 분포가 얼마나 집중되어 있는지 나타내는 지표입니다. 실제 업무에서 자동 처리할 기준값은 별도의 평가 데이터로 정해야 합니다. Noul의 Yes 확률과 Choice·Score의 confidence도 서로 다른 값입니다.

[참조: https://docs.typesafe.ai/introduction]

2. 설치 전 준비: 로컬 에이전트와 TypeSafe 키

준비물은 Windows PC, 파일과 명령을 실행할 수 있는 로컬 Codex, Python 3.10 이상, 본인의 TypeSafe API 키, 인터넷 연결입니다. Python 설치 후 PowerShell에서 py -3 --version을 실행해 버전을 확인합니다.

이 글에서 ‘로컬’은 에이전트와 실행기, 키 보관 위치가 PC에 있다는 뜻입니다. JEV 추론 자체는 TypeSafe API 서버에서 수행됩니다. 판단에 필요한 자료가 서버로 전송되므로 업무상 전송할 수 있는 자료만 최소한으로 전달해야 합니다.

API 키를 Windows 사용자 환경변수에 등록하기

1. TypeSafe에서 본인의 API 키를 준비합니다.
2. Windows 검색에서 ‘시스템 환경 변수 편집’을 열고 ‘환경 변수’를 선택합니다.
3. ‘사용자 변수’의 ‘새로 만들기’에서 변수 이름을 TYPESAFE_API_KEY로 입력합니다.
4. 변수 값에 본인의 TypeSafe 키를 저장합니다. 이미 같은 변수가 있다면 기존 설정을 확인합니다.
5. 설정 후 Codex를 완전히 종료하고 다시 실행합니다.

키를 넣는 곳은 Path 목록이 아닙니다. 이름이 TYPESAFE_API_KEY인 별도의 사용자 환경변수입니다. 채팅, 블로그, 스크린샷에 키 값을 붙여 넣지 마세요. 환경변수 저장은 암호화된 비밀 저장소와 같지는 않습니다.

이번에 검증한 ChatGPT 로그인 기반 로컬 Codex 구성에서는 JEV를 연결하기 위한 별도의 OpenAI API 키가 필요하지 않았습니다. JEV 인증에는 TypeSafe 키를 사용합니다. Codex 이용 조건과 TypeSafe API 이용량·요금은 별도로 확인해야 합니다.

[참조: https://docs.typesafe.ai/sdk/python]

3. Jev 스킬과 실행기를 설치하기

이 글의 첨부 자료 Jev-desktop-kit.zip은 실제로 동작한 구성을 다른 Windows 사용자도 설치할 수 있도록 정리한 사용자 제작 설치 자료입니다. TypeSafe 공식 배포 설치 프로그램은 아닙니다. 공식 SDK를 이용하는 실행기와 Codex용 지침을 묶었습니다.

Jev-desktop-kit.zip

0.01MB

첨부 ZIP을 내려받아 압축을 풀고 install.py가 있는 폴더에서 PowerShell을 엽니다. 파일 탐색기 주소창에 powershell을 입력하는 방법도 있습니다. 아래 명령을 실행합니다.

py -3 install.py

설치기는 사용자 폴더의 .agents\skills\jev에 스킬을 배치하고, 전용 Python 가상환경을 만들며, 검증에 사용한 typesafe-sdk==0.7.2를 설치합니다. 이어서 Codex 기본 지침 파일인 AGENTS.md를 백업하고 JEV 사용 규칙을 추가합니다. 기본 위치는 %USERPROFILE%\.codex\AGENTS.md이며, CODEX_HOME이 지정된 경우 해당 위치를 사용합니다.

동일한 설치 폴더나 기존 JEV 기본 지침이 있으면 덮어쓰지 않고 중단합니다. 내용이 있는 전역 AGENTS.override.md가 발견되어도 먼저 지침을 통합하도록 중단합니다. 기존 설치가 있는 독자는 중복 설치보다 기존 구성을 점검해야 합니다.

자동 적용은 어떻게 설정되나요?

스킬 설명과 기본 지침에 “로컬 작업에서 분류·비교·관련성·근거 확인·평가 기준에 따른 검토가 필요하면 실제 JEV API를 호출한다”는 규칙을 넣습니다. 단순 계산, 복사, 서식 변경은 제외합니다. 판단에 필요한 호출 기록을 확인하고, 호출에 실패하면 JEV 검증이 완료되지 않았다고 표시하도록 설정합니다.

이것은 에이전트가 읽는 지침을 통한 자동 적용입니다. 운영체제 전체를 감시하거나 GPT의 내부 추론을 모두 가로채는 기능은 아닙니다. 프로젝트별 지침과 도구 사용 가능 여부가 달라질 수 있으므로 새 대화에서 실제 실행을 확인해야 합니다. 행동 승인과 권한 결정도 JEV에 넘기지 않습니다.

설치가 끝나면 Codex를 다시 열고 새로운 로컬 작업을 시작합니다. 공식 TypeSafe 스킬만 설치하는 방법과 이 글의 실행기·전역 지침을 함께 설치하는 방법은 구성 범위가 다릅니다.

[참조: https://learn.chatgpt.com/docs/agent-configuration/agents-md]

4. ‘연결했습니다’라는 말 대신 실제 호출을 검증하기

첫 번째: 키를 찾을 수 있는지 확인

PowerShell에서 아래 명령을 실행합니다. 키 값은 출력하지 않고 존재 여부를 확인합니다. 이 단계는 API 호출 성공을 의미하지 않습니다.

$jev = Join-Path $env:USERPROFILE '.agents\skills\jev'
& "$jev\.venv\Scripts\python.exe" "$jev\scripts\jev.py" --check

두 번째: 실제 API 자체 시험

& "$jev\.venv\Scripts\python.exe" "$jev\scripts\jev.py" --self-test

자체 시험은 TypeSafe API를 실제로 호출하므로 이용량이 발생할 수 있습니다. ok: true, api_called: true, http_statuses: [200], 반환 모델과 receipt_path를 확인합니다. 이 설치 자료는 재현을 위해 jev-1.13.0을 지정했습니다. 향후 모델 제공 상태가 바뀌면 공식 문서에 따라 설정을 검토해야 합니다.

세 번째: 새로운 로컬 대화에서 자동 적용 확인

스킬 이름을 직접 말하지 않고 다음 요청을 입력합니다.

다음 고객 요청을 결제·기술지원·기타 중 하나로 분류하고 긴급 여부를 판단하세요. “같은 주문이 두 번 결제됐습니다. 오늘 안에 해결해 주세요.” 판단 기준: 오늘 해결을 요청하면 긴급으로 봅니다. 답변 마지막에 실제 적용한 스킬, 로컬 실행 여부, 외부 API를 호출했다면 반환 모델과 실행 기록 파일 경로를 적으세요. 호출하지 않았다면 호출하지 않았다고 적고 API 키 값은 출력하지 마세요.

정답처럼 보이는 답변만으로는 연동 성공을 확인할 수 없습니다. 도구 실행 내역에서 Jev 실행기를 호출했는지, 실제 반환값과 기록 파일이 있는지 함께 확인합니다. 기록은 기본적으로 %USERPROFILE%\.codex\jev\receipts에 저장됩니다.

이번에 확인한 시험	관찰한 결과
기존 구성의 새로운 로컬 Codex 대화	스킬 이름 없는 요청에서 실제 Jev 실행기 호출 확인
위 고객 문의 판단	결제·긴급, HTTP 200, 반환 모델 jev-1.13.0
독자용 설치 자료의 별도 폴더 설치	가상환경 생성·SDK 설치·의존성 검사 성공
독자용 실행기의 실제 자체 시험	HTTP 200, Choice·Noul·Score 응답 모두 확인

독자용 설치 자료는 현재 PC의 별도 폴더에서 설치와 API 실행을 확인했습니다. 다른 사람의 새 PC 전체 환경에서 자동 적용까지 시험한 결과는 아닙니다. 각 독자는 마지막 ‘새 로컬 대화’ 검증까지 마쳐야 합니다.

실행 기록에는 모델, HTTP 상태, 토큰 사용량, 시각 등의 메타데이터를 남기며 키와 판단 원문은 저장하지 않습니다. 다만 터미널에 표시되는 응답에는 판단 결과가 포함될 수 있습니다. 기록 파일은 로컬 실행 증거이며 서버가 전자서명한 인증서는 아닙니다.

잘 안 될 때 확인할 부분

• 키를 찾지 못함: 사용자 변수 이름과 값을 확인하고 앱을 다시 실행합니다.
• 401 응답: TypeSafe 키의 유효성을 확인합니다. OpenAI 키로 바꾸지 않습니다.
• 자체 시험은 되지만 대화에서 호출하지 않음: 로컬 작업인지, 스킬과 기본 지침을 읽었는지, 우선 적용되는 다른 지침이 있는지 확인합니다.
• 429·529 응답: 제한이나 서비스 상태를 확인합니다. 반복 요청을 계속 보내지 않습니다.
• 일반 Chat에서 파일·명령 실행 불가: 이 설치 방식의 실행 범위에 해당하지 않습니다.

[참조: https://docs.typesafe.ai/api]

마무리

JEV를 연결할 때 중요한 것은 키 저장, 실행기 설치, 기본 지침, 실제 호출 검증을 하나의 과정으로 보는 것입니다. 간단한 고객 문의부터 시작해 결과와 실행 기록을 확인한 뒤, 자료 분류나 근거 검토로 적용 범위를 넓혀 보세요.

자주 묻는 질문

JEV를 쓰려면 OpenAI API 키도 필요한가요?

이 글에서 검증한 ChatGPT 로그인 기반 로컬 Codex 연결에는 별도의 OpenAI API 키가 필요하지 않았습니다. JEV 호출에는 TypeSafe API 키를 사용합니다.

로컬 설치이므로 인터넷 없이 작동하나요?

아닙니다. 실행기는 PC에서 작동하지만 JEV 판단은 TypeSafe API 서버에서 수행되므로 인터넷 연결이 필요합니다.

ChatGPT 데스크톱의 모든 대화에 적용되나요?

아닙니다. 로컬 도구와 지침을 사용할 수 있는 에이전트 작업을 대상으로 합니다. 일반 Chat이나 클라우드 작업에 자동 적용되는 구성은 아닙니다.

출처

• TypeSafe 소개와 판단 유형
• TypeSafe API 명세
• Python SDK
• Confidence의 의미
• TypeSafe 공식 스킬
• Codex 스킬 구성
• AGENTS.md 기본 지침
• ChatGPT Work와 Codex 실행 환경

※ 유의사항 ※
제작 안내: 사용자의 실제 설치·실행 기록과 공식 자료를 바탕으로 AI가 조사, 초안 작성, 구성 및 검토를 도왔습니다. 설치 자료는 사용자 제작 자료이며 TypeSafe 또는 OpenAI의 공식 배포물이나 보증을 의미하지 않습니다. 서비스와 모델 제공 상태는 변경될 수 있습니다.
Disclosure: AI assisted with research, drafting, organization and review using actual installation records and official documentation. The installation kit is community-created, not an official distribution or endorsement by TypeSafe or OpenAI. Service and model availability may change.

※ 제작자 후원 ※
이 후원 은 네이버 브랜드 커낵트로 부터 상품 판매시 일정 비율의 금액을 지원받습니다. 여러분의 작은 후원이 좋은 컨텐츠를 계속 만들 수 있도록 하는 믿거름이 됩니다.
[상품명] 오아 큐브 멀티탭 PD35 대용량 4000W 콘센트 USB C타입 고용량 멀티 3구 어댑터
[구매링크] https://naver.me/GB3BYNnt