Claude Code에 '작업 공간'을 맡기기: CLAUDE.md 및 claude -p의 정기 실행, 후크, 스킬 활용 사례

## 작업 방침
- 새 파일이 생성된 경우 여기에 추가하여 파악할 수 있도록 한다.
- 파일명은 `종류-일련번호_이름_v버전.확장자` (예: `TOOL-35_NoteResearch_v1.0.py`). 이전 버전은 삭제하지 않고 남긴다.

Get-Content -Raw -Encoding UTF8 .
prompt.md | 
claude -p --model <모델명> --max-turns 80 `
--allowedTools Read Glob Grep Write Edit WebSearch WebFetch

import glob, os, shutil
def find_claude():
hit = shutil.which(

후크(Hook)는 Claude Code의 움직임의 분기점(도구를 사용한 후, 답변을 마쳤을 때 등)에 정해진 명령을 실행하는 시스템입니다.

제가 넣은 것은 **컨텍스트 사용량이 상한선 30%에 도달했을 때, 해당 대화에서 한 번만 알려주는** 후크입니다. 긴 대화는 후반부로 갈수록 지시 사항 누락이 발생하기 쉬우므로, 구획을 나누어 알림을 받습니다.

설정은 사용자의 `settings.json`

（`%USERPROFILE%\.claude\settings.json`）에 작성합니다.

스크립트가 하는 일은 세 가지뿐입니다.

- 표준 입력으로 전달되는 JSON에서 대화 기록 파일의 위치와 세션 ID를 읽음
- 기록 파일의 마지막 사용량(토큰 수)을 읽고, 상한선으로 나눔
- 임계치를 초과했고, 해당 세션의 표시( `%TEMP%` 폴더의 파일)
가 없으면 메시지를 출력하고 표시를 만듦

## 4. 스킬: 진행 과정에 이름을 붙이다

스킬은 진행 과정 매뉴얼에 이름을 붙여서 필요할 때 불러 쓰는 시스템입니다. `%USERPROFILE%\.claude\skills<이름>\SKILL.md`

에 두면 모든 프로젝트에서 사용할 수 있습니다. 폴더명은 소문자 영문과 하이픈을 사용합니다.

제가 자주 사용하는 직접 만든 스킬은 두 가지입니다.

- **autorun**: 중간에 확인 과정을 거치지 않고, 완료와 확신까지 끝내는 진행 과정. 망설일 때 결정하는 표와, '되돌릴 수 없는 조작(삭제/공개 등)은 실행하지 않고 마지막 보고서에 남긴다'는 원칙입니다.
- **pre-research**: 착수하기 전에, 현황・규정 및 경위・도구 및 환경・외부 정보・선택지를 조사하여 사실과 추측을 구분한 짧은 메모를 내보낸 후 시작하는 진행 과정입니다.

뼈대는 이렇습니다.

`description`에 '이렇게 말하면 사용'을 구체적으로 작성하는 것이 요령입니다. 이름을 부르지 않아도 말투로 자동으로 로드됩니다.

## 5. 맡기지 않을 선은 규정이 아닌 시스템으로 지킨다

맡기는 범위를 넓힐수록, 맡기지 않을 선을 명확히 할 필요가 있었습니다.

- **돈이 움직이는 조작은 사람이 누른다.** 유료 기사 공개 버튼을 AI에게 누르게 하려 했더니, Claude Code의 안전장치에 막혔습니다. 지금은, AI가 설정 버튼 바로 직전까지 준비하고 마지막 버튼만 사람이 누릅니다.
- **개인 정보는 기계와 눈으로 확인한다.** 공개할 본문・이미지・zip 파일을 개인을 식별할 수 있는 단어 목록으로 검사하는 스크립트를 거칩니다. 목록은 손에만 두고, 공개물에는 넣지 않습니다. 이미지는 EXIF・GPS도 검사합니다. zip 파일은 내부 파일까지 열어서 검사합니다.
- **검증 데이터의 선은 스크립트로 끊는다.** FX(외환) 검증에서 마지막 확인으로 남겨둘 기간을 정해두고, 그 기간에 걸리는 실행은 백테스트를 돌리는 스크립트 측에서 거부합니다.

## 6. 잘 되지 않았던 것들

- **디자인은 완전히 맡길 수 없었다.** 아이콘을 두 번 연속으로 되돌려 받았습니다. 의미가 전달되는 그림은 그릴 수 있지만, 해당 분야에서 선호하는 모양을 몰랐기 때문입니다. 지금은 정기 조사를 통해 반응이 좋은 기사 제목 이미지를 매번 보고, 원칙을 노트에 모으고 있습니다.
- **같은 날 두 번 작동시키니 데이터가 덮어쓰여졌다.** 출력 파일명이 날짜만으로 결정되었기 때문입니다. AI 스스로 분석 과정에서 이를 깨닫고 노트에 적었습니다.

## 요약

- `CLAUDE.md`는 작업장의 지도. 만든 것은 AI 스스로에게 추가하게 한다 - 정기 실행은 '데이터 수집은 AI가, 생각하는 부분만 AI'. 도구는 처음부터 좁힌다.
- 후크는 AI의 외부 규칙, 스킬은 이름으로 부를 수 있는 진행 방식
- 돈・개인 정보・검증 데이터의 선은 시스템으로 지킨다

이 작업장에서 돌리고 있는 FX 자동매매 검증(결과를 보기 전에 합격선을 정하고 18가지 방법을 측정하여, 전부 떨어진 기록)은 note에 적어두었습니다.

### Discussion

![](https://static.zenn.studio/images/drawing/discussion.png)