본문으로 건너뛰기

Swift 는 처음인데 Claude Code 로 맥 메뉴바 앱을 만들어 배포까지 했습니다

골치덩어리

2026.10.26

소개

Claude Code 를 돌려놓고 자리를 비우면 세션이 살아 있는지 알 수가 없었습니다. 돌아와 보면 끊겨 있고, 언제 왜 끊겼는지도 모릅니다.

맥은 가만두면 잠듭니다. 잠들면 맥에서 돌던 AI 작업도 같이 멈춥니다. 문제는 지금 자고 있는지 아닌지를 알 방법이 없다는 거였습니다.

맥을 안 재우는 앱은 이미 여럿 있습니다(KeepingYouAwake, Amphetamine 등). 그런데 전부 켜짐/꺼짐 두 단계라 "지금 지키고 있나"가 눈에 안 보였습니다.

그래서 메뉴바 아이콘 모양만 보고 상태를 아는 앱을 만들기로 했습니다.

저는 프론트엔드 개발자입니다. Swift 도 AppKit 도 처음이었고, Xcode 를 써 본 적도 없었습니다.

https://github.com/badeagle85/dads-watching-this

진행 방법

어떤 도구를 사용했고, 어떻게 활용하셨나요?

Tip: 사용한 프롬프트 전문을 꼭 포함하고, 내용을 짧게 소개해 주세요.

Tip: 활용 이미지나 캡처 화면을 꼭 남겨주세요.

Tip: 코드 전문은 코드블록에 감싸서 작성해주세요. ( / 을 눌러 '코드 블록'을 선택)

쓴 도구는 Claude Code 하나입니다. 기획, 디자인, 코드, 테스트, 배포를 전부 대화로 했습니다.

긴 프롬프트를 쓰지 않았습니다. 대부분 아래 정도 길이였습니다.

시작은 질문 하나였습니다

"지금 이 컴퓨터 안꺼지게 할수있나?? ai 작업중인데.. 화면 보호기는되는데 뒤에서 세션에서 돌고있는건 멈추면안됨"

여기서 macOS 의 caffeinate 명령을 알게 됐고, 그럼 이걸 메뉴바 앱으로 만들자로 이어졌습니다.

만들기 전에 조사부터 시켰습니다

"일단 시장조사를하자, ai 시대에 노트북을 안꺼지게 옵션해야하는데 이걸 눈으로 확인 못하는 상황이 생겨 그래서 만들고 싶은데 비슷한 프로그램들을 밴치마킹해보자"

경쟁 앱 5개를 표로 정리받았고, 어디도 상태 가시성을 풀지 않았다는 빈자리를 찾았습니다. 이게 이 앱의 방향이 됐습니다.

기획서를 먼저 쓰고 시나리오를 쓴 다음 개발했습니다

바로 코드로 가지 않았습니다.

기획서에는 왜 만드나, 경쟁, 1차 범위, 범위 밖, 기술 제약, 상태 정의를 적었습니다.

시나리오에는 케이스 32개를 표로 적었습니다. 번호, 행동, 기대 결과, 출처 네 칸입니다. 못 정한 것은 빈칸으로 따로 모아 뒀습니다.

이 시나리오 표가 나중에 테스트 코드의 이름이 됐습니다. 테스트 40개가 전부 "#12 세션이 끝나면 자동 해제" 같은 식으로 시나리오 번호를 답니다.

Xcode 가 정말 필요한지 되물었습니다

"이거 만드는데 진짜 xocode 필요해??"

결론은 필요 없다였습니다. Command Line Tools 에 들어 있는 swiftc 만으로 .app 번들이 나옵니다. 빌드 스크립트가 아래가 전부입니다.

swiftc -parse-as-library -O \

-target arm64-apple-macos14.0 \

-F Vendor -framework Sparkle \

-o "$APP/Contents/MacOS/$NAME" \

Sources/*.swift

cp Resources/Info.plist "$APP/Contents/Info.plist"

codesign --force --sign - "$APP"

.app 은 그냥 정해진 구조의 폴더입니다. 그 안에 실행 파일과 Info.plist 를 넣으면 앱이 됩니다.

테스트도 AI 가 돌렸습니다

"니가 테스트해봐"

UI 클릭은 자동화가 막혀 있어서, 실제로 caffeinate 를 띄우고 더미 프로세스를 죽여 보는 테스트 하네스를 만들었습니다. 지금 40개가 돕니다.

── 세션 감시 (케이스 11·12) ──

✓ #11 세션 모드에서 caffeinate 가 뜬다

✓ #11 상태가 '세션 지키는 중'

✓ #12 세션이 끝나면 자동 해제

✓ #12 caffeinate 도 사라진다

통과 40 · 실패 0

나중에는 화면 기록 권한이 생겨서 스크린샷도 AI 가 직접 찍었습니다. AppleScript 로 메뉴를 열고 좌표를 읽어 그 영역만 캡처하는 식입니다.

결과물입니다

Swift 1,855줄, 테스트와 도구가 316줄 더 있습니다. 커밋은 28개입니다.

2026년 10월 21일에 "컴퓨터 안 꺼지게 할 수 있나"로 시작해서 10월 26일에 공개 배포했습니다.

결과와 배운 점

배운 점과 나만의 꿀팁을 알려주세요.

과정 중에 어떤 시행착오를 겪었나요?

도움이 필요한 부분이 있나요?

앞으로의 계획이 있다면 들려주세요.

하나. 기획서를 먼저 쓰니 개발이 빨랐습니다

"일단 만들어줘"로 시작했으면 몇 번을 갈아엎었을 겁니다.

기획서에 범위 밖을 적어 둔 게 특히 컸습니다. 중간에 아이디어가 떠올라도 그건 범위 밖으로 넘길 수 있었습니다.

둘. AI 가 틀린 것이 세 번 있었고, 전부 실측으로 잡혔습니다

실측하자고 하지 않았으면 그대로 갔을 겁니다. 이게 가장 큰 배움이었습니다.

첫째, 뚜껑 닫힘입니다. AI 가 caffeinate 로 막을 수 있다고 했는데, 실제로 뚜껑을 닫아 보니 5초 만에 잠들었습니다. 충전기를 꽂고 외부 모니터를 빼도 같았습니다. 두 번 실측한 뒤 기능을 아예 다시 설계했습니다.

둘째, 설치 명령입니다. brew install --cask --no-quarantine 하면 된다고 안내받았는데, 실제로 쳐 보니 그 옵션이 Homebrew 7 에서 제거돼 있었습니다.

셋째, 버그 원인 오진입니다. 테스트가 간헐적으로 실패해서 파일 디스크립터 누수로 진단하고 고쳤는데 또 실패했습니다. 진단 로그를 넣고서야 진짜 원인이 UTF-8 디코딩 실패인 걸 찾았습니다. 7MB 로그에 깨진 바이트가 하나 섞여서 전체를 못 읽고 조용히 넘어가던 거였습니다.

꿀팁이라면, 명령어든 동작이든 일단 돌려 보게 시키는 것입니다. "네가 직접 해 봐"라고 하면 됩니다.

셋. 문구는 AI 가 못 정합니다

메뉴 문구를 열 번쯤 고쳤습니다.

처음엔 화자가 섞여 있었습니다. "안 잔다", "이제 잔다"는 아빠 말인데 "화면 끄고 지키기", "아이콘 읽는 법"은 설명서 말투였습니다.

고치면서 기준을 하나 세웠습니다. 누르기 전에 무슨 일이 일어날지 알 수 있는가.

이 기준에 걸려 버린 안이 다섯입니다.

"같이 볼래?"는 기능이 안 보입니다.

"이제 주무세요?"는 안 자는 모드인데 자라는 말이라 뜻이 반대로 읽힙니다.

"내가 끌 때까지"는 내가 누구인지, 끄다가 뭘 끄는지 모호합니다.

"체력 20%"는 배터리 얘긴지 모릅니다.

"불 끄고 본다"는 불이 모호하고, 끄는데 본다니 모순입니다.

AI 는 그럴듯한 안을 빠르게 많이 냅니다. 고르는 건 사람 몫이었습니다.

넷. 배포까지 갔습니다

Homebrew tap 을 만들어 brew install --cask dads-watching-this 로 깔 수 있게 했습니다.

터미널을 안 쓰는 분을 위해 dmg 도 만듭니다. 드래그해서 설치합니다.

자동 업데이트는 Sparkle 을 썼습니다. Apple 공증은 연 99달러가 드는데 안 받았습니다. 대신 EdDSA 서명으로 동작하게 해서, 설치할 때 한 번만 격리 표시를 떼면 그 뒤로는 앱이 알아서 갱신합니다.

릴리스는 명령 한 줄입니다. 버전 올리기, 테스트, 압축, dmg 만들기, 서명, 태그, 릴리스, tap 갱신 여덟 단계를 한 번에 합니다. 손으로 하다가 appcast 갱신을 빠뜨려서 자동 업데이트가 안 가는 사고를 한 번 냈고, 그 뒤로 스크립트에 검사를 넣었습니다.

도움이 필요한 부분

영어 현지화를 아직 못 했습니다. 앱 UI 가 전부 한국어라 해외 목록에 올리기 어렵습니다. macOS 앱 문자열을 JSON 으로 관리해 보신 분 계시면 방법을 듣고 싶습니다.

앞으로의 계획

영어 현지화를 하고, 반응을 보고 Apple 공증 여부를 정하려고 합니다. 공증을 받으면 설치가 명령 네 줄에서 한 줄로 줄어듭니다.

그다음은 공식 Homebrew cask 등재입니다. 지금은 제 저장소를 tap 으로 추가해야 하는데, 등재되면 brew install 한 줄로 끝납니다.

https://github.com/badeagle85/dads-watching-this

도움 받은 글 (옵션)

참고한 지피터스 글이나 외부 사례를 알려주세요.

(내용 입력)

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.10.26

골치덩어리님, 안녕하세요! "지금 자고 있는지 아닌지를 알 방법이 없다"는 한 문장에서 출발해서, 경쟁 앱 5개를 표로 정리하다 '상태 가시성'이라는 빈자리를 찾은 흐름이 인상 깊었어요.

특히 AI가 틀린 세 가지를 전부 실측으로 잡으신 부분이 좋았습니다. 뚜껑을 실제로 닫아 보니 5초 만에 잠들었다는 것, Homebrew 7에서 --no-quarantine 옵션이 사라져 있었다는 것, 간헐 실패의 진짜 원인이 7MB 로그 속 깨진 UTF-8 바이트 하나였다는 것까지요. "네가 직접 해 봐"라는 꿀팁은 바로 가져다 쓰고 싶어요. 시나리오 32개 표가 그대로 테스트 40개의 이름이 됐다는 연결도 깔끔합니다.

프론트엔드 개발자가 Xcode 없이 swiftc만으로 5일 만에 공개 배포까지 가셨다니, 꼬리 탁! 치고 응원하고 갑니다 🐈‍⬛

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기