소개
이번 스터디에서는 개발 이외의 영역에서 Claude Code를 어떻게 활용할 수 있는지 실험해보았습니다. Codex나 Gemini CLI는 얕게 경험한 적이 있었지만, Claude Code는 이번이 처음 설치였습니다. 스터디의 주제 자체가 "개발 외의 활용"이었기에, CLI 환경에서 Claude Code를 개인 비서처럼 활용하는 사례를 만들어보고자 했습니다 🧑💻.
특히 Claude Code의 Sub Agent 기능을 적극 활용하여, 메인 에이전트는 오케스트레이션(프롬프트 체이닝)만 담당하고, 실제 기능은 각 Sub Agent가 수행하는 구조를 설계했습니다.
현재 구현된 개인 비서는 할일/일정 관리 기능을 중심으로 동작하며, 앞으로 점차 기능을 확장할 계획입니다.
진행 방법
🧠 설계
메인 에이전트
역할: Sub Agent들을 조율하고 사용자 요청을 적절히 분배하는 오케스트레이션 레이어
서브 에이전트 구성
메모리 에이전트
개인 비서로서의 지시사항을 최신 상태로 업데이트
./CLAUDE.md파일을 유동적으로 수정해, 장기 기억 및 MCP/Sub Agent 변경사항 반영
형상관리 에이전트
Git/GitHub MCP를 통해 버저닝 및 롤백이 가능하도록 형상 관리 수행
변경 사항 발생 시 자동 커밋/푸시
할일/일정 관리 에이전트
사용자의 요 청을 받아 할일(Task)은 Linear에, 일정(Schedule)은 Google Calendar에 기록
Linear: 기간 내 수행할 작업 관리
Calendar: 특정 이벤트나 고정 시간 일정 관리
🔧 MCP 연결 상황
[✅] GitHub MCP: https://github.com/github/github-mcp-server
[✅] Linear MCP: https://linear.app/docs/mcp
[❌] Google Calendar MCP: 인증 실패 (Dispatch URL 문제 → 해결 방법 불명). Smithery를 통한 연결을 시도했으나 인증 오류 발생.
📂 에이전트별 설정과 실행
메모리 에이전트
프롬프트 예시:
현재 변경 사항을 확인하고 CLAUDE.md를 작성해. claude-md-manager agent를 이용해.
결과: MCP 및 Sub Agent 변경사항이
CLAUDE.md에 잘 기록됨 ✅
형상관리 에이전트
정책 설정:
### Branch 정책
* main branch에서는 직접 작업하지 않는다.
* 작업은 별도 branch에서 수행 후 merge.
### Commit 정 책
* commit 메시지는 상세하게.
* 여러 주제는 commit 분리.
### Push 정책
* commit 시 GitHub MCP로 push까지 자동 진행.
* push 실패 시 pull → merge → 재시도.
실행 예시:
저장소는 https://github.com/tot0rokr/PersonalAssistant.git 이거야. 장기기억해. 그리고 변경 사항에 대해서 커밋 푸시 해
결과: commit 및 push 정상 완료 ✅
할일/일정 관리 에이전트
프롬프트 설정:
# 할일 및 일정 관리
## 기본 원칙
* 사용자 요청 기반으로만 추가/변경/삭제
* 장기 일정 조정은 반드시 사용자 확인 후 반영
## 할일(Task)
* Linear MCP 활용
* due date 필수, priority는 Low 기본값
* 라벨: Home, Work, Side Project 등 분류
## 일정(Schedule)
* Google Calendar MCP 활용 (연동 실패 상태)
* 카테고리: Leisure, Social, Travel, Event
테스트 요청:
오늘 저녁 8시 전에 크몽 답장 해야한다고 할일 생성해
결과: Linear MCP에 Task 등록 성공 ✅ / Calendar MCP는 실패 ❌
결과와 배운 점
✅ 성과
Sub Agent를 활용해 메인은 오케스트레이션, 서브는 전문 기능 수행하는 구조 실현
GitHub, Linear MCP 연동 성공 → 개인 비서의 기본 기능 확보
CLI 환경에서 충분히 개인 비서 활용 가능성 확인
⚠ 문제점
토큰 과소비 이슈
클로드를 잘 안써서 API로 연결했는데 순식간에 5$ 소모함 ㅎㄷㄷ
/context로 확인 시, MCP만 50k 토큰 소모 (전체의 25%)대화 없이 새 세션 시작 시에도 기본 33k 토큰 사용
GitHub MCP가 특히 토큰을 과도하게 사용
Google Calendar MCP 인증 실패
Dispatch URL 문제로 인해 연동 불가
🔧 앞으로의 계획
과도한 토큰 소모와 불필요한 컨텍스트 낭비를 막기 위해 메인 에이전트는 MCP를 전혀 사용하지 않고, 오직 Sub Agent만 MCP를 활용하게 하고 싶음 → 현재 구조상 불가능해 보임
Calendar MCP 대체 방안 (Smithery 재검증 또는 다른 연동 방법) 시도 예정
도움 받은 글
🎯 마무리 메시지
이번 시도로 "Claude Code도 충분히 개인 비서 역할을 할 수 있다"는 가능성을 확인했습니다. 토큰 관리와 MCP 인증 문제가 남아있지만, Sub Agent 기반 구조 덕분에 앞으로 다양한 기능을 점진적으로 추가할 수 있을 것 같습니다 🚀.
다음 단계에서는 더 정교한 자동화 기능을 붙여 진짜 비서 같은 Claude Code로 발전시켜보겠습니다 🙌.
