#claude-code

API 키가 아니라 구독(OAuth) 계정으로 Claude Code 를 cron 스케줄러에서 무인 실행하며 만난 함정 4개와 해결을 정리했습니다. 컨테이너 안에서 1회 로그인하고 설정 디렉토리를 볼륨으로 영속시키는 구성입니다.

다른 레포를 --add-dir 로 열면 hooks·권한이 따라오지 않고 /cd 로 옮기면 원래 레포 규칙을 잃는데, 레포마다 세션을 두고 SendMessage 로 요청하면 각자 자기 하네스대로 작업합니다.

코딩 에이전트의 할 일을 애플 미리알림과 동기화하는 하네스입니다. 제목 대신 메모(body)에 세션별 고유 키를 심어 여러 세션이 리스트 하나를 공유해도 서로의 항목을 건드리지 않고, 세션 종료 시 자동 정리됩니다.

맥 미리알림을 AppleScript로 제어하면 섹션·태그는 다룰 수 없지만 깃발로 대신할 수 있고, 항목 참조를 변수에 담아 속성을 쓰면 속성당 5초가 붙어 참조 없이 한 번에 쓰면 9배 빨라집니다.

Claude Code statusLine 은 rate_limits 가 Pro/Max 첫 응답 이후에만 와 jq // empty 로 방어해야 하고, 브랜치는 JSON에 없어 git 으로, epoch 는 BSD·GNU date 를 둘 다 폴백해야 합니다.

CodeGraph는 코드베이스를 로컬 SQLite 그래프로 미리 인덱싱해 호출 관계·블라스트 반경·소스를 explore 한 번으로 돌려주고, 데이터가 기계 밖으로 나가지 않아 grep 반복 탐색을 줄입니다.

AI 에이전트가 길어질수록 둔해지는 건 cat·grep 같은 툴 출력이 통째로 컨텍스트에 쌓이기 때문인데, context-mode 는 샌드박스에서 코드로 처리해 결과만 꺼내 hook 적용 시 약 98% 토큰을 절감합니다.

Hooks 는 모델이 언제 깨어나는지가 아니라 깨어난 뒤 행동을 강제하는 가드레일로, PreToolUse 훅이 exit code 2 를 내면 프롬프트와 달리 결정론적으로 도구 호출을 차단합니다.

외부 이벤트가 오면 즉시 claude -p 를 실행하는 webhook 구조로, PR 리뷰 자동화에 적용해 호출 수를 1/10, 응답은 거의 즉시로 줄였습니다. 페이로드는 execFile 로 넘겨야 셸 인젝션을 막을 수 있습니다.

claude -p 를 cron 이나 Node 스케줄러로 직접 호출하는 방식으로, 사내망 접근·데이터 통제엔 유리하지만 cron 의 PATH·인증 누락과 토큰 폭주, 프롬프트 인젝션을 직접 막아야 합니다.

Claude Code 루틴은 저장된 자동화로, Remote 는 꺼둔 노트북에서도 API·GitHub 트리거까지 돌지만 Local 은 앱이 켜져 있어야 하는 시간 트리거만 지원해 사내망 접근이 아니면 Remote 가 낫습니다.

/loop 은 세션 안에서 반복 프롬프트를 도는 Claude Code 내장 스케줄러로, OS 가 아니라 프로세스에 묶여 터미널을 닫거나 세션이 끝나면 루프도 함께 멈춥니다.