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

Claude Code

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

이 기술은 무엇인가요?

Anthropic의 Claude AI를 터미널과 IDE에서 대화형으로 사용할 수 있게 하는 CLI/에이전트 도구

Claude Code는 Anthropic의 Claude AI 모델을 명령줄이나 자동화 스크립트에서 직접 호출하고, 파일 읽기/쓰기, 코드 실행, 도구 사용 등을 수행할 수 있도록 지원하는 인터페이스입니다. 헤드리스(headless) 모드를 통해 사람의 개입 없이 반복 작업을 자동화하거나, 대화형 모드로 개발 과정에서 AI 어시스턴트를 즉시 활용할 수 있습니다. CI/CD 파이프라인, 티켓 관리 시스템, 코드 리뷰 자동화 등 개발 워크플로우 전반에 AI 에이전트를 통합하는 데 사용됩니다.

이럴 때 사용합니다

  • Jira, Linear 같은 이슈 트래커와 연동해 티켓 내용을 읽고 코드 수정을 자동 제안할 때
  • CI/CD 파이프라인에서 코드 리뷰, 테스트 생성, 문서 업데이트를 자동화할 때
  • 터미널에서 즉시 AI 어시스턴트를 호출해 코드 설명, 디버깅, 리팩토링 도움을 받을 때
  • 헤드리스 환경에서 정기적으로 코드베이스를 분석하고 리포트를 생성할 때

핵심 개념

Headless Mode
사용자 입력 없이 스크립트나 자동화 워크플로우 내에서 Claude를 실행하는 모드. 프롬프트와 도구를 미리 정의해두고 결과만 받아 처리할 수 있습니다.
Tool Use
Claude가 파일 시스템 접근, 셸 명령 실행, API 호출 등 외부 도구를 호출할 수 있도록 허용하는 기능. 에이전트가 스스로 필요한 작업을 수행하게 만듭니다.
Agentic Loop
Claude가 목표를 받고, 계획을 세우고, 도구를 사용하고, 결과를 검토한 뒤 다음 단계를 결정하는 반복 사이클. 사람의 개입 없이 복잡한 작업을 완수합니다.
Context
Claude에게 전달되는 프로젝트 파일, 대화 기록, 시스템 프롬프트 등의 입력 정보. 컨텍스트 크기에 따라 Claude가 참조할 수 있는 코드베이스 범위가 결정됩니다.

헤드리스 모드로 파일 분석 후 요약 생성

파일 읽기/쓰기 도구를 허용하고, Claude에게 디렉토리 분석 및 요약 작성을 지시합니다. 헤드리스 모드이므로 대화 없이 결과만 생성됩니다.

Shell
# 환경변수로 API 키 설정
export ANTHROPIC_API_KEY=your_api_key

# 헤드리스 모드로 Claude 실행
claude --headless \
  --prompt "src/ 디렉토리의 모든 TypeScript 파일을 읽고, 주요 컴포넌트 목록을 summary.md에 작성해줘" \
  --tool file-read \
  --tool file-write

# 또는 스크립트에서 프로그래밍 방식으로 호출
cat <<EOF | claude --headless --tool file-read --tool git
README.md를 읽고 개선점 3가지를 제안한 뒤,
새 브랜치를 만들어 수정안을 커밋해줘
EOF

처음 쓸 때 흔한 함정

  • 헤드리스 모드에서 도구 권한을 명시하지 않으면 Claude가 필요한 작업을 수행하지 못함
  • 컨텍스트 크기 제한으로 대규모 코드베이스 전체를 한 번에 전달하면 일부만 처리됨
  • 자동화 루프에서 에러 핸들링을 하지 않으면 Claude가 중간에 멈춰도 알 수 없음

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

프로젝트별 활용 방식

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

함께 사용한 기술

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

Atlassian MCPExpressGitGitHub CLIJavaScriptNode.jsReactShell ScriptSlack API