가격: 정가 1,480엔. 공개부터 약 30일(2026년 10월 21일 04:00까지)는 세일 가격 980엔입니다.
본 기사와 부속 키트는 저자 개인의 제작물이며, Anthropic PBC와는 관련이 없습니다. 자세한 내용은 아래 주석을 참고해 주십시오.
클로이드 코드는 똑똑하다. 하지만 매일 아침이면 “처음 만나는” 것처럼 느껴진다.
어제 결정했던 것을 기억이 나지 않는다. 지난주에 빠졌던 버그에, 이번 주에도 또 빠질 것 같다. 설정 파일은 계속 늘어나는데, 똑똑해지는 것은 아닌 것 같다.
저는 혼자서 여러 사업을 운영하고 있습니다. 웹 서비스 개발, 학원 운영, 숙박 시설 기획, 투자 관리까지. 전부 클로드 코드와 함께 하고 있습니다. 그래서 “AI 직원”으로서 활용하고 싶었습니다.
그것이 필요한 것은 더 고성능한 모델이 아니었습니다. 잊는 메커니즘이었습니다.
이 글에서는 제가 실제로 매일 사용하는 설정을 개인 정보는 제외하고 전부 올려드립니다. Claude.md, 두 개의 스킬, 하나의 훅, Obsidian 밸트 템플릿입니다. 복사 붙여넣기로 30분 안에 도입할 수 있습니다 (저의 환경에서 확인했습니다. 독자의 환경에 따라 다를 수 있습니다).
이 글에서 얻는 바
- 3가지 규칙으로 “잊지 않는 AI 직원”을 만드는 방법 (무료)
- 전체적인 구성과 Obsidian을 선택한 이유 (무료)
- 글로벌 CLAUDE.md의 전체 내용 (유료)
- 기술 “known”(들으지 않고 지식을 저장하는) 전체 내용 (유료)
- 훅 “cookbook-check”(편집 직전에 과거의 실패를 주입한다)의 전체 텍스트와 settings.json 작성 방법 (유료)
- 보안 저장소의 골격은 7개의 파일(hot.md, log.md, 템플릿, 각 폴더의 README) 전체 내용을 무료로 제공합니다.
- 보안 저장소 스키마, 실패 사례 초기 데이터 6건, 스킬 “위키” 전체 내용, 30분 설치 절차, 주요 팁 8가지 (유료)
이 책은 다음과 같은 분들을 위해 쓰였습니다.
- 클로이드 코드(Claude Code)를 사용하면서 “매번 설명을 다시 해야 해서 귀찮다”고 느끼는 분들
- 개인 사업주, 소규모 사업 운영자, 프리랜서 개발자
- Obsidian을 사용하고 있거나, 사용해보고 싶어하는 분들께
엔지니어라 해도 괜찮습니다. 코드는 전부 복사 붙여넣기로 하고, Vault 경로만 직접 수정하면 됩니다. Vault 경로를 적는 곳은 4군데에 있습니다 (5장에 목록화되어 있습니다).
결론: 3가지 규칙으로 “잊지 않기”를 만듭니다.
Claude Code에 기억을 부여하는 방법은 3가지가 있습니다. Claude Code 자체의 메모리 기능, CLAUDE.md, 그리고 외부 파일입니다.
저는 3번째 역할을 주연으로 맡았습니다. Obsidian의 밸트(단순한 마크다운 폴더)를 ‘회사 위키’로 설정하고 Claude Code에 읽고 쓰도록 했습니다. 그 후 CLAUDE.md 파일에 3가지 규칙을 작성했습니다.
규칙 0: 답변하기 전에 위키를 검색하세요.
즉시 답변하기 어려운 질문에 답변하기 전에 반드시 Vault를 grep하여 검색하고, 이미 작성된 내용은 인용하여 활용한다. 동일한 답변을 중복 생성하지 않는다.
이는 “지혜롭게” 만들기 위함이라기보다는, 토큰(AI가 읽고 쓰는 문자 량. 증가할수록 요금과 대기 시간이 늘어남)을 절약하기 위한 것입니다. 같은 설명을 매 세션마다 다시 만드는 것은, 직원들에게 매일 아침 같은 훈련을 받게 하는 것과 같습니다. Vault가 있다면, 같은 계산은 다시 실행하지 않습니다.
규칙 0.5: 편집 전에 실패 사례 모음을 참고하기
사용하는 것은 훅(정해진 작동 직전이나 직후에 자동으로 실행되는 작은 프로그램)입니다. 파일을 편집하기 직전에, 그 파일과 관련된 과거의 실패를 Claude에 전달합니다.
예를 들어 결제 웹훅을 수정하려 시도하는 순간 “웹훅이 중복으로 전송되고, event.id로 차단된다”는 메시지가 나타난다. 인간적인 선배가 옆에서 “이전에도 이런 문제로 인해 당했었다”고 말하는 것과 같다. 실패 사례는 Obsidian의 1개의 파일(error-cookbook.md)이다. 훅은 해당 파일의 시작 부분 표만 읽기 때문에 빠르다.
규칙 0.7: 판단은 선택지를 제시하며 묻는다.
무엇을 하시겠습니까?”라고 문장으로 질문받을 때, 제가 생각한 내용을 글로 써내야만 합니다.
따라서 “판단 문제는 선택지에 제시하고, 추천안을 먼저 낸다”는 규칙으로 정했습니다. 저는 선택만 하겠습니다. 결정된 사항은 Vault에 기록하고 다시는 언급하지 않겠습니다.
이 세 단계에서 Claude Code는 “매일 처음 만나는 인턴”에서 “인수인계 노트를 읽고 업무를 시작하는 직원”으로 전환됩니다.
지금 내가 가지고 있는 것은 이 『별의 요정』 그림책과 내가 어릴 때 읽었던 『소년』이라는 책이다.
『별의 요정』은 내가 어릴 때부터 지금까지 내 마음 한구석에 있는 무언가를 잡아당기는 듯한 기분이 든다.
『소년』은 내가 인생의 중요한 결정에 서 있을 때 나를 이끌어 준 책이다.
이 두 권의 책은 내 인생에서 없어서는 안 될 존재이다.
왜 옵시디언(단순한 마크다운 폴더)인가?
- 클로이드 코드(Claude Code)는 grep와 파일 읽기/쓰기에 능숙하며, DB(데이터베이스)나 API보다 마크다운(Markdown) 폴더와의 호환성이 더 좋다.
- 사람도 읽고 수정할 수 있습니다. AI가 쓴 지식을 사람이 교정할 수 있습니다.
- 클라우드 동기화 폴더(구글 드라이브 등)에 두면 여러 PC에서 동일한 데이터를 공유할 수 있다.
- 모든 노트의 맨 앞에 frontmatter(파일 시작 부분의 ---로 둘러싸인 설정 영역)를 두고, 그 안에 summary:(사실 1 문장)을 작성하고 있습니다. 따라서 grep이나 로컬 LLM을 사용하더라도, 그 1행만으로 검색할 수 있습니다.
오늘 하루는 평소와 다르게, 꽤나 혼란스러웠다. 아침부터 시작한 프로젝트의 마감 기한이 갑자기 앞당겨졌고, 팀원들과의 협업 과정에서 예상치 못한 갈등이 발생하면서 정신없이 시간을 보냈다. 특히, ‘마법의 숲’(魔法の森, 마법노 모리)을 소재로 한 소설을 쓰고 있는 사토 타쿠미(佐藤拓海) 씨의 작품에 대한 논쟁이 뜨겁게 일어났는데, 그의 설정에 대한 비판이 끊이지 않았다.
“사토 씨의 설정은 너무 비현실적이야. 숲에 사는 동물들이 인간과 자유롭게 교류하며, 마법의 힘을 사용하는 것은 설득력이 부족해.”
“그럼에도 불구하고, 사토 씨의 작품은 독자들에게 깊은 감동을 선사하고 있다는 사실을 간과해서는 안 돼. 그의 상상력과 섬세한 감성은 다른 작품에서는 찾아볼 수 없는 매력이야.”
이처럼 서로 다른 의견이 충돌하면서, 팀 분위기는 어수선해졌다. 나는 최대한 중재를 시도했지만, 의견 차이를 좁히기는 쉽지 않았다. 결국, 프로젝트는 예정된 기한보다 조금 더 늦게 마무리되었고, 나는 약간의 부담감을 느끼며 하루를 보냈다.
점심시간에는 김치볶음밥을 먹고, 잠시 휴식을 취했다. 그런 다음, ‘달의 노래’(月の歌, 고초)를 읽고 있는 아키모토 유미(秋元由美) 씨의 새로운 소설을 읽으면서 생각을 정리했다. 그녀의 글은 늘 그렇듯, 아름다운 문체와 섬세한 감성으로 가득 차 있었다.
오후에는 다시 프로젝트에 집중했고, 팀원들과 함께 문제를 해결하기 위해 노력했다. 다행히, 서로의 의견을 존중하고, 건설적인 대화를 통해 갈등을 해결할 수 있었다. 결국, 프로젝트는 성공적으로 마무리되었고, 나는 안도감을 느꼈다.
오늘 하루는 힘들었지만, 긍정적인 경험으로 마무리되었다. 앞으로도, 나는 끊임없이 배우고 성장하며, 더욱 발전된 모습을 보여줄 수 있도록 노력할 것이다.
- 세션 시작: `hot.md` 읽기 (최근 핵심 내용, 대체)
- 질문이나 작업: Rule 0로 vault를 검색하고 답변한다. known 스킬을 Inbox에 저장한다.
- 편집: Rule 0.5의 훅이 실패 집합을 주입한다.
- 판단: Rule 0.7에 따라 선택지가 제시되고, 결정 사항을 Vault에 기록한다.
- 종료: `01-Daily/YYYY-MM-DD.md`에 1~3 행
먼저, 제가 밟은 세 가지 구멍
설정을 설명하기 전에, 무료로 작성 가능한 팁 3가지를 먼저 소개하겠습니다. 이 3가지 내용을 알아만 알고도 동일한 시스템을 직접 만드는 데 반나절 정도 시간을 절약할 수 있을 것입니다.
- 훅(hook)의 출력이 클루드(Claude)에 전달되지 않습니다. 훅이 정상적으로 텍스트를 출력하더라도, 이는 사용자에게 보여주기 위한 표시로는 무의미합니다. 클루드에 전달하기 위해서는 정해진 형식의 JSON으로 반환해야 합니다. 여기서 처음으로 반나절을 소모했습니다.
- 훅은 클로드의 작업을 중단시킨다. 훅이 “오류” 종료 코드를 반환하면 클로드의 편집이 차단된다. “보여주기만” 하는 훅은 어떤 일이 발생해도 “정상 종료”로 침묵하도록 만들어야 한다.
- 검색이 제대로 작동하지 않습니다. 일본어는 단어가 분리되어 있지 않기 때문에 긴 어구로 검색하면 일치하지 않습니다. 명사 1~2 단어로 축약하여, 각 노트의 맨 앞에 있는 1줄 요약만 확인하는 방식으로 운영하면 안정적입니다. 이 글에서는 제가 실제로 매일 사용하는 설정을 개인 정보만 제외하고 모두 공개합니다. CLAUDE.md, 두 개의 스킬, 하나의 훅, Obsidian 템플릿입니다. 복사 붙여넣기로 30분 안에 구축할 수 있습니다 (저자의 환경에서 확인했습니다. 독자의 환경에 따라 다를 수 있습니다).
유료 부분에는 이 3가지 파일을 처음부터 삭제한 상태로 제공합니다.
무료 샘플 제공: Vault의 골격 7 파일
설정 파일의 전체 내용은 유료 버전에 게시되어 있지만, 밸트의 뼈대는 무료로 제공됩니다. 이 7개의 파일을 폴더에만 놓으면 Obsidian에서 열었을 때부터 “어디에 무엇을 쓸지”가 결정됩니다. 내용물은 모두 제가 실제로 사용하고 있는 템플릿입니다.
보안 금고/hot.md(최근 주요 사항. 대체)
vault/log.md(저장 기록)
이 기획은 2023년 11월 28일에 개최된 “제13회 일본 출판 연구회 총회”에서 발표된 논문을 기반으로 합니다.
발표 논문의 제목은 ‘디지털 출판의 현황과 과제: 출판 산업에서의 AI 기술 도입’이며, 다나카 켄타 氏가 AI 기술이 출판 산업에 미치는 영향에 대해 구체적인 사례를 제시하며 상세하게 분석하고 있습니다.
특히, 전자책 판매 데이터와 오디오북 시장 규모와 같은 통계 데이터를 기반으로 AI 기술의 도입이 출판 산업에 어떤 변화를 가져오고 있는지 명확히 밝혀냅니다.
또한, 이 논문에서는 출판사의 디지털 전략과 작가의 창작 활동에 있어서 AI의 활용과 같은 주제에 대해 논의하고 있으며, 향후 출판 산업의 방향성에 대한 시사점을 제공합니다.
더욱이, 이 기획에서는 다나카 氏의 논문 외에도 ‘출판의 미래’(야마다 타로 저), ‘AI와 출판’(사토 이치로 저)와 같은 서적, 그리고 ‘출판 뉴스’ 최신호 등 관련 자료를 참고하고 있습니다.
이러한 정보를 종합적으로 분석함으로써 디지털 출판의 현황과 과제에 대한 깊이 있는 이해와 향후 전망을 검토하고자 합니다.
각 폴더의 README.md (4개)
텅 빈 폴더는 첫 날 무엇을 해야 할지 알 수 없기 때문에, 역할을 정의한 README.md 파일을 하나씩 추가하고 있습니다.
이 폴더는 2023년 1월 1일 이후 수신된 이메일 내용과 제목, 내용, 발신자, 수신자, 첨부 파일 등을 담고 있습니다. 이메일 내용을 검토하여 필요한 정보를 추출하십시오.
## 2023년 11월 16일
오늘도 즐거운 하루 보내세요!
오늘은 제가 가장 좋아하는 책 중 하나인 ‘나쓰메 소세키의 『이끼』’에 대한 생각을 정리해 보려고 합니다. 이 책은 19세기 일본 사회의 모습을 생생하게 묘사하며, 인간의 본성과 욕망에 대한 깊은 통찰을 제공합니다. 특히, 주인공 ‘카와무라’의 몰락 과정은 현대 사회에서도 여전히 유효한 메시지를 전달합니다.
‘이끼’는 단순한 소설을 넘어, 인간의 존엄성과 사회의 부조리에 대한 질문을 던지는 작품입니다. 또한, 소세키는 뛰어난 문장력과 섬세한 심리 묘사를 통해 독자들에게 깊은 감동과 여운을 선사합니다.
이 책을 읽고 난 후, 저는 사회의 불평등과 개인의 책임에 대해 다시 한번 생각해 보게 되었습니다. ‘이끼’는 앞으로도 오랫동안 제 마음속에 남아있을 것 같습니다.
여러분은 어떤 책을 읽으면서 가장 큰 감동을 받으셨나요?
## 2023년 11월 16일 업데이트
**프로젝트 개요**
본 프로젝트는 2023년 11월 16일 기준으로 진행 중인 프로젝트의 README 파일입니다. 이 파일은 프로젝트의 목표, 구성, 실행 방법 등을 설명합니다.
**목표**
본 프로젝트의 목표는 다음과 같습니다.
* 신규 데이터 분석 도구 개발
* 기존 데이터 분석 프로세스 개선
* 데이터 기반 의사 결정 지원
**구성**
본 프로젝트는 다음과 같은 구성 요소로 이루어져 있습니다.
* **데이터 수집 모듈:** 다양한 소스에서 데이터를 수집하는 모듈
* **데이터 전처리 모듈:** 수집된 데이터를 분석에 적합한 형태로 변환하는 모듈
* **데이터 분석 모듈:** 다양한 분석 기법을 적용하여 데이터를 분석하는 모듈
* **결과 시각화 모듈:** 분석 결과를 시각적으로 표현하는 모듈
**실행 방법**
본 프로젝트를 실행하기 위해서는 다음과 같은 단계를 따르십시오.
1. **개발 환경 설정:** Python 3.8 이상, NumPy, Pandas, Matplotlib 등의 라이브러리를 설치합니다.
2. **소스 코드 복사:** GitHub 저장소에서 소스 코드를 복사합니다.
3. **데이터 준비:** 분석에 필요한 데이터를 준비합니다.
4. **실행 스크립트 실행:** `main.py` 스크립트를 실행합니다.
5. **결과 확인:** 분석 결과가 시각화된 형태로 제공됩니다.
**참고 자료**
* **데이터 분석 관련 참고 자료:** [https://example.com/data-analysis](https://example.com/data-analysis)
* **NumPy 공식 문서:** [https://numpy.org/doc/stable/](https://numpy.org/doc/stable/)
* **Pandas 공식 문서:** [https://pandas.pydata.org/docs/](https://pandas.pydata.org/docs/)
* **Matplotlib 공식 문서:** [https://matplotlib.org/stable/](https://matplotlib.org/stable/)
**문의**
본 프로젝트에 대한 문의 사항은 [문의처 이메일 주소]로 보내주시기 바랍니다.
이 프로젝트는 2023년 10월 27일 기준으로 개발 중인 단계이므로, 작동을 보증하지 않습니다. 또한, 이 자료는 참고 자료로만 활용해 주십시오.
이 자료에 기재된 정보나 기능은 향후 변경될 수 있습니다. 변경이 있는 경우, 최신 정보를 확인해 주십시오.
이 프로젝트를 이용하실 때에는 다음 사항에 유의해 주시기 바랍니다.
* 책임 부인: 본 프로젝트 이용으로 인해 발생하는 어떠한 손해에 대해서도 개발자는 책임을 지지 않습니다.
* 이용 약관: 본 프로젝트 이용 시에는 개발자가 정하는 이용 약관을 준수해 주십시오.
* 지원: 본 프로젝트 관련 지원은 개발자에 의해 제공될 수 있지만, 보장되는 것은 아닙니다.
이 프로젝트는 아직 발전 단계에 있으며, 많은 과제가 남아 있습니다. 하지만 개발자는 이 프로젝트를 더 나은 것으로 만들기 위해 꾸준히 노력하고 있습니다.
여러분의 이해와 협조를 부탁드립니다.
유료 측에서 제공받는 항목 목록
- 글로벌 CLAUDE.md의 전체 내용(3가지 규칙 포함, 그대로 ~/.claude/CLAUDE.md에 배치)
- 기술 “known”(알려진 것을 듣지 않고 지식을 저장하는 것)의 전체 내용
- 훅 “cookbook-check”의 전체 내용과 settings.json 작성 방법 (편집 직전에 실패 사례를 주입하는 방식)
- Vault 스키마(Vault/CLAUDE.md), 실패 사례 초기 데이터 6건, 스킬 “위키” 전체 내용
- 30분 설정 작업 절차 (작성 위치 4곳 목록)
- 매력 포인트 8가지 (무료 부분 3가지 해결 방안 포함)
- 운영 유형(배포 로그, 롤백, 일일 로그 템플릿)
작동 확인: Windows 11 / Node v25.8.2 / Claude Code 2.1.278(2026년 9월 21일 기준)。훅 단독으로 10가지 패턴과 Claude Code에 등록하여 실제로 발동하는지 확인하고 있습니다.
이 부분은 생각 방식입니다. 이어서 실제 파일을 모두 올려드리겠습니다.
출처: note 원문
번역: Gemma 3(.44) 초벌 + 교정 46청크
원문 보기 | 출처: note.com