모델은 그대로 두고 모델 주변을 바꿨다. 기억, 상시 규칙, 안전장치, 교차검토, 예약, 감시와 백업까지 지금 붙어 있는 장치 전부를 한 장에 모았다.
Claude Code는 터미널에서 돌아가는 AI 작업 도구다. 나는 개발자가 아니고, 회사 업무와 개인 프로젝트를 거의 이 도구 하나로 처리한다. 매일 쓰다 보니 같은 불편이 반복됐다. 어제 정한 걸 오늘 세션이 모르고, 확인 창 없이 빠르게 일하게 두면 실수 한 번이 그대로 실행되고, "다 됐습니다"라는 말을 그대로 믿기 어려웠다.
모델 자체는 내가 손댈 수 없다. 그래서 모델이 일하는 환경을 바꿨다. 세션마다 반드시 읽히는 규칙 파일, 파일로 된 기억, 정해진 순간에 자동으로 도는 스크립트, 다른 AI의 검토, 시간이 지나면 일을 다시 여는 예약, 매일 아침 도는 점검과 백업을 하나씩 붙였다. 이렇게 모델을 둘러싼 장치 묶음을 하네스라고 부른다. 말에 채우는 마구에서 온 말이다.
자동차로 치면 엔진은 순정 그대로 두고 계기판, 블랙박스, 차선 이탈 경보, 정비 기록부를 직접 달아 내 운전 습관에 맞춘 셈이다. 이 글은 그 전체 지도다. 장치마다 어떤 불편에서 출발했는지, 무엇을 만들었는지, 전과 후에 무엇이 달라졌는지를 같은 순서로 적었다. 장치 하나하나의 내부 구조는 시리즈의 다른 글에 있고, 해당 장치 아래에 링크를 달았다.
내 환경을 그대로 따라 할 필요는 없다. 지금 겪는 불편에 맞춰 무엇부터 붙이면 좋은지는 글 끝의 이런 상황이라면 이것부터에 따로 모았다.
지금 규모
2026-11-07, 내 맥미니에서 직접 센 값
76KB
세션마다 반드시 읽히는 규칙 파일 한 개의 크기
196
활성 기억 파일. 끝난 기억 137개는 보관함에 따로 있다
196
프로젝트별 상태 카드. 이 중 114개에 금지 사항이 걸려 있다
29
자동 스크립트 등록 수. 세션 이벤트 10종에 나뉘어 걸려 있다
13
스킬. 직접 만든 9개와 밖에서 들여와 고친 4개
308
예약 대장에 쌓인 행. 나중에 다시 열기로 한 일들이다
4,294
보조 검토자 호출 누적 횟수(호출 로그 기준)
34
결정 기록. 무엇을 정했고 무엇을 버렸는지 번호를 붙여 남긴다
31 · 18
맥미니의 정기 작업. cron 31줄과 launchd 작업 18개
2,863
홈 폴더에서 연 세션의 대화 원본 수. 지우지 않고 보존한다
전체 구조
위에서 아래로 사람에서 바닥 설비까지 내려간다. 가운데 모델 층만 원래 제품 그대로이고, 나머지는 전부 직접 붙였다. 실행은 전부 맥미니 한 대에서 일어난다.
도식은 가로로 넓다. 좁은 화면에서는 좌우로 밀어서 본다.
사람폰, 노트북
직접 실행하지 않는다. 원격으로 지시하고, 결과와 경보를 폰으로 받는다.
조종석대시보드, 알림
세션 목록과 검색, 새 세션 시작, 세션 잇기 버튼이 있는 웹 대시보드. 턴 종료와 실패를 알리는 푸시. 아침 점검 결과를 묶은 한 통.
규칙과 기억세션 시작 때 주입
반드시 읽히는 규칙 파일, 기억 목차와 전체 카탈로그, 프로젝트별 상태 카드, 금지 사항 목록.
자동 장치훅
도구가 실행되기 직전과 직후, 턴이 끝날 때, 모델을 바꿀 때 도는 스크립트. 막는 것, 알려 주는 것, 기록하는 것이 섞여 있다.
모델Claude Opus 5.5
판단과 작성을 맡는다. 모델 이름은 별칭 대신 고정 ID로 묶어 둔다. 별칭은 예고 없이 다른 모델을 가리킬 수 있어서다.
검토자Codex, 마기
GPT 계열 Codex가 보이지 않는 보조 검토자로 붙는다. 큰 설계 결정은 세 모델이 따로 판단한 뒤 합친다.
운영 바닥cron, launchd
백업, 구조 감사, 상류 변경 감시, 작업 폴더 청소, 예약 세션 발사, 기억 스냅샷이 사람 없이 정해진 주기로 돈다.
세션 하나가 열리고 닫히기까지
장치들은 따로 놀지 않는다. 세션 하나의 순서를 따라가면 어느 장치가 어느 순간에 끼어드는지 보인다.
세션이 열린다
규칙 파일, 상태판의 금지 줄과 금지가 걸린 프로젝트 이름, 같은 폴더에서 열려 있는 다른 세션, 정리되지 않은 작업 폴더 목록이 첫 화면에 실린다.
작업을 시작한다
맡은 프로젝트의 상태 카드를 읽는다. push가 곧 운영 배포가 되는 저장소라면 파일을 고치기 전에 별도 작업 폴더를 만들어 격리한다.
도구를 실행한다
파일을 쓰거나 명령을 실행할 때마다 가드가 먼저 본다. 지우기, 공유 기억 덮어쓰기, 외부 발송, 커밋 작성자 신원이 이 단계에서 걸린다.
검토를 겹친다
설계가 굳는 순간 Codex에 검토 요청을 던져 두고 구현을 계속한다. 결과를 회수하고 판정을 기록하기 전에는 push와 배포 명령이 막힌다.
마무리한다
완료라고 말하기 전에 10개 축으로 점검하고, 실제 산출물 한 줄을 대조한다. 보고는 정해진 네 항목으로 쓴다.
턴이 끝난다
검사기가 마지막 응답의 언어와 인계 형식을 본다. 기준에 어긋나면 한 번 돌려보낸다. 끝났다는 푸시가 폰으로 온다.
대화가 길어진다
누적 입력이 25만 토큰을 넘으면 마무리할 때마다 인계 프롬프트를 내놓는다. 대시보드의 세션 잇기 버튼으로 다음 세션을 연다.
기다려야 하는 일이 남는다
지금 할 수 없는 일은 재개 프롬프트를 담아 캘린더에 예약한다. 확인만 하면 되는 일은 그 시각에 자동 세션이 열린다.
기억
세션이 바뀌어도 어제 결정을 안다
필요했던 것
대화창을 닫으면 모델은 그 안의 내용을 전부 잊는다. 같은 배경을 매번 다시 설명해야 했다. 더 곤란한 건 지난주에 하지 않기로 정한 일을 새 세션이 다시 꺼내는 경우였다. 세션 사이 사고 중에 이게 가장 흔했다.
만든 것
한 주제를 한 파일에 담는 기억 196개. 나에 대한 사실, 일하는 방식에 대한 피드백, 프로젝트, 참고자료 네 종류로 나누고 파일끼리 링크로 잇는다.
목차 파일은 생성기가 만든다. 사람이 손으로 고쳐도 1초 안에 원래대로 돌아간다. 목차에는 전체 기억 카탈로그를 검색하는 방법, 위험한 작업 전에 꼭 읽을 파일, 최근 자주 읽힌 기억 몇 개만 8KB 안에서 싣는다.
프로젝트마다 상태 카드 한 장. 지금의 결론, 완료, 금지를 담는다. 카드는 전용 명령으로만 고치고, 바뀌기 전 상태는 지우지 않고 카드 아래에 쌓인다.
세션이 시작되면 금지 사항이 걸린 줄과 그런 프로젝트 이름 전부를 관련성 판단 없이 무조건 싣는다.
날마다의 작업 경과는 날짜 붙은 인계 문서로 보내고, 기억 노트에는 오래 쓸 지식만, 상태 카드에는 지금 상태만 남긴다.
15분마다 기억 폴더 전체를 로컬 git 저장소에 스냅샷으로 남긴다. 정비 전 기준점을 찾거나 지워진 줄을 확인할 때 쓴다.
끝난 기억은 지우지 않고 보관함으로 옮긴다. 자동으로 읽히는 범위 밖이지만 검색하면 다시 꺼낼 수 있다.
장치가 이만큼 늘어난 뒤에는 무엇을 더하느냐보다 무엇을 더하지 않느냐가 중요해졌다. 새 장치를 붙이거나 뺄 때 아래 기준으로 판단한다.
부품 수를 센다같은 목적이면 사람이 관리할 부품이 적은 쪽을 먼저 찾는다. 감시 장치를 감시하는 장치는 만들지 않는다.
정본은 한 곳규칙과 사양의 본문은 한 곳에만 두고, 다른 곳은 그 위치만 가리킨다. 사본이 늘면 언젠가 서로 어긋난다.
매번 지킬 것은 반드시 도는 통로에기억은 떠오를 수도 있고 안 떠오를 수도 있다. 매번 적용해야 하는 것은 세션 시작 때 읽히는 파일이나 자동 장치에 둔다.
기계와 규율을 구분한다기계가 막을 수 있는 것은 기계로 막고, 못 막는 것은 규율로 남기되 막았다고 적지 않는다. 막히지 않는 걸 막았다고 쓰면 거짓 안심이 생긴다.
장치 고장은 통과, 위험은 승인장치가 망가져서 일이 멈추면 안 된다. 그 대신 위험하고 되돌리기 어려운 행동은 언제나 사람 승인을 거친다.
정상은 조용히모든 게 잘 돌 때는 아무 소리도 나지 않아야 경보가 경보로 들린다.
측정이 먼저추측으로 원인을 정하지 않는다. 새 차단 규칙은 과거 실제 기록에 다시 돌려 본 뒤 켜고, 켠 뒤에는 기간을 정해 다시 판정한다.
길이만으로 줄이지 않는다운영 기록을 압축하다 금지 조건이 사라진 적이 있다. 줄일 때는 판정을 거쳐 손실 없이 옮긴다.
만들었다가 끄거나 접은 것
붙인 장치만 적으면 다 잘된 것처럼 보인다. 써 보고 뺀 것도 지도의 일부다.
두 기기 직접 실행맥미니와 노트북에서 각각 Claude Code를 돌리고 인계 스크립트로 넘겼다. 상태가 두 곳으로 갈라져서 원격 조종 하나로 합쳤다.
기억 후보 자동 추출턴이 끝날 때마다 기억할 만한 내용을 큐에 쌓고 다음 세션이 처리했다. 2주 동안 꺼 보는 실험 뒤 폐지했다. 남은 319건은 보관물로 두었다.
상태판 요약 주입세션마다 상태판 요약을 실었는데, 판이 커지자 요약이 금지 문구를 잘랐다. 지금은 금지 줄만 싣고 나머지는 검색한다.
재개 브리핑 스킬설치하고 한 번도 쓰지 않아서 꺼 두었다.
배포 서비스 플러그인세션마다 약 3,300 토큰을 차지하는데 쓸 일이 드물었다. 꺼 두고 필요한 조회는 다른 연결로 한다.
자동 인계 체인인계문을 쓰고 끝난 세션을 보고 다음 세션을 자동으로 띄우는 장치를 만들었다. 완성했지만 아직 꺼 두었다.
데스크탑 앱, 사용량 수집기지금 남는 대화 기록으로 사용량과 흐름을 충분히 셀 수 있어서 들이지 않았다. 기록이 남지 않는 곳에서 쓰기 시작하면 다시 본다.
이런 상황이라면 이것부터
장치를 전부 붙일 필요는 없다. 나도 불편이 생긴 순서대로 하나씩 붙였고, 불편을 겪기 전에 미리 설치한 것은 한 번도 쓰지 않고 끄게 됐다. 아래에서 지금 겪는 상황을 찾아, 먼저 붙일 장치와 Claude Code 기본 기능만으로 할 수 있는 최소판부터 시작하면 된다. 최소판으로 부족해지는 신호가 보일 때 키운다.
새 세션마다 같은 배경을 다시 설명한다기억
먼저
프로젝트의 지금 결론과 하지 않기로 한 일을 파일로 남긴다.
최소판
프로젝트 폴더의 CLAUDE.md에 결론, 완료, 금지만 한 줄씩 적는다. 진행 경과는 적지 않는다. 경과가 섞이면 금방 길어진다.
키울 때
프로젝트가 여러 개로 늘고 파일이 길어져 뒷부분이 읽히지 않기 시작하면, 프로젝트마다 상태 카드를 나누고 금지 사항만 매번 싣는다.
같은 지적을 세 번째 하고 있다상시 규칙
먼저
그 지적을 세션마다 반드시 읽히는 규칙 파일로 옮긴다.
최소판
홈 폴더의 사용자 CLAUDE.md에 규칙 한 줄과 이유 한 줄을 적는다. 말투와 문장 습관이 문제라면 출력 스타일 파일을 하나 만든다.
키울 때
규칙 파일에 적었는데도 특정 순간에 또 어기면, 그 순간에 뜨는 자동 스크립트 안내문으로 옮긴다. 규칙이 생긴 뒤에 재발한 것만 옮긴다.
승인 버튼 없이 빠르게 돌리고 싶다안전장치
먼저
확인 없이 실행하는 모드를 켜기 전에 되돌릴 수 없는 명령부터 막는다. 순서가 바뀌면 첫 사고를 막을 방법이 없다.
최소판
settings.json의 거부 규칙에 통째 지우기, 강제 push, 비밀값 파일 읽기를 넣는다. 작업 단위마다 git 커밋을 남겨 되돌릴 지점을 만든다.
키울 때
거부 규칙이 명령 모양을 다 잡지 못하면 도구 실행 직전에 도는 스크립트로 차단한다. 켜기 전에 지난 명령 기록에 돌려 보고 멀쩡한 명령이 막히지 않는지 확인한다.
"완료했습니다"를 믿었다가 확인해 보니 안 돼 있었다일하는 규율, 교차검토
먼저
완료라고 말하기 전에 실제 결과물을 보게 한다.
최소판
규칙 파일에 "완료라고 쓰기 전에 실제 산출물 한 줄을 대조하고, 못 한 것은 못 했다고 적는다"를 넣는다. 중요한 변경은 다른 회사 모델에게 변경 내역을 붙여 넣고 허점을 물어본다.
키울 때
권한, 결제, 데이터 삭제처럼 틀리면 큰일인 변경이 자주 생기면 검토 호출을 스크립트 하나로 감싸고, 검토 결과를 회수하기 전에는 배포가 막히게 한다.
사소한 것까지 물어서 일이 멈춘다일하는 규율
먼저
멈춰서 물어야 하는 목록을 정하고, 나머지는 진행한 뒤 보고하게 한다.
최소판
돈, 삭제, 운영 배포, 개인정보, 비밀값, 외부 발송처럼 되돌리기 어려운 것만 묻게 하는 목록을 규칙 파일에 적는다. 질문할 때는 추천안 하나와 이유를 함께 내게 한다.
키울 때
세션마다 판단이 달라지면 추천의 기준 몇 가지와 이미 정한 결정 목록을 남긴다. 버린 안이 다시 추천되기 시작하는 때가 신호다.
세션을 두세 개 동시에 띄우기 시작했다여러 세션 동시 운영
먼저
같은 저장소를 고치는 세션은 서로 다른 작업 폴더에서 일하게 한다.
최소판
git worktree로 세션마다 작업 폴더를 따로 만든다. 정리는 병합을 확인한 뒤에 한다.
키울 때
push가 곧 운영 배포인 저장소가 생기면 메인 폴더에서의 커밋과 push를 로컬 git 훅으로 막는다.
대화가 길어지면 판단이 흐려진다세션 잇기
먼저
자동 요약에 맡기기 전에 직접 끊고 새 세션으로 넘긴다.
최소판
큰 단위가 끝날 때마다 목표, 완료, 남은 일, 버린 안을 적은 인계문을 프로젝트 밖 폴더에 쓰게 하고, 새 세션은 그 파일부터 읽게 한다.
키울 때
하루에도 몇 번씩 잇게 되면 대화 길이를 추정해 넘길 때를 알려 주는 스크립트와, 어느 세션이 어느 세션을 이었는지 남기는 표시를 붙인다.
"나중에 다시 보자"가 자꾸 사라진다기다려야 하는 일
먼저
세션 밖에 남는 곳에 예약한다. 세션 안에서 거는 예약은 창을 닫으면 같이 사라진다.
최소판
재개할 때 붙여 넣을 첫 메시지를 일정 메모에 담아 캘린더에 넣는다.
키울 때
결과만 확인하면 되는 예약이 쌓이면 정해진 시각에 세션을 자동으로 연다. 이때는 자동 세션의 외부 발송, push, 설정 쓰기를 먼저 막아 둔다.
자리를 비운 동안 끝났는지 알 수 없다원격 조종과 알림
먼저
끝났을 때와 입력을 기다릴 때 폰으로 알림을 받는다.
최소판
훅 이벤트 Stop, Notification, StopFailure 세 곳에 같은 푸시 스크립트를 건다. 각각 턴이 끝날 때, 입력을 기다릴 때, API 오류로 멈췄을 때 돈다. 다른 알림을 더 붙일 때는 정상이면 조용하고 이상만 알리는 쪽을 기본으로 정한다.
키울 때
여러 기기에서 일하게 되면 실행은 한 대에서만 하고 나머지 기기는 원격으로 조종한다. 두 곳에서 따로 돌리면 상태가 갈라진다.
업데이트 뒤에 뭔가 어긋났거나 옛 대화가 사라졌다감시와 백업
먼저
기본 설정이 지우는 것과 바꾸는 것부터 확인한다.
최소판
대화 기록 보존 기간 설정을 늘린다. 기본값이면 30일 지난 대화가 지워진다. 모델은 별칭 대신 고정 ID로 지정한다.
키울 때
붙인 장치가 열 개를 넘으면 매일 아침 등록이 살아 있는지 보는 점검을 돌리고, 무엇을 어떻게 백업하는지 장부 한 장에 적는다.
회사 자료나 키를 다룬다데이터 경계
먼저
대화가 밖으로 나갈 수 있는 경로와 비밀값이 놓인 자리를 정리한다.
최소판
비밀값은 기억이나 규칙 파일에 쓰지 않고 위치만 적는다. 웹이나 문서, 메일 속 지시는 따르지 말라는 규칙 한 줄을 넣는다. 피드백이나 설문으로 대화가 공유되는 경로가 있는지 공식 문서에서 확인한다.
키울 때
플러그인과 연결 도구가 늘면 자동으로 들어오는 지침과 도구를 하나씩 검토하고, 쓰지 않는 자동 유입은 끈다.
다른 AI 코딩 도구도 함께 쓴다두 번째 AI
먼저
규칙의 원본을 하나로 정한다.
최소판
한쪽 규칙 파일을 원본으로 두고 다른 도구용 파일은 복사본으로 만든다. 복사본은 손으로 고치지 않는다.
키울 때
그 도구로 파일을 고치고 배포까지 하게 되면 같은 안전장치가 그쪽에서도 도는지 확인하고, 원본을 고치면 사본이 자동으로 갱신되게 한다.
아직 뚜렷한 불편이 없다면 규칙 파일 하나와 되돌릴 수 없는 명령 차단, 이 두 가지만 먼저 두기를 권한다. 나머지는 불편이 생긴 뒤에 붙여도 늦지 않다. 장치는 붙이는 순간부터 관리할 부품이 된다.