Claude Code는 코드를 대신 써주는 도구로만 보면 활용 폭이 좁습니다. 개인 프로젝트에서는 오히려 “작업을 읽고, 정리하고, 작은 단위로 실행하는 자동화 비서”에 가깝게 쓰는 편이 좋습니다.

이 글은 Claude Code를 개인 자동화 흐름에 붙일 때의 기본 사용법을 정리한 메모입니다.

먼저 맡기기 좋은 일

처음부터 큰 기능 전체를 맡기기보다, 작고 검증 가능한 일부터 맡기는 편이 안전합니다.

• 프로젝트 구조 파악
• README나 문서 초안 작성
• 반복되는 파일 수정
• 간단한 스크립트 작성
• 빌드 에러 원인 추적
• 변경사항 요약
• 다음 작업 체크리스트 정리

핵심은 “한 번에 완성”이 아니라 “작게 맡기고 바로 확인”입니다.

좋은 요청 방식

Claude Code에게는 추상적인 요청보다 조건이 있는 요청이 더 잘 통합니다.

예를 들어 이렇게 요청합니다.

이 프로젝트 구조를 먼저 읽고, 블로그 글 목록 페이지를 수정하려면 어떤 파일을 봐야 하는지 정리해줘.
아직 코드는 수정하지 말고 계획만 보여줘.

또는:

src/content/blog 안의 글 형식을 유지하면서 새 글 3개를 추가해줘.
추가 후 npm run build로 검증해줘.

이렇게 하면 작업 범위가 분명해지고, 원치 않는 대형 수정이 줄어듭니다.

개인 비서처럼 쓰는 흐름

제가 생각하는 기본 흐름은 다음과 같습니다.

1. 목표를 한 문장으로 적습니다.
2. 관련 파일을 먼저 읽게 합니다.
3. 수정 전 계획을 받습니다.
4. 작은 단위로 실행하게 합니다.
5. 빌드나 테스트로 확인합니다.
6. 마지막에 변경 요약을 받습니다.

이 흐름을 지키면 AI가 빠르게 움직이면서도 프로젝트가 망가질 가능성을 줄일 수 있습니다.

주의할 점

Claude Code가 항상 맞는 것은 아닙니다. 특히 다음 작업은 직접 확인이 필요합니다.

• API 키나 토큰 처리
• 결제, 배포, 계정 권한 변경
• 외부 서비스 정책 해석
• 보안 관련 설정
• 사용자의 실제 의도가 중요한 글 발행

AI는 작업 속도를 올려주는 도구이지, 최종 책임자를 대체하는 도구는 아닙니다.

Daejin Lab 작업에 적용한 예

이 블로그를 만들 때도 AI 에이전트식 작업 흐름을 그대로 적용했습니다.

실제 작업은 대략 이런 순서였습니다.

1. 블로그 목적 정리
2. Astro 프로젝트 생성
3. 기본 페이지 작성
4. 글 10개 작성
5. Search Console 인증 태그 추가
6. sitemap URL 오류 수정
7. 카테고리 페이지 추가
8. GitHub SSH push 문제 해결

각 단계마다 바로 배포하지 않고 먼저 로컬에서 검증했습니다.

npm run build

그리고 변경사항은 작은 커밋으로 나눴습니다.

Initial Daejin Lab static blog
Add initial AI automation blog posts
Use Pages URL for sitemap
Add category pages and improve about page

이렇게 기록을 남겨두면 나중에 같은 구조로 2호, 3호 블로그를 만들 때 복제하기 쉽습니다.

맡기면 안 되는 부분

반대로 AI에게 그대로 맡기면 안 되는 부분도 있었습니다.

• 사이트명과 도메인 결정
• AdSense 신청 시점 판단
• 실제 경험이 없는 내용을 경험처럼 쓰는 것
• GitHub, Cloudflare, Google 계정 권한 처리
• API 키와 토큰 처리

이 부분은 사람이 직접 판단해야 합니다. AI는 실행 속도를 높여줄 수 있지만, 사이트의 신뢰도와 책임까지 대신 가져가지는 못합니다.

정리

Claude Code는 “코딩 대행”보다 “프로젝트 작업 파트너”로 쓰는 편이 더 유용합니다. 작은 작업을 맡기고, 결과를 검증하고, 그 과정을 문서화하면 개인 자동화 시스템의 중심 도구가 될 수 있습니다.