Q&A 피드 AI Workflow

VIBECODING 365 / Q&A

클러드 코드가 뭔가

클로드 코드는 터미널에서 실행되는 Anthropic의 AI 코딩 에이전트로, 코드베이스를 읽고 파일을 수정하며 명령을 실행해 개발 작업을 자동화합니다.

# 클로드 코드(Claude Code)란?

한 줄 정의

클로드 코드는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트입니다. 채팅창에 코드를 붙여넣는 방식이 아니라, 실제 프로젝트 폴더 안에서 파일을 읽고, 코드를 수정하고, 테스트를 실행하고, Git 작업을 보조하는 도구입니다.

왜 주목받는가

  • 에이전틱 워크플로우: 단순 완성보다 목표를 주고 여러 단계를 스스로 수행합니다.
  • 코드베이스 이해: 프로젝트 구조를 탐색해 기존 코드 스타일을 파악합니다.
  • 직접 실행: 파일 편집, 명령어 실행, 오류 수정까지 한 흐름으로 이어집니다.
  • 확장성: VS Code, JetBrains 등 IDE와 연동하고 MCP로 외부 도구를 연결할 수 있습니다.

주요 기능

  1. 코드 작성, 수정, 리팩터링
  2. 버그 원인 분석 및 수정 제안
  3. 테스트 실행 및 실패 로그 해석
  4. Git 커밋 메시지, PR 설명 초안 작성
  5. 문서, README, 주석 생성
  6. CLAUDE.md를 통한 프로젝트 규칙 공유

설치부터 첫 실행까지 체크리스트

1단계: 준비

  • [ ] Node.js 등 실행 환경 확인
  • [ ] Git이 설치된 프로젝트 폴더 준비
  • [ ] 중요한 작업 전 Git 커밋 또는 백업

2단계: 설치 및 로그인

  • [ ] 공식 안내에 따라 Claude Code 설치
  • [ ] 브라우저 로그인으로 계정 연결
  • [ ] 터미널에서 claude 명령으로 실행 확인

3단계: 프로젝트에서 시작

  • [ ] 프로젝트 루트 폴더로 이동
  • [ ] claude 실행
  • [ ] /init으로 프로젝트 분석 및 CLAUDE.md 생성 시도
  • [ ] 작은 작업부터 테스트: 설명 요청, 파일 요약, 간단한 수정

기본 사용 워크플로우

  1. 탐색: '이 프로젝트 구조를 설명해줘'
  2. 계획: '로그인 버그를 수정하려면 어떤 파일을 봐야 해?'
  3. 실행: '방금 계획대로 수정하고 테스트해줘'
  4. 검토: '변경된 파일을 diff로 보여줘'
  5. 정리: '커밋 메시지를 만들어줘'

팁: 한 번에 큰 작업을 지시하기보다 탐색 → 계획 → 실행 → 검토 순서로 나누면 결과가 안정적입니다.

효과적인 프롬프트 예시

  • 'src 폴더의 인증 관련 코드를 찾아서 흐름을 요약해줘'
  • '이 함수에 대한 단위 테스트를 추가해줘. 기존 테스트 스타일을 따라줘'
  • '에러 로그를 보고 원인을 분석하고, 수정안을 제시해줘. 바로 적용하지 말고 먼저 설명해줘'
  • 'README에 설치 방법 섹션을 추가해줘'

CLAUDE.md 활용법

프로젝트 루트에 두는 규칙 파일입니다. 반복해서 설명할 내용을 적어두면 매번 같은 지시를 줄일 수 있습니다.

예시 항목:

  • 사용하는 언어와 프레임워크
  • 코드 스타일과 네이밍 규칙
  • 테스트 실행 명령어
  • 금지 사항: 예) DB 스키마를 임의로 변경하지 말 것
  • 자주 쓰는 명령어

안전하게 쓰는 법

  • [ ] 처음에는 읽기 전용 탐색부터 시작
  • [ ] 파일 삭제, 배포, DB 변경 같은 작업은 실행 전에 내용 확인
  • [ ] 권한 요청이 뜨면 명령어를 꼼꼼히 확인
  • [ ] 중요한 변경 전에는 반드시 Git으로 되돌릴 수 있게 준비
  • [ ] 민감한 정보나 개인 키를 프롬프트에 직접 붙여넣지 않기

모델과 요금 관련 팁

  • Claude Code는 구독 플랜 또는 API 사용량 기반으로 동작하는 방식이 안내됩니다.
  • 복잡한 설계와 디버깅은 상위 모델, 반복적인 단순 작업은 빠른 모델로 나누면 효율적입니다.
  • 사용량 제한이 있는 경우, 한 번에 너무 큰 작업을 몰아서 시키지 말고 단계별로 나눠보세요.

처음 해볼 만한 프로젝트 3가지

  1. 기존 코드 설명받기: 낯선 오픈소스 프로젝트의 구조 파악
  2. 테스트 추가: 테스트가 없는 함수에 테스트 작성
  3. 문서화: 함수 주석과 README 개선

자주 묻는 질문

Q. ChatGPT나 일반 챗봇과 뭐가 다른가요? A. 클로드 코드는 실제 파일 시스템에 접근해 코드를 직접 수정하고 명령을 실행할 수 있다는 점이 다릅니다.

Q. 초보자도 쓸 수 있나요? A. 네. 다만 처음에는 코드를 직접 다 짜는 것보다 설명, 계획, 검토를 맡기는 방식으로 시작하는 것이 좋습니다.

Q. 회사 프로젝트에 써도 되나요? A. 회사 보안 정책과 라이선스를 먼저 확인하세요. 외부로 보내면 안 되는 코드가 있다면 사용 범위를 제한해야 합니다.

오늘 바로 시작하기

  1. 작은 개인 프로젝트 폴더를 준비하세요.
  2. Claude Code를 설치하고 로그인하세요.
  3. '이 프로젝트가 뭘 하는지 설명해줘'부터 시작하세요.
  4. 결과를 Git diff로 검토한 뒤 다음 작업을 지시하세요.