Q&A 피드 AI Workflow
VIBECODING 365 / Q&A
클러드 코드가 뭔가
클로드 코드는 터미널에서 실행되는 Anthropic의 AI 코딩 에이전트로, 코드베이스를 읽고 파일을 수정하며 명령을 실행해 개발 작업을 자동화합니다.
# 클로드 코드(Claude Code)란?
한 줄 정의
클로드 코드는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트입니다. 채팅창에 코드를 붙여넣는 방식이 아니라, 실제 프로젝트 폴더 안에서 파일을 읽고, 코드를 수정하고, 테스트를 실행하고, Git 작업을 보조하는 도구입니다.
왜 주목받는가
- 에이전틱 워크플로우: 단순 완성보다 목표를 주고 여러 단계를 스스로 수행합니다.
- 코드베이스 이해: 프로젝트 구조를 탐색해 기존 코드 스타일을 파악합니다.
- 직접 실행: 파일 편집, 명령어 실행, 오류 수정까지 한 흐름으로 이어집니다.
- 확장성: VS Code, JetBrains 등 IDE와 연동하고 MCP로 외부 도구를 연결할 수 있습니다.
주요 기능
- 코드 작성, 수정, 리팩터링
- 버그 원인 분석 및 수정 제안
- 테스트 실행 및 실패 로그 해석
- Git 커밋 메시지, PR 설명 초안 작성
- 문서, README, 주석 생성
- CLAUDE.md를 통한 프로젝트 규칙 공유
설치부터 첫 실행까지 체크리스트
1단계: 준비
- [ ] Node.js 등 실행 환경 확인
- [ ] Git이 설치된 프로젝트 폴더 준비
- [ ] 중요한 작업 전 Git 커밋 또는 백업
2단계: 설치 및 로그인
- [ ] 공식 안내에 따라 Claude Code 설치
- [ ] 브라우저 로그인으로 계정 연결
- [ ] 터미널에서
claude명령으로 실행 확인
3단계: 프로젝트에서 시작
- [ ] 프로젝트 루트 폴더로 이동
- [ ]
claude실행 - [ ]
/init으로 프로젝트 분석 및 CLAUDE.md 생성 시도 - [ ] 작은 작업부터 테스트: 설명 요청, 파일 요약, 간단한 수정
기본 사용 워크플로우
- 탐색: '이 프로젝트 구조를 설명해줘'
- 계획: '로그인 버그를 수정하려면 어떤 파일을 봐야 해?'
- 실행: '방금 계획대로 수정하고 테스트해줘'
- 검토: '변경된 파일을 diff로 보여줘'
- 정리: '커밋 메시지를 만들어줘'
팁: 한 번에 큰 작업을 지시하기보다 탐색 → 계획 → 실행 → 검토 순서로 나누면 결과가 안정적입니다.
효과적인 프롬프트 예시
- 'src 폴더의 인증 관련 코드를 찾아서 흐름을 요약해줘'
- '이 함수에 대한 단위 테스트를 추가해줘. 기존 테스트 스타일을 따라줘'
- '에러 로그를 보고 원인을 분석하고, 수정안을 제시해줘. 바로 적용하지 말고 먼저 설명해줘'
- 'README에 설치 방법 섹션을 추가해줘'
CLAUDE.md 활용법
프로젝트 루트에 두는 규칙 파일입니다. 반복해서 설명할 내용을 적어두면 매번 같은 지시를 줄일 수 있습니다.
예시 항목:
- 사용하는 언어와 프레임워크
- 코드 스타일과 네이밍 규칙
- 테스트 실행 명령어
- 금지 사항: 예) DB 스키마를 임의로 변경하지 말 것
- 자주 쓰는 명령어
안전하게 쓰는 법
- [ ] 처음에는 읽기 전용 탐색부터 시작
- [ ] 파일 삭제, 배포, DB 변경 같은 작업은 실행 전에 내용 확인
- [ ] 권한 요청이 뜨면 명령어를 꼼꼼히 확인
- [ ] 중요한 변경 전에는 반드시 Git으로 되돌릴 수 있게 준비
- [ ] 민감한 정보나 개인 키를 프롬프트에 직접 붙여넣지 않기
모델과 요금 관련 팁
- Claude Code는 구독 플랜 또는 API 사용량 기반으로 동작하는 방식이 안내됩니다.
- 복잡한 설계와 디버깅은 상위 모델, 반복적인 단순 작업은 빠른 모델로 나누면 효율적입니다.
- 사용량 제한이 있는 경우, 한 번에 너무 큰 작업을 몰아서 시키지 말고 단계별로 나눠보세요.
처음 해볼 만한 프로젝트 3가지
- 기존 코드 설명받기: 낯선 오픈소스 프로젝트의 구조 파악
- 테스트 추가: 테스트가 없는 함수에 테스트 작성
- 문서화: 함수 주석과 README 개선
자주 묻는 질문
Q. ChatGPT나 일반 챗봇과 뭐가 다른가요? A. 클로드 코드는 실제 파일 시스템에 접근해 코드를 직접 수정하고 명령을 실행할 수 있다는 점이 다릅니다.
Q. 초보자도 쓸 수 있나요? A. 네. 다만 처음에는 코드를 직접 다 짜는 것보다 설명, 계획, 검토를 맡기는 방식으로 시작하는 것이 좋습니다.
Q. 회사 프로젝트에 써도 되나요? A. 회사 보안 정책과 라이선스를 먼저 확인하세요. 외부로 보내면 안 되는 코드가 있다면 사용 범위를 제한해야 합니다.
오늘 바로 시작하기
- 작은 개인 프로젝트 폴더를 준비하세요.
- Claude Code를 설치하고 로그인하세요.
- '이 프로젝트가 뭘 하는지 설명해줘'부터 시작하세요.
- 결과를 Git diff로 검토한 뒤 다음 작업을 지시하세요.