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

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

멜론 AI 인사이트 Melon AI Insight