5분 만에 시작하기 (베타)

설치 단계

한 줄 설치 사용자는 ①②③이 자동 처리되므로 ④ ltc setup부터 시작하시면 됩니다. 수동 zip 설치 사용자는 ①부터 순서대로 진행하세요.

1. ①

   압축 해제 — 한 줄 설치 시 자동

   다운로드한 zip을 원하는 디렉토리에 풉니다.

   # macOS Apple Silicon 예시
   unzip ltc-darwin-arm64.zip -d ~/ltc-bridge
   chmod +x ~/ltc-bridge/auth-bridge-darwin-arm64

   # Linux
   unzip ltc-linux-amd64.zip -d ~/ltc-bridge
   chmod +x ~/ltc-bridge/auth-bridge-linux-amd64

   Windows: 탐색기에서 다운로드한 zip을 우클릭 → "압축 풀기" → C:\ltc-bridge 같은 경로에 풉니다. 실행 권한은 자동입니다.

2. ②

   npm 패키지 글로벌 설치 — ltc 명령 등록 — 한 줄 설치 시 자동

   zip 내부에 동봉된 4개 tarball(ltc-types/ltc-core/ltc-mcp/ltc-cli)을 글로벌 설치하면 ltc 명령어가 PATH에 등록됩니다. Node.js 22 LTS가 사전에 설치되어 있어야 합니다 (node --version 확인).

   # macOS / Linux (~/ltc-bridge로 이동 후 한 줄)
   cd ~/ltc-bridge
   npm install -g ./ltc-types-*.tgz ./ltc-core-*.tgz ./ltc-mcp-*.tgz ./ltc-cli-*.tgz

   # Windows PowerShell (관리자 권한 권장)
   cd C:\ltc-bridge
   $tgz = Get-ChildItem -Filter *.tgz | Sort-Object Name
   npm install -g $tgz.FullName

   권한 에러 시 macOS/Linux는 sudo npm install -g ..., Windows는 PowerShell을 "관리자 권한으로 실행"하세요. 설치 후 ltc --version 으로 정상 등록 여부를 확인할 수 있습니다.

3. ③

   환경변수 설정 — LTC_AUTH_BRIDGE_BIN — 한 줄 설치 시 안내 출력

   한 줄 설치 사용자: 설치 종료 시 화면에 export ... 명령이 출력됩니다. 자동 영구 반영은 하지 않으니, 출력된 한 줄을 복사해 ~/.zshrc 또는 ~/.bashrc에 추가해주세요 (선택, MCP 사용 시 권장).

   수동 zip 설치 사용자: auth-bridge 바이너리 경로를 환경변수로 알려줍니다.

   # macOS / Linux (bash, zsh)
   export LTC_AUTH_BRIDGE_BIN="$HOME/ltc-bridge/auth-bridge-darwin-arm64"
   # 영구 적용: ~/.zshrc 또는 ~/.bashrc 에 위 라인 추가

   # Windows PowerShell (현재 세션)
   $env:LTC_AUTH_BRIDGE_BIN = "C:\ltc-bridge\auth-bridge-windows-amd64.exe"
   
   # 영구 적용 (재시작 후에도 유지)
   [Environment]::SetEnvironmentVariable(
     "LTC_AUTH_BRIDGE_BIN",
     "C:\ltc-bridge\auth-bridge-windows-amd64.exe",
     "User"
   )

   Linux x86_64는 auth-bridge-linux-amd64, Intel Mac은 auth-bridge-darwin-amd64로 파일명을 바꿔서 적용하세요.

4. ④

   ltc setup — 인증서·기관기호 등록 (대화형)

   인증서 디렉토리, 비밀번호(Keychain 저장), 기관기호를 한 번 등록합니다. 명령을 인자 없이 실행하면 4개 질문이 순서대로 표시됩니다. 기본값이 미리 입력되어 있으며, Enter로 채택하거나 Backspace로 지우고 새 경로 입력도 가능합니다.

   ltc setup
   ? 인증서 디렉토리 경로 (Enter=기본값 사용, 수정 시 Backspace): ~/ltc-bridge/테스트재가복지센터
   ? 인증서 비밀번호: ************   (입력 시 * 마스킹)
   ? 기관기호 (10~11자리 숫자): 21165000216
   ? 기관 유형 코드: B01   (방문요양 = B01)
   ✓ ~/.ltc/config.json 저장
   ✓ Keychain에 비밀번호 안전 저장
   ✓ 로그인 테스트 성공

   📁 경로 입력 방식 — 두 가지 모두 가능

   표기 ① ~/ 단축 (모든 OS 권장):

   ~/ltc-bridge/테스트재가복지센터

   본인 홈 디렉터리로 자동 확장되어 저장됩니다 (운영체제별 실제 절대경로):

   • macOS: /Users/<사용자>/ltc-bridge/테스트재가복지센터
   • Linux: /home/<사용자>/ltc-bridge/테스트재가복지센터
   • Windows: C:\Users\<사용자>\ltc-bridge\테스트재가복지센터

   표기 ② Windows 절대경로 (드라이브 루트):

   C:\ltc-bridge\테스트재가복지센터

   이 경우 C:\ltc-bridge\ 와 C:\Users\<사용자>\ltc-bridge\ 는 서로 다른 위치입니다. zip을 푼 실제 위치와 일치시키세요.

   비밀번호는 macOS Keychain · Windows Credential Manager · Linux Secret Service에만 저장되며 파일에 절대 기록되지 않습니다.
   
   비대화형 모드(flag 전달)는 현재 미지원 — 다음 사이클에서 추가 예정입니다.

5. ⑤

   ltc whoami — 인증 검증

   등록된 인증서로 NPBS에 즉시 로그인하여 기관 정보를 회신합니다.

   ltc whoami
   → 햇살재가복지센터 · 인증 OK · 0.6s

   실패 시 FAQ "ltc whoami가 인증 실패로 끝나요" 항목을 참조하세요.

6. ⑥

   ltc check — 9 룰 자동 점검

   누락 청구·계약 만료·평가 자료 결격 등 9개 룰을 일괄 점검합니다.

   ltc check
   ✓ 청구 누락 점검 — 2건 발견
   ✓ 계약 만료 임박 — 3명
   ✓ 재가 정기평가 자료 — 결격 0
   …

   여기까지 끝났다면 정상 가동입니다. MCP 등록(§6)은 선택이며, 자연어로 호출하고 싶을 때만 진행하세요.