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

Claude Code CLI

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

이 기술은 무엇인가요?

터미널에서 자연어 지시로 코드를 읽고 작성·수정·실행하는 AI 코딩 에이전트 CLI

Claude Code CLI는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트로, 자연어 지시를 받아 파일을 읽고 수정하고 셸 명령을 실행하며 실제 개발 작업을 끝까지 수행한다. 기존 채팅형 어시스턴트가 코드 스니펫만 제안하던 것과 달리, 파일시스템·Git·테스트 실행 등 개발 환경에 직접 접근해 작업을 완결하도록 설계되었다. 대화형(interactive) 모드뿐 아니라 프롬프트 하나를 넘기고 종료하는 헤드리스(non-interactive) 모드도 지원해 CI 파이프라인이나 자동화 스크립트에 내장할 수 있다.

이럴 때 사용합니다

  • 반복적인 코드 작성·리팩터링·버그 수정을 사람 개입 없이 자동화하고 싶을 때
  • CI/CD나 스크립트에서 헤드리스로 호출해 PR 초안 생성 같은 파이프라인을 구성할 때
  • 터미널·Git 등 기존 개발 워크플로 안에서 그대로 AI를 활용하고 싶을 때
  • 대규모 코드베이스 탐색이나 다단계 작업을 자연어 지시만으로 처리하고 싶을 때

핵심 개념

Agentic loop
도구 호출과 결과 관찰을 반복하며 목표를 달성할 때까지 스스로 다음 행동을 계획하는 실행 방식이다.
Headless mode
대화 세션 없이 단일 프롬프트를 실행하고 결과를 표준출력으로 반환해 스크립트나 파이프라인에서 호출할 수 있게 하는 모드다.
Tool use
파일 읽기/쓰기, 셸 명령 실행, 검색 등 모델이 호출할 수 있는 기능 단위로, 이를 조합해 실제 작업을 수행한다.
Permission model
파일 수정이나 명령 실행 전에 사용자 승인을 요구하거나 사전에 허용 규칙을 정해 자동화 범위를 제어하는 장치다.
CLAUDE.md
프로젝트 규칙, 아키텍처, 코딩 컨벤션 등을 기록해 에이전트가 매 세션 참고하도록 하는 컨텍스트 파일이다.
MCP (Model Context Protocol)
이슈 트래커, DB 등 외부 시스템과 연동할 도구를 표준화된 방식으로 추가할 수 있게 하는 프로토콜이다.

헤드리스 모드로 단발성 작업 실행

대화 없이 프롬프트 하나를 넘겨 실행 결과만 받아오는 방식으로, CI 스크립트나 자동화 파이프라인에서 Claude Code를 호출할 때 쓰는 기본 패턴이다.

Shell
# 대화형 세션 없이 프롬프트 하나를 실행하고 종료
claude -p "이 저장소의 실패하는 테스트를 찾아서 원인을 설명해줘"

# 결과를 JSON으로 받아 스크립트에서 파싱하기
claude -p "README에 설치 방법 섹션을 추가해줘" --output-format json

# 특정 도구 사용을 사전 승인해 확인 프롬프트 없이 실행
claude -p "lint 에러를 고쳐줘" --allowedTools "Edit,Bash(npm run lint)"

처음 쓸 때 흔한 함정

  • 헤드리스 모드에서 권한 설정을 안 해두면 명령마다 승인 대기로 멈출 수 있다
  • CLAUDE.md 같은 컨텍스트 파일 없이 쓰면 프로젝트 컨벤션을 매번 다시 설명해야 한다
  • 자동화 파이프라인에서 도구 허용 범위를 제한하지 않으면 의도치 않은 파일 변경이 발생할 수 있다

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

프로젝트별 활용 방식

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

  1. 01자동화
    2026년 7월

    Jira 카드 자동 개발-PR 파이프라인

    Jira 카드를 탐지해 Claude가 질문→개발→PR→완료처리까지 수행하는 루프 자동화 도구와 제어용 로컬 대시보드

    이 프로젝트에서의 Claude Code CLI 활용

    카드 검토·질문 작성·실제 코드 구현을 헤드리스로 수행하는 실행 엔진

    jira_auto_pilot프로젝트 자세히 보기 →

함께 사용한 기술

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

GitHub CLI2JavaScript2Node.js2CSSExpressGitHTMLJira REST APInode:testReactShellShell Script