Claude Code를 「사용」하는 단계에서 「육성」하는 단계로 ― 환경 구축 시리즈 총정리

hook의 지연을 측정하는 이야기까지 계속해 온 「Claude Code 환경」 시리즈의 최종회입니다.

지금까지 하나씩 「기억」, 「스킬」, 「비용」, 「자기 수복 (Self-healing)」과 같은 부품들을 만들어 왔습니다. 이 최종회에서 할 일은 두 가지입니다. 하나는 그 부품들을 하나의 지도 위에 다시 나열하여, 개별 기사에는 쓰지 않았던 「부품 간의 연결성」과 모든 내용에 관통하는 설계 원칙을 언어화하는 것입니다. 다른 하나는 마지막까지 읽어준 분들이 가장 알고 싶어 할 질문 ―― **「그래서, 이 환경은 결국 어떻게 되었나요?」**에 정면으로 답하는 것입니다.

전반부는 기술적인 정리(새로운 코드는 나오지 않습니다)입니다. 후반부에는 이 환경이 실제로 무엇을 만들어냈는지 ―― 돈 이야기까지 포함하여 ―― 솔직하게 쓰겠습니다.

작성한 기사들을 역할별로 나열하면 다음과 같습니다.

• 4층 구조의 기억 아키텍처 (Memory Architecture) ― 세션을 넘나들며 문맥을 유지하는 토대

• 대화 로그를 기억으로 바꾸기 ― 모든 세션을 Obsidian Vault로 자동 투입하여, 조작을 방지하는 ground truth로 만들기

• 자기 증식하는 스킬 ― 재사용 가능한 절차를 요청하지 않아도 스스로 스킬화하도록 함

• Codex와 Claude의 협업 ― 설계는 Claude, 구현은 Codex에 맡기는 역할 분담

• push 전의 비밀 가드 (Secret Guard) ― commit/push 시 API 키나 PII(개인 식별 정보)를 자동으로 차단

• 매일 아침 GitHub 순회 ― 유용한 OSS나 스킬을 자동으로 발견 및 채점

• autopilot으로 자율 주행 ― 잔량 cap과 자기 신고의 실측값 대조

• 비용 시각화 ― 얼마를 사용하고 있는지를 터미널에 표시

• 자동화 생사 확인 (Liveness Monitoring) ― 「고장 났을 때만 빨간불이 들어오는」 방식의 건강 진단

• 환경 맵 매일 아침 자동 생성 ― PC, Claude, 프로젝트를 Mermaid 다이어그램으로 조망

• 프로젝트 장부와 symlink 트리 ― 계속 늘어나는 프로젝트를 8개 카테고리로 정리

• 컨텍스트 비대화 억제 ― 주입되는 문맥을 필요한 만큼만 압축

• launchd의 함정 ― macOS의 정기 실행에서 빠지기 쉬운 함정

• hook의 지연 측정 ― hook의 p95를 wrap 한 줄로 측정

이 부분이 개별 기사에서는 쓸 수 없었던 부분입니다. 위의 14개 주제는 서로 다른 테마처럼 보이지만, 사실은 **하나의 루프 (Loop)**를 돌리고 있습니다.

┌─────────────────────────────────────────────┐
│ │
▼ │
...

• 기억이 「어제까지의 문맥」을 전달하고, 이를 바탕으로 스킬 (절차)이 선택되며, 자율 주행 (launchd)이 무인으로 실행되고, 그 결과를 시각화/모니터링이 관측한다.
• 무인으로 작동하기 때문에 가드 (비밀 스캔, owner 검증)가 필요하며, 고장 나면 자기 수복이 복구한다. 그리고 수복 로그와 실측값이 다시 기억으로 돌아가 다음 판단의 재료가 된다.

부품을 단독으로 넣어도 효과가 없습니다. 「기억이 있기에 스킬이 자라나고, 스킬이 자라나기에 자율 주행이 가능하며, 자율 주행을 하기에 모니터링과 가드가 필요하다」는 의존의 연쇄로 이루어져 있으며, 루프가 닫혀야 비로소 「내버려 두어도 돌아가는 환경」이 됩니다. 연재를 순서대로 읽으면 부품을 만드는 법은 알 수 있지만, 이 연결 방식이야말로 본체였습니다.

다시 나열해 보면, 서로 다른 테마처럼 보여도 같은 사고방식이 몇 번이고 등장했습니다.

이 시리즈에서 가장 반복했던 것은 이것입니다. Claude는 「했습니다」, 「3개의 기사를 공개했습니다」라고 말하지만, 그 말과 실체는 어긋납니다. 그래서 대화 로그는 ground truth로서 실제 파일을 정답으로 삼고, autopilot은 자기 신고 횟수를 실측값과 대조하며, hook 측정에서는 「mean(평균)은 이상치 때문에 망가지므로 p95를 본다」고 결론지었습니다. AI에게 맡길수록, 검증은 인간(과 스크립트)이 쥐어야 합니다.

생사 확인의 핵심은 「정상일 때는 침묵, 이상할 때만 RED FLAG가 나타나는」 설계였습니다. 매일 아침 「모두 OK입니다」라는 알림이 오는 시스템은 3일이면 아무도 읽지 않게 됩니다. 침묵을 기본값(Default)으로 설정하고, 일탈만을 눈에 띄게 만든다. 자기 수복도 마찬가지로, 고쳤을 때는 조용히, 고치지 못했을 때만 인간을 호출합니다. 알림의 수는 신뢰도와 반비례합니다.

무인으로 작동할수록 사고는 조용히 퍼집니다. 비밀 가드는 push 전에 PII를 차단하며, launchd 기사에서는 「launchd 직접 실행에는 hook이 적용되지 않으므로 스크립트 내에 자체적으로 비밀 스캔을 재구현해야 한다」는 함정을 다루었습니다. 사람의 손길이 빠진 경로일수록 가드를 이중으로 설치한다. 단 한 번이라도 API 키를 push하면 되돌릴 수 없습니다.

스킬의 자기 증식도 프로젝트 분류도, "처음에 완벽한 체계를 만드는" 것이 아니라 "사용하면서 더하고, 정기적으로 솎아내는" 운용 방식이었습니다. 스킬은 30일간 미사용 시 stale(정체), 90일이면 아카이브. 늘리는 메커니즘과 줄이는 메커니즘을 세트로 갖추기 때문에, 비대해지지 않고 성장합니다. 분재와 마찬가지로, 뻗어나갈 가지와 자를 가지를 모두 결정하기 때문에 형태가 잡힙니다.

설계도가 처음에 있었던 것은 아닙니다. 부품을 하나씩 더하다 보니 지금 이렇게 되었습니다.

• launchd에 등록된 자동화:
  30개 - 직접 쓰게 하며 키워낸 스킬:
  85개 - 이 연재 자체:
  14편 (심지어 집필 → 썸네일 생성 → 비밀 스캔 → 공개까지 자동화되어 있음)

숫자를 자랑하고 싶은 것이 아니라, "하나씩 더하기"를 계속하면 여기까지 올 수 있다는 실례로서 남겨둡니다. 처음부터 30개의 launchd를 설계하려고 했다면, 아마 단 하나도 완성하지 못했을 것입니다. 작게 시작해서, 고장 나면 고치고, 다시 더한다. 그뿐입니다.

만약 지금 제로에서부터 구축한다면, 의존의 연쇄를 따라 이 순서로 넣겠습니다.

기억 (4개 층) ― 이것이 없으면 아무것도 쌓이지 않는다. 가장 먼저 한다. -
비밀 가드 ― 자동화를 추가하기 전에, 사고를 막는 그물을 먼저 친다. -
스킬의 자기 증식 ― 절차(Procedure)가 쌓이기 시작한다. 여기서부터 가속한다. -
launchd로 딱 1개만 자율 주행 ― 작게 무인 실행을 체험한다. 첫 번째 1개가 가장 무섭다. -
생사 확인(Liveness monitoring) ― 자율 주행을 늘리기 전에 "고장 나면 알 수 있는" 상태로 만든다. -
나머지는 더하기만 하면 됨 ― 감시와 가드가 있으므로, 안심하고 수를 늘릴 수 있다. -

역순(먼저 대량의 자동화, 나중에 가드)으로 하면, 조용한 사고로 큰 코를 다칩니다. 가드와 감시를 "늘리기 전"에 배치하는 것이 유일하고도 최대의 요령이었습니다.

기술적인 정리는 여기까지입니다. 하지만 솔직히 말하자면, 제가 이 환경을 구축한 동기는 "Claude Code를 편리하게 사용하고 싶다"는 것만이 아니었습니다. 살기 위해서였습니다.

처음에는 월 10만 엔이었습니다. 대학에 다니면서 아르바이트 느낌으로 벌던 수입.

거기서 여러 회사를 병행하며 어느덧 월 60만 엔. 학생치고는 꽤 잘하고 있다고 생각했습니다.

——그 모든 것이, 어느 날 한꺼번에 사라졌습니다. 회사 사정에 의한 해고. 수입은 제로.

쌓아 올렸다고 믿었던 것들이 순식간에 무너져, "나에게는 아무것도 남지 않았다"고 진심으로 생각했습니다.

하지만, 단 하나 남아 있었습니다. **"내 손으로 무언가를 계속 돌리는 메커니즘을 만드는 힘"**이었습니다.

그로부터 반년, Claude Code를 파트너 삼아 이 연재에서 써왔던 자율 환경을 제로에서부터 구축했습니다. 기억 · 스킬 · 자동화 · 가드 ―― 부품을 하나씩 더해, **거의 무인으로 콘텐츠와 앱을 계속해서 만들어내는 "공장"**을 세웠습니다. 어느덧 launchd 30개 · 스킬 85개. 그리고 수입은 월 120만 엔까지 돌아와 있었습니다.

돌아올 수 있었던 이유는 근성이 아닙니다. "자는 동안에도 돌아가는 메커니즘"을 가졌기 때문입니다. 제로로 떨어졌던 그날의 자신에게 한 마디만 할 수 있다면, 이렇게 말하겠습니다 ―― "계속해라. 네가 만드는 "메커니즘"만큼은, 누구도 해고할 수 없다".

이 환경은 단순한 작업 효율화로 끝나지 않았습니다. 30개의 launchd와 85개의 스킬이, 지금 **콘텐츠(제휴 마케팅 기사 · YouTube 대본 · 기사 배포)와 앱(iOS 마이크로 앱 양산 → 심사 제출)을 거의 무인으로 계속 생산하는 「공장」**으로서 작동하고 있습니다. 원가는 거의 제로 ―― API 과금은 Claude Max의 할당량과 무료 티어(Free Tier)만으로 돌리고 있기 때문입니다.

무료 연재가 「장기를 만드는 법」이었다면, 남은 것은 그것을 전부 연결해 "수익을 창출하는 시스템"으로 움직이는 이야기입니다. 구체적으로는,

• 어떤 부품이 어떻게 돈으로 바뀌고 있는가 (메커니즘의 전체도)
• 각 채널의 실제 숫자와 구축 과정에서 막혔던 부분
• 제로에서 시작하는 순서 (첫 1엔이 발생하기까지의 최단 경로)
• 구매자를 위한 지속적인 서포트

이것을 note의 유료 기사에 전부 정리했습니다.

출시 기념으로 저가로 시작합니다. 읽히는 부수가 늘어날 때마다 가격을 올릴 예정이므로, 빨리 읽을수록 저렴합니다. 관심 있는 분은 공개 직후를 추천합니다.

이와 병행하여, 이 환경에서 실제로 무엇을 만들었는지에 대한 연재도 시작합니다. 「개인 개발 양산」 시리즈 ―― 하루 만에 iOS 앱을 구상하여 심사 제출까지 하는 양산 플로우나, 제휴 마케팅 기사를 매일 아침 자동으로 공개하는 메커니즘 등, 공장의 내부를 하나씩 열어보겠습니다.

지금까지 함께해 주셔서 감사합니다. 환경을 「사용」하는 것에서 「육성」하는 단계로 ―― 그리고, 육성한 환경은 제대로 당신을 먹여 살려줄 것입니다. 이 연재가 누군가의 첫 번째 부품이 된다면 기쁘겠습니다.

Lily（@bokuwalily）― 개인 개발자. Claude Code로 자동화 기반을 구축하며, iOS 앱과 Web 서비스를 양산하고 있습니다.

• 만든 앱은 포트폴리오 (Portfolio)에 정리해 두었습니다📱
• 최신 소식 및 개발 뒷이야기는 X @bokuwalily 에서 발신하고 있습니다🌍
• OSS: github.com/bokuwalily 🐙

여러분의 ❤️와 공유가 큰 힘이 됩니다!