정정지용
기술스택 목록
도구

Claude CLI

프로젝트 1개에서 사용했습니다. 각 프로젝트에서 어떤 역할로 썼는지 아래에 정리했습니다.

이 기술은 무엇인가요?

터미널에서 Claude에게 코드 작업을 지시하고 자동화 스크립트에도 연결할 수 있는 CLI 도구

Claude CLI는 터미널 환경에서 Claude 모델과 대화하며 파일 읽기·쓰기, 명령 실행 같은 실제 작업을 수행하게 하는 커맨드라인 도구다. 대화형으로 개발자를 돕는 것뿐 아니라, 프롬프트 하나만 넘기고 결과를 받아 종료되는 비대화형(headless) 실행도 지원해 셸 스크립트나 CI 파이프라인에 끼워 넣을 수 있다. 사람이 매번 채팅창을 열지 않아도 반복적인 분석·생성 작업을 자동화하려는 목적에서 만들어졌다.

이럴 때 사용합니다

  • 여러 파일·저장소를 반복적으로 분석해 자동으로 결과물을 생성하고 싶을 때
  • CI/CD나 배치 스크립트 안에서 사람 개입 없이 AI 처리를 실행하고 싶을 때
  • 구조화된 출력(JSON 등)을 받아 후속 프로그램이 그대로 파싱하게 하고 싶을 때

핵심 개념

headless mode
대화형 세션 없이 `-p` 옵션 등으로 프롬프트를 한 번 전달하고 결과만 받아 종료되는 실행 방식으로, 스크립트나 배치 작업에 적합하다.
tool use
모델이 답변만 생성하는 것이 아니라 파일 읽기/쓰기, 셸 명령 실행 등 정의된 도구를 스스로 호출해 실제 작업을 수행하는 능력이다.
system prompt / instructions
CLI 실행 시 역할·규칙·출력 형식을 지정하는 초기 지시문으로, 매 실행마다 모델의 행동 범위를 제어한다.
MCP (Model Context Protocol)
외부 서비스나 데이터 소스를 표준화된 방식으로 CLI에 연결해 모델이 추가 도구처럼 사용할 수 있게 하는 프로토콜이다.
permission / sandbox
파일 수정이나 명령 실행처럼 위험할 수 있는 동작을 실행 전 승인받거나 제한된 범위 안에서만 허용하는 안전장치다.

Headless 모드로 프롬프트 실행하기

표준입력으로 파일 내용을 전달하고, 대화형 세션 없이 한 번의 응답만 받아 스크립트에서 바로 처리할 수 있게 하는 예시다.

Shell
# 파일 내용을 컨텍스트로 넣고 결과를 JSON으로 받기
cat README.md | claude -p "이 프로젝트의 기술 스택을 요약해줘" \
  --output-format json

처음 쓸 때 흔한 함정

  • 대화형 세션과 headless 실행의 컨텍스트·세션 유지 방식이 달라 혼동하기 쉽다
  • 도구 사용 권한을 넉넉히 허용하면 의도치 않은 파일 수정·명령 실행이 발생할 수 있다

위 개요는 기술 학습을 돕기 위해 자동 생성된 일반 설명입니다. 정확한 사양과 최신 정보는 공식 문서를 확인하세요.

프로젝트별 활용 방식

위 개념이 실제 프로젝트에서 어떻게 쓰였는지 보여줍니다.

함께 사용한 기술

위 프로젝트들에서 같이 쓰인 다른 기술입니다.

GitHub ActionsGitHub APIMermaidNext.jsNode.jsReactShell ScriptTailwind CSSTypeScript