🌱 롱텀 코파일럿 시작하기 — 비개발자 친화 A-Z 가이드

버전: v0.0.10 (2026-05-12 기준) · 베타 단계 · Lite 영구 무료 변경 내역: GitHub Releases v0.0.10 — 평가 자문 4 endpoint + check-evaluation 룰 + 매출 4 endpoint(직전 v0.0.10 통합)

이 가이드는 누구를 위한 건가요?

Claude·ChatGPT(Codex)·Cursor 등 AI 도구를 평소 사용하시지만 개발 지식은 전혀 없는 분이, 본인 컴퓨터에 롱텀 코파일럿을 직접 설치해서 사용하고 싶을 때 처음부터 끝까지 따라할 수 있도록 만들었습니다.

막히는 부분은 언제든 부담 없이 [email protected]로 연락 주세요. 이 가이드를 따라하시는 분의 마찰을 줄이는 게 저희의 가장 큰 관심사입니다.

📌 1분 요약 — 이게 뭔가요?

롱텀 코파일럿(Longterm Copilot, ltc)은:

장기요양정보시스템(NPBS, longtermcare.or.kr)에서 매일 클릭으로 처리하시던 31가지 조회 + 12종 진단 룰을 명령 한 줄로 끝내주는 도구입니다 (v0.0.10 기준)
평소 쓰시던 Claude Desktop이나 ChatGPT(Codex)에 한국어로 자연스럽게 물어보면 NPBS 데이터를 자동으로 가져와서 답해줍니다
예: “이번 달 미승인 RFID 보여줘” → 자동으로 NPBS 호출 → 결과 답변
예: “이번 달 청구 들어가도 돼?” → 4축 종합 진단 (한도/RFID/계약/처우개선) → 한 문단 답변
예: “올해 우리 기관 매출 어떻게 돼?” → 4축 집계 (지급/계좌/채권/환수) → 보고서 답변
예: “우리 평가 잘 받을 수 있어?” → 4축 자가진단 (자체평가/결과/가산/예정일) → 권장 조치 답변
본인 PC에서만 동작 (NPBS 호출만 외부, 그 외 어떤 서버와도 통신하지 않습니다)
Lite 버전은 영구 무료 (베타 단계에서는 유료 기능도 비활성)

이 가이드를 따라하시면:

✅ 본인 컴퓨터에 설치 (Windows·macOS·Linux 지원)
✅ NPBS 인증서로 로그인
✅ 명령 한 줄로 31가지 조회 + 12 진단 룰 실행
✅ Claude Desktop·Codex·Cursor에서 자연어로 호출

예상 소요 시간: 처음 1회 터미널 설정 30~60분 → 이후 매일 사용은 Claude Desktop · Codex 앱에서 자연어 한 문장 (터미널 불필요)

🚦 시작하기 전 — 3가지 체크

✅ 체크 1. NPBS 인증서를 본인이 가지고 있나요?

본 도구는 NPBS 포털 인증서가 필수입니다. 인증서 없으면 사용할 수 없어요.

확인 방법:

인증서 파일 2개를 본인 PC 어딘가에 가지고 계신가요?
signCert.der (공개 인증서)
signPri.key (개인 키)
보통 USB 또는 PC ~/AppData/LocalLow/NPKI/ 같은 폴더에 자동 저장되어 있습니다
인증서어 내한 내용은: 노인장기요양보험 포털 공인인증서 안내 참조

✅ 체크 2. 본인 컴퓨터의 운영체제는?

화면 확인 방법	결과
Windows: `Win 키 + R` → `winver` 입력 → 엔터	“Windows 10/11” → ✅ 지원
macOS: 화면 왼쪽 위 🍎 → “이 Mac에 관하여” → “칩” 정보	“Apple M1/M2/M3/M4…” → macOS Apple Silicon ✅
	“Intel” → macOS Intel ✅
Linux: 터미널에서 `uname -m`	“x86_64” → ✅

✅ 체크 3. 명령행(터미널) 사용 경험

명령행이 처음이신가요? 괜찮습니다. 이 가이드에서 시키는 명령만 복사 → 붙여넣기 → 엔터하시면 됩니다. 이 한 번만 따라하시면 됩니다.