2026-09-08 · 참가자 실습안 / 진행자 점검 / GPT 연결 부록
본편 24장은 텔레그램 → 내 봇 → 실행 중인 Claude Code → PC 파일 작업을 따라갑니다. GPT 연결은 아래 부록의 별도 프로그램 구성으로 설명합니다. Claude Code의 명령을 ChatGPT 대화창에 붙여넣는 방식과 혼동하지 않습니다. 화면은 모두 교육용 도식입니다. 실제 계정의 실행 결과를 캡처한 것이 아닙니다.
PowerShell을 검색해 열고 claude를 입력합니다. Claude Code 입력줄에 다음 문장을 붙입니다.
내 폰 텔레그램에서 이 Claude Code에 일을 시킬 수 있게 준비해줘
필요한 것을 확인하고 설치해줘
내가 직접 해야 하는 단계가 오면 멈춰서 알려줘준비 결과를 읽습니다. 진행자는 Bun 설치, Claude Code 버전과 채널 기능 사용 가능 여부를 확인합니다. 사람의 로그인과 인증은 직접 합니다.
공식 BotFather를 엽니다. /newbot을 보낸 뒤 표시 이름, 고유 사용자명을 차례로 입력합니다. 사용자명은 bot으로 끝나야 합니다. _bot으로 끝내도 됩니다. 받은 토큰은 봇 제어 권한을 가진 비밀 값입니다. 화면 공유와 단체 대화에 노출하지 않습니다. BotFather 대화와 내 봇 대화는 서로 다릅니다.
Claude Code가 이미 설치했다면 반복하지 않습니다. 아직 남아 있으면 Claude Code 입력줄에서 실행합니다.
/plugin install telegram@claude-plugins-official설치 범위는 user를 선택합니다. /reload-plugins 실행 안내가 있으면 따릅니다. 화면 공유를 중지한 상태에서 다음 명령의 <토큰>만 실제 값으로 바꿉니다.
/telegram:configure <토큰>토큰은 ~/.claude/channels/telegram/.env에 저장됩니다. 연결에 필요한 설정 파일은 유지하고 공유·복사 기록의 노출을 확인합니다. 설정 외 다른 기록에 남지 않는다고 보장할 수 없으므로 토큰을 일반 대화로 전달하지 않습니다.
Claude Code에서 /exit로 종료합니다. PowerShell에서 다음 두 줄을 순서대로 입력합니다.
Set-Location ([Environment]::GetFolderPath('Desktop'))
claude --channels plugin:telegram@claude-plugins-official첫 줄은 현재 윈도우 계정에 등록된 바탕화면으로 이동합니다. OneDrive 등으로 바탕화면이 이동된 경우에도 단순한 cd Desktop보다 적절한 경로를 얻기 위한 방식입니다. 폴더 신뢰·채널 시작 안내·관리자 경고를 읽습니다. 이 명령은 PowerShell용입니다. WSL 실습에 그대로 복사하지 않습니다.
내 봇 대화방에 안녕을 보냅니다. 받은 페어링 코드를 PC의 Claude Code에 입력합니다.
/telegram:access pair <코드>코드가 오지 않으면 내 봇이 맞는지, PC 수신 창이 켜져 있는지 먼저 확인합니다.
Claude Code에서 다음을 실행합니다.
/telegram:access policy allowlist내 계정만 허용목록에 있는지 확인합니다. 토큰 보관, 사용자 허용목록, PC 도구 권한은 각각 다른 사항입니다.
내 봇 대화방에 보냅니다.
바탕화면에 test.txt 파일을 만들고
'원격 테스트 성공'이라고 써줘
같은 이름의 파일이 있으면 덮어쓰지 말고 알려줘
완료하면 저장한 위치와 파일 내용을 이 대화방에 알려줘PC 권한 질문이 있으면 작업 내용을 보고 처리합니다. 바탕화면 파일을 직접 열어 문구를 확인하고 폰의 답장도 확인합니다. 두 결과가 모두 맞아야 성공입니다. 이미 파일이 있으면 새 파일명을 정해 요청합니다. 바탕화면에서 시작해도 모든 권한 질문이 없어지는 것은 아닙니다.
사용하는 동안 PC 전원·인터넷과 수신 세션을 유지합니다. 기관 정책에 따라 절전을 조정합니다. 화면 끄기와 절전은 다릅니다. 재부팅 또는 세션 종료 뒤에는 4단계로 다시 켭니다. 사용을 마치면 PC에서 /exit로 종료합니다. 자동 시작·예약 요청은 별도 설정입니다.
아래는 실제 수업 전 수행할 점검입니다. 이번 자료 제작 중 완료된 실습으로 표시하지 않습니다.
| 점검 | 성공 기준 | 상태 |
|---|---|---|
| 참가자와 같은 Windows 환경 | Claude Code·Bun 실행, 채널 시작 경고 없음 | 현장 확인 필요 |
| Team 관리자 설정 | Owner가 Channels 활성화 확인 | 현장 확인 필요 |
| 사내망 | Telegram 수신·응답 가능 | 현장 확인 필요 |
| 봇 등록 | 본인 페어링 및 allowlist 확인 | 현장 확인 필요 |
| 실제 파일 작업 | 바탕화면 파일·내용·폰 답장 일치 | 현장 확인 필요 |
| 권한 대기 | 첫 파일 쓰기·응답 권한을 PC 앞에서 확인 | 현장 확인 필요 |
| 종료 후 재시작 | 같은 봇으로 다시 수신 가능 | 현장 확인 필요 |
| 자료 화면 | 캡처에 개인 정보·토큰 없음 | 도식만 사용 |
최소 지원 버전과 Windows 네이티브의 실제 채널 구동은 이 제작 환경에서 실측하지 않았습니다. 설치된 도구만 보고 실습 성공으로 판정하지 않습니다. 실패하면 해당 PC를 준비한 뒤 교육하거나, 진행자의 사전 검증된 PC로 시연합니다.
이 부록에서 제시하는 구성은 Telegram Bot API + 연결 프로그램 + OpenAI Responses API입니다. 텔레그램에서 문장을 보내 GPT 답변을 받는 것이 첫 목표입니다. API 호출만으로 내 PC 파일을 수정하는 기능이 생기지는 않습니다. 파일 작업은 따로 구현하고 권한을 정해야 합니다. Claude Code 본편의 /telegram:configure와 –channels 명령은 이 구성에 사용하지 않습니다. ChatGPT 웹 대화 기록이나 기존 로그인 세션을 이어받는 것으로 설명하지 않습니다.
PC에서 개발 작업을 할 수 있는 Codex 또는 Claude Code에 아래 문장을 보냅니다. 실제 연결 프로그램 제작은 이번 본편의 실습 범위 밖입니다.
내 텔레그램 봇에서 메시지를 보내면 OpenAI Responses API의 GPT 모델이
한국어로 답하는 개인용 프로그램을 만들어줘.
먼저 현재 PC 환경을 확인하고, 처음에는 긴 폴링 방식으로 구현해줘.
TELEGRAM_BOT_TOKEN, OPENAI_API_KEY, OPENAI_MODEL,
TELEGRAM_ALLOWED_USER_ID를 환경 설정으로 분리해줘.
키는 내가 로컬 설정에 직접 입력하게 하고 화면·로그·Git에 남기지 마.
내 Telegram 사용자 ID가 일치하는 개인 대화만 처리해줘.
허용되지 않은 요청은 모델 API를 호출하기 전에 거부해줘.
모델명은 내 계정에서 사용 가능한 것을 확인한 뒤 설정하게 해줘.
파일 수정·명령 실행·다른 사람에게 발송하는 기능은 만들지 마.
텍스트 한 건씩 답하고, 중복 수신·오류·긴 답장 분할을 처리해줘.
설정 예시에는 비밀 값 대신 자리표시자만 넣어줘.
시작·종료·다시 실행하는 방법을 초보자용으로 적어줘.
먼저 가짜 API로 테스트하고, 키 입력과 사용 요금 확인을 마친 뒤
내가 보낸 시험 메시지 한 건으로 실제 답장을 확인하게 해줘.내 개인 대화의 텍스트 요청에 답하고, 허용되지 않은 입력은 차단되며, 비밀 값이 출력되지 않아야 합니다. 이 GPT 프로그램은 이번 작업에서 구현·인증·실제 응답 시험을 한 것이 아닙니다. 본편 Claude Code 경로와 구분하기 위한 제작 프롬프트와 실습 설계입니다.
2026-09-08 확인. 기능이 리서치 프리뷰인 만큼 교육 직전에 다시 확인합니다.