Show GN: 텔레그램을 이용한 Claude Code 실행 스크립트

소개

급할때(퇴근 후, 외부)에서 쓰려고 만든 npx 스크립트로 클로드 코드를 텔레그램으로 제어할 수 있는 스크립트입니다.

특징

• 프로젝트(경로) 1개 당 채팅방 1개(개별 텔레그램 봇이 필요함)
• 병렬 실행, 반복 실행(성공 시까지), 우선순위 지정 가능
• 작업 확인, 작업 취소 가능

설치 및 사용법

• npx cc-telegram 으로 실행하여 봇 토큰과 안내에 따라 텔레그램 chat id를 등록하고 기타 몇가지 설정을 하면 사용 준비 완료가 됩니다.
• 이후 npx cc-telegram으로 실행하고 텔레그램으로 /new 명령어로 새로운 요청을 보내면 됩니다.
• 텔레그램에서는 / 자동완성으로 사용할 수 있는 명령어 목록이 노출됩니다. 자세한 건 링크를 참조해주세요.

간략 개발기

1차 버전

1차 버전은 중계 서버와 pc내의 여러 경로를 지정할 수 있는 에이전트 프로그램을 이용해서 1개의 채팅방을 통해 여러 경로의 프로젝트들을 사용하는 버전이였습니다.
여러개의 프로젝트를 하나의 채팅방으로 관리하려다보니 오히려 복잡도만 올라가서 2일만에 폐기처리하였습니다.

2차 버전

2차 버전에서 중계 서버를 없애고 스크립트에 telegram 메세지를 polling 방식으로 가져오게 변경하였습니다.
이때는 기능 내에 서브 에이전트 들을 탑재하고, 해당 에이전트들이 요청사항을 분석해 작업하고, 작업이 없을땐 개선 사항등을 제안/자동실행 하는 방식 이였습니다.
작년 연말 휴일 4일 돌린 결과, 대량의 쓰레기 코드를 생성해낸 걸 확인하고 폐기하였습니다.

2.5차 버전

2차 버전에서 개선 사항 제안/자동실행 부분을 삭제한 버전입니다. 뭔가 동작은 하는데

현재 버전

얼마전 ralph-loop 플러그인을 알게 되어 개별 프로젝트마다 사용해보고, 반복 실행 방식과 프로젝트마다의 클로드 설정을 이용하는게 가장 좋다고 판단했습니다.

2차 버전의 문제점은 개별 프로젝트 마다 적절한 서브에이전트 설정이 따로 있는데, 그걸 고려하지 않고 통합 서브에이전트들을 제공해줘서 오히려 성능 저하가 있다고 판단했습니다.

이전까지의 작업들을 거의 폐기(os별 클로드 코드 실행 부분, 텔레그램 연동 부분 코드만 재활용)하고 거의 처음부터 다시 설계해서 지금 버전이 나왔습니다.
개인적으로는 이제야 처음으로 그래도 쓸만한 버전이 나왔다고 생각합니다.

사용해 보시고 소감이나 피드백 주시면 감사하겠습니다.