창 없이 한 번에 실행하기

대화 세션은 사람이 중간에 판단해야 할 때 값이 있습니다. 반대로 요청이 매번 똑같고 결과 형태도 정해져 있으면, 세션을 여는 것부터 답을 복사해 붙여넣는 것까지가 전부 반복 비용이 됩니다.

claude 명령에 -p를 붙이면 대화창을 열지 않고 요청 하나를 실행합니다. 답은 대화 기록이 아니라 터미널 출력으로 나오고, 실행이 끝나면 세션이 닫힙니다. 결과를 파일로 넘기거나 다른 프로그램에 이어 붙일 수 있어서, 정해진 검사를 저장소에 올릴 때마다 자동으로 돌리는 CI 같은 자리에 씁니다.

이 단계는 이 코스에서 명령어를 피하기 어려운 몇 안 되는 지점입니다. 데스크탑 앱에는 같은 기능이 없고, 실행 자체가 명령 한 줄이기 때문입니다. 대신 외울 것은 세 조각뿐입니다. 요청 문장, 미리 승인할 도구, 결과를 어디로 보낼지입니다.

미리 승인하는 도구는 좁게 잡습니다

대화 세션에서는 파일을 고치거나 명령을 실행하기 전에 확인 창이 뜹니다. -p 실행에는 그 창이 없으므로, 승인이 필요한 지점에 닿으면 거기서 멈춥니다. --allowedTools로 미리 승인해 두면 멈추지 않고 끝까지 진행합니다.

여기서 넓게 잡으면 확인 없이 실행되는 범위가 그만큼 넓어집니다. 읽어서 정리하는 일이라면 Read 하나로 충분하고, 파일을 고쳐야 할 때 Edit을 더합니다. Bash는 명령을 직접 실행하는 도구라, 초보 단계의 자동 실행에는 넣지 않습니다.

내가 만들지 않은 폴더에서는 —bare를 붙입니다

-p 세션에는 폴더를 신뢰하겠냐고 묻는 창이 뜨지 않습니다. 그래서 옵션 없이 실행하면 그 폴더의 .claude/settings.json에 등록된 Hook이 그대로 실행되고, .mcp.json에 적힌 서버에도 연결됩니다. 내려받은 저장소나 남에게 받은 폴더에서 이 점이 문제가 됩니다.

--bare를 붙이면 Hook·스킬·플러그인·MCP 서버·CLAUDE.md를 모두 읽지 않고 실행합니다. 어느 컴퓨터에서 돌려도 같은 결과가 나오므로, 저장소를 처음 열어 볼 때와 CI에서 검사를 돌릴 때 함께 씁니다.

성공 여부는 종료 코드로 확인합니다

화면에 답이 나왔다고 해서 성공한 것은 아닙니다. 실행이 실패하면 Claude Code는 0이 아닌 종료 코드를 남기고, 인증이 빠진 경우처럼 실행 도중 생긴 실패는 결과 자리에 그대로 출력합니다. 명령을 이어 붙이거나 자동으로 돌릴 때는 종료 코드를 기준으로 다음 동작을 정합니다.

순서 아래 명령을 그대로 붙여넣어, 결과 파일이 실제로 만들어지는지 확인해 보세요.

터미널에서 claude -p를 써서 지금 폴더의 파일 목록을 표로 정리하고 결과를 files.md로 저장하는 명령 한 줄을 만들어 줘. 읽기 도구만 미리 승인하고, 명령의 각 부분이 무슨 뜻인지 한 줄씩 설명해 줘.

내가 매번 반복하는 요청이 있어: [여기에 반복 요청]. 이걸 claude -p 한 줄로 바꿔 줘. 도중에 나한테 되물어야 하는 부분이 있으면 그건 대화 세션에 남기라고 알려 주고, 명령으로 옮길 수 있는 부분만 만들어 줘.

claude -p를 --bare 없이 남의 저장소 폴더에서 실행하면 무엇이 자동으로 실행되는지 공식 문서를 근거로 설명해 줘. 지금 이 폴더에 그런 설정 파일이 있는지도 확인해 줘.