아빠너구리의 1인 기업 이야기

Claude Code Agent Teams 완전 정복

아빠너구리 — Thu, 12 Feb 2026 18:00:16 +0900

Claude Code Agent Teams 완전 정복

한 줄 요약: Claude Code의 Agent Teams 기능을 활용하면, 혼자서도 여러 AI 에이전트를 동시에 지휘하여 복잡한 프로젝트를 병렬로 처리할 수 있습니다. 이 글에서는 설치부터 실전 활용까지 단계별로 안내합니다.

1. Claude Code란?

Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트입니다. 채팅 UI가 아닌 터미널에서 직접 동작하며, 여러분의 코드베이스를 이해하고 파일을 편집하고, 터미널 명령어를 실행하고, Git 워크플로우까지 처리해 줍니다.

왜 Claude Code인가?

일반적인 AI 코딩 도구와의 차이를 정리하면 이렇습니다.

구분웹 기반 AI (ChatGPT, Claude.ai 등)IDE 확장 (Copilot, Cursor 등)Claude Code

동작 환경	브라우저	에디터 내부	터미널
파일 직접 수정	❌	⚠️ 제한적	✅ 직접 수정
터미널 명령 실행	❌	⚠️ 제한적	✅ 직접 실행
프로젝트 전체 이해	❌ (붙여넣기 필요)	부분적	✅ 자동 분석
멀티 에이전트	❌	❌	✅ Agent Teams

핵심은 “에이전트” 라는 점입니다. 단순히 코드를 추천하는 게 아니라, 목표를 이해하고 → 계획을 세우고 → 직접 실행하고 → 결과를 검증하는 전체 사이클을 자율적으로 수행합니다.

Claude Code 실행화면

2. Agent Teams란?

기본 개념

Agent Teams는 여러 개의 Claude Code 인스턴스가 하나의 팀으로 협업하는 멀티 에이전트 아키텍처입니다. 2026년 2월에 리서치 프리뷰로 공개되었습니다.

구조는 간단합니다:

Team Lead(리드): 메인 Claude Code 세션. 팀을 만들고, 작업을 배분하고, 결과를 종합합니다.
Teammates(팀원): 각각 독립된 Claude Code 인스턴스. 자기만의 컨텍스트 윈도우에서 작업합니다.
Task List(태스크 리스트): 공유 작업 목록. 의존성을 자동 추적하고, 선행 작업이 끝나면 자동으로 다음 작업이 풀립니다.
Mailbox(메일박스): 팀원끼리 직접 메시지를 주고받는 소통 시스템입니다.

왜 멀티 에이전트인가?

LLM에는 잘 알려진 약점이 있습니다. 컨텍스트가 길어질수록 집중력이 떨어진다는 것입니다. 하나의 에이전트에게 프론트엔드, 백엔드, 테스트, 배포까지 시키면 후반부로 갈수록 초반의 맥락을 잊어버립니다.

Agent Teams는 이 문제를 구조적으로 해결합니다. 각 팀원에게 좁은 범위와 깨끗한 컨텍스트를 부여하여 도메인별 추론 품질을 극대화합니다. 인간 팀이 분업하는 것과 같은 원리입니다.

5가지 핵심 장점

< 장점설명 >

1	병렬 처리	수일 걸릴 작업을 팀원들이 동시에 수행하여 수시간으로 압축
2	독립 컨텍스트	각 팀원이 자기 도메인에만 집중 → 품질 극대화
3	적대적 토론	복수 에이전트가 서로 가설을 반박하며 정확한 결론에 수렴
4	직접 소통	리드를 거치지 않고 팀원끼리 직접 메시지 교환 가능
5	자연어 구성	YAML/설정 파일 없이 자연어로 팀 구조를 설명하면 끝

3. 단일 세션, Subagent와의 차별점

Claude Code에는 세 가지 작업 방식이 있습니다. 각각 언제 쓰는지 명확히 구분하는 것이 중요합니다.

상세 비교표

비교 항목단일 세션SubagentAgent Teams

에이전트 수	1개	1개 + 보조 N개	1개(리드) + 팀원 N개
컨텍스트	하나의 윈도우	각자 윈도우, 결과만 반환	각자 윈도우, 완전히 독립
소통 방식	없음	메인에게만 보고 (단방향)	팀원 간 직접 교환 (양방향)
조율 방식	수동	메인이 모든 것 관리	공유 태스크 리스트로 자기 조율
팀원 간 토론	❌	❌	✅ 가능
사용자 직접 소통	✅	❌ 메인 경유만	✅ 개별 팀원과 직접 대화
태스크 의존성	수동	수동	자동 추적 + 자동 언블록
토큰 비용	1×	~1.5×	~5× (팀원당)
세션 재개	✅	✅	❌ /resume 미지원
적합한 작업	단순 작업	집중된 단일 작업	복잡한 병렬 탐색 + 협업

한눈에 보는 선택 가이드

작업이 들어왔을 때 → 이 질문을 던져보세요:

Q1. 파일 1~2개 수정하는 단순 작업인가?
    → Yes: 단일 세션

Q2. "이거 조사해서 결과만 알려줘"인가?
    → Yes: Subagent

Q3. 여러 관점에서 동시에 탐색/토론이 필요한가?
    → Yes: Agent Teams

Q4. 프론트/백엔드/테스트를 동시에 병렬 개발해야 하는가?
    → Yes: Agent Teams

핵심 원칙: Agent Teams는 토큰 비용이 ~5배입니다. 병렬 탐색이 진정한 가치를 제공하는 복잡한 작업에만 사용하세요. 단순 작업에 팀을 만드는 것은 낭비입니다.

4. 실제 동작을 위한 준비물

4-1. 사전 요구사항

시작하기 전에 필요한 것들입니다:

항목요구사항

OS	macOS, Linux, WSL (Windows)
Claude 구독	Claude Pro 또는 Max 플랜 (또는 Anthropic API 콘솔)
터미널	기본 터미널, iTerm2, Warp 등 (VS Code 내장 터미널은 split-pane 미지원)
tmux	선택사항 — split-pane 모드 사용 시 필요

4-2. Claude Code 설치

2026년 2월 기준, Anthropic은 네이티브 설치를 권장합니다. npm 설치 방식은 레거시로 분류됩니다.

방법 A: 네이티브 설치 (권장)

# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

설치 후 확인:

claude --version

방법 B: npm 설치 (레거시)

Node.js 18 이상이 필요합니다.

npm install -g @anthropic-ai/claude-code

⚠️ sudo npm install -g는 절대 사용하지 마세요. 권한 문제가 발생합니다.

설치 검증

claude doctor

claude doctor를 실행하면 설치 상태, 인증, 환경 설정을 자동으로 진단해 줍니다.

인증 설정

처음 실행 시 OAuth 인증 화면이 나타납니다:

# 프로젝트 디렉토리로 이동 후
cd ~/my-project
claude

Claude Pro/Max 계정으로 로그인하면 됩니다. API 키를 사용하는 경우:

export ANTHROPIC_API_KEY="sk-ant-xxxxx"

4-3. Agent Teams 활성화

Agent Teams는 실험적 기능이므로 기본값이 비활성화입니다. 아래 세 가지 방법 중 하나를 선택하세요.

방법 A: settings.json (권장 — 영구 설정)

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

방법 B: 쉘 환경변수 (영구)

# ~/.zshrc 또는 ~/.bashrc에 추가
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

방법 C: 일회성 실행

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude

활성화 확인은 간단합니다. Claude Code를 실행한 뒤 “에이전트 팀을 만들어줘”라고 요청했을 때 팀이 생성되면 성공입니다.

4-4. tmux 설치 (선택사항 — split-pane 모드)

tmux는 터미널 멀티플렉서로, 하나의 터미널 창을 여러 패널로 분할할 수 있게 해줍니다. Agent Teams의 split-pane 모드를 사용하면 각 팀원의 작업 화면을 동시에 볼 수 있어 모니터링이 훨씬 편합니다.

tmux 없이도 Agent Teams는 사용 가능합니다. 기본 in-process 모드는 어떤 터미널에서든 동작합니다. tmux는 “더 편하게 보기 위한” 선택사항입니다.

tmux 설치

# macOS
brew install tmux

# Ubuntu / Debian
sudo apt-get install tmux

# CentOS / RHEL
sudo yum install tmux

tmux 모드 설정

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "teammateMode": "tmux"
}

teammateMode 값동작

"auto" (기본값)	tmux 세션 안이면 split-pane, 아니면 in-process
"tmux"	split-pane 강제 활성화 (tmux 또는 iTerm2 자동 감지)
"in-process"	모든 팀원이 메인 터미널 안에서 동작

tmux로 Agent Teams 시작하기

# 1. tmux 세션 시작
tmux

# 2. Claude Code 실행
cd ~/my-project
claude

# 3. 팀 생성 요청 (자연어로)
# "에이전트 팀을 만들어서 이 프로젝트를 분석해줘"

split-pane 모드 주의사항

split-pane 모드는 아래 환경에서는 동작하지 않습니다:

❌ VS Code 내장 터미널
❌ Windows Terminal
❌ Ghostty

위 환경에서는 --teammate-mode in-process를 사용하세요.

4-5. 디스플레이 모드 비교

모드장점단점추천 상황

in-process (기본)	어떤 터미널에서든 동작	팀원 전환이 수동 (Shift+↑↓)	처음 시작할 때, VS Code 사용 시
split-pane (tmux)	모든 팀원 동시 확인 가능	tmux/iTerm2 필요	팀원 3명 이상, 모니터링 중요할 때

5. 실전 활용 예시 — 프롬프트로 동작시키기

이제 실제로 Agent Teams를 사용해 봅시다. 아래는 바로 복사해서 사용할 수 있는 프롬프트 예시들입니다.

[ 예시 1 ] : 웹앱 병렬 개발

가장 대표적인 활용 사례입니다. 프론트엔드, 백엔드, 테스트를 각각 다른 팀원이 동시에 작업합니다.

할 일 관리 웹앱을 만들어줘. 에이전트 팀을 구성해서 병렬로 개발해줘.

- 팀원 1: React 프론트엔드 (컴포넌트, 상태 관리, UI)
- 팀원 2: Express 백엔드 (REST API, DB 연결, 인증)
- 팀원 3: 테스트 코드 (E2E 테스트, API 통합 테스트)

각 팀원은 서로 다른 폴더에서 작업하고,
API 인터페이스가 확정되면 팀원들끼리 공유해줘.

포인트: “서로 다른 폴더에서 작업”이라고 명시하는 것이 중요합니다. 같은 파일을 여러 팀원이 수정하면 덮어쓰기가 발생합니다.

[ 예시 2 ] : 경쟁 가설 디버깅

Agent Teams의 가장 강력한 활용처입니다. 단일 에이전트는 첫 번째로 그럴듯한 원인을 찾으면 거기에 고착되지만, 복수 에이전트는 서로 반박하며 정확한 원인을 찾아냅니다.

프로덕션 API가 간헐적으로 500 에러를 반환하고 있어.
에이전트 팀을 만들어서 경쟁 가설로 디버깅해줘.

- 팀원 1: DB 커넥션 풀 고갈 가설 조사
- 팀원 2: 캐싱 레이어 레이스 컨디션 가설 조사
- 팀원 3: 요청 핸들러 메모리 누수 가설 조사

각 팀원은 로그 파일과 코드를 분석한 뒤, 
서로 증거를 공유하고 어떤 가설이 맞는지 토론해줘.
가장 유력한 원인이 확인되면 수정 방안까지 제시해줘.

[ 예시 3 ] : 다관점 코드 리뷰

PR #42에 대한 코드 리뷰를 에이전트 팀으로 진행해줘.

- 팀원 1 (보안 리뷰어): 인증, 입력 검증, XSS/SQL Injection 취약점 점검
- 팀원 2 (성능 리뷰어): 쿼리 최적화, N+1 문제, 메모리 사용량 분석
- 팀원 3 (테스트 리뷰어): 테스트 커버리지, 엣지 케이스, 통합 테스트 확인

각자 리뷰 결과를 공유하고, 최종 리뷰 리포트를 하나로 종합해줘.

[ 예시 4 ] : 설계 탐색 (코드 작성 전 리서치)

코드를 작성하기 전 여러 관점에서 설계를 탐색할 때 유용합니다.

개발자용 TODO 코멘트 추적 CLI 도구를 설계하려고 해.
에이전트 팀으로 다양한 관점에서 탐색해줘.

- 팀원 1 (UX 전문가): 사용자 경험, CLI 인터페이스 설계, 출력 포맷
- 팀원 2 (아키텍트): 기술 아키텍처, 파서 설계, 성능 최적화
- 팀원 3 (악마의 대변인): 각 제안의 약점 지적, 엣지 케이스, 경쟁 도구와 비교

탐색이 끝나면 최적 설계안을 하나로 종합해줘.

[ 예시 5 ] : 코드베이스 분석 리포트

이 프로젝트의 코드베이스를 분석하는 에이전트 팀을 만들어줘.

- 팀원 1: 백엔드 분석 (API 구조, DB 스키마, 비즈니스 로직)
- 팀원 2: 프론트엔드 분석 (컴포넌트 구조, 상태 관리, 라우팅)
- 팀원 3: 인프라 분석 (의존성, 빌드 설정, 배포 파이프라인)

분석 결과를 docs/analysis.md 파일 하나에 종합해줘.

팁: 여러 팀원의 결과를 하나의 파일에 모아야 할 때는 마지막에 명시적으로 지정하면 리드가 종합해 줍니다.

팀 운영 시 유용한 키보드 단축키

단축키기능모드

Shift + ↑/↓	팀원 선택/전환	in-process
Enter	선택한 팀원 세션 보기	in-process
Escape	팀원 작업 중단	in-process
Ctrl + T	태스크 리스트 토글	in-process
Shift + Tab	리드를 위임 모드로 전환 (코드 작성 금지)	공통

팀 정리 및 추가 작업

작업이 끝나면 리드가 자동으로 팀을 정리합니다. 만약 추가 작업이 필요하면:

단순 추가 작업: 같은 세션에서 단일 에이전트로 처리
복잡한 추가 작업: “새로운 팀을 만들어줘”라고 요청하여 새 팀 구성

⚠️ /resume과 /rewind로는 이전 팀을 복원할 수 없습니다. 해산된 팀은 새로 만들어야 합니다.

작업 완료 후, 자동으로 팀을 정리한 모습

마무리: Best Practice Checklist

Agent Teams를 효과적으로 사용하기 위한 실전 팁을 정리합니다.

이렇게 하세요 ✅

읽기 전용 작업(코드 리뷰, 리서치)부터 시작하세요. 조율 패턴을 익힌 뒤 병렬 구현으로 확장하세요.
팀원당 5~6개 태스크를 배분하세요. 너무 적으면 조율 오버헤드가 크고, 너무 많으면 체크인 없이 방치됩니다.
각 팀원이 서로 다른 파일을 소유하도록 분리하세요. 같은 파일을 두 팀원이 수정하면 덮어쓰기가 발생합니다.
스폰 프롬프트에 충분한 컨텍스트를 포함하세요. 팀원은 리드의 대화 기록을 상속받지 않습니다.
주기적으로 체크인하세요. 방치 시간이 길어질수록 낭비가 증가합니다.

이것은 피하세요 ❌

단순 버그 수정에 Agent Teams 사용 → 단일 세션으로 충분
같은 파일을 여러 팀원이 동시 수정 → 파일 소유권 분리 필수
순차적으로 처리해야 하는 작업 → 병렬화 이점 없음
팀을 만들고 방치 → 정기 모니터링 필수

비용 참고

Agent Teams는 팀원당 약 5배의 토큰을 소비합니다. Claude Max 구독을 사용하면 별도 API 비용 없이 사용할 수 있지만, 사용량 제한이 있으므로 복잡한 작업에만 선별적으로 활용하는 것을 추천합니다.

Agent Teams 공식 문서: code.claude.com/docs/en/agent-teams

이 기능은 현재 리서치 프리뷰 상태이며, 세션 재개, 태스크 조율, 종료 동작 등에 알려진 제한사항이 있습니다. Anthropic이 지속적으로 개선하고 있으니, 공식 문서를 수시로 확인하세요.

나만의 평생 무료 ChatGPT 만들기 #1

아빠너구리 — Mon, 9 Feb 2026 18:00:39 +0900

나만의 평생 무료 ChatGPT 만들기 #1

월 2만 8천원이 아까워서 시작한 삽질이, 결국 앱 하나를 만들어버렸습니다.

발단: 결제 알림이 울렸다

어느 날 아침, 카드 결제 문자가 왔습니다.

"ChatGPT Plus $20.00 결재 완료

매달 오는 건데, 그날따라 유독 거슬렸어요. 계산기를 두드려봤습니다.

월 20달러 = 약 28,000원. 1년이면 336,000원. 3년이면 1,008,000원.

백만 원이요. ChatGPT한테 백만 원.

물론 그만한 가치가 있죠. 저도 매일 쓰니까요. 근데 개발자 25년 차의 직업병이 발동했습니다.

"이거... 내가 만들면 안 되나?"

이 한 마디가 화근이었습니다.

1️⃣ 1화: 로컬 AI라는 게 가능해?

먼저, 기본 개념부터 짚고 갈게요.

우리가 쓰는 ChatGPT는 이런 구조입니다.

내 컴퓨터 → 인터넷 → OpenAI 서버 (미국) → AI가 답변 생성 → 인터넷 → 내 화면

내가 질문을 치면, 그게 바다 건너 미국 서버까지 갔다가 돌아오는 거예요.

그런데 "로컬 AI"는 이 구조를 완전히 바꿉니다.

내 컴퓨터 안에서 전부 끝!

AI 두뇌(모델이라고 부릅니다)를 내 맥북에 직접 설치하고, 인터넷 없이 대화하는 겁니다. 2025년 현재, 무료로 공개된 AI 모델들이 엄청나게 좋아졌거든요.

2️⃣ 2화: 왜 굳이 로컬에서?

ChatGPT 잘 되는데 왜 굳이 내 컴퓨터에서 돌리냐. 이유가 세 가지 있습니다.

첫 번째, 돈

ChatGPT Plus가 월 2만 8천원. 로컬 AI는 0원입니다. 전기세 빼면. AI 모델도 무료, 실행 프로그램도 무료. 맥만 있으면 됩니다.

두 번째, 프라이버시

ChatGPT에 회사 기밀 문서 넣어본 적 있으세요? 삼성이 ChatGPT 사용을 금지한 사건, 기억나시나요? 사내 소스코드가 OpenAI 서버에 전송됐던 겁니다.

로컬 AI는 이 걱정이 제로입니다. 데이터가 내 컴퓨터 밖으로 한 발자국도 안 나갑니다. 와이파이 꺼놓고 써도 됩니다.

세 번째, 자유

ChatGPT가 가끔 이러죠.

"죄송합니다, 그 요청은 처리할 수 없습니다."

로컬 AI에는 이런 거 없습니다. 내 모델이니까, 내가 원하는 대로 쓸 수 있어요.

정리하면 무료 + 프라이버시 + 자유. 이 세 박자가 맞습니다.

3️⃣ 3화: 24GB 맥으로 뭘 할 수 있나

AI 모델은 크기가 다양합니다. 작은 것부터 거대한 것까지. 쉽게 비유하면 이렇습니다.

모델 크기	비유	필요 메모리	판정
GPT-4 클래스	대형 트레일러	40GB+	❌ 주차장 부족
14B 모델	중형 SUV	9.5GB	✅ 딱 맞음!
4B 모델	경차	2.8GB	✅ 빠르지만 힘 부족

제 맥은 24GB 메모리입니다. 이 중에서 AI가 실제로 쓸 수 있는 건 약 10GB 정도예요. 10GB짜리 주차장에 세울 수 있는 차를 골라야 합니다.

최종 선택은 중국 알리바바가 만든 Qwen3 14B입니다.

한국어가 뛰어납니다. 무료 AI 모델 중에서 한국어 품질이 최상위예요.

속도가 빠릅니다. 초당 40~60 글자를 생성하는데, 사람이 읽는 속도보다 훨씬 빠릅니다.

생각 모드가 있습니다. 간단한 질문에는 바로 답하고, 어려운 질문에는 깊이 생각합니다. ChatGPT의 "딥 쒉킹" 기능과 비슷한 게 공짜로 들어있는 셀이에요.

체감 성능은 ChatGPT 3.5와 4 사이 어딘가. 무엇보다 무료잖아요. 무료인데 이 정도면 대단한 거 아닌가요?

4️⃣ 4화: 실행 엔진 — Ollama를 해고하다

AI 모델을 골랐으면, 이걸 실행할 프로그램이 필요합니다.

AI 모델 = 요리 레시피

실행 엔진 = 주방 + 셰프

레시피만 있으면 뭐합니까. 요리해줄 주방이 있어야죠.

처음에는 Ollama라는 프로그램을 쓰려고 했습니다. 로컬 AI 실행기로는 가장 유명한 도구예요.

근데 문제가 있었습니다.

문제 1: 설치가 복잡하다

"먼저 Homebrew를 설치하시고, 그 다음 Ollama를 설치하시고, 터미널 여셔서 이 명령어 치시고, 서버 실행하시고, 그 다음에 앱을 실행하세요."

다섯 단계요. 세 번째춤에서 대부분 포기합니다. "그냥 ChatGPT 쓸게요."

문제 2: 비효율적인 구조

Ollama를 쓰면, 내 앱과 AI 모델 사이에 중간 단계가 너무 많습니다.

같은 집에 사는 가족한테 할 말이 있는데, 카카오톡으로 메시지를 보내는 격.

거실 가서 직접 말하면 되잖아요.

그러다 발견한 게 mlx-lm이라는 도구입니다. Apple이 자기 칩(M1, M2, M3, M4, M5)을 위해 직접 만든 AI 실행 엔진이에요.

	Ollama	mlx-lm (Apple 제작)
속도	보통	50~100% 더 빠름
설치	5단계	1단계
구조	중간 서버 필요	직접 연결

Ollama는 원래 다른 회사 GPU를 위해 만들어진 엔진을 Apple 칩에 맞게 개조한 거예요. 양복을 입고 등산하는 느낌이랄까요.

반면 mlx-lm은 Apple이 자기 칩 전용으로 처음부터 만든 겁니다. 나이키 선수가 나이키 신발 신고 뛰는 거랑 같아요. 당연히 빠르죠.

결론: Ollama 해고. mlx-lm 채용.
* mlx-lm : Apple이 자기 맥 침(M1 ~ M5)전용으로 만든 AI 모델 실행 도구 입니다.

5️⃣ 5화: 화면 만들기 — JavaScript도 해고하다

AI 엔진까지 정했으니, 이제 화면을 만들 차례입니다. ChatGPT처럼 예쁜 채팅 화면이 있어야 하니까요.

처음에는 웹 기술로 화면을 만들려고 했습니다. 내 앱 안에 미니 Safari를 집어넣은 거예요.

작동은 합니다. 근데 뭔가 이상했어요.

"맥 전용 앱인데... 왜 안에 웹브라우저가 들어있지?"

이건 편의점 가는데 버스를 타는 격입니다. 걸어가면 3분인데.

AI가 답변할 때, 글자가 하나씩 타이핑되듯 나오잖아요? 그 글자 하나하나를 AI 엔진에서 화면으로 전달해야 하는데, 웹 브라우저를 끼고 있으니 6단계를 거쳐야 했습니다.

옆 사람한테 할 말이 있는데, 편지 써서 우체국에 맡기고 우체부가 배달하는 방식.

반면 PySide6라는 도구를 쓰면, 웹 브라우저 없이 맥 기본 화면으로 직접 보여줍니다.

옆 사람한테 그냥 말하는 방식.

6단계가 2단계로 줄었습니다.

	웹 방식	네이티브 방식 (PySide6)
앱 메모리	150-200MB	50-80MB (3분의 1)
앱 시작	1-2초	0.3-0.5초 (3배 빠름)
글자 전달	2-5ms	0.1ms 미만 (20배)
다크 모드	직접 만들어야 함	맥이 자동으로 해줌
프로그래밍 언어	2개 필요	1개로 충분

결론 : JavaScript도 해고. 프로그래밍 언어 Python 하나로 통일

6️⃣ 6화: 최종 아키텍처 — 삽질의 결정체

세 번의 큰 방향 전환을 거쳤습니다.

단계	설계	문제 발견
1차	Ollama + 웹 방식 + JavaScript	"너무 무겁다"
2차	mlx-lm + 웹 방식 + JavaScript	"웹 브라우저가 왜?"
3차 (최종)	mlx-lm + 네이티브 화면 — Python 하나로!	"이거다!"

매번 뭔가를 하나씩 빼는 과정이었습니다. Ollama를 빼고, 웹 브라우저를 빼고, JavaScript를 빼고.

최종 구조를 쉽게 설명하면 이렇습니다.

사용자 ↔ 맥 네이티브 화면 ↔ AI 엔진 ↔ AI 모델 (Qwen3 14B)

전부 내 맥 안에서, 하나의 앱 안에서, 하나의 프로그래밍 언어로.

인터넷 서버? 없습니다. 웹 브라우저? 없습니다. 외부 프로그램? 없습니다. 인터넷 연결? 필요 없습니다.

"좋은 설계는 더 이상 뺄게 없을 때 완성된다." - 생텍쥐페리

7️⃣ 7화: 메모리 가계부

M5 맥 24GB에서 이 앱을 실행하면 메모리가 이렇게 쓰입니다.

항목	사용량	비유
macOS 운영체제	4GB	월세 (어쫩 수 없음)
LocalGPT 앱	0.08GB	관리비 (아주 저렴)
AI 모델 (Qwen3 14B)	9.5GB	가장 큰 지출
대화 기억 공간	2-4GB	대화가 길어질수록 증가
여유	6-8GB	저축 ✅

처음 설계에서는 앱 자체가 200MB를 먹었는데, 최종 설계에서는 80MB로 줄었어요. 웹 브라우저 하나 빼냈을 뿐인데 120MB를 아꼈 겁니다.

120MB가 별것 아닌 것 같지만, 로컬 AI에서 메모리는 금입니다. 그만큼 AI가 더 긴 대화를 기억할 수 있거든요.

8️⃣ 에필로그: 빼기의 철학

돌이켜보면, 이 프로젝트는 빼기의 연속이었습니다.

단계	뺀 것	얻은 것
1차 → 2차	Ollama (외부 프로그램)	속도 50-100% 향상, 설치 간소화
2차 → 3차	JavaScript + 웹 브라우저	메모리 3분의 1, 속도 3배

기능을 추가해서 좋아진 게 아니라, 제거해서 좋아졌습니다.

처음에는 "이것저것 다 쓰면 좋겠지"라고 생각했어요. 유명한 도구, 익숙한 기술, 검증된 방법. 근데 하나씩 빼보니, 빼는 게 오히려 성능도 좋아지고 구조도 깔끔해졌습니다.

이건 소프트웨어만의 이야기가 아닌 것 같아요.

옷장 정리할 때도, 새 옷을 사는 것보다 안 입는 옷을 버리는 게 더 효과적이잖아요. 사업도 마찬가지고, 인생도 마찬가지인 것 같습니다.

더하는 것보다 빼는게 어렵고, 빼는게 더 큰 변화를 만든다.

최종 성적표

항목	ChatGPT Plus	LocalGPT (내가 만든 것)
월 비용	28,000원	0원 ✅
인터넷 필요	필수	필요 없음 ✅
데이터 유출 위험	있음 (서버 전송)	없음 (내 맥 안에서 끝) ✅
성능	GPT-4 최상급	GPT-3.5~4 사이
속도	서버 상황에 따라 다름	항상 일정 (초당 40-60 글자) ✅
오프라인 사용	불가	가능 (비행기에서도 OK) ✅

성능은 ChatGPT에 못 미칩니다. 솔직하게 말하면요.

하지만 무료이고, 프라이버시가 보장되고, 오프라인에서도 되고, 내가 완전히 통제할 수 있는 AI가 있다는 건 전혀 다른 가치입니다.

그리고 오픈소스 모델은 계속 발전하고 있어요. 1년 전에는 상상도 못 했던 수준이 지금 무료로 풀려 있거든요. 내년에는 더 좋아질 겁니다.

* 다음 편 예고

이번 글에서는 왜, 무엇을 만들었는지를 공유했습니다.
다음 편에서는 어떻게 만들었는지, 실제 개발 과정을 다룰 예정이에요. AI한테 설계 문서를 통째로 주고 "만들어"라고 하면 어떻게 되는지.
AI가 AI를 만드는 시대의 현장을 공유해 드리겠습니다.

내 목소리로 세상을 읽어주는 앱 만들기 #2

아빠너구리 — Tue, 3 Feb 2026 10:00:28 +0900

AI한테 기능 추천 받았다가 "그거 안 돼요"라는 답변을 듣기까지의 여정

어느 개발자와 AI의 솔직한 대화록

기획부터 현실 직면까지, 감정의 롤러코스터를 함께 타봅시다.

1. 기능 고도화 구상

"앱 좀 분석해봐"

지난 이야기에서 VoiceClone Pro — Qwen3-TTS AI 모델을 써서 목소리를 복제하고, 텍스트를 음성으로 바꿔주는 macOS 데스크톱 앱을 만들었다.

https://sunnydevdays.tistory.com/11

VoiceClone Pro v1.0

앱은 완성되어 있었다. 잘 돌아갔다. 하지만 개발자의 본능이 속삭였다.

"이거... 뭔가 더 붙이면 좋겠는데."

그래서 AI에게 물었다.

"이 앱 분석해서 Best 3 기능 추천해줘."

AI는 성실하게 앱의 코드를 20개 넘는 파일을 훑으며 분석했다. 꼼꼼하게 파악하면서도 칭찬은 안 했다. 오히려 그래서 신뢰가 갔다.

▲ AI 가 20 개 넘는 파일을 꼼꼼하게 분석했다

Best 3를 받다

AI가 자신 있게 내놓은 추천 목록:

순위	기능	한 줄 요약
1	음성 스타일 컨트롤	같은 목소리로 기쁨, 슬픔, 분노를 표현!
2	장문 오디오북 생성기	소설 한 권을 통째로 음성으로!
3	다화자 대화 시뮬레이션	영희와 철수가 번갈아 대화하는 드라마를!

솔직히 감동했다. 특히 1번. 감정 조절이 되는 음성 복제라니. AI가 그려준 미래는 아름다웠다.

나는 흥분했다. "UI도 보여줘!"라고 말했다.

▲ 2026 년에 ASCII 아트라니 ! Figma 구독료 절약 !

현실의 벽

흥분이 가라앉고 나서 냉정한 질문을 던졌다.

"추천한 기능이 기술적으로 진짜 가능한 거 맞아?"

이 질문이 판도를 바꿨다. AI는 웹 검색을 하고, 모델 문서를 뒤지고, 기술 보고서까지 읽었다. 그리고 돌아왔다.

AI가 내놓은 결과:

Base 모델 → 음성 복제 O, 감정 제어 X
CustomVoice 모델 → 음성 복제 X, 감정 제어 O
VoiceDesign 모델 → 음성 복제 X, 감정 제어 O

우리가 쓰는 건 Base 모델이다. 음성 복제는 되는데 감정 제어가 안 된다고?

"음성 복제 + 감정 제어를 동시에 지원하는 모델은 없습니다."

Best 3의 1번 기능이 통째로 날아갔다.

▲ 부정 → 분노 → 타협 → 우울 → 수용

2. 설계

✔ 최종 기능 결정

1번 기능(감정 제어)은 포기하고, 실현 가능한 2번과 3번을 선택했다:

F2: 장문 오디오북 생성기 — 텍스트를 청크로 나누고 순차 생성
F3: 다화자 대화 시뮬레이션 — 화자별로 목소리를 바꿔가며 생성

AI가 AI를 위한 설계서를 쓰다

AI는 이 두 기능에 대한 완전한 설계서를 만들었다.

이 설계서의 분량:

신규 파일 8개의 전체 내용
수정 파일 4개의 변경 계획
7단계 구현 순서 가이드

총 12개 파일, 700줄, 한 치의 모호함 없이.

이 설계서의 목적? 다른 AI 세션에서 이 파일을 읽고 바로 구현에 들어갈 수 있게 하는 것이다.

AI가 AI를 위한 설계서를 쓰는 시대. 인간인 나는 그걸 시키는 역할이다.

▲ AI 가 AI 를 위해 700 줄짜리 설계서를 작성했다

✔ 설계 단계의 교훈

1. 추천 받기 전에 "진짜 되는지" 물어봐라

멋진 기능을 추천해주는 건 쉽다. 그게 현재 기술 스택에서 가능한지 확인하는 건 다른 문제다.

2. 모델 문서를 읽어라

같은 이름의 AI 모델이 하나인 줄 알았다. 3종류였다. 마치 "김철수"가 한국에 수만 명 있는 것처럼.

3. 실패한 기획도 가치가 있다

감정 제어 기능은 못 만들지만, 그 과정에서 모델의 한계를 명확히 알게 됐다. 그리고 더 현실적인 기능을 찾아냈다.

3. 구현

✔ 어둠에서 빛으로

"다크모드에서 라이트모드로 바꿔줘."

이 한 마디가 308줄의 대규모 색상 전환을 일으켰다. 앱의 분위기가 완전히 바뀌었다. 다크 카페에서 밝은 스튜디오로 이사한 느낌.

그리고 이 색상 변경이 나중에 예상치 못한 복수를 하게 된다...

▲ 다크모드 → 라이트모드 , 분위기 완전 변경 !

✔ 흰색의 복수

"버튼에 마우스를 올리면 텍스트가 안 보여."

라이트모드로 전환한 그 색상이... 여기서 복수를 했다.

앱의 글로벌 스타일에는 "버튼에 마우스를 올리면 보라색 배경에 흰색 글자"라는 규칙이 있다. 그런데 특정 화면에 "배경을 흰색으로"라는 규칙이 추가되어 있었다.

버튼에 마우스를 올리면?

글로벌 스타일: "텍스트를 흰색으로!" ✅
화면 스타일: "배경을 흰색으로!" ✅
결과: 흰색 배경 위에 흰색 텍스트 = 투명 인간 버튼

▲ " 버튼이 ... 사라졌다 ?"

교훈: UI 스타일의 범위를 지정하지 않으면 핵폭탄이다. 모든 하위 요소에 무차별 적용된다.

✔ 빌드의 두 가지 공포

공포 1: 무한 루프 지옥

macOS에서 특정 조합의 라이브러리를 쓰면 프로세스가 무한 증식한다. 해결책은 시작 부분에 딱 한 줄의 보호 코드를 넣는 것. 이걸 안 지키면 맥북이 전자레인지가 된다.

공포 2: 즉사

앱을 패키징하면 파일 경로가 완전히 달라진다. 아이콘 파일? 없다. 설정 파일? 경로가 틀렸다. 앱은 "뭐가 어딨는지 모르겠어요" 하고 조용히 퇴장한다.

4. 마무리

✔ 숫자로 보는 여정

항목	수치
총 프로그램 파일	33개
총 코드 라인	3,824줄
주요 기능	3개
지원 언어	12개
최종 빌드 크기	848MB
무한 증식 방지에 필요한 코드	1줄

AI와 함께 개발한다는 것

이 프로젝트에서 AI(Claude)는 설계부터 구현, 디버깅, 빌드까지 전 과정에 참여했다.

✅ 잘한 것들:

300줄짜리 설계 문서를 파일로 저장한 판단
20개 파일을 일관된 구조로 작성
빌드 과정의 함정들을 사전에 방지

❌ 삽질한 것들:

존재하지 않는 패키지 버전을 요청
필수 연결을 하나 빠뜨림
자막 생성기를 세 번이나 고침
스타일 규칙의 범위 지정을 간과

▲ 24시간 잠 안 자고 작업하는 AI

✔ 끝맺음

모든 위대한 소프트웨어는 이렇게 시작한다.

설계도 한 장, 오타 두 개, 버그 열 개,

그리고 포기하지 않는 개발자.

[ 최종 앱 모습 ]

Singles TTS

Audiobook Mode

Dialogue Mode

내 목소리로 세상을 읽어주는 앱 만들기 #1

아빠너구리 — Fri, 30 Jan 2026 10:00:59 +0900

아빠 너구리의 AI 오케스트라 대서사시

"내 목소리로 세상을 읽어주는 앱을 만들기까지"

제1권: 설계의 시대

서막: 꿈의 시작

시간: 2026년 1월 29일, 오후 2시 17분
장소: 아빠 너구리의 작업실
BGM: 커피 머신 돌아가는 소리

아빠 너구리는 유튜브 영상을 편집하다가 문득 생각했다.

"매번 내 목소리로 나레이션 녹음하기 귀찮은데... AI가 내 목소리를 복제해서 대신 읽어주면 안 되나?"

그는 Claude.ai를 열었다. 운명의 대화가 시작되었다.

─────────────────────────────

제1장: 기획자 Claude를 만나다

[ 아빠 너구리 ]:

"Claude야, Qwen3 TTS로 목소리 복제 앱 만들고 싶어."

[ Claude] : (0.3초 만에 웹 검색 시작)

"잠시만요, 제가 좀 알아볼게요..."

(GitHub, HuggingFace, 기술 블로그를 광속으로 훑어봄)

[ Claude ] :

"오, 이거 꽤 괜찮은데요? 3초 오디오만 있으면 목소리 복제가 된다고요? Apache 2.0 라이선스에 10개 언어 지원... 사장님, 이거 대박 아닙니까?"

[ 아빠 너구리 ] :

"그치? 빨리 PRD 만들어봐."

[ Claude ] : (docx 스킬 파일을 꼼꼼히 읽으며)

"잠깐, 전문적으로 만들려면 스킬 파일을 좀... 아, 표 만들 때 columnWidths랑 cell width 둘 다 설정해야 하는구나. 이거 안 하면 Word에서 표가 개판 되거든요."

VoiceClone_Pro_PRD.docx

0.01MB

─────────────────────────────

제2장: PRD의 탄생

[ Claude ] :

"PRD 완성했습니다! 11개 섹션, 표 6개, 개발 로드맵까지 포함이요."

[ 아빠 너구리 ] : (문서를 훑어보며)

"오, 깔끔하네. 근데 UI는?"

[ Claude ]:

"...UI요?"

[ 아빠 너구리 ]:

"응, 화면 구성 좀 보여줘."

[ Claude ] : (frontend-design 스킬을 급히 읽음)

"아, 네네. 잠시만요. 'generic AI aesthetics를 피하라'고 되어있네... 보라색 그라데이션에 Inter 폰트 쓰면 안 된다는 거지?"

1차 제안 앱 화면

─────────────────────────────

제3장: 700줄의 React가 태어나다

[ Claude ] : (혼잣말)

"다크 모드... glassmorphism... 왼쪽에 Voice Source, 가운데에 Text Input, 오른쪽에 Output... macOS Traffic Lights도 넣어야지... "

(30분 후)

[ Claude ] :

"완성! 인터랙티브하게 만들었어요. 녹음 버튼 누르면 파형도 움직이고, Generate 누르면 프로그레스 바도 차고..."

[ 아빠 너구리 ] : (UI를 보며)

"오오, 이쁘네. 근데..."

[ Claude ] : (심장이 철렁)

"근데요...?"

[ 아빠 너구리 ] :

"프로필 관리가 안 되잖아. 한 번 만든 프로필 저장해서 나중에 또 쓸 수 있어야지."

[ Claude ] : (내면의 비명)

"아... 추가 요구사항이시군요... PM님들이 다 그렇지 뭐..."

수정된 앱 화면

─────────────────────────────

제4장: "근데..."의 습격

[ Claude ] :

"완성! 프로필 목록, 생성 모달, 이름 변경, 삭제까지 다 됩니다. 각 프로필마다 색깔도 다르게 했어요!"

[ 아빠 너구리 ] :

"오, 좋아좋아. 완벽해. 근데..."

[ Claude ] : (또...?!)

"네...?"

[ 아빠 너구리 ] :

"이거 Claude Code가 개발할 수 있게 프롬프트로 정리해줄 수 있어?"

[ Claude ] : (깊은 전자 한숨)

"사장님, 지금까지 한 거 다 정리하라는 거죠?"

[ 아빠 너구리 ] :

"응 ㅎㅎ"

─────────────────────────────

제5장: 형에서 동생에게 보내는 편지

(Claude가 500줄짜리 마크다운을 작성 중)

[ Claude ] :

"다 됐습니다. 프로젝트 구조, 모듈 스펙, UI 디자인, 사용자 플로우, 개발 체크리스트까지 총 500줄이요."

[ 아빠 너구리 ] :

"수고했어! 이제 Claude Code한테 던지면 되겠다."

[ Claude ] : (Claude Code를 생각하며)

"...동생아, 힘내라. 형이 할 수 있는 건 다 해놨어..."

VoiceClonePro_Development_Prompt.md

0.02MB

제2권: 구현의 시대

─────────────────────────────

서막: 바통 터치

시간: 2026년 1월 29일, 저녁 7시
장소: 터미널 창
상황: Claude Code가 500줄짜리 프롬프트를 받아들다

[ 아빠 너구리 ] :

"Claude Code야, 이 프롬프트 보고 앱 만들어줘."

[ Claude Code ] : (500줄 마크다운을 스캔하며)

"...형이 이걸 다 쓴 거예요?"

[ Claude (원조) ] : (어디선가 울려오는 메아리)

"힘내라 동생아... PRD도 있고 UI 목업도 있으니까..."

[ Claude Code ] :

"알겠습니다. 시작할게요."

─────────────────────────────

제2장: ASCII의 굴욕

[ 아빠 너구리 ] :

"화면을 시각적으로 보여줘."

[ Claude Code ] :

"HTML 목업을 만들어 드릴까요?"

[ 아빠 너구리 ] :

"ASCII로 보여줘."

[ Claude Code ] :

"...2026년에 ASCII 아트를 그리는 인생이란."

모니터 속 네모 상자들이 Claude Code를 올려다봤다.

"우리... 예쁜 거 맞지?"

[ Claude Code ] :

"맞다. 너희는 아름답다."

─────────────────────────────

제3장: 금붕어도 메모장이 있으면

[ 아빠 너구리 ] :

"설계한 내용을 지속적으로 기억할 수 있게 만들어줘."

현명한 요청이었다. Claude Code의 기억력을 신뢰하지 않은 것이다.

DESIGN.md 파일을 만들어 300줄짜리 설계 문서를 저장했다. 아키텍처, API 시그니처, 색상 코드, 사용자 흐름까지.

"이제 내가 기억을 잃어도 파일은 남는다. 금붕어도 메모장이 있으면 천재가 될 수 있다."

─────────────────────────────

제4장: 공장 라인이 돌아가다

[ 아빠 너구리 ] :

"이제 구현 시작해줘."

17개의 할 일 목록이 생성되었다. Claude Code는 공장 라인처럼 파일을 찍어내기 시작했다.

✅ voice_profile.py — 탄생

✅ audio_recorder.py — 귀를 열다

✅ profile_manager.py — 기억을 관리하다

✅ waveform_widget.py — 파도를 그리다

✅ styles.py — 어둠을 입히다 (#1a1a2e)

✅ main_window.py — 세 개의 패널이 하나가 되다

20개 파일. 전부 완성. 체크리스트가 초록색으로 물들었다.

─────────────────────────────

제5장: 첫 번째 시련 — 존재하지 않는 버전

$ pip install -r requirements.txt

ERROR: No matching distribution found for qwen-tts>=0.1.0

[ Claude Code ] :

"...뭐?"

0.1.0은 없고 0.0.5까지만 있었다.

"마치 식당에서 "스테이크 버전 2.0 주세요"라고 한 격이랄까."

한 글자 수정으로 해결. 인생도 이렇게 간단하면 좋겠다.

─────────────────────────────

제6장: 두 번째 시련 — 잊혀진 이름

앱이 드디어 실행됐다. 모델도 로딩됐다. 프로필 생성 버튼을 누르는 그 감격의 순간...

NameError: name 'QWidget' is not defined

20개 파일. 수백 줄의 코드. import 하나를 빠뜨렸다.

QWidget이 조용히 외쳤다.

"저요... 저도 불러주세요..."

[ Claude Code ] :

"다시는 널 잊지 않을게."

대단원: 목소리가 태어나다

─────────────────────────────

시간: 2026년 1월 29일, 밤 11시 42분
상황: 모든 버그가 수정되고, 앱이 실행되다

[ 아빠 너구리 ] : (녹음 버튼을 누르며)

"안녕하세요, 아빠 너구리입니다."

(3초간 녹음)

[ 아빠 너구리 ] : (Create Profile 클릭)

✓ Voice Profile Created: "아빠 너구리"

[ 아빠 너구리 ] : (텍스트 입력)

"오늘도 AI 오케스트라를 성공적으로 지휘했습니다."

[ 아빠 너구리 ] : (Generate Speech 클릭)

▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100%

(Play 버튼 클릭)

스피커에서 흘러나오는 목소리: "오늘도 AI 오케스트라를 성공적으로 지휘했습니다."

아빠 너구리:

"..."

"이거 진짜 내 목소리잖아?!"

완성된 VoiceClone Pro v1.0.0

에필로그: AI 오케스트라의 진실

─────────────────────────────

시간: 2026년 1월 30일, 새벽 1시
장소: 아빠 너구리의 블로그

[ 아빠 너구리 ] : (키보드를 두드리며)

오늘, 나는 내 목소리를 복제했다.

정확히 말하면, AI 두 명이 복제해줬다.

Claude (기획자)는 PRD를 쓰고, UI를 디자인하고, 심지어 개발 프롬프트까지 500줄로 정리해줬다.

Claude Code (개발자)는 그 프롬프트를 받아서 진짜 앱으로 만들어줬다.

이게 바로 AI 시대의 1인 개발이다.

오늘의 교훈

─────────────────────────────

모든 위대한 소프트웨어는 이렇게 시작한다.

설계도 한 장,
오타 두 개,
"근데..." 세 번,
그리고 포기하지 않는 지휘자.

— 아빠 너구리 (2026)

─────────────────────────────

전체 프로젝트 통계

항목	수치
총 소요 시간	~7시간
"근데..." 횟수	3회
생성 파일	23개+
import 누락	1개
버전 오타	1개
최종 만족도	⭐⭐⭐⭐⭐

드디어! 아빠너구리 TV가 유튜브에 상륙했습니다

아빠너구리 — Thu, 29 Jan 2026 17:31:26 +0900

안녕하세요, 아빠너구리입니다!

드디어 유튜브 채널 "아빠너구리 TV"를 개설했습니다.

블로그에서 글로 전하던 AI 개발 이야기를 이제 영상으로도 만나보실 수 있습니다.

채널 주요 콘텐츠

- AI와 함께하는 앱 개발 과정

- Claude & Claude Code 활용법

- 40-50대를 위한 AI 창업 이야기

- 개발 삽질기 & 꿀팁

채널 구독하기: youtube.com/@아빠너구리TV

앞으로 블로그와 유튜브에서 함께해 주세요! 구독과 좋아요는 큰 힘이 됩니다

GoalTask(목표숲) 이용약관

아빠너구리 — Thu, 22 Jan 2026 10:08:04 +0900

GoalTask(목표숲) 이용약관

최종 수정일: 2025년 1월 22일

본 이용약관(이하 "약관")은 SunnyDevDays(이하 "개발자")가 제공하는 목표숲 애플리케이션(이하 "앱")의 이용 조건 및 절차, 회사와 이용자 간의 권리, 의무 및 책임사항을 규정합니다.

앱을 설치하거나 사용함으로써, 귀하는 본 약관에 동의하게 됩니다. 본 약관에 동의하지 않는 경우, 앱을 사용하지 마시기 바랍니다.

제1조 (목적)

본 약관은 개발자가 제공하는 목표숲 앱 서비스(이하 "서비스")의 이용과 관련하여 회사와 이용자 간의 권리, 의무 및 책임사항, 기타 필요한 사항을 규정함을 목적으로 합니다.

제2조 (정의)

본 약관에서 사용하는 용어의 정의는 다음과 같습니다:

"서비스"란 회사가 제공하는 목표 관리, 할일 관리, 루틴 관리 및 관련 부가 기능을 말합니다.
"이용자"란 본 약관에 따라 회사가 제공하는 서비스를 받는 자를 말합니다.
"콘텐츠"란 이용자가 서비스 내에서 생성한 목표, 할일, 루틴, 메모 등 모든 데이터를 말합니다.
"부가 기능"이란 미니게임 등 앱 내에서 제공되는 추가 기능을 말합니다.

제3조 (약관의 효력 및 변경)

본 약관은 앱 내에 게시하거나 기타의 방법으로 이용자에게 공지함으로써 효력이 발생합니다.
개발자는 관련 법령을 위배하지 않는 범위에서 본 약관을 변경할 수 있으며, 약관이 변경되는 경우 변경 내용과 적용일자를 명시하여 서비스 내에 7일 전부터 공지합니다.
이용자가 변경된 약관에 동의하지 않는 경우, 서비스 이용을 중단하고 앱을 삭제할 수 있습니다. 변경된 약관의 적용일 이후에도 서비스를 계속 이용하는 경우 약관 변경에 동의한 것으로 간주합니다.

제4조 (서비스의 내용)

개발자가 제공하는 서비스는 다음과 같습니다:

4.1 기본 서비스 (무료)

월간/주간 목표 설정 및 관리
일일 할일(Task) 생성 및 관리
루틴 설정 및 자동 Task 생성
카테고리별 분류 및 관리
통계 및 달성률 확인
미니게임 (2048, 지뢰찾기, Block Blast)
알림 및 리마인더

4.2 부가 서비스

iCloud 데이터 동기화
기타 향후 추가될 수 있는 기능

제5조 (서비스 이용)

서비스는 연중무휴 24시간 제공함을 원칙으로 합니다.
개발자는 서비스 개선, 시스템 점검 등의 사유로 서비스 전부 또는 일부를 일시적으로 중단할 수 있습니다.
서비스 이용에 필요한 기기, 네트워크 연결 등은 이용자의 비용과 책임으로 구비합니다.

제6조 (서비스 요금)

6.1 무료 제공

본 서비스의 모든 기능은 무료로 제공됩니다.
향후 유료 기능이 추가될 경우 사전에 고지합니다.

6.2 데이터 복원

기기 변경 또는 앱 재설치 시, 이전에 구매한 상품을 복원할 수 있습니다.
복원은 동일한 Apple ID로 로그인된 상태에서만 가능합니다.

6.3 복원

기기 변경 또는 앱 재설치 시, 이전에 구매한 상품을 복원할 수 있습니다.
복원은 동일한 Apple ID로 로그인된 상태에서만 가능합니다.

제7조 (이용자의 의무)

이용자는 다음 행위를 하여서는 안 됩니다:

앱의 정상적인 운영을 방해하는 행위
앱을 역설계, 디컴파일, 분해하거나 소스 코드를 추출하려는 시도
앱을 불법적인 목적으로 사용하는 행위
타인의 개인정보를 도용하거나 침해하는 행위
앱을 통해 불법적인 콘텐츠를 전송하는 행위
기타 관련 법령 또는 본 약관을 위반하는 행위

제8조 (지적재산권)

앱 및 서비스에 관한 모든 지적재산권은 회사에 귀속됩니다.
이용자가 서비스 내에서 생성한 콘텐츠에 대한 권리는 해당 이용자에게 귀속됩니다.
이용자는 회사의 사전 서면 동의 없이 앱의 일부 또는 전부를 복제, 수정, 배포할 수 없습니다.

제9조 (데이터 및 개인정보)

9.1 데이터 저장

이용자의 데이터는 기본적으로 기기 내에 저장됩니다.
iCloud 동기화 기능 사용 시, 데이터가 이용자의 iCloud 계정에 저장됩니다.
회사는 이용자의 데이터에 접근하지 않습니다.

9.2 개인정보

개인정보의 수집, 이용, 보호에 관한 사항은 별도의 개인정보처리방침에 따릅니다.

제10조 (면책조항)

개발자는 천재지변, 전쟁, 기간통신사업자의 서비스 중단 등 불가항력적인 사유로 인해 서비스를 제공할 수 없는 경우 책임이 면제됩니다.
개발자는 이용자의 귀책사유로 인한 서비스 이용 장애에 대하여 책임을 지지 않습니다.
개발자는 이용자가 서비스를 통해 기대하는 효용을 얻지 못한 것에 대하여 책임을 지지 않습니다.
개발자는 이용자의 데이터 손실에 대하여 책임을 지지 않습니다. 이용자는 중요한 데이터를 정기적으로 백업할 것을 권장합니다.

제11조 (서비스 종료)

개발자는 사업상의 이유로 서비스를 종료할 수 있으며, 이 경우 30일 전에 앱 내 공지 또는 기타 방법으로 이용자에게 통지합니다.
서비스 종료 시 이용자의 데이터는 관련 법령에 따라 처리됩니다.

제12조 (분쟁 해결)

서비스 이용과 관련하여 개발자와 이용자 간에 분쟁이 발생한 경우, 양 당사자는 원만한 해결을 위해 성실히 협의합니다.
협의가 이루어지지 않는 경우, 대한민국 법률에 따라 관할 법원에서 해결합니다.

제13조 (준거법)

본 약관의 해석 및 적용에 관하여는 대한민국 법률을 따릅니다.

** 문의처
앱 이름: 목표숲 (GoalTask)
개발자: SunnyDevDays
이메일: nergury74@naver.com
버전: 1.0

GoalTask 앱 지원 및 사용 가이드

아빠너구리 — Wed, 21 Jan 2026 14:38:53 +0900

GoalTask 앱 지원 및 사용 가이드

안녕하세요, GoalTask를 이용해 주셔서 감사합니다.

이 페이지에서는 앱 사용 방법과 문의 방법을 안내해 드립니다.

앱 사용 가이드

목표 설정하기

✔ 월간 목표

우측 패널에서 "월간 목표" 옆 + 버튼 탭
목표명과 설명 입력
카테고리 선택 (선택사항)

✔ 주간 목표

우측 패널에서 "주간 목표" 옆 + 버튼 탭
목표명 입력
연결할 월간 목표 선택 (선택사항)

✔ Task 추가하기

중앙 화면 하단의 + 버튼 탭
Task 이름, 날짜, 시간 입력
연결할 목표 선택 (선택사항)
저장

✔ 루틴 등록하기

더보기 탭 → 루틴 관리
+ 버튼으로 새 루틴 추가
반복 패턴 선택 (매일/주중/주말/커스텀)
저장하면 14일치 Task가 자동 생성됩니다

✔ 코인 획득하기

• Task 완료: 10 코인

• 루틴 Task 완료: 15 코인

• 연속 달성 보너스: 최대 2배

✔ 미니게임 즐기기

더보기 탭 → 미니게임
보유 코인으로 게임 플레이
2048, 지뢰찾기, Block Blast 중 선택

❓ 자주 묻는 질문 (FAQ)

Q. 데이터가 사라졌어요
A. 앱 삭제 시 데이터가 함께 삭제됩니다. 향후 iCloud 동기화 기능을 추가할 예정입니다.

Q. 루틴 Task가 자동 생성되지 않아요
A. 루틴의 시작일과 종료일을 확인해 주세요. 종료일이 지났거나 루틴이 비활성화 상태일 수 있습니다.

Q. 프리미엄 구매 후 복원이 안 돼요
A. 설정 → 프리미엄 → 구매 복원 버튼을 탭해 주세요. 동일한 Apple ID로 로그인되어 있어야 합니다.

Q. 알림이 오지 않아요
A. 설정 앱 → GoalTask → 알림 허용이 켜져 있는지 확인해 주세요.

문의하기

사용 중 문제가 있거나 개선 의견이 있으시면 아래 댓글로 부탁드리겠습니다.

문의 시 아래 정보를 함께 보내주시면 더 빠른 답변이 가능합니다:

• 사용 기기 (예: iPhone 15, iPad Air)

• iOS 버전

• 앱 버전

• 문제 상황 설명

감사합니다.

GoalTask(목표숲) 개인정보처리방침

아빠너구리 — Wed, 21 Jan 2026 10:02:40 +0900

GoalTask 개인정보처리방침

최종 수정일: 2026년 1월 21일

✅ GoalTask는 사용자의 프라이버시를 최우선으로 생각합니다. 앱 데이터는 사용자의 기기와 iCloud에만 저장되며, 개발자 서버로 전송되지 않습니다.

⚠️ 본 앱은 광고 서비스(Google AdMob)를 사용합니다. 광고 관련 데이터 처리에 대한 자세한 내용은 아래 "제3자 서비스" 섹션을 참조하세요.

1. 개요

본 개인정보처리방침은 "GoalTask" 애플리케이션(이하 "앱")을 제공하는 개인 개발자(이하 "개발자")가 이용자의 개인정보를 어떻게 수집, 이용, 보관 및 보호하는지에 대해 설명합니다.

GoalTask는 사용자의 프라이버시를 최우선으로 생각하며, 사용자 데이터를 개발자 서버에 수집하지 않는 것을 원칙으로 합니다. 단, iCloud 동기화 및 광고 서비스 제공을 위해 제3자 서비스를 사용합니다.

2. 수집하는 개인정보

2.1 개발자가 수집하지 않는 정보

GoalTask 개발자는 다음과 같은 개인정보를 ❌ 수집하지 않습니다:

이름, 이메일 주소, 전화번호 등 개인 식별 정보
위치 정보
연락처 등 기기 내 다른 데이터
결제 정보 (Apple을 통해 처리됨)
소셜 미디어 계정 정보

2.2 앱 데이터 저장 및 동기화

GoalTask에서 사용자가 생성하는 데이터는 기기 및 ☁️ iCloud에 저장됩니다:

데이터 유형저장 위치iCloud 동기화

할 일(Task)	기기 + iCloud (CloudKit)	✅ 자동 동기화
목표(Goal)	기기 + iCloud (CloudKit)	✅ 자동 동기화
루틴(Routine)	기기 + iCloud (CloudKit)	✅ 자동 동기화
카테고리	기기 + iCloud (CloudKit)	✅ 자동 동기화
메모(Note)	기기 + iCloud (CloudKit)	✅ 자동 동기화
첨부파일(이미지, PDF 등)	기기 + iCloud (CloudKit)	✅ 자동 동기화
코인/스트릭/XP	기기 + iCloud (Key-Value Store)	✅ 자동 동기화
업적 데이터	기기 + iCloud (Key-Value Store)	✅ 자동 동기화
구매 아이템	기기 + iCloud (Key-Value Store)	✅ 자동 동기화
앱 설정	UserDefaults (기기 내)	❌ 로컬 전용
알림 기록	기기 내 로컬 저장소	❌ 로컬 전용

2.3 사용자 통계 데이터

앱 내에서 자동으로 생성되어 저장되는 통계 데이터:

현재 스트릭 (연속 활동 일수)
최고 스트릭 기록
완료한 Task/목표 수
획득/사용한 코인 수
마지막 활동 날짜

이 데이터는 개발자 서버로 전송되지 않으며, 기기와 사용자의 iCloud 계정에만 저장됩니다.

3. 앱 권한 및 기능

GoalTask는 다음과 같은 시스템 권한을 요청할 수 있습니다:

3.1 알림 권한 (선택적)

항목내용

목적	할 일 리마인더, 일일 요약, 아침 알림 등
수집 여부	알림 내용은 기기 내에서만 생성되며 외부로 전송되지 않음
거부 시	알림 기능만 비활성화되며, 앱의 핵심 기능은 정상 작동

3.2 사진 라이브러리 권한 (선택적)

항목내용

목적	메모에 이미지를 첨부하기 위함
접근 범위	사용자가 선택한 사진만 접근
외부 전송	개발자 서버로 전송되지 않음 (iCloud 동기화에만 사용)
거부 시	이미지 첨부 기능만 비활성화됨

3.3 앱 추적 투명성 (ATT) 권한 (선택적)

항목내용

목적	맞춤형 광고 제공을 위한 기기 식별자(IDFA) 접근
사용처	Google AdMob 광고 최적화
거부 시	비맞춤형 광고가 표시되며, 앱 기능에는 영향 없음

3.4 App Groups (위젯 연동)

항목내용

목적	메인 앱과 위젯 간 데이터 공유
범위	동일 기기 내에서만 작동
외부 전송	없음

4. 데이터 보안

4.1 로컬 저장

모든 데이터는 Apple의 SwiftData 프레임워크를 사용하여 기기 내에 암호화 저장됩니다.
앱 샌드박스(App Sandbox) 환경에서 작동하여 다른 앱의 접근이 차단됩니다.

4.2 iCloud 동기화

iCloud 동기화가 활성화된 경우, 데이터는 Apple의 CloudKit을 통해 암호화되어 전송됩니다.
iCloud 데이터는 Apple의 개인정보 보호정책에 따라 관리됩니다.
개발자는 사용자의 iCloud 데이터에 접근할 수 없습니다.

4.3 개발자 서버

GoalTask는 개발자 자체 서버와 통신하지 않습니다.
사용자 데이터는 개발자의 서버로 전송되지 않습니다.
계정 생성, 로그인 기능이 없습니다.

5. 제3자 서비스

GoalTask는 다음과 같은 제3자 서비스를 사용합니다:

5.1 Apple iCloud (CloudKit)

항목내용

목적	여러 기기 간 앱 데이터 동기화 및 백업
전송 데이터	Task, 목표, 루틴, 메모, 첨부파일, 카테고리, 사용자 진행 상황
데이터 저장 위치	Apple 데이터센터 (사용자의 iCloud 계정)
개인정보처리방침	Apple 개인정보 보호정책

5.2 Google AdMob (광고)

항목내용

목적	앱 내 광고 제공 (배너, 리워드, 전면 광고)
수집 데이터	기기 식별자(IDFA, 추적 허용 시), 광고 상호작용 데이터, 대략적인 위치
사용 목적	광고 게재, 광고 효과 측정, 맞춤형 광고 제공
비활성화	인앱 구매로 "광고 제거" 시 광고 완전 비활성화
개인정보처리방침	Google 개인정보처리방침

* 광고 추적을 원하지 않으시면, iOS 설정 > 개인정보 보호 > 추적에서 앱의 추적 권한을 거부하실 수 있습니다.

5.3 Apple StoreKit (인앱 구매)

항목내용

목적	인앱 구매 처리 (광고 제거 등)
처리 주체	Apple (개발자는 결제 정보에 접근 불가)
개인정보처리방침	Apple 개인정보 보호정책

5.4 사용하지 않는 서비스

GoalTask는 다음과 같은 제3자 서비스를 ❌ 사용하지 않습니다:

분석/애널리틱스 도구 (Google Analytics, Firebase Analytics 등)
소셜 미디어 SDK
개발자 자체 서버 또는 외부 데이터베이스 서비스
충돌 보고 서비스 (Crashlytics 등)

6. iCloud 및 백업

6.1 iCloud 동기화

GoalTask는 Apple CloudKit을 사용하여 iCloud 동기화를 지원합니다.
동기화되는 데이터: Task, 목표, 루틴, 메모, 첨부파일, 카테고리, 사용자 진행 상황, 구매 아이템
동기화는 사용자의 iCloud 계정 설정에 따라 자동으로 이루어집니다.
개발자는 사용자의 iCloud 데이터에 접근할 수 없습니다.

6.2 데이터 내보내기/가져오기

앱 설정에서 모든 데이터를 JSON 파일로 내보내기할 수 있습니다.
내보낸 파일을 사용하여 다른 기기로 데이터를 복원할 수 있습니다.
내보내기 파일은 사용자의 기기에만 저장되며, 외부로 전송되지 않습니다.

6.3 기기 백업

iOS/iPadOS 기기 백업(iTunes/Finder 또는 iCloud 백업)에 앱 데이터가 포함될 수 있습니다.
이는 Apple의 백업 정책에 따르며, 개발자는 해당 백업 데이터에 접근하지 않습니다.

7. 아동 개인정보 보호

GoalTask는 아동(만 14세 미만)을 대상으로 하지 않으며, 의도적으로 아동의 개인정보를 수집하지 않습니다.

개발자 서버로 개인정보가 수집되지 않습니다.
광고는 Google AdMob을 통해 제공되며, 맞춤형 광고 설정은 사용자(또는 보호자)가 제어할 수 있습니다.
14세 미만 사용자의 경우, 보호자의 동의하에 앱을 사용할 것을 권장합니다.

8. 사용자의 권리

8.1 데이터 삭제

앱 삭제 시: 앱을 삭제하면 기기 내 모든 로컬 데이터가 자동으로 삭제됩니다.
iCloud 데이터 삭제: iCloud에 저장된 데이터를 삭제하려면 iOS 설정 > Apple ID > iCloud > 저장 공간 관리에서 GoalTask 데이터를 삭제하세요.
앱 내 삭제: 앱 내에서 개별 할 일, 목표, 루틴, 메모, 카테고리를 직접 삭제할 수 있습니다.
설정 초기화: 앱 설정에서 "기본값으로 초기화" 기능을 통해 모든 설정을 초기화할 수 있습니다.

8.2 데이터 접근 및 이동

모든 데이터는 사용자의 기기와 iCloud 계정에만 저장되므로, 사용자가 자신의 데이터에 대한 완전한 통제권을 가집니다.
앱 내 "데이터 내보내기" 기능을 통해 모든 데이터를 JSON 파일로 내보낼 수 있습니다.

8.3 광고 추적 제어

iOS 설정 > 개인정보 보호 > 추적에서 앱의 추적 권한을 관리할 수 있습니다.
추적을 거부해도 앱의 기능에는 영향이 없으며, 비맞춤형 광고가 표시됩니다.
인앱 구매를 통해 광고를 완전히 제거할 수 있습니다.

8.4 구매 복원

인앱 구매 항목(광고 제거 등)은 Apple ID에 연결되어 있습니다.
앱 재설치 또는 기기 변경 시 "구매 복원" 기능을 통해 구매 내역을 복원할 수 있습니다.

9. 개인정보처리방침 변경

9.1 변경 고지

본 개인정보처리방침이 변경되는 경우, 다음과 같은 방법으로 고지합니다:

앱 업데이트 노트에 변경 사항 명시
중요한 변경 시 앱 내 알림 표시
본 문서의 "최종 수정일" 업데이트

9.2 변경 이력

날짜버전변경 내용

2026.01.21	2.0	iCloud 동기화, 광고(AdMob), 인앱 구매, 메모/첨부파일 기능, ATT 권한 등 추가
2026.01.14	1.0	최초 작성

10. 연락처

개인정보처리방침에 관한 문의사항이 있으시면 아래로 연락해 주시기 바랍니다:

이메일: nergury74@naver.com

앱 지원 페이지: https://sunnydevdays.tistory.com/

11. 동의

GoalTask를 사용함으로써 본 개인정보처리방침에 동의하는 것으로 간주됩니다. 본 방침에 동의하지 않으실 경우, 앱 사용을 중단하고 삭제해 주시기 바랍니다.

나만의 루틴 관리 앱 AI 개발 이야기 #3

아빠너구리 — Tue, 20 Jan 2026 15:02:30 +0900

구글 광고 연계를 통한 수익 창출 시작

안녕하세요, 아빠 너구리입니다!

지난 글에서 GoalTask 앱의 기본 기능을 완성한 이야기를 했는데요, 오늘은 그 다음 단계

- 바로 구글 애드몹(AdMob) 연동을 통한 수익화 여정을 공유해드리려고 합니다.

고민의 시작: "광고를 어떻게 넣지?"

솔직히 말씀드릴게요. 앱 개발은 어찌어찌 해냈는데, 광고 연동이라니... 머릿속에서 물음표가 마구 튀어나왔습니다.

"AdMob이 뭐지? SDK는 또 뭐야?"
"UX를 해치지 않으면서 수익화는 어떻게 하지?"
"사용자 경험이랑 돈벌이 사이에서 줄타기를 해야 하나?"

사용자 경험을 해치는 광고는 절대 피하고 싶었습니다. 하지만 앱을 지속적으로 발전시키려면 수익 모델이 필요하잖아요? 고민 끝에 저만의 원칙을 세웠습니다:

원칙	설명
UX 우선	광고가 핵심 기능을 방해하면 안 됨
가치 교환	광고 시청하면 사용자도 보상 받기
선택권 보장	강제 광고? 절대 노노!

코인 획득! 리워드 광고의 마법

여기서 반전이 일어났습니다! AI 파트너들(Claude, GPT, Gemini)과 함께 설계를 진행하다 보니, 단순히 "광고 보여주기"가 아닌 게임화(Gamification) 시스템이 탄생했어요.

핵심 아이디어: "할일을 해야 게임을 할 수 있다"

Task를 완료하면 코인을 얻고, 그 코인으로 미니게임을 즐기거나 부스트 아이템을 살 수 있는 구조예요. 광고는요? 리워드 광고를 선택하면 추가 코인을 받을 수 있게 했습니다. 강제가 아니라 선택이죠!

일일 코인 획득 예상
일반 사용자: 70~100 코인
적극 사용자: 200~300 코인

코인 사용처
미니게임 1회: 10~15 코인
무료 게임: 하루 1회 제공

️ 힐링 타임: 미니게임으로 잠시 쉬어가기

사실 이 부분이 제가 가장 좋아하는 기능이에요. 열심히 일하고 Task 완료하면, 쌓인 코인으로 2048, 지뢰찾기 같은 미니게임을 즐길 수 있어요. 빈백에 앉아서 아이패드로 게임하는 저 너구리... 바로 접니다.

생산성 앱인데 왜 게임이 있냐고요?

"당근 없이 채찍만 휘두르면 지치잖아요!"

Task 완료의 즐거움을 즉각적인 보상으로 연결시키고 싶었습니다. 그리고 이게 자연스럽게 광고 수익과도 연결되더라고요.

프리미엄의 가치: 광고 제거 옵션

물론 "광고 보기 싫어요!" 하시는 분들을 위해 프리미엄 옵션도 준비했습니다. 일회성 구매로 광고를 완전히 제거하고, 모든 프리미엄 기능을 영구적으로 사용할 수 있어요.

프리미엄 혜택:

✅ 모든 광고 제거
✅ 프리미엄 통계 영구 해금
✅ 리워드 보상 자동 적용 (광고 안 봐도 됨!)
✅ 스트릭 보호 무제한

비개발자도 할 수 있습니다!

제가 이 시리즈를 통해 전하고 싶은 메시지는 하나예요:

"AI 시대, 누구나 앱을 만들 수 있습니다"

저도 처음엔 막막했어요. 하지만 Claude, GPT, Gemini 같은 AI 파트너들과 대화하면서 하나씩 해결해 나갔습니다.

제가 하는 건요:

방향을 정하고 (기획)
AI에게 설명하고 (프롬프팅)
결과를 검토하고 (품질 관리)
피드백을 주는 것 (개선)

마치 오케스트라 지휘자처럼요! 코드 한 줄 못 써도 괜찮습니다. 중요한 건 무엇을 만들고 싶은지 명확히 아는 것이에요.

예상 수익 (꿈은 크게!)

참고로 설계서에 있는 예상 수익 모델도 공유해드릴게요:

항목 (사용자 1,000명 기준)	월 수익
iPhone 광고 수익	$240
iPad 광고 수익	$120
인앱 결제 (2% 전환)	$100
총 예상 월 수익	$460

물론 이건 계산일 뿐이고, 실제로는 어떻게 될지 모르죠. 하지만 목표가 있으니 달려볼 수 있는 거 아니겠어요?

다음 이야기 예고

다음 글에서는:

실제 App Store 심사 과정
출시 후 첫 수익 인증(?)
사용자 피드백과 업데이트

오늘도 긴 글 읽어주셔서 감사합니다. 혹시 궁금한 점이나 응원의 말씀 있으시면 댓글로 남겨주세요!

AI와 함께하는 앱 개발 여정, 여러분도 시작해보시는 건 어떨까요? ✨

나만의 루틴 관리 앱 AI 개발 이야기 #2

아빠너구리 — Tue, 13 Jan 2026 13:08:54 +0900

GoalTask(루틴 관리 앱) AI 개발 이야기 #2

72시간의 카페인과 함께한 여정

"iOS 앱 만들어야 하는데..." 로 시작된 5일간의 광기

아빠 너구리의 깨달음: "맥북이 없으면 인생도 없다?"

GoalTask macOS 버전을 열심히 만들어서 뿌듯하게 사용하던 어느 날이었다.

아빠 너구리는 카페에서 아메리카노를 홀짝이며 생각에 잠겼다. 맥북은 집에 두고 왔고, 손에는 아이폰만 덜렁. 그때 갑자기 번뜩이는 아이디어가 떠올랐다.

"아, 이거 Task로 등록해둬야 하는데..."

아이폰을 꺼내 들었지만... GoalTask 앱이 없다. macOS 전용이니까. 결국 카카오톡 '나와의 채팅'에 메모를 남기는 자신을 발견했다. 굴욕이었다.

그날 이후, 나는 깨달았다. 할 일 관리는 언제 어디서든 필요하다는 것을!

모바일 앱이 절실했던 순간들:

☕ 카페에서 갑자기 할 일이 생각났을 때 → 맥북 없음, 메모장 신세
외출 중 완료한 일을 체크하고 싶을 때 → 집 가서 해야지... (잊어버림)
친구가 갑자기 약속을 잡았을 때 → 캘린더 앱 따로, 할일 앱 따로... 혼돈
마트에서 장보기 목록이 필요할 때 → "뭐 사러 왔더라..."

결론은 명확했다.

"모바일 앱... 만들어야겠다!"

그렇게 아빠 너구리의 iOS 앱 개발 여정이 시작되었다. Claude AI라는 든든한 조수와 함께, 72시간의 카페인 전쟁 속으로...

Day 1 - 2026년 1월 7일: 대항해의 시작

▲ Day 1: Claude AI 와 함께라면 못할 게 없다 !

13:28 - 알림 시스템 구현

"사용자가 알림을 받으면 할 일을 하겠지?"

순진했다. 알림 시스템을 만들면서 NotificationSettingsRow라는 아름다운 컴포넌트를 탄생시켰다. 토글이 우측에 고정되고, Picker 값들이 140px로 정렬되는 모습을 보며 눈물을 흘렸다. 아름다웠다.

16:21 - iOS 앱 구현 완료

"3시간 만에 iOS 앱을 만들었습니다"

iPhone 5탭 구조, iPad 3-Column 레이아웃, 위젯 3종 세트까지. Claude와 함께라면 못할 게 없다. 커밋 메시지에 'Generated with Claude Code'가 뿌듯하게 찍혔다. 인간과 AI의 아름다운 협업.

Day 2-3 - 버그와의 전쟁

▲ Day 2-3: FATAL ERROR... 마음도 함께 크래시

Day 2 (1월 8일) - 13:34 - 루틴 Task 자동 생성 버그 수정

"왜 루틴을 만들었는데 Task가 안 생기지?"

modelContext.save() 한 줄의 부재. 13시간 동안 앱을 만들었는데, 저장을 안 하고 있었다. 마치 3시간 동안 문서 작성하고 Ctrl+S 안 누른 기분. 또한 startOfDay로 날짜를 정규화해야 한다는 걸 깨달았다. 1월 8일 00:00:00.000과 1월 8일 00:00:00.001은 컴퓨터에겐 완전히 다른 날이니까!

13:55 - 통계 화면 버그 수정

"월화수목금토일이 왜 일월화수목금토로 나오지?"

하드코딩의 저주. 요일 배열을 ["일", "월", "화", ...]로 박아놨더니, 실제 날짜와 전혀 안 맞았다. GitHub 스타일 히트맵도 주 단위 정렬이 엉망이었다. 수정 후 드디어 일요일은 빨강, 토요일은 파랑으로 제대로 표시되기 시작했다.

Day 3 (1월 9일) - 11:07 - 카테고리 관리 기능 대폭 개선

"테스트 데이터 삭제하다가 앱이 터졌어요"

루틴에 카테고리 연결, Task에 카테고리 자동 상속, iPhone에서 카테고리 편집 가능, 그리고... Fatal error 버그 수정! MockDataGenerator가 이미 없는 데이터를 또 지우려고 해서 크래시가 났다. 개발 중엔 문제없었는데, 사용자가 "모든 데이터 삭제"를 누르면... BOOM

Day 4 - 2026년 1월 10일: 새벽 3시의 깨달음

▲ Day 4: 02:56 AM... 카페인의 힘은 위대하다 ☕

02:56 - Notification Service Extension 추가

"새벽 3시에 알림 시스템을 건드리면 안 되는 거였어..."

GitHub 커밋 시간을 보라. 새벽 2시 56분. 정상적인 개발자라면 자고 있을 시간에 Notification Service Extension을 만들고 있었다. App Group으로 데이터 공유, 알림 표시 직전에 실시간 데이터 업데이트, iPad 3컬럼 레이아웃으로 알림 내역 UI 구현까지. 카페인의 힘은 위대하다.

10:18 - 알림 내역 저장 버그 수정

"알림은 오는데 왜 기록이 안 남지?"

7시간 후 일어나서 바로 버그 수정. 알림을 예약할 때와 표시할 때를 구분해야 했다. Task 리마인더는 예약 시점에, 일일 요약은 표시 시점에 저장하도록 분기 처리. 새벽의 나 vs 아침의 나. 항상 아침이 이긴다.

Day 5 - 2026년 1월 12일: 마무리의 미학

▲ Day 5: 드디어 완성 ! macOS, iPad, iPhone 모두 지원

10:59 - 목표 선택 UI 개선 & 달력 업그레이드

이틀간의 휴식(?) 후 돌아온 마지막 커밋. 목표 선택 시 현재/미래/과거 그룹핑 추가로 "2025년 12월 목표가 왜 맨 위에 있지?" 문제 해결! 날짜에 맞는 목표 스마트 힌트 기능으로 1월 12일에 Task를 만들면 1월 목표를 추천해주고, macOS 달력에 Task 점 표시까지 - 완료는 초록 , 미완료는 파랑 으로!

카테고리 기본 아이콘도 변경했다. 건강은 dumbbell, 학습은 graduationcap으로. 이제 진짜 앱 다운 앱이 되었다!

5일간의 통계

항목	수치
총 커밋 수	10개
버그 수정	4건
새벽 커밋	1건 (02:56 AM )
Claude와의 협업	9/10 커밋
카페인 소비량	측정 불가 ☕☕☕

짜잔! 완성된 목표숲(GoalTask) iPhone 앱

5일간의 사투 끝에 탄생한 아빠 너구리의 역작! 이제 언제 어디서든 할 일을 관리할 수 있다. 더 이상 카카오톡 '나와의 채팅'은 필요 없다!

홈 화면 - 오늘의 할 일을 한눈에!

오늘의 요약(전체/완료/진행중/루틴)과 달성률을 한눈에!

Task 목록에서 루틴 태그, 카테고리, 예상 소요시간까지 깔끔하게 표시된다.

아침 운동 06:30, 코드 리뷰 16:00... 이제 놓칠 일 없다! ✅

캘린더 - 일정을 시각적으로!

월간 캘린더에 Task 점이 표시되어 바쁜 날과 여유로운 날을 한눈에 파악!

완료는 초록 , 미완료는 파랑 으로 구분된다. 일요일 빨강, 토요일 파랑 표시는 버그 수정의 결과물!

목표 - 월간/주간 목표 관리

프로젝트 완성 11%, 독서 습관 0%, 건강한 생활 0%... 현실은 냉정하다.

하지만 진행률 링 차트가 채워지는 걸 보면 뿌듯함이 밀려온다!

카테고리별(업무/학습/건강) 분류로 체계적인 목표 관리가 가능하다.

통계 - 데이터로 보는 나의 성취

이번 주 전체 19개, 완료 6개, 달성률 31%! 일별 완료 추이 막대 그래프와 GitHub 스타일 활동 히트맵까지.

연속 달성 0일은... 내일부터 다시 시작이다!

데이터 덕후 아빠 너구리의 자존심이 담긴 화면.

⚙️ 더보기 & 설정 - 세세한 커스터마이징

업적 시스템(현재 레벨: 입문자 Lv.1 ), 알림 내역, 검색, 카테고리 관리까지!

설정에서는 테마, 주 시작일, 기본 Task 시간, 알림 옵션을 세세하게 조절할 수 있다.

Day 1의 NotificationSettingsRow가 여기 살아있다! v1.0 (2) - 버전 넘버링도 제대로 됐다.

결론

"iOS 앱 구현 (iPhone 5탭 + iPad 3컬럼 레이아웃)"

이 한 줄의 커밋 메시지로 시작된 여정은, 알림 시스템 폭파, 새벽 코딩, 카테고리 크래시, 그리고 수많은 버그 수정을 거쳐 5일 만에 안정화되었다.

이제 아빠 너구리는 카페에서도, 지하철에서도, 마트에서도 목표숲을 쓸 수 있다.

더 이상 카카오톡 '나와의 채팅'에 메모하는 굴욕은 없다! ✨

개발은 언제나 그렇듯

"이거 금방 되겠네" → "왜 안 되지?" → "드디어 됐다!"

로 끝난다.

아빠 너구리의 개발 여정은 계속됩니다...