train-ktx 사용 가이드

KTX 열차를 찾고 예약하는 스킬입니다. 평소 말하듯 부탁하면 됩니다.

⚠️ 실험적 스킬 — 배포하지 마세요#

이 스킬은 개인 학습·실험 목적으로 만든 것입니다. 코레일의 비공식 통로를 쓰기 때문에 코레일 이용약관에 어긋날 수 있고, 그래서 다른 사람에게 배포하거나 공개 마켓플레이스에 올리지 않습니다. 직접 쓰실 때도 본인 계정·본인 책임이라는 점을 기억해 주세요. 동작 원리가 궁금하면 README.md를 참고하세요.

먼저 알아두세요#

• 이 스킬은 코레일의 비공식 통로로 동작합니다. 코레일 사정(보안 점검 등)에 따라 갑자기 안 될 수 있습니다. 그럴 때는 잠시 후 다시 시도하거나 코레일 앱을 이용하세요.
• 이 스킬은 열차 찾기와 예약까지만 도와줍니다. 결제와 취소는 직접 하셔야 합니다. 예약을 해 두어도 정해진 시간 안에 코레일 앱/웹에서 결제하지 않으면 자리가 자동으로 풀립니다.
• 예약·결제·노쇼(예약 후 미탑승)에 대한 책임은 본인에게 있습니다.
• 취소표를 자동으로 계속 노리는 매크로 기능은 제공하지 않습니다.

준비물#

코레일 회원 계정이 필요합니다. 아직 없다면 코레일 홈페이지(letskorail.com)에서 가입하세요.

가입 후, 코레일 아이디와 비밀번호를 Claude Desktop 지침에 등록해 두면 됩니다 — Claude Desktop → 설정 → 일반 → “Claude 지침” 에 아래 두 줄을 붙여넣고 저장하세요.

KORAIL_USER_ID=코레일 회원번호 또는 휴대폰번호 또는 이메일
KORAIL_PASSWORD=코레일 로그인 비밀번호

한 번 넣으면 이후 모든 대화에서 Claude가 자동으로 사용합니다 — .env 같은 파일을 직접 만들 필요가 없습니다. (아이디·비밀번호는 화면이나 기록에 그대로 드러나지 않도록 가려서 다룹니다. 특히 비밀번호는 본인만 보는 지침 영역에 두는 것이 안전합니다.)

개발자라면 작업 폴더·홈의 .env 파일이나 환경변수에 같은 두 줄을 넣어도 됩니다.

등록이 끝나면 확인해 보세요 — “코레일 계정 확인해줘”라고 말하면 로그인을 한 번만 시도해 계정이 맞게 설정됐는지 알려드립니다(아이디는 가려서 표시). 표를 구하려는 순간에 로그인 오류를 만나는 일을 막아 줍니다.

이렇게 말해보세요#

계정 확인

• “코레일 계정 확인해줘”
• “코레일 로그인 되는지 봐줘”

열차 찾기

• “다음 주 금요일 서울에서 부산 가는 KTX 찾아줘”
• “내일 오후 2시 이후에 동대구 가는 표 있어?”
• “6월 12일 오전에 용산에서 광주 가는 기차 알려줘”
• “어른 2명 어린이 1명, 주말에 강릉 가는 KTX 보여줘”

출발·도착역, 날짜, 시간대, 인원을 말해 주면 됩니다. 시간은 “오후 2시 이후”처럼 대략 말해도 그 시각 이후 열차를 보여줍니다.

예약하기

• “그중에 두 번째 열차로 예약해줘”
• “제일 빠른 걸로 잡아줘”
• “특실로 예약 가능해?”

예약은 두 단계로 진행됩니다#

안전을 위해 예약은 한 번에 끝내지 않습니다.

1. 먼저 어떤 열차를 잡을지 보여드립니다 — 시각, 구간, 좌석유형, 인원. (이 단계에서는 아직 예약되지 않습니다.)
2. 내용을 확인하고 “맞아, 예약해줘” 라고 승인하면 그때 실제로 예약합니다.

예약이 되면 예약번호와 결제기한을 알려드립니다. 그 시간 안에 코레일 앱/웹에서 직접 결제하세요.

결제와 취소#

• 결제: 이 스킬은 결제하지 않습니다. 예약 후 코레일 앱/웹에서 결제기한 안에 직접 하세요.
• 취소: 이 스킬은 취소하지 않습니다. 코레일 앱/웹이나 고객센터(1544-7788)에서 취소하세요. (결제 전 예약은 기한이 지나면 저절로 풀립니다.)

지금은 안 되는 것들#

• 갈아타는 여정(환승), 자동 결제, 자동 취소, 할인 최적화는 지원하지 않습니다.
• “자리 날 때까지 계속 시도해줘” 같은 반복 감시는 하지 않습니다. 필요할 때 그때그때 다시 찾아 달라고 하세요.

잘 안 될 때#

• “차단되었습니다”라고 나오면 코레일 보안 점검에 막힌 것입니다. 잠시 후 다시 시도하거나 코레일 앱을 이용하세요.
• “로그인 필요”가 나오면 Claude 지침(또는 .env)에 넣은 아이디·비밀번호를 다시 확인하세요. 고친 뒤 “코레일 계정 확인해줘”라고 말하면 바로 검증할 수 있습니다.
• 원하는 시간대가 안 보이면 매진일 수 있습니다. 다른 시간대나 날짜로 다시 찾아보세요.