train-ktx 사용 가이드

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

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

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

먼저 알아두세요

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

준비물

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

가입 후, 코레일 아이디와 비밀번호를 .env 파일에 넣습니다 (권장) — 작업 폴더(Cowork 연결 폴더 / Claude Code 프로젝트 루트)(연결한 폴더가 여러 개면 아무 폴더나) 루트에 .env 파일을 만들고 아래 두 줄을 넣어 두면 스킬이 자동으로 찾아 읽습니다. 점(.)으로 시작하는 파일을 만들기 어렵다면 환경변수.txt 라는 이름으로 만들어도 똑같이 읽힙니다(메모장이 .txt 를 붙여 .env.txt 가 되어도 됩니다).

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

Claude Desktop의 "Claude 지침"(설정 → 일반)에 같은 내용을 적는 방식도 동작하지만, 대화 컨텍스트에 값이 노출되므로 .env 파일을 권장합니다. (아이디·비밀번호는 화면이나 기록에 그대로 드러나지 않도록 가려서 다룹니다. .env 파일은 작업 폴더 밖으로 공유하지 마세요.)

개발자라면 셸 환경변수나 홈($HOME) 루트의 .env에 넣어도 됩니다.

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

이렇게 말해보세요

계정 확인

• /train-ktx 코레일 계정 확인해줘
• /train-ktx 코레일 로그인 되는지 봐줘

열차 찾기

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

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

예약하기

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

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

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

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

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

결제와 취소

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

지금은 안 되는 것들

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

잘 안 될 때

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