Claude Code로 메신저봇 개발환경 구축 - AVD 연동부터 자동 배포까지

소개

안녕하세요! 초보맘들을 돕는 커뮤니티 리더, 지니 K입니다.

현재 1인 기업가로서 130명 규모의 이유식 중심 육아 커뮤니티를 운영하며, 이유식이 막막하고 두려운 엄마들을 위한 다양한 콘텐츠와 서비스를 제공하고 있습니다.

지난 카톡봇 스터디를 통해 커뮤니티 운영 리소스를 절감하고자 ‘잇다봇’을 만들었습니다. 이번 18기에는 잇다봇에 더 다양한 기능을 붙여 업그레이드하고자 합니다.

진행 방법

이번 기수에서는 Claude Code(클로드코드)를 활용해서 기존 카톡봇 제작 과정의 비효율성을 해소할 수 있었습니다.

해당 사례글에서는 클로드코드를 안로이드 스튜디오 에뮬레이터(AVD)와 연동하여 메신저봇 개발 및 배포 환경을 구축하는 과정을 공유합니다.

목표

Claude Code 설치 및 초기 설정
안드로이드 스튜디오 AVD와 연동
메신저봇 파일 자동 배포 시스템 구축

사용한 도구들

Node.js
Claude Code
Android Studio (AVD)
Cursor

진행 과정

0) Node.js 설치

원활한 클로드코드 설치를 위해 node.js 를 우선 설치

# nvm 다운로드 및 설치:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# Node.js 다운로드 및 설치:
nvm install 22

# Node.js 버전 확인:
node -v # "v22.19.0"가 출력되어야 합니다.
nvm current # "v22.19.0"가 출력되어야 합니다.

# Verify the Node.js version:
node -v # Should print "v22.19.0".

npm 버전 확인:
npm -v # 10.9.3가 출력되어야 합니다.

1) Claude Code 설치 및 초기 설정

터미널 창에서 npm 통해 클로드 코드 설치

# Claude Code 설치 
npm install -g @anthropic-ai/claude-code

# Claude Code 실행
claude

# 초기 설정
/init

2) 작업 폴더 생성 및 커서 환경 세팅

효과적인 작업을 위한 파일 구조 세팅 후, 커서에서 Project 폴더를 최상위 폴더로 열기

폴더 구조: Projects > Bots > PerBot > PerBot.js

3) Android Studio USB 디버깅

원인을 알 수 없는 이슈로 와이파이 무선 디버깅이 동작하지 않아, USB 디버깅을 통해 애뮬레이터 연결

4) 클로드 코드 AVD 연동

클로드코드에 아래와 같이 프롬프트 입력. (스터디장 현우님 강의자료 참고)

Adroid Studio AVD와 연결해 줘. 애뮬레이터는 SM-G986N으로 연결되어 있어. adb devices로 먼저 확인하고, /storage/emulated/0/msgbot/Bots/ 경로를 확인해 줘.

[클로드코드 작업 과정]

adb 명령어 사용을 위해 Android SDK 경로를 환경변수에 추가

# Android SDK 경로를 PATH에 추가
export PATH=$PATH:~/Library/Android/sdk/platform-tools 

# 연결된 디바이스 확인
adb devices

# 메신저봇 Bots 폴더 확인
adb shell "ls -la /storage/emulated/0/msgbot/Bots/"

# 로컬 파일을 AVD로 배포
adb push "/Users/jinny.k/Library/Mobile Documents/com~apple~CloudDocs/Msgbots/Projects/Bots/PerBot/PerBot.js" "/storage/emulated/0/msgbot/Bots/PerBot/"

# 배포된 파일 확인
adb shell "ls -la /storage/emulated/0/msgbot/Bots/PerBot/"

5) 메신저봇 코드 확인 및 테스트

이전에 생성한 PerBot 폴더에 PerBot.js 파일이 자동으로 푸시된 것을 확인

→ 컴파일 후 DEBUG ROOM에서 테스트 완료!

결과와 배운 점

카톡봇 제작 과정에 클로드 코드 도입으로 아래와 같은 효과를 얻을 수 있었습니다.

개발 시간 단축: 수동 복사 → 자동 배포로 90% 시간 절약
오류 감소: 파일 경로 실수 방지
테스트 효율성: 즉시 배포로 빠른 피드백 루프 구현

이번 주차에는 Claude Code와 Android Studio AVD의 연동을 통해 메신저봇 개발 환경을 크게 개선할 수 있었습니다. 특히 자동화된 코드 푸시/배포 프로세스는 개발 생산성을 대폭 향상시켰습니다.

향후 계획

향상된 개발 환경에 힘입어 앞으로는 커뮤니티에서 생성되는 데이터를 Supabase에 저장 및 활용하여 기존 카톡봇을 한층 발전시켜 나갈 계획입니다.

환영 인사봇 (리뉴얼)
퍼플렉시티 연동 검색봇 (리뉴얼)
출석 및 대화참여도 분석봇 - 활성도체크 기간 한정
추천 아이템 링크 정보 요약봇
하루 핵심 대화 요약봇

등등...

20개의 주제를 확인해보세요! AI 스터디 슈퍼 얼리버드 시작🕊️