기본 콘텐츠로 건너뛰기

코딩 없이 클로드로 AI 비서 만드는 법 Discord Claude Code 완전 가이드

thumbnail

Photo by Babak Habibi on Unsplash

AI 자동화
Claude Code 구독 하나면 충분합니다.
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 생성 완료.

주의 — token.json은 로컬에서만 쓰세요. Render 같은 서버에 배포할 때는 환경변수로 관리해야 합니다. 파일로 올리면 보안 문제가 생깁니다.

3 봇 실행 및 배포

로컬에서 python bot.py로 먼저 테스트. 잘 작동하면 Render에 배포합니다. Render는 무료 플랜으로도 24시간 봇 운영이 가능합니다. 환경변수에 Discord 토큰과 Google 인증 정보를 입력하면 완료.

필요한 것 요약

· Claude Code 구독 (월 $100 / Pro 기준)

· Discord 계정 + 서버

· Google 계정

· Python 3.10 이상 (설치만 하면 됨, 코딩 불필요)


실제로 어떻게 작동하는가 — 핵심 코드 구조

복잡한 프레임워크 없이, 핵심은 단 하나입니다. Discord 메시지를 받으면 claude -p 명령을 subprocess로 실행하고, 결과를 다시 Discord로 보냅니다.

import subprocess import discord client = discord.Client(intents=discord.Intents.default()) @client.event async def on_message(message): if message.content.startswith('!ask'): query = message.content[4:].strip() # Claude CLI 호출 — API 비용 없음 result = subprocess.run( ['claude', '-p', query], capture_output=True, text=True, timeout=60 ) response = result.stdout[:2000] # Discord 2000자 제한 await message.channel.send(response or "응답 없음")

위 코드가 전부입니다. claude -p는 Claude Code 구독이 있으면 터미널에서 바로 쓸 수 있는 명령어입니다. subprocess로 실행한다는 건, 터미널에서 직접 치는 것과 똑같다는 뜻입니다.

System Prompt 설정 예시 (CLAUDE.md 활용)

Claude에게 Discord 봇 맥락을 주고 싶다면, 프로젝트 폴더의 CLAUDE.md에 이렇게 적어두세요:

# 역할 나는 Discord AI 비서입니다. !ask 명령을 받으면 질문에 간결하게 답합니다. !오늘일정 명령을 받으면 구글 캘린더에서 오늘 일정을 조회합니다. # 응답 규칙 - 200자 이내로 간결하게 - 리스트는 줄바꿈으로 - 코딩 관련 질문은 코드 블록 활용

다른 방식과 비용 비교해보면

AI 봇을 만들 때 가장 걱정하는 게 API 비용입니다. 이 방식이 실제로 얼마나 차이 나는지 정리해봤습니다.

방식 월 기본 비용 메시지당 추가 비용 특징
Claude Code 구독 (이 방식) $20 (Pro) 없음 구독료 안에 포함. 사용량 무관
Claude API 직접 연결 없음 토큰당 과금 많이 쓸수록 비용 증가
OpenAI API (GPT-4o) 없음 토큰당 과금 하루 100회면 월 $5~15 추가
Claude Code Channels (공식) 구독 포함 없음 공식 지원, 세팅 더 간단

매일 아침 브리핑이나 간단한 질문 정도라면 Claude Code Pro 구독($20) 안에서 충분히 커버됩니다. API를 직접 연결하면 사용량에 따라 비용이 올라가는 반면, 이 방식은 구독료 외 추가 비용이 없습니다.


막혔을 때 해결법

세팅하다가 자주 막히는 지점 4가지입니다. 에러 메시지 그대로 Claude에게 붙여넣으면 대부분 해결됩니다.

증상 원인 해결법
claude: command not found Claude Code PATH 미설정 터미널에서 which claude 확인. 없으면 Claude Code 재설치
Discord 봇이 메시지에 반응 없음 Message Content Intent 미활성화 Discord Developer Portal → Bot → Privileged Gateway Intents → MESSAGE CONTENT INTENT 켜기
캘린더 조회 안됨 OAuth token.json 만료 python setup_calendar.py 재실행 → 브라우저 재인증
응답이 중간에 잘림 Discord 2000자 제한 코드에서 result.stdout[:2000]으로 슬라이싱

앞으로 더 발전할 기능들

체리플랜이 다음으로 추가하고 싶다고 밝힌 기능들입니다. 이 방향이 흥미로운 이유는, 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가지 →
#멜론AI인사이트 #Claude Code #AI자동화 #비개발자

참고 자료
· 체리플랜 (@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

댓글

이 블로그의 인기 게시물

Opus 4.7 제대로 쓰는 법 — Claude Code 팀이 공유한 실전 팁 6가지 2026

Photo by Joshua Woroniecki on Unsplash Opus 4.7로 바꿨는데 "음... 좀 나아진 것 같기도?"로 끝났다면, 모델이 아니라 쓰는 방식이 문제입니다. Claude Code를 만든 팀이 직접 몇 주간 써보고 깨달은 것을 공유했습니다. 솔직히 저도 그랬습니다. Opus 4.7 나왔다길래 바로 써봤는데, 처음엔 "뭐가 달라졌지?" 싶었습니다. 그런데 Boris Cherny(Claude Code 팀)의 팁을 보고 워크플로우를 바꿨더니, 체감이 확 달라졌습니다. 매일 이 블로그를 Claude Code로 운영하면서 하나씩 적용해본 기록입니다. 광고 자리 (AdSense 승인 후 교체) 핵심 요약 — 6가지 팁 한눈에 팁 한줄 요약 적용 방법 Auto mode 권한 프롬프트 자동 판단 Shift+Tab /fewer-permission-prompts 반복 허락 묻기 제거 /fewer-permission-prompts 입력 Recaps 긴 작업 후 요약 자동 제공 자동 (Opus 4.7 기본 탑재) Focus mode 중간 과정 숨기고 결과만 /focus 입력 Effort level 생각 깊이 직접 조절 /effort 입력 검증 수단 제공 AI가 스스로 결과를 확인하게 테스트/브라우저/Computer use 연결 1. Auto mode — 옆에서 지켜보지 마세요 "이 명령어 실행해도 될까요?" — Cla...

클로드 코드 왕초보 가이드 11편 — Git으로 작업 안전하게 저장하기 2026

Photo by carmen dominguez on Unsplash 클로드 코드 왕초보 가이드 — 11편 전체 목차 보기 Claude Code로 파일을 수정하다가 "아, 아까 그 버전이 더 나았는데" 싶은 적 있으신가요? Ctrl+Z를 연타해도 돌아가지 않는 그 순간. Git을 쓰면 무한 Ctrl+Z가 됩니다. 비개발자도 세 마디면 끝납니다. AI한테 파일을 고치라고 시키면, 파일이 순식간에 바뀝니다. 한 번이면 괜찮은데 두세 번 고치다 보면 "처음 버전이 나았다"는 생각이 듭니다. 문제는 그때 이미 처음 버전이 사라져 있다는 겁니다. 광고 자리 (AdSense 승인 후 교체) 왜 저장이 따로 필요한가 일반적인 문서 작업이라면 Ctrl+S 하나로 충분합니다. 하지만 Claude Code와 함께 작업하면 상황이 다릅니다. AI가 한 번에 여러 파일을 동시에 수정합니다 "이것도 고쳐줘"를 3번 반복하면 원본이 어땠는지 기억이 안 납니다 Ctrl+Z는 현재 열려 있는 파일 하나만 되돌립니다 "2시간 전 상태로 통째로 돌아가고 싶다"는 불가능합니다 Git은 이 문제를 해결합니다. 작업 폴더 전체를 특정 시점으로 되돌리는 타임머신입니다. Google Drive vs Git — 뭐가 다른가요 "Google Drive도 버전 기록이 있잖아요?"라고 생각하실 수 있습니다. 맞습니다. 하지만 성격이 다릅니다. 항목 Google Drive Git 저장 방식 자동 저장 (알아서 됨) 직접 저장 (내가 "저장해줘"라고 해야 됨) 저장 단위 ...

Google+Amazon 650억 달러가 Anthropic 한 곳에 몰린 이유 — AI 경쟁의 본질은 전력이다 2026

Photo by Mark Brennan on Unsplash Google이 Anthropic에 400억 달러(56조 원)를 투자합니다. 4일 전 Amazon 250억 달러에 이어, 일주일 만에 650억 달러가 한 회사로 몰렸습니다. 어제 Google이 Anthropic에 400억 달러 투자를 발표했습니다 . 100억 달러는 즉시 투입, 나머지 300억은 성과 마일스톤에 따라 추가됩니다. 4일 전엔 Amazon이 250억 달러 투자를 발표 했고요. 일주일 사이에 650억 달러(약 91조 원)가 Anthropic 한 곳에 몰렸습니다. 처음엔 숫자에 놀랐는데, 투자 구조를 자세히 보니까 더 놀랐습니다. 광고 자리 (AdSense 승인 후 교체) 돈만 준 게 아니다 — 전력을 줬다 투자 내역을 보면 현금만 들어간 게 아닙니다. Google은 Google Cloud를 통해 5GW(기가와트) 규모의 컴퓨팅 인프라를 5년간 제공합니다. Amazon도 마찬가지로 5GW 규모의 컴퓨팅 용량을 약속했고요. 5GW가 얼마나 큰 규모인지 감이 안 올 수 있는데요. 서울시 전체 평균 전력 소비가 약 10GW입니다. Google과 Amazon이 각각 서울시 절반 규모의 전력을 Anthropic한테 밀어주겠다는 겁니다. 왜 현금이 아니라 전력일까요? AI 모델을 학습시키고 운영하는 데 가장 부족한 자원이 더 이상 인재나 데이터가 아니기 때문입니다. 전력입니다. IEA가 올해 '전기의 시대'를 선언한 것 도 이런 맥락이었죠. 광고 자리 (AdSense 승인 후 교체) 경쟁사에 투자하는 이상한 구조? 재미있는 건 Google도 자체 AI 모델 Gemini를 만들고 있다는 겁니다. 경쟁사한테 56조 원을 넣는 게 말이 되나 싶잖아요. 근데 뒤집어 보면 논리가 있습니다. Google 입장에선 Anthropic이 Google Cloud를 쓰...