API 키도, 월 사용료도 따로 없는 AI 비서를 만들 수 있어요.
"AI 비서 만들고 싶은데 API 비용이 너무 무서워요." 저도 처음에 그랬습니다. OpenAI API 연결했다가 토큰 폭탄 맞는 이야기를 몇 번 들었거든요. 그런데 Claude Code를 구독하면 CLI로 직접 호출할 수 있고, 이게 API 비용을 완전히 우회하는 구조라는 걸 알게 됐습니다. 체리플랜(@cherryplan2)이 실제로 만들어 공유한 Discord + Claude Code + Google 캘린더 AI 비서가 그 증거입니다.
왜 Discord인가 — 텔레그램 대신 Discord를 선택한 이유
Anthropic이 2026년 3월 20일 Claude Code Channels를 공식 출시했습니다. 텔레그램, Discord, iMessage를 통해 Claude Code에 명령을 보낼 수 있는 공식 기능입니다. 그런데 체리플랜이 만든 건 그것보다 한 발 더 나아간 버전입니다. 단순히 Claude에게 질문하는 게 아니라, 구글 캘린더까지 연결해서 실제 일정을 조회하고 추가까지 됩니다.
Discord를 선택한 이유는 단순합니다. 서버 채널별로 명령을 분리할 수 있고, 팀 단위로 쓰기도 좋습니다. 텔레그램이 개인 용도라면 Discord는 팀 AI 비서에 더 가깝습니다.
Claude.ai 열기 → 로그인 → 프롬프트 입력 → 캘린더 따로 확인 → 수동 입력
Discord에서 !오늘일정 입력 → 오늘 일정 자동 출력. 끝.
핵심 구조 — API 비용이 0원인 이유
대부분의 AI 봇은 API 키를 연결해서 쓰는 구조입니다. 메시지를 보낼 때마다 토큰이 소모되고, 사용량에 따라 청구됩니다. 이 봇은 다릅니다.
핵심 구조
Discord 봇이 메시지를 받음 → Python subprocess로 claude -p "질문" 실행 → CLI 응답을 Discord로 돌려보냄
Claude Code 구독이 있으면 claude CLI는 이미 포함돼 있습니다. API 키 없이, 추가 비용 없이 돌아갑니다.
쉽게 말하면, 터미널에서 claude 명령어를 직접 치는 것과 똑같은 방식입니다. 그걸 Discord 봇이 대신 실행해주는 구조입니다. Claude Code 월 구독료 외에 추가 비용이 없습니다.
사용 가능한 명령어 — 이런 것들이 됩니다
- !ask [질문] — Claude에게 무엇이든 물어보기. "오늘 회의 자료 요약해줘"도 됩니다.
- !오늘일정 — 구글 캘린더에서 오늘 일정을 자동으로 불러와 출력
- !이번주일정 — 이번 주 전체 일정 한눈에 확인
- !할일추가 [내용] [날짜] — 구글 Tasks에 할 일 추가. "3월 27일 오후 2시 미팅"도 인식
- !할일목록 — 현재 할 일 목록 출력
체리플랜은 여기서 더 나아가 자연어 파싱 강화도 준비 중입니다. 지금은 "3월 27일 오후 2시"는 인식하는데 "다음 주 월요일"은 안 된다고 하는데, 이 부분을 Claude에게 위임하면 훨씬 자유로워진다고 합니다.
세팅 3단계 — 비개발자도 따라할 수 있는 방법
1 Discord 봇 만들기
Discord Developer Portal에서 새 앱 생성 → Bot 탭에서 토큰 발급. 생성된 봇을 내 서버에 초대합니다. 10분이면 됩니다.
2 Google Calendar 연동
Google Cloud Console에서 Calendar API + Tasks API 활성화 → OAuth 클라이언트 ID 발급(데스크톱 앱 유형) → 다운받은 JSON 파일을 credentials.json으로 이름 변경 → python setup_calendar.py 실행 → 브라우저 로그인으로 token.json 생성 완료.
3 봇 실행 및 배포
로컬에서 python bot.py로 먼저 테스트. 잘 작동하면 Render에 배포합니다. Render는 무료 플랜으로도 24시간 봇 운영이 가능합니다. 환경변수에 Discord 토큰과 Google 인증 정보를 입력하면 완료.
필요한 것 요약
· Claude Code 구독 (월 $100 / Pro 기준)
· Discord 계정 + 서버
· Google 계정
· Python 3.10 이상 (설치만 하면 됨, 코딩 불필요)
앞으로 더 발전할 기능들
체리플랜이 다음으로 추가하고 싶다고 밝힌 기능들입니다. 이 방향이 흥미로운 이유는, Claude Code가 자연어를 처리하는 부분을 담당하면 봇이 점점 더 영리해질 수 있기 때문입니다.
- 자연어 파싱 강화 — "다음 주 월요일", "내일 오후" 같은 표현 인식
- 일일 브리핑 자동화 — 매일 아침 지정 시간에 오늘 일정 자동 전송
- 슬래시 커맨드 전환 — !ask 방식에서 /ask 방식으로 바꿔 Discord UX 개선
- Notion 연동 — 구글 Tasks 대신 Notion 데이터베이스를 할 일 백엔드로
세미나에서 개념을 배우고, 직접 에러와 삽질을 겪으면서 구조를 이해했다는 체리플랜의 말이 기억에 남습니다. AI 도구는 결국 부딪혀봐야 손에 익습니다.
자주 묻는 질문 (FAQ)
Q. Claude Code 구독 없이도 가능한가요?
이 방식은 claude CLI를 subprocess로 호출하는 구조라 Claude Code 구독이 반드시 필요합니다. 대신 별도 API 비용이 없으니, Claude Code를 이미 쓰고 있다면 추가 비용이 전혀 없습니다. Anthropic의 공식 Claude Code Channels 기능(Discord/텔레그램 연동)도 있으니, 더 간단한 세팅을 원한다면 그쪽을 먼저 시도해보세요.
Q. 코딩을 전혀 못해도 되나요?
Python 설치와 터미널 명령어 실행 정도는 필요합니다. 하지만 코드를 직접 짜는 건 필요 없습니다. GitHub에 공개된 코드를 그대로 가져다 쓰면 되고, 모르는 부분은 Claude에게 물어보면 됩니다. 세팅하다 막히면 Claude에게 에러 메시지 붙여넣고 물어보세요.
Q. 텔레그램 봇과 뭐가 다른가요?
기능은 유사합니다. Discord는 서버 채널별로 역할을 나눌 수 있어서 팀 단위 활용에 유리합니다. 개인 용도라면 텔레그램이 더 간단하고, Anthropic 공식 Claude Code Channels도 텔레그램을 지원합니다. 이미 Discord를 쓰고 있다면 Discord 봇이 자연스럽습니다.
Q. Render 배포가 어렵지 않나요?
Render는 GitHub 저장소를 연결하면 자동 배포되는 구조라 생각보다 간단합니다. 무료 플랜도 있고, 환경변수 설정도 웹 UI에서 클릭으로 됩니다. Claude에게 "Render 배포 단계별로 알려줘"라고 물어보면 친절하게 알려줍니다.
정리하며
AI 비서를 만드는 게 비싸고 어렵다는 인식은 이제 옛날 얘기입니다. Claude Code 구독 하나로, 이미 매일 쓰는 Discord에 내 캘린더까지 연결된 AI 비서를 만들 수 있습니다. 처음엔 에러도 나고 삽질도 합니다. 그런데 그 과정이 구조를 이해하는 가장 빠른 길이기도 합니다. 한 번 만들어두면 매일 씁니다.
Claude Code를 아직 시작 안 했다면, 여기서부터 시작하세요.
클로드 AI 입문 가이드 — 비개발자 활용법 5가지 →
참고 자료
· 체리플랜 (@cherryplan2) — Discord + Claude Code + Google Calendar AI 비서 구축기 (2026.03)
· Anthropic — Claude Code Channels: Telegram, Discord & iMessage (2026.03.20 출시)
· VentureBeat — Anthropic shipped Claude Code Channels for Discord and Telegram
댓글
댓글 쓰기