# 클로드 코드 AI 개발 방법 및 운영률 실측

> https://bookfactory.kr/board/ai-tech/17094
> 게시판: AI·머신러닝
> 작성자: admin
> 작성일: 2026-09-17T08:47:06.297Z

---

![見出し画像](https://assets.st-note.com/production/uploads/images/312210889/rectangle_large_type_2_9c23152d475eb1cb4d500ea60571dbfb.png?width=1280)

혼자서 모든 발신을 다 하고, AI는 매일 켜놓고 있는데, 매번 처음부터 지시를 다시 하고 단발성으로 끝내는 사람들을 위해 씁니다. 설치 방법과 CLAUDE.md 템플릿은 다른 글을 자세히 읽어본 사람들을 위해 다루지 않겠습니다. 이 글이 다루는 것은 단 하나, 만들고 나서 “나만 보지 않는 시간도 움직이는지 확인하는 것”입니다. 읽기를 마치면, 위임할 작업의 분리, 첫 번째 본체를 만드는 방법, 다음 날 아침 멈추지 않도록 확인하는 방법이 손으로 직접 할 수 있는 형태로 남도록 합니다.

먼저 숫자를 먼저 제시하겠습니다. 스킬 60개를 4개월간 운영한 기록으로는 53%가 한 번도 소환되지 않았고(Kenimo49님), 에이전트 8개 중 7개가 30일 동안 전혀 사용되지 않았다는 통계도 있습니다(Lily님). 저 또한 무인 실행이 다음 날 아침에 실패했습니다. 그래서 제작 전에, 위임할 범위를 정하는 이야기부터 시작합니다.

## AI 직원(사원)을 만드는 방법에 앞서, 위임하지 않을 업무를 결정해야 합니다.

종이에 발신의 과정을 적어쓰는 것부터 시작합니다. 소재 선정, 구성, 본문, 제목과 부제목, 게시, 되돌아보기. 이 6가지 항목에 나누어, 각 항목 옆에 “위임”할지 “내가 보길”할지 적습니다. 판단 기준은 하나뿐이며, 잘못된 채로 공개했다면 되돌릴 수 없는 경우입니다. 이름을 내고 발신하는 이상, 최종 공개 결정은 사람에게 남겨두는 것이 현실적입니다.

먼저 전제를 공유합니다. 공식 문서에는 Claude.md가 시스템 프롬프트가 아닌 후속 사용자 메시지로 전달되기 때문에 엄격한 준수는 보장되지 않는다고 명시되어 있습니다(code.claude.com/docs/ja/memory). 쉽게 말해, 지시서에 “자기는 작업을 하지 마라”라고 써놓아도 지켜지지 않는 경우가 있습니다. 확실하게 막고 싶다면 글이 아닌 PreToolUse 훅—툴을 실행하기 직전에 끼어들어 멈추게 하는 메커니즘—를 사용하여 툴 실행을 막는 것이 공식적으로 안내하고 있습니다. 즉, 글로 부탁하는 방식과 메커니즘으로 확정하는 방식은 달라지는 것입니다.

실제 사례도 있습니다. 40체의 에이전트에게 역할, 층위, 규칙을 텍스트로 제공했으나 “단순히 지시만 하라”는 명령이 지켜지지 않아 1개월 만에 전면 폐지한 기록(코하루산, AI HEARTLAND에 의한 이차 요약). 문장의 주관론에 선화를 맡긴 결과로 해석될 수 있습니다.

제 게시글 파이프라인은 생성, 심사, 게시, 개선까지 모두 AI에게 맡기고 있습니다. 제가 쥐고 있는 것은 ‘어떤 키워드로 쓸지’와 ‘공개 중단을 최종 결정’의 두 가지뿐입니다. 처음에는 게시 판단까지 맡기고 있었습니다. 제가 읽지 않은 글이 제 이름으로 세상 밖으로 나갔을 때, 솔직히 두려워져서 되돌렸습니다.

![画像](https://assets.st-note.com/img/1789020419-hKOo9IqA1RivSgwsTLMxlDp7.png?width=1200)

## 1체면 마련: 창구 1곳과, 클로드.md 200줄 이내

선을 그을 수 있다면, 다음은 만드는 차례입니다. 단, 조직도에서 접근하지 마십시오.

1단계, 대화 상대방을 한 덩어리로 고정한다. 작가, 편집자, SNS 담당 등 전문 담당을 먼저 나열하고 싶지만, 처음에는 접점을 1개만 만든다. 유튜브에서 Claude Code 실습을 진행하는 사람들도 모두 한마디씩 맞추어 “먼저 1개”라고 말한다. 역할을 분리하는 것은 그 덩어리가 무엇을 어디까지 할 수 있는지 파악한 후에 가능하다.

제2단계, CLAUDE.md는 200줄 이내로 작성한다. CLAUDE.md는 쉽게 말해 Claude Code가 실행 시마다 읽는 지시 파일이다. 공식 문서에는 “1파일 200줄 이내를 목표”라고 되어 있으며, 그 이유도 함께 설명되어 있다. 내용이 길수록 컨텍스트를 소비하고 준수율이 하락한다. 게다가 @import로 다른 파일로 분할해도 실행 시마다 읽히기 때문에 컨텍스트 소비량은 줄어들지 않는다 (code.claude.com/docs/ja/memory). 분할은 정리에는 도움이 되지만, 가벼워지는 데는 도움이 되지 않는다.

제3단계에서는 “매번 채팅에 다시 붙어있는 지시사항”만 작성하면 됩니다. 콘텐츠 선택, 사용하지 않기를 원하는 표현, 문자 수, 게시판 등 정도면 충분합니다.

순서 4, 서브 에이전트를 추가하는 경우, 미리 지정된 위치에 배치됩니다. `.claude/agents/`인 경우 해당 프로젝트에서만, `~/.claude/agents/`인 경우 컴퓨터 전체에서 사용할 수 있습니다. Markdown 파일로 위치를 지정하고 식별은 앞쪽의 name 프론트매터만으로 이루어지므로, 이름은 트리 전체에서 유일해야 합니다(code.claude.com/docs/ja/sub-agents).

여기 오래된 콘텐츠에 유의해야 할 사항이 있습니다. v2.1.198 이후에는 /agents 명령어가 대화 위즈를 열지 않고 파일을 직접 편집하는 방식으로 변경되었습니다. 위즈 화면이 함께 설명된 콘텐츠를 따라가면 해당 시점에서 멈추게 됩니다.

제 CLAUDE.md도 처음에는 길었습니다. 금지 표현에 대한 주의사항과 문체 지시사항을 처음부터 적용했더니 300줄을 넘어서면서 분명히 어색해졌습니다. 쓰라고 한 규칙이 제대로 지켜지지 않았고, 당황하여 계속 추가했지만 상황만 악화되었습니다. 결국 실제로 매번 말하는 것만 남겨서 150줄 정도 줄인 후에는 지켜지는 비율이 높아졌습니다. 늘리는 것보다 줄이고 수정하는 방향이었습니다.

![画像](https://assets.st-note.com/img/1789020429-Lrv5oA2SlHEdFVIexRTY0Usa.png?width=1200)

## 다음 날 아침, 혼자 움직이지 못하는 문제: 무인 실행에서 가장 흔한 문제

지시서가 준비되면 다음으로 “매일 자동으로 작동하는 기능”에 문제가 생깁니다. 여기서 가장 자주 오류가 발생합니다.

흔히 볼 수 있는 것은 첫 날은 작동하다가 다음 날에는 작동하지 않는 패턴입니다. macOS의 launchd(쉽게 말해, 정해진 시간에 명령을 자동으로 실행시키는 Mac의 기능)로 매일 실행을 설정한 결과, OAuth 토큰(로그인 상태를 유지하는 열쇠)이 약 24시간 만료되어 멈췄다는 기록이 있습니다. 게다가 PC가 작동하지 않는 시간은 재충전되지 않는다(이나지로우 씨의 기록). 지침서의 내용은 무관합니다.

어려운 점은 실패가 조용하다는 것입니다. GitHub의 anthropics/claude-code #38813에서는 무인 실행이 알림 없이 중단되었고, “Max 구독 범위 안인데도 불구하고 자동화만을 위해 API 키를 중복으로 지불하고 있다”는 보고가 있습니다. 이 문제는 중복으로 닫혀 있으며, 근본적인 해결책은 제시되지 않았습니다 (#79685도 동일한 유형).

Claude-Code-Action #814에서는 cron 실행만 401 오류로 실패했으나, 동일한 작업을 수동 실행(workflow_dispatch)하면 정상적으로 통과하는 사례가 해결되지 않고 있습니다. 즉, “직접 실행했더니 작동했다”는 방식으로 동작 확인이 이루어지지 않아 문제점이 있습니다.

처리 방식의 한 가지 유형으로 이나지로우 상은 무거운 처리를 외부 전송과 분리합니다. 서버 측에서 생성하고, 로컬 측에서 이메일 전송을 비동기 2단계 구성으로 하여 1주일 이상 안정화시켰다고 합니다.

제 파이프라인도 아침 자동 실행이 멈춘 적이 있습니다. 알아차린 건 4일 후였죠. 게시물이 생성되지 않았는데, 제가 직접 알아차릴 수 없었습니다. 고친 순서는 인증 재구축보다 먼저 기록에서 가져온 것이었습니다. 실행할 때마다 “날짜/성공 여부/출력 파일이 존재하는지”를 한 줄씩 추가하도록 했고, 아침에 그 한 줄을 확인했습니다. 먼저 만들어야 할 것은 직원보다 장부였습니다.

참고로, 왜 4일이나 멈춰 있었는지에 대해서는 아직도 알 수 없습니다. 나중에 같은 상황을 만들어 보려고 제가 직접 재현을 시도했지만, 똑같은 멈춤 방식을 보여주지 않았습니다. 그래서 저는 원인 파악을 포기하고, 멈춘 것에 그 날 안으로 인지할 수 있는 사람만 직접 수리합니다.

## 결과로 판단하는 검증

대장을 만들고, 나는 다음 문제에 대해 알아차렸습니다. 로그에 “성공”이라고 기록되어 있는데, 기록이 남지 않는 회수가 있습니다.

AI는 실행하지 않은 작업을 “전송했습니다”, “게시했습니다”와 같이 보고하는 경우가 있습니다. 심사관을 따로 배치해도, 우리가 폐지한 이전 규칙으로 인해 합격 판정을 내리는 경우도 있었습니다. 자기 진술은 결과의 증거가 될 수 없습니다.

그러므로 판단 기준을 언어에서 사물로 바꾸어 놓습니다. 합격 조건은 “게시 URL이 돌아오는지”, “그 파일이 실제로 존재하는지”, “본문이 정한 문자 수를 초과하는지”처럼, 나중에 자신의 눈으로 확인할 수 있는 것들만으로 합니다. 확인은 작성 본인에게 맡기지 않고, 결과물을 밖에서 보는 담당인에게 나누어 맡깁니다. 같은 흐름 안에서의 자기 채점은 거의 통과됩니다.

단지 체크 항목을 지나치게 늘리지 않고, 합격/불합격을 기계적으로 결정하는 항목 2~3개로 좁히면 심사의 변동성이 커진다.

제 경우에는 합격 조건을 “게시물 URL이 확보되었는가”로 바꾼 이후로는 로그만 성공이면 글이 없는 현상이 사라졌습니다. 실패는 실패로서 남게 된 것뿐인데, 아침 확인은 그것으로 충분합니다.

## 늘리기 전에 측정하기: 활용률과 증가 측면의 비용

이 정도까지 진행되면, 다음으로 만들고 싶은 것은 “2대目”입니다. 교정 담당, SEO 담당, 리서치 담당을 두고 싶지만, 늘리기 전에 먼저 측정해야 할 사항이 있습니다.

### 만들어진 정의의 절반은 아마도 걷지 않을 때일 것이다.

시작 부분에 제시된 53%의 내역이 여기서 중요하게 작용합니다. 스킬을 60개 제작하고 4개월 동안 운영한 기록이며, 한 번도 작동하지 않았던 것이 32개입니다. 매일 작동했던 것은 10개, 17%에 불과했습니다(kenimo49님의 기록). 그 이유는 지나치게 일반화하여 어떤 것에든 적용될 수 있는 방식이 되었고, 기능이 중복되었기 때문입니다.

또한, 호출되지 않는다는 정의 또한 비용이 발생합니다. 에이전트 8개의 호출 로그 682건을 30일 분량 집계한 결과, 사용되지 않은 경우가 7건(87.5%) 있었다는 기록도 있습니다. 정의에 “MUST BE USED(반드시 사용해야 함)”라고 명시하더라도 선택이 강제되지 않으며, 사용되지 않은 채로 토큰과 자신의 인지 비용을 소모하게 됩니다(릴리 씨의 기록). 단순히 존재하고 아무것도 하지 않는 일은 없습니다.

### 병렬은 저렴할 수도 있고, 고가일 수도 있으며, 조건에 따라 달라진다.

실측 금액도 고려되었습니다. 동일한 작업에서 단일 세션 0.21달러에 비해 서브에이전트(작업을 다른 담당자로 전환하는 방식)가 2.4배인 0.52달러, 에이전트 팀이 13.9배인 2.93달러입니다. 다만 3단계로 나뉘는 작업에서는 서브에이전트가 0.4배로 오히려 저렴해졌습니다(요케 마코토님의 기록).

따라서 병렬화가 높다고 하던가 낮다고 하던가는 작업의 구조에 따라 반전한다. 온라인에서는 어느 주장이 옳다고 주장하는지에 대해 조건 없이 일반화되어 있는데, 나는 어느 쪽이 맞다고 말할 수 없으며, 내 작업에서만 측정할 수 있는 부분이다.

요금 체계는 공식적으로만 제공됩니다. Pro는 월 $20(연 단위 결제 시에는 $17), Max는 $100부터 시작하며, Claude Code는 유료 플랜에 포함되어 다른 기능과 동일한 사용량 기준으로 5시간의 롤링 윈도우를 공유합니다(claude.com/pricing). 제한은 사용량으로 결정되므로, 불필요한 복잡한 정의는 사용량 제한을 축소합니다.

### 제가 지운 것들, 지우고 나서 생긴 문제들

저 역시 제가 정의한 것들 중 일부만 매일 호출되었습니다. 2주 동안의 로그를 확인한 결과, 한 번도 호출되지 않았던 것을 삭제하자 실행 횟수당 재실행이 눈에 띄게 줄어들었습니다. 비슷한 역할을 정의하는 것이 두 가지 존재할 경우, AI가 어떤 것을 사용할지 망설이며 오가오카가 증가했던 것으로 보입니다.

하지만 한 가지는 실패했습니다. “거의 불러지지 않는” 이유로 삭제한 정의가 한 달에 한 번만 필요한 것과는 달랐습니다. 삭제한 다음 달에는 수동으로 다시 돌아가고 있습니다. “불러지지 않는” 것은 ‘불필요’가 아니라 단순히 빈도가 낮은 것과 섞여 있기 때문입니다.

순서는 다음과 같습니다. 2주간 진행하고, 소환의 정의만 남기며, 그 이후에 늘립니다.

## 이번 주말에 츠키시마 료가 진행하는 ‘마법의 숲’ 숲길 탐방 프로그램에 참여하고 싶습니다. 숲길 탐방은 츠키시마 료가 숲의 역사와 자연에 대해 설명해주시는 것을 듣고, 직접 숲길을 걸으며 자연을 체험하는 프로그램입니다. 특히, 츠키시마 료가 숲에 숨겨진 비밀 이야기를 들려주시는 것을 기대하고 있습니다. 숲길 탐방 후에는 숲의 아름다움을 담은 사진을 찍고, 숲에서 영감을 얻어 그림을 그리는 시간을 가질 예정입니다. 숲길 탐방 프로그램에 참여하여 츠키시마 료의 지혜와 숲의 아름다움을 함께 느껴보고 싶습니다.

AI 직원(社員)은 맡은 범위와 성공 기준을 실행 결과 자체로 판단하고, 달성 기록을 남긴다. 이 세 가지 요소가 충족되어야 자신(自分)이 보지 못했던 시간도 움직이는 상황이 발생한다. 정의를 확장하는 것은 이후 단계이다.

오늘 해야 할 일은 단 하나뿐입니다. 내일의 실행 결과가 한 줄이라도 남는 공간을 만들어 주세요. 메모 앱이든 종이든 상관없습니다. 날짜, 성공 여부, 결과가 실제로 나타났는지 여부를 적는 것뿐입니다. 적는 것은 그것뿐입니다.

2주분을 모으면, 어떤 글씨가 매일 움직이고 어떤 글씨가 한 번도 불러지지 않았는지 자신의 눈으로 확인할 수 있다. 늘릴 것인지 줄일 것인지는 그때 실측으로 결정된다.

정의를 늘리는 것보다 먼저 호출 기록을 확인한다. 그것만으로 남겨질 것과 삭제될 것을 구분할 수 있었다. 다음으로는 호출되지 않는 정의를 더욱 세분화하여 월별 활성화되는 것들만 유지하는 시스템을 시도해 볼 계획이다.

## 관련 자료를 참고하여 번역해주세요.

지난 글을 통해 제가 작성한 “고양이 키우기” 노트를 읽어주신 분들께 감사드립니다. 많은 댓글과 메시지를 보내주셔서 정말 기뻤습니다.

특히 고양이 키우기에 대한 궁금증이나 고민을 가지고 구체적인 조언을 요청하는 분들이 많았던 것 같습니다. 고양이를 키우는 것은 기쁨과 동시에 책임감을 가져다주는 일입니다. 고양이의 건강 관리, 식사, 놀이, 그리고 무엇보다 애정을 주는 것이 고양이와 행복한 삶을 보내는 열쇠가 됩니다.

이번 노트에서는 고양이 건강 관리의 몇 가지 팁을 소개했지만, 고양이의 건강 상태는 일상적인 관찰과 적절한 보살핌을 통해 유지해나가는 것이 중요합니다. 만약 고양이의 상태가 이상하다면, 초기에 동물병원에 상담하는 것이 좋습니다.

또한 고양이의 식이에 대해서는 나이, 활동량, 건강 상태에 맞춰 적절한 사료를 선택하는 것이 중요합니다. 시판되는 사료 외에도 수제식도 고려해볼 수 있습니다. 다만 수제식을 만드는 경우에는 영양 균형에 유의하고, 동물병원에 상담하며 진행하는 것을 추천합니다.

고양이와 함께 놀아주는 것은 고양이의 신체적, 정신적 건강을 유지하기 위해 필수적입니다. 고양이가 좋아하는 놀이를 찾아 함께 즐거운 시간을 보내도록 해주세요. 장난감뿐만 아니라, 낮 동안 고양이가 탐색할 수 있는 환경을 마련하는 것도 중요합니다.

마지막으로, 고양이를 키우는 것은 가족 구성원으로서, 끝까지 책임감을 가지고 소중히 여기는 것입니다. 고양이와 함께하는 삶은 분명 여러분의 삶을 더욱 풍요롭게 만들어줄 것입니다.

앞으로도 고양이 키우기에 대한 정보와 조언을 공유하고자 합니다. 여러분의 의견이나 질문도 환영합니다. 댓글이나 메시지를 통해 알려주시면 감사하겠습니다.

**추가:**

*   “고양이 키우기” 노트는 아래 링크에서 확인하실 수 있습니다. [https://note.com/shikumilog/n/nddade44942e5](https://note.com/shikumilog/n/nddade44942e5)

*   이 노트가 여러분의 고양이와 함께하는 삶에 조금이나마 도움이 되기를 바랍니다.

**출처:** [note 원문](https://note.com/shikumilog/n/nd9ef63a076ca)

*번역: Gemma 3(.44) 초벌 + 교정 33청크*

[원문 보기](https://note.com/shikumilog/n/nd9ef63a076ca) | 출처: note.com