Claude Code 상세 사용법 02: CLI 명령과 안전한 실행 루프 | DAKER 커뮤니티

Claude Code 상세 사용법 02: CLI 명령과 안전한 실행 루프

Claude Code를 잘 쓰려면 대화형 모드와 비대화형 모드를 구분해야 합니다. 공식 CLI 문서는 claude, claude "query", claude -p, claude -c, claude -r 같은 흐름을 나눠 설명합니다. 이 차이를 알면 코드 리뷰, 로그 요약, 테스트 보조를 훨씬 안정적으로 자동화할 수 있습니다.

1. 대화형으로 깊게 들어가기

가장 기본은 프로젝트 루트에서 대화형 REPL을 여는 것입니다.

claude

처음부터 한 줄 목표를 넣고 시작할 수도 있습니다.

claude "이 프로젝트의 테스트 구조를 설명해줘"

대화형 모드는 설계, 디버깅, 리팩터링처럼 맥락이 길게 이어지는 일에 어울립니다. 대신 작업이 길어질수록 중간중간 요약과 검증 기준을 요구해야 합니다.

지금까지 확인한 사실, 아직 추정인 것, 다음에 실행할 명령을 나눠서 말해줘.

2. -p로 짧은 자동화 만들기

공식 CLI 문서의 -p는 질문을 실행하고 종료하는 print 모드입니다. 로그 요약이나 변경 파일 리뷰처럼 한 번에 끝나는 작업에 좋습니다.

claude -p "package.json의 scripts를 읽고 개발자가 알아야 할 명령만 요약해줘"

파이프와 함께 쓰면 터미널 자동화가 됩니다.

cat error.log | claude -p "원인 후보를 우선순위대로 정리해줘"

단, -p 결과를 바로 배포나 삭제 명령으로 연결하지 마세요. AI 코딩 자동화는 읽기 작업부터 시작하고, 쓰기 작업은 사람이 확인할 수 있는 diff를 남기는 편이 안전합니다.

3. 이어가기와 세션 재개

가장 최근 대화를 이어가려면 continue 모드를 씁니다.

claude -c

특정 세션을 다시 열어야 할 때는 session id로 재개합니다.

claude -r "<session-id>" "이전 작업의 남은 TODO를 정리해줘"

팀에서 쓰는 경우에는 세션 재개보다 작업 기록을 명확히 남기는 것이 더 중요합니다. "무엇을 바꿨는지"보다 "왜 그 판단을 했는지"를 남겨야 다음 사람이 이어받을 수 있습니다.

4. 안전한 실행 루프

Claude Code에 명령 실행을 맡길 때는 다음 순서를 반복하세요.

1. 읽기: 관련 파일과 명령을 먼저 확인한다.

2. 계획: 수정 범위와 검증 방법을 말하게 한다.

3. 실행: 작은 단위로 바꾼다.

4. 검증: 테스트와 diff를 확인한다.

5. 기록: 남은 리스크를 적는다.

실전 프롬프트는 이렇게 쓰면 좋습니다.

수정 전에 관련 파일과 실행할 테스트를 먼저 제안해줘. 내가 확인할 수 있게 예상 diff 범위도 말해줘.

그리고 실행 후에는 이렇게 닫습니다.

변경 파일, 실행한 명령, 실패한 검증, 다음 사람이 봐야 할 리스크를 짧게 정리해줘.

Claude Code CLI는 빠르게 코드를 고치는 도구이지만, 좋은 개발자는 속도보다 루프를 설계합니다. 대화형은 깊은 사고에, -p는 짧은 자동화에, -c와 -r은 맥락 복구에 쓰세요. 이 구분만 해도 클로드 코드 기반 개발 생산성이 훨씬 안정적으로 올라갑니다.