Claude Code 상세 사용법 12: CLI 자동화와 반복 루틴 만들기 | DAKER 커뮤니티

Claude Code 상세 사용법 12: CLI 자동화와 반복 루틴 만들기

Claude Code는 대화형 터미널만을 위한 도구가 아니다. 공식 CLI usage와 headless automation 문서 기준으로 claude -p는 비대화형 실행에 쓰이고, scheduled task와 routine은 반복 작업을 표준화하는 흐름이다. 다만 자동화는 편리함보다 권한과 출력 계약이 먼저다.

아래 Mermaid는 CLI 자동화를 만들 때 먼저 고정해야 할 계약을 보여준다. 입력, 권한, 출력, 실패 처리를 분리해 두면 claude -p가 사람 대신 판단하는 도구가 아니라 반복 조사 비용을 줄이는 루틴이 된다.

1. 자동화할 작업을 작게 고른다

처음부터 "매일 전체 코드베이스 개선"을 맡기면 실패한다. 좋은 후보는 입력과 완료 조건이 분명한 일이다.

반대로 제품 판단, 대규모 리팩터링, secret 접근이 필요한 작업은 사람이 개입하는 대화형 세션이나 PR 리뷰 단계로 남긴다.

2. claude -p에는 출력 형식을 요구한다

headless 실행은 중간 질문에 답할 사람이 없다. 그래서 prompt에 멈출 조건과 출력 형식을 써야 한다.

5. 실패 모드를 먼저 설계한다

자동화가 실패하는 흔한 이유는 세 가지다. 인증이 만료됨, 명령이 오래 걸림, Claude가 사람에게 질문함. 그래서 timeout, 재시도 횟수, 실패 artifact 저장 위치를 둔다.

timeout 600 claude -p "Inspect tmp/ci.log and write tmp/triage.md.
If information is missing, write BLOCKED with the exact missing input."

팀에서는 결과를 바로 merge하지 말고 PR 코멘트나 슬랙 요약처럼 사람이 검토할 수 있는 곳에 둔다. CLI 자동화의 목적은 결정을 대체하는 것이 아니라 반복 조사 비용을 줄이는 것이다.

Senior takeaway: Claude Code 자동화는 "AI에게 알아서 맡기기"가 아니라 입력, 권한, 출력, 실패 처리를 코드처럼 관리하는 LLM 개발 워크플로우다. 이 계약이 선명하면 클로드 코드는 테스트 자동화와 코드 리뷰 준비 시간을 꾸준히 줄인다.

claude -p "Read the latest test log from tmp/ci.log.
Return JSON with failingTest, suspectedCause, filesToInspect,
and nextCommand. Do not edit files."

파이프라인에서는 파일 입력도 유용하다.

cat tmp/ci.log | claude -p "Summarize this failure for a reviewer.
Include only root cause candidates and the next verification command."

3. 권한은 자동화마다 다르게 준다

CI나 cron에서 돌아가는 Claude Code는 기본적으로 좁은 권한이 안전하다. 파일을 고치지 않는 요약 작업이면 read-only로 설계하고, 수정이 필요하면 별도 브랜치와 제한된 도구만 허용한다. MCP 서버를 붙일 때도 같은 원칙이다. 이 자동화가 GitHub, 이슈 트래커, 배포 도구 중 어디까지 접근해야 하는지 먼저 적는다.

Allowed: read repository files, run pnpm test:unit
Not allowed: push, deploy, edit secrets, change lockfiles
Output: markdown summary under tmp/claude-report.md

4. scheduled task와 routine은 사람의 반복을 옮긴다

공식 문서의 scheduled tasks와 routines는 반복되는 개발 습관을 Claude Code에 맡기는 방향이다. 매일 CI 실패를 분류하고, 매주 flaky test 후보를 찾고, 릴리스 전 위험 요약을 만드는 식이다.

Redirecting to Claude Code 상세 사용법 12: CLI 자동화와 반복 루틴 만들기 | DAKER 커뮤니티...