Headless
대화창을 열지 않고 요청 하나를 실행해 결과를 파일로 받을 수 있습니다
단계 1 / 6
결과가 화면 출력이나 파일로 남는 일만 고르고, 중간에 사람에게 되물어야 하는 일은 대화 세션에 남겨 둡니다.
단계 2 / 6
답이 대화창 대신 터미널에 바로 출력됩니다.
일반 터미널에서 실행합니다. Claude Code 세션 안이 아닙니다. -p는 --print의 짧은 형태이고, 실행이 끝나면 세션이 그대로 닫힙니다.
claude -p "이 폴더의 README를 읽고 핵심을 다섯 줄로 요약해 줘"
단계 3 / 6
지정하지 않으면 실행 도중 승인 창이 필요한 지점에서 멈춥니다.
미리 승인한 도구는 실행 중 확인 없이 쓰입니다. 읽기만 필요하면 Read만 넣고, 파일을 고치거나 명령을 실행하는 도구는 필요한 것만 하나씩 추가합니다.
claude -p "이 폴더의 문서 목록을 표로 정리해 줘" --allowedTools "Read"
단계 4 / 6
화면에 흘려보내지 않고 남겨야 다음 작업에서 쓸 수 있습니다.
> 뒤에 적은 이름으로 파일이 새로 만들어집니다. 같은 이름이 이미 있으면 덮어쓰므로 새 이름을 씁니다.
claude -p "이 폴더의 README를 읽고 핵심을 다섯 줄로 요약해 줘" --allowedTools "Read" > summary.md
단계 5 / 6
--bare는 그 폴더의 Hook·스킬·플러그인·MCP 서버·CLAUDE.md를 읽지 않고 실행합니다. 붙이지 않으면 신뢰 확인 창 없이 그것들이 그대로 실행됩니다.
claude -p "이 폴더가 무슨 프로젝트인지 설명해 줘" --bare --allowedTools "Read"
단계 6 / 6
0이면 성공이고, 0이 아니면 실행이 실패한 것입니다.
직전 명령의 종료 코드를 출력합니다. Windows PowerShell에서는 $LASTEXITCODE를 씁니다.
echo $?
터미널에서 claude -p를 써서 지금 폴더의 파일 목록을 표로 정리하고 결과를 files.md로 저장하는 명령 한 줄을 만들어 줘. 읽기 도구만 미리 승인하고, 명령의 각 부분이 무슨 뜻인지 한 줄씩 설명해 줘.