제작사가 Claude Code에 고객 사이트를 맡기기 전 권한 체크리스트

제작사 업무에는 랜딩페이지 CTA, 히어로 문구, 캠페인 날짜, 사례 도입부처럼 작은 수정이 많습니다. Claude Code는 빠르게 고칠 수 있지만, 고객 사이트에서는 속도보다 경계가 먼저입니다.

이 체크리스트는 WordPress, Astro, Next.js, 정적 LP, 폼이 있는 캠페인 페이지를 운영하는 팀을 위한 것입니다.

핵심 요점

• 수정 전 파일을 읽기 전용, 편집 가능, 금지로 나눕니다.
• Claude Code에는 diff, build, 링크 확인, 모바일 확인을 맡깁니다. 고객 승인과 공개 판단은 사람이 합니다.
• 고객 데이터, 광고 태그, 폼 전송 위치, 분석 코드, 결제 설정, 법률 문구는 보호합니다.
• 혼자라면 무료 PDF, 제작 흐름 표준화는 setup guide, 다인 고객 업무는 상담이 맞습니다.

권한을 세 단계로 나누기

에이전시 사고는 기술보다 범위에서 자주 납니다. “이 버튼만” 고친다는 일이 공통 헤더나 추적 태그까지 번질 수 있습니다.

먼저 세 단계를 적습니다.

단계	의미	예시
읽기 전용	볼 수 있지만 수정하지 않음	기존 LP, 디자인 참고, 이전 CTA
편집 가능	이번 작업에서 수정 가능	대상 페이지, 문구 데이터
금지	필요 없으면 열지 않고 수정 금지	.env, 고객 목록, 광고 픽셀, 결제 설정

경계를 글로 쓰면 Claude Code 지시가 안정됩니다.

Claude Code의 역할

Claude Code는 버튼 문구 수정, 링크 유지, build 실행, 모바일 너비 확인 같은 구체 작업에 적합합니다.

사람은 브랜드 톤, 법무 표현, 광고 약속, 공개 여부를 판단합니다. 고객 승인은 사람의 책임입니다.

복사해서 쓰는 지시문

이 고객 랜딩페이지의 CTA 문구만 수정하세요.

편집 가능:
- site/src/pages/campaign.astro
- site/src/content/campaign-copy.ts

읽기 전용:
- site/src/layouts/BaseLayout.astro
- site/src/components/Header.astro

건드리지 말 것:
- .env*
- form 제출 위치
- analytics / ads / pixel 코드
- 가격, 계약, 법률, 개인정보처리방침

작업:
1. CTA 제목을 짧게 만들기
2. 버튼을 “무료 상담 예약”으로 바꾸기
3. 링크는 /training/ 유지
4. npm run build 실행
5. diff와 확인 결과 보고

읽기 전용과 편집 가능의 분리가 중요합니다. 문맥을 읽는 것과 수정 권한은 다릅니다.

작은 보호 스크립트

const diff = process.env.DIFF_TEXT || "";
const forbidden = [".env", "gtag(", "fbq(", "stripe", "customer_email"];

const hits = forbidden.filter((word) => diff.includes(word));
if (hits.length) {
  console.error("금지 영역으로 보이는 diff:", hits.join(", "));
  process.exit(1);
}

console.log("금지어 체크 통과");

실제로는 git diff를 DIFF_TEXT로 넘깁니다. 완벽하지 않지만 광고, 결제, 고객 데이터 실수를 빨리 찾습니다.

세 가지 사용 사례

1. LP 버튼 문구 변경
편집 가능 범위는 대상 페이지뿐입니다. 폼 주소, 태그, 가격은 금지합니다.

2. 사례 페이지 도입부 줄이기
과거 사례는 읽기 전용, 대상 글만 편집합니다. 고객명과 성과 수치는 사람이 승인합니다.

3. 캠페인 종료일 교체
날짜 하나도 OGP, 구조화 데이터, CTA, 폼 마감과 연결됩니다. 영향 목록은 Claude Code, 공개 승인은 사람이 합니다.

함정과 수정

함정 1: “이 부분 좋게 해줘”
넓은 수정이 됩니다. 파일을 먼저 나열합니다.

함정 2: 금지 목록 없음
.env, 광고, 결제, 폼은 반드시 보호 목록에 씁니다.

함정 3: build 성공만 보고 공개
CTA 링크나 canonical 오류는 build로 알 수 없습니다. 공개 URL, h1, 링크, 모바일을 봅니다.

함정 4: 승인 전 강한 표현 사용
“보장”, “최저가”, “1위”는 근거가 필요합니다. 사람이 막아야 합니다.

CTA: 다음 단계

혼자 익히려면 무료 치트시트부터 보세요. 제작팀의 CLAUDE.md, 권한, hooks, setup을 정리하려면 setup guide가 맞습니다.

여러 명이 고객 프로젝트에 적용한다면 도입 상담에서 읽기 전용, 편집 가능, 금지 영역을 실제 프로젝트 기준으로 설계할 수 있습니다. 함께 권한 가이드와 팀 롤아웃 위험 대장도 읽어보세요.

고객별 운영 메모를 남기기

제작사에서 이 체크리스트를 쓰려면 고객마다 한 장의 운영 메모를 둡니다. 매번 새로 판단하면 담당자가 바뀔 때 경계가 흔들립니다. 메모에는 편집 가능한 디렉터리, 확인할 공개 URL, 금지 설정 파일, 승인자, 되돌리는 방법을 적습니다.

폼이 있는 LP는 폼 제출 위치, 감사 페이지, 측정 이벤트, 광고 링크를 한 묶음으로 봐야 합니다. 버튼 문구만 바꿨다고 생각해도 이벤트 이름이나 링크가 어긋나면 문의 측정이 깨집니다.

Claude Code에게는 결과 보고 형식도 지정합니다. 변경 파일, 건드리지 않은 금지 영역, build 결과, 모바일 확인, CTA 링크를 다섯 줄로 보고하게 하면 담당자는 공개 전 확인 지점을 놓치지 않습니다.

수익 동선까지 포함한 대행사 체크

대행사 프로젝트에서는 권한 체크와 수익 동선 체크를 따로 보지 않는 편이 안전합니다. CTA 문구를 바꾸거나, 무료 자료 버튼을 추가하거나, Gumroad 교재 링크를 넣거나, 상담 폼으로 유도하는 일은 작은 수정처럼 보이지만 고객사의 리드 측정에 직접 영향을 줍니다.

그래서 Claude Code 작업 요청에는 수정 가능한 UI뿐 아니라 깨지면 안 되는 측정도 적어야 합니다. 폼 제출 이벤트, 감사 페이지 URL, 광고 파라미터, 상품 링크, 문의 이메일을 함께 확인합니다. 공개 확인에서는 페이지가 열리는지만 보지 말고 사용자가 다음 행동으로 갈 수 있는지 봅니다.

체크리스트를 운영에 넣을 때는 고객명, 담당자, 공개 URL, 주요 CTA, 되돌리는 방법을 한 줄로 남깁니다. 이 한 줄이 있으면 다음 달 개선이나 담당자 교체 때 같은 판단을 반복하지 않아도 됩니다.

특히 외주 제작에서는 빠른 수정 요청이 자주 들어옵니다. 이때 범위가 흐려지면 AI가 편한 방향으로 넓게 수정할 수 있습니다. 작은 문구 변경이라도 금지 파일과 확인 URL을 함께 주면, 속도와 안전을 동시에 가져갈 수 있습니다.

마지막으로 공개 후 문의 수를 리뷰에 넣습니다. 화면이 정상이어도 버튼 클릭과 폼 도달이 줄어들 수 있습니다. 권한, 표시, 클릭, 폼 도달을 같은 표에서 봐야 수익 동선까지 확인됩니다. 이 기록이 있어야 다음 수정의 우선순위도 정해집니다. 고객 보고도 더 짧아집니다. 승인도 쉬워집니다.

실제로 시도한 결과

LP CTA 수정에 체크리스트를 적용했습니다. 편집 파일을 두 개로 제한하고 폼 주소와 추적 태그를 금지한 뒤 build와 모바일을 확인했습니다.

가장 효과적인 부분은 읽기 전용과 편집 가능을 나눈 것입니다. Claude Code는 문맥을 읽되 diff는 좁게 유지했습니다. 에이전시 운영에서는 경계 작성이 품질을 좌우합니다.