Gemini CLI와 cokacdir로 만드는 무료 텔레그램 코딩 비서

Gemini CLI와 cokacdir로 만드는 나만의 무료 텔레그램 코딩 비서

비싼 API 비용 때문에 코딩 에이전트 도입을 망설였다면, 이제 걱정하지 마세요. Google AI Studio의 무료 티어와 cokacdir이라는 브릿지 도구를 활용하면, 스마트폰 텔레그램으로 언제 어디서든 내 PC의 개발 환경을 제어할 수 있습니다.

1. Gemini CLI 무료 사용 방법

가장 먼저 엔진이 될 API 키를 확보해야 합니다.

• Google AI Studio에 접속하여 Get API key를 클릭합니다.
• 새 프로젝트에서 키를 생성하고 안전한 곳에 복사해 둡니다.
• Gemini 1.5 Flash 모델은 분당 15회, 하루 1,500회까지 무료로 넉넉하게 사용 가능합니다.
• 환경 변수 설정을 통해 터미널에서 export GOOGLE_API_KEY="여러분의_키"를 입력하여 활성화합니다.

※ 주의: 무료 티어의 데이터는 모델 학습에 사용될 수 있으므로 민감한 개인 정보 입력은 지양하는 것이 좋습니다.

2. cokacdir와 Gemini CLI의 연동 구조

cokacdir은 단순한 대화 도구가 아니라, 사용자의 텔레그램 메시지를 로컬 PC의 Gemini CLI로 전달하는 중계(Bridge) 역할을 수행합니다.

• 경제성: 유료 API 구독 없이도 Gemini의 무료 할당량을 원격으로 소비할 수 있습니다.
• 연속성: 외부에서도 텔레그램을 통해 사무실 PC의 프로젝트 파일을 분석하고 코드를 수정할 수 있습니다.
• 성능: 가벼운 Rust 기반으로 설계되어 리소스 점유율이 매우 낮습니다.

3. 단계별 설정 순서

Step 1. cokacdir 설치

# Windows (PowerShell)
irm https://cokacdir.cokac.com/manage.ps1 | iex; cokacctl

# Mac/Linux (Bash)
curl -fsSL https://cokacdir.cokac.com/manage.sh | bash && cokacctl

Step 2. 실행 경로 등록

~/.cokacdir/.env.json 파일에 실제 Gemini CLI 파일 경로를 입력합니다.

{ "COKAC_GEMINI_PATH": "/usr/local/bin/gemini-cli" }

Step 3. 텔레그램 봇 연결

• @BotFather를 통해 봇 토큰을 발급받습니다.
• cokacctl 실행 후 i를 눌러 토큰을 입력하고 s를 눌러 서버를 시작합니다.
• 이제 텔레그램에서 /model 명령어로 모델을 선택하고 바로 코딩 지시를 내릴 수 있습니다.

요약: 왜 이 조합인가?

결국 경제성과 편의성입니다. 비싼 비용을 들이지 않고도 Google의 최신 모델을 내 PC 환경과 결합하여 나만의 코딩 비서를 구축하는 가장 스마트한 방법이기 때문입니다. 지금 바로 시작해 보세요!