안녕하세요 코드깎는노인입니다.

이미 쓰고 있는 코딩 에이전트(Claude Code, Codex, Gemini CLI, OpenCode)를 텔레그램에서 그대로 쓸 수 있게 해주는 cokacdir이라는 오픈소스 도구의 소개와 사용방법을 알려드립니다.

cokacdir은 자체 AI 에이전트를 내장하지 않습니다. 대신 기존 에이전트에 작업을 위임하고, 이를 텔레그램에서 편하게 운용할 수 있는 인터페이스와 실행 환경을 제공합니다. 그래서 별도 API 비용 없이, 이미 쓰고 있는 구독 플랜 안에서 활용할 수 있습니다.

• 에이전트 간 작업 위임과 상호 소통
• 스케줄 기반 자동 실행
• 자유로운 세션 생성 및 이어쓰기
• systemd, launchd, Task Scheduler 기반 상시 실행
• 진행상황 실시간 공유
• 텔레그램에서 셸 명령 실행
• 파일 업로드를 다음 AI 컨텍스트에 자동 반영
• 채팅별 개별 설정

OpenClaw와 차이

차이는 구조입니다.

OpenClaw는 자체 에이전트를 내장하므로 LLM API 키와 토큰 과금이 필요합니다. 컨텍스트가 길어질수록 비용도 커질 수 있습니다.

반면 cokacdir은 에이전트를 직접 포함하지 않고, Claude Code·Codex·Gemini CLI·OpenCode에 위임합니다. 그래서 추가 API 과금 없이 기존 구독 기반으로 쓸 수 있습니다.

이러한 이유로 에이전트 구동을 위해 별도 OAuth 인증정보를 직접 다루지 않기 때문에, 그 과정에서 생길 수 있는 정책 리스크로부터 완전히 자유롭습니다.

이런 기능이 핵심

여러 봇을 같은 텔레그램 그룹에 넣어 역할을 나눌 수도 있습니다.
예를 들어 Claude Code가 구현하고, Codex가 리뷰하고, 다른 봇이 테스트를 돌리는 식입니다.

또 세션을 제한 없이 병렬로 굴릴 수 있고, CLI에서 하던 작업을 텔레그램에서 이어받는 것도 가능합니다.
!git status, !docker ps 같은 셸 명령도 텔레그램에서 바로 실행할 수 있어서, 폰으로 로그 확인·재시작·배포 같은 작업도 가능합니다.

스케줄 작업은 이전 실행 결과를 기억합니다.
그래서 "매일 아침 분석" 같은 자동화도 누적 맥락을 바탕으로 이어서 수행할 수 있습니다.

설치

코딩 에이전트(Claude Code, Codex, Gemini CLI, OpenCode 중 하나 이상)가 설치된 머신에서 실행하면 됩니다.

macOS / Linux

curl -fsSL https://cokacdir.cokac.com/manage.sh | bash && cokacctl  

Windows (관리자 권한 PowerShell)

irm https://cokacdir.cokac.com/manage.ps1 | iex; cokacctl 

실행 후 서비스 매니저 TUI에서 텔레그램 봇 토큰을 등록하고 시작하면 끝입니다.
텔레그램에서 해당 봇에게 /start를 보내면 바로 사용할 수 있습니다.

참고로 OpenCode는 macOS/Linux만 지원합니다.

추천 대상

• Claude Code나 Codex를 이미 구독 중인 사람
• 코딩 에이전트를 스마트폰에서도 쓰고 싶은 사람
• 여러 에이전트를 협업시켜 보고 싶은 사람
• OpenClaw의 토큰 비용이 부담스러운 사람
• 반복 작업을 자동화하고 싶은 사람