---
title: "train-ktx"
description: "KTX 고속열차를 검색하고 예약하는 스킬입니다. 2026-09-01 SRT가 KTX로 통합되어 옛 SRT 구간(수서·동탄·평택지제 출발)도 이 스킬이 담당합니다. \"다음 주 금요일 서울에서 부산 KTX 찾아줘\", \"수서에서 부산 가는 표 있어?\", \"오후 2시 이후 동대구 가는 표 있어?\", \"아까 그 열차로 예약해줘\", \"코레일 계정 확인해줘\"처럼 말하면 됩니다. 코레일 비공식 API를 사용하며, 예약은 반드시 확인을 거치고 결제·취소는 사용자가 직접 합니다. [책임 경계] 본 스킬은 KTX·옛 SRT 전 고속열차 예매 전담 — itda-travel:train-srt 는 통합 안내 스텁이며 기능을 갖지 않습니다."
pack: itda-travel
slug: train-ktx
status: experimental
tags: ["ktx", "korail", "srt", "train", "booking", "reservation", "travel"]
---
# train-ktx 사용 가이드

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

## SRT도 이 스킬로 찾습니다 (2026-09-01 통합)

SRT는 2026년 9월 1일부터 KTX로 통합됐습니다. 9월 1일 이후 출발하는 열차는
코레일+ 앱과 코레일 홈페이지에서만 예매할 수 있어서, **수서·동탄·평택지제에서
출발하는 열차도 이 스킬로 찾습니다.**

"수서에서 부산 가는 표 찾아줘" 처럼 말하면 됩니다. "SRT" 라고 부르셔도 되고,
결과에 **KTX·KTX-산천**으로 표기되는 것이 정상입니다(같은 열차입니다).
옛 `train-srt` 스킬은 안내만 하고 종료합니다.

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

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

## 먼저 알아두세요

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

## 준비물

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

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

```dotenv
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 코레일 계정 확인해줘`라고 말하면 바로 검증할 수 있습니다.
- 원하는 시간대가 안 보이면 매진일 수 있습니다. 다른 시간대나 날짜로 다시 찾아보세요.