고지 사항: 저는 Mac 앱인 ShipPress를 제작했으며, 끝부분에 간략하게 언급합니다. 그 이전의 모든 내용은 제 도구 없이도 작동합니다.
Claude Code, Codex 및 유사한 에이전트들은 이제 워드프레스 테마나 페이지 세트에 놀라울 정도로 많은 작업을 수행할 수 있습니다. 때로는 요청받은 범위를 약간 넘어서기도 합니다. 즉, 건드려서는 안 되는 파일을 편집하거나 데이터베이스에 직접 쓰는 경우도 발생합니다. 이 다섯 가지는 몇 달 동안 AI 에이전트를 워드프레스와 결합해 사용하면서 제가 처음부터 했어야 한다고 생각하는 것들입니다.
1. 운영 환경(Production)이 아닌 로컬 또는 스테이징 환경에서 작업하기
이는 당연하게 들리지만, 가장 많은 것을 절약해 주는 방법입니다. 에이전트가 라이브 사이트에 대해 SSH를 통해 작업을 하도록 두지 마십시오. 변경 사항은 로컬이나 스테이징 복사본에서 만들고, 확인한 다음 옮기는 것이 좋습니다.
wp-env, Local, Docker: 어떤 것을 사용하든 상관없습니다. 중요한 것은 무언가를 망가뜨려도 아무도 피해를 입지 않는 장소여야 한다는 것입니다.
2. 작업 디렉터리 제한하기
에이전트에게 전체 리포지토리(repo)나 워드프레스 루트 폴더 전체를 넘겨주면, wp-config.php와 핵심 파일들까지 읽게 됩니다. 테마에서만 작동하게 하고 싶다면, 테마 폴더 안에서 시작하십시오:
cd wp-content/themes/my-theme
claude # 또는 codex 등
Claude Code를 사용할 경우, 프로젝트 내에 작성된 CLAUDE.md 파일에 허용되는 내용을 명시하면 큰 도움이 됩니다:
## 규칙
- wp-content/themes/my-theme 아래의 파일만 변경할 것
- wp-config.php 또는 핵심 파일을 읽거나 변경하지 말 것
...
3. 파일뿐만 아니라 데이터베이스도 백업하기
git은 파일을 되돌릴 수 있습니다. 하지만 게시물(posts), 페이지, 메뉴 및 블록 테마의 편집 내용은 데이터베이스에 저장되며, git만으로는 AI가 재작성한 페이지를 복구할 수 없습니다.
따라서 매 세션 전에 WP-CLI로 내보내기(export) 하십시오:
# before
wp db export backups/before-ai-$(date +%Y%m%d-%H%M).sql
...
그리고 파일 측면에서는 매 단계 후에 커밋(commit)하십시오:
git add -A && git commit -m "before: ask agent to change header colour"
4. 요청을 작게 유지하기
"웹사이트 전체를 만들어줘(Build me the whole website)"라고 요청하는 것보다 "홈페이지의 히어로 섹션만 만들어줘(build only the hero section of the home page)"라고 요청하는 것이 검토하고 되돌리기 훨씬 쉽습니다. 작은 단위로 작업(요청, 확인, 스냅샷)을 진행하면 어떤 지침이 무언가를 망가뜨렸는지 즉시 알 수 있습니다.
5. 배포 전에 diff를 확인하세요
어떤 것이든 라이브 상태가 되기 전에, 저는 적어도 다음 사항들을 확인합니다:
git diff --stat # 어떤 파일이 변경되었나요?
wp plugin list --status=active # 인식하지 못하는 플러그인이 있나요?
wp option get siteurl # URL이 재작성되었나요?
만약 siteurl 또는 home이 프로덕션 환경에서 여전히 로컬 URL로 설정되어 있다면, 사이트가 로드되지 않습니다. 이 부분은 한 번 더 자세히 살펴볼 가치가 있습니다.
요약
- 로컬 또는 스테이징(staging) 환경에서 작업하세요
- 에이전트가 작업할 범위를 제한하세요
- 파일은 git으로, 데이터베이스는
wp db export로 백업하세요
- 작게 요청하고 매번 확인하세요
- 배포 전에 diff와 설정을 확인하세요
참고 사항: 이를 대신 해주는 앱
1단계부터 3단계까지의 과정은 저에게 너무 많은 수동 작업이었기 때문에, 저는 ShipPress라는 무료 Mac 앱을 만들었습니다. 이 앱은 로컬 WordPress 사이트를 설정해주고, 이미 가지고 있는 AI CLI(Claude Code, Codex, Grok Build, Antigravity CLI, Cursor CLI)가 사이트를 구축하도록 허용하며, AI가 무언가를 변경할 때마다 복원 지점(restore point)을 생성합니다. InstaWP와 같은 호스트 통합이나 SSH를 통해, 또는 정적 내보내기(static export) 형태로 게시할 수 있습니다.
다운로드: https://shippress.codotx.com/?ref=devto-en
AI 에이전트가 워드프레스 주변에서 안전하게 작동하도록 자신만의 노하우가 있다면 댓글로 알려주시면 감사하겠습니다.
Oberon Lai