claude -p: 대화창 없이 답만 받는 자동화의 핵심 (print)

지금까지 Claude Code를 채팅하듯 써왔다면, 이번 명령은 조금 다른 세계예요. 사람이 직접 대화하는 게 아니라, 다른 프로그램이나 스크립트가 Claude를 "부품처럼" 불러 쓰는 방식이에요. 반복되는 분석 작업을 자동화하고 싶을 때 시작점이 되는 옵션입니다.

정의 (뭐냐면)

claude -p "질문"은 대화창을 열지 않고 답만 받고 종료하는 명령이에요(-p = print, 출력). 평소처럼 대화창이 열려 이어서 채팅하는 게 아니라, 시킨 일의 답을 화면에 한 번 출력하고 바로 끝나요. 사람이 대화하는 용도가 아니라, 스크립트(여러 명령을 자동으로 실행하는 작은 프로그램)가 Claude를 호출해 결과만 받아갈 때 써요.

어떻게 쓰나 (난이도별)

시작 전에: -p는 답을 텍스트로 한 번 뱉고 끝나기 때문에, "결과를 받아서 다른 데 쓰고 싶을 때" 특히 빛을 발해요. 아래 명령들도 작업 대상 폴더로 이동(cd 폴더경로)한 뒤 실행하면 그 폴더의 파일을 보고 답합니다.

기초 — 한 줄 답 받기

claude -p "이 함수 하는 일 한 문장으로"

질문에 답을 한 번 출력하고 바로 끝나요. 채팅창이 열려 입력을 기다리지 않으니, "딱 이것만 빠르게 물어보고 싶다" 할 때 깔끔해요.

응용 — 파일을 파이프로 넘겨 분석

cat error.log | claude -p "에러 원인 설명"

cat(파일 내용을 화면에 출력하는 명령)으로 로그 파일 내용을 꺼내, 파이프(|, 앞 명령의 출력을 뒤 명령으로 연결하는 기호)로 Claude에게 넘겨 분석시키는 거예요. 파일을 복사·붙여넣기 하지 않아도 통째로 넘어가요.

심화 — 결과를 JSON으로 받아 자동화

git diff | claude -p "커밋 메시지 써줘" --output-format json

git diff(아직 커밋 안 한 변경 내용 보기)를 넘겨 커밋 메시지를 만들되, --output-format json으로 결과를 JSON 형식(프로그램끼리 주고받기 좋은 정형화된 데이터 형태)으로 받는 거예요. 이렇게 받으면 다른 도구가 그 결과를 바로 읽어 다음 작업으로 넘길 수 있어요.

흔한 함정

-p는 자동화용이라, 보통 권한 옵션이나 출력 형식 옵션(--output-format 등)과 함께 자주 써요. 또 대화창이 열리지 않으니 "왜 채팅 입력이 안 되지?" 하고 당황하지 마세요. 그게 정상 동작이에요. 사람이 직접 이어서 대화하고 싶다면 -p 없이 그냥 claude를 쓰면 됩니다.

실전 사례

매일 밤 서버 로그를 cat으로 넘겨 claude -p로 요약시키고, 그 요약 결과를 자동으로 메일로 보내는 스크립트를 예약 실행(cron, 정해진 시각에 자동으로 명령을 돌려주는 도구)에 걸어둔 사례가 있어요. 사람이 손대지 않아도 매일 정리된 로그 요약이 메일함에 도착해요.

이렇게 더 씁니다

• 답을 글자(텍스트)로 받을 수 있으니, 반복되는 분석 작업을 통째로 자동화할 수 있어요.
• JSON으로 받으면 결과를 다른 프로그램이 곧장 읽어 처리할 수 있어, 도구들을 줄줄이 연결하기 좋아요.
• 지난 대화 맥락을 이어가며 답만 받고 싶다면 claude -c -p "..."처럼 -c와 함께 쓰면 돼요.

정리

claude -p는 "사람이 채팅하는 모드"가 아니라 "프로그램이 Claude를 불러 답만 받아가는 모드"예요. 답을 텍스트나 JSON으로 받을 수 있어서, 파이프·예약 실행과 엮으면 반복 작업을 통째로 자동화할 수 있어요. 자동화에 입문하는 가장 중요한 옵션입니다.

기준: Claude Code v2.1.154 (2026.05)