Claude Code를 프로젝트 작업 비서처럼 쓰는 법

Claude Code를 처음 쓸 때는 코딩 도구로만 봤습니다. 그런데 Daejin Lab을 만들고 고치다 보니, 단순히 코드를 짜는 도구라기보다 프로젝트 작업 비서에 더 가까웠습니다.

특히 글 목록을 보고, 수정 후보를 고르고, 빌드까지 확인하는 흐름에서는 사람이 일일이 기억하지 않아도 되는 부분을 꽤 줄여줬습니다. 다만 그만큼 맡기면 안 되는 부분도 같이 분명해졌습니다.

처음 맡기기 좋은 일

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

프로젝트 구조 파악
관련 파일 후보 정리
README나 운영 문서 초안 작성
반복되는 Markdown 형식 정리
간단한 스크립트 작성
빌드 에러 원인 추적
변경사항 요약

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

요청은 조건을 붙여서 한다

추상적인 요청보다 조건이 있는 요청이 낫습니다.

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

또는 이렇게 씁니다.

src/content/blog 안의 글 형식을 유지하면서 글 3개를 보강해줘.
API 키나 계정 정보는 절대 추가하지 말고,
수정 후 npm run build로 검증해줘.

이 정도 조건을 주면 원치 않는 대형 수정이 줄어듭니다.

Daejin Lab에 적용한 흐름

이번 블로그 작업은 대략 이런 순서로 진행했습니다.

블로그 목적 정리
Astro 프로젝트 생성
기본 페이지 작성
초기 글 작성
Search Console 인증 태그 추가
sitemap URL 오류 수정
카테고리 페이지 추가
GitHub SSH push 문제 해결
기존 글의 경험 문단 보강

각 단계는 로컬에서 먼저 확인했습니다.

npm run build

그리고 배포 뒤에는 공개 URL도 확인했습니다. 특히 sitemap 문제는 Cloudflare나 Google 화면만 보고 판단하지 않고, 실제 URL 응답을 같이 봤습니다.

맡기면 안 되는 부분

아래는 도움을 받을 수는 있어도 그대로 맡기지 않습니다.

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

이 부분은 속도보다 책임이 더 큽니다. 도구가 빠르게 제안해도 마지막 판단은 사람이 해야 합니다.

기록을 남기는 이유

작은 커밋과 작업 메모를 남기면 다음 블로그를 만들 때 도움이 됩니다.

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

무엇을 언제 바꿨는지 남아 있으면, 같은 문제를 두 번 설명하지 않아도 됩니다.

남긴 기준

Claude Code는 코딩 대행보다 프로젝트 작업 파트너로 쓸 때 더 유용했습니다. 구조를 읽히고, 일을 작게 나누고, 빌드로 검증하고, 기록을 남기는 흐름 안에 넣으면 개인 자동화의 중심 도구가 될 수 있습니다.

이번 블로그 작업에 적용한 범위

Daejin Lab에서는 Claude Code를 “대신 판단하는 도구”가 아니라, 확인 가능한 작업을 빠르게 처리하는 보조자로 두었습니다. 실제로 맡긴 일과 직접 본 일을 나눠보면 아래처럼 정리됩니다.

구분	Claude Code에 맡긴 일	사람이 직접 확인한 일
구조 파악	Astro 페이지, layout, content 폴더 후보 찾기	어떤 수정이 AdSense 준비에 더 중요한지 결정
글 보강	내부 링크 후보, 반복 표현, 표 구조 제안	실제 경험처럼 말해도 되는지 검수
배포 전 확인	`npm run build` 실행과 오류 요약	Search Console 화면 상태 판단
운영 기준	다음 작업 목록 정리	push, 신청, 외부 콘솔 조작 승인

이 기준은 에이전트에게 맡길 일과 직접 볼 일과 프롬프트보다 중요한 작업 분해 방식에서 정한 선과 이어집니다. 자동화가 커질수록 “맡긴 일”보다 “검증한 일”을 남기는 쪽이 더 중요했습니다.

2026년 5월 10일 보강 기준

이번 콘텐츠 보강에서는 Claude Code 같은 도구를 “더 많이 쓰는 것”보다, 어디까지 맡기고 어디서 멈추는지를 더 중요하게 봤습니다.

실제로는 아래 순서가 안정적이었습니다.

1. 약한 글 후보를 지표로 찾는다.
2. 글 5개 단위로만 범위를 자른다.
3. 내부 링크와 대표 이미지부터 보강한다.
4. 실제 운영 메모를 추가한다.
5. build와 sitemap 검증 후 커밋한다.
6. push와 배포는 별도 승인 후 진행한다.

이 흐름을 두면 AI 도구가 글을 마음대로 늘리는 구조가 아니라, 운영자가 정한 품질 기준을 빠르게 반영하는 구조가 됩니다. 특히 AdSense 준비 단계에서는 속도보다 “검수 가능한 변경”이 더 중요했습니다.

자동화 비서를 쓰는 최종 운영선

이번 보강을 거치면서 Claude Code나 비슷한 에이전트형 도구는 “일을 대신 끝내는 도구”보다 “작업 단위를 유지하는 도구”에 가깝다고 봤습니다. 실제로 안정적이었던 범위는 글 후보를 고르고, 기존 글을 읽고, 내부 링크와 운영 메모를 추가하고, npm run build와 정적 검증 결과를 남기는 정도였습니다.

반대로 여전히 사람이 붙잡아야 하는 버튼은 분명합니다.

허용: 기존 Markdown 글 보강, 검증 명령 실행, 로컬 커밋 메시지 정리
보류: git push, Cloudflare 콘솔, Search Console, AdSense 신청, 실제 연락처 공개
확인: 공개 URL 반영 여부, canonical, index/follow, sitemap URL 수

이 선을 문서로 남기면 다음 블로그에도 그대로 가져갈 수 있습니다. Claude Code는 프롬프트보다 중요한 작업 분해 방식처럼 일을 잘게 자를 때 효과가 있고, 실제 배포 검증은 Cloudflare Pages 배포 후 꼭 확인하는 체크리스트와 함께 봐야 합니다. 도구가 빨라질수록 책임 경계를 더 명확히 쓰는 쪽이 안전했습니다.

비서처럼 쓸 때의 기준

Claude Code는 방향을 대신 정해주는 사람이라기보다, 제가 정한 방향을 빠르게 실행해주는 비서에 가깝습니다. 그래서 요청을 줄 때도 “좋게 해줘”보다 “이 파일을 이 기준으로 고쳐줘”가 더 잘 맞았습니다.

Daejin Lab에서는 앞으로도 반복 점검, 파일 수정, 빌드 확인에는 적극적으로 쓸 생각입니다. 대신 발행, 배포, 수익화 판단은 제가 마지막에 확인하는 선을 유지하려고 합니다.

비서처럼 쓰려면 제가 먼저 일을 정리해야 했다

Claude Code가 편했던 건 맞지만, 아무 말이나 던졌을 때 좋은 비서가 되는 건 아니었습니다. 제가 프로젝트 상황과 멈춰야 할 지점을 먼저 적어줘야 결과가 안정됐습니다. 결국 좋은 도구를 쓰는 문제라기보다, 제가 일을 얼마나 말로 정리할 수 있느냐의 문제였습니다.

2026-05-31에 다시 본 작업 비서의 경계

Claude Code 같은 도구를 “프로젝트 작업 비서”로 쓴다는 말은 편하지만, 경계가 없으면 위험합니다. 특히 블로그 공개 작업에서는 글을 고치는 것과 발행하는 것이 연결됩니다. 그래서 이번 보강에서는 맡길 일과 맡기지 않을 일을 더 분명하게 나눴습니다.

후보 찾기, 좁은 범위 수정, 검증 명령 실행, 승인 보류로 나누는 Claude Code 작업 비서 경계

이 카드는 AI 작업 비서에게 맡기기 좋은 범위와 사람이 남겨야 할 승인선을 구분한 것입니다.

도구에게 맡기기 좋은 일은 후보 찾기, 반복 수정, 링크 점검, build 실행입니다. 반대로 계정 콘솔 조작, 비밀값 처리, 법적·금융 판단, 최종 발행 승인은 사람이 남겨야 합니다. 이번 AdSense 대응에서도 같은 원칙을 적용했습니다. 약한 글 후보와 검증 명령은 도구가 돕지만, 재검토 요청 버튼은 별도 승인 전에는 누르지 않습니다.

참고한 공식 문서

공식 문서는 도구의 기본 역할과 공개 콘텐츠/보안 기준을 확인하는 데 봅니다. Daejin Lab에서는 이 문서를 바탕으로 “무엇을 맡기고 어디서 멈출지”를 운영선으로 남깁니다.

확인하지 않은 것

이 글은 Claude Code가 모든 작업에 최적이라는 결론이 아닙니다. 도구 선택은 작업 범위, 권한, 검증 가능성에 따라 달라집니다. 이 글에서는 개인 프로젝트에서 작업 비서처럼 쓸 때의 경계를 다룹니다.

FAQ

Claude Code에게 블로그 글을 전부 맡겨도 되나요?

초안과 보강은 맡길 수 있지만 최종 공개 판단은 사람이 해야 합니다. 특히 공개 repo와 자동 배포가 연결된 경우 더 조심해야 합니다.

가장 잘 맡길 수 있는 일은 무엇인가요?

파일 찾기, 후보 정리, 제한된 범위 수정, 테스트 실행처럼 결과를 검증할 수 있는 일입니다.

애드센스 대응에서 어떤 역할을 했나요?

약한 글 선별, 보강 패턴 적용, build와 sitemap/RSS 검증 같은 작업에 잘 맞았습니다. 승인 요청이나 계정 조작은 맡기지 않습니다.