Claude Code로 워드프레스 플러그인 만들기: 실전 튜토리얼

프레스 쿠키 · 2026년 4월 29일 · 6분 읽기 · 조회 14

코딩을 잘 몰라도 워드프레스 플러그인을 직접 만들고 싶었던 적 있으신가요? Claude Code를 활용하면 생각보다 훨씬 쉽게 나만의 플러그인을 완성할 수 있습니다. 오늘은 실제 제작 과정을 단계별로 안내해 드릴게요.

Claude Code란? 왜 플러그인 개발에 적합할까?

Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트입니다. 단순히 코드를 생성해 주는 것을 넘어서, 파일을 직접 읽고 수정하며 명령어를 실행하는 자율적인 개발 파트너 역할을 해줍니다.

워드프레스 플러그인 개발에 특히 유용한 이유가 있어요.

PHP 파일 구조를 자동으로 생성해 줍니다
워드프레스 코딩 표준(WordPress Coding Standards)을 이해하고 적용합니다
오류가 발생하면 스스로 디버깅 후 수정을 시도합니다
플러그인 헤더, 훅(Hook), 필터(Filter) 등 워드프레스 특유의 문법을 잘 처리합니다

기존 챗봇형 AI와 달리 Claude Code는 프로젝트 전체 맥락을 유지하면서 작업하기 때문에, 복잡한 플러그인도 일관성 있게 완성할 수 있습니다.

실전 튜토리얼: 간단한 공지 플러그인 만들기

실제로 “사이트 상단에 공지 배너를 표시하는 플러그인”을 함께 만들어 보겠습니다.

1단계: 프로젝트 폴더 준비

터미널에서 워드프레스 플러그인 디렉토리로 이동한 뒤 Claude Code를 실행합니다.

cd /wp-content/plugins
claude

2단계: Claude Code에게 명확하게 지시하기

Claude Code 사용법의 핵심은 구체적인 프롬프트입니다. 아래처럼 요청해 보세요.

“워드프레스 플러그인을 만들어줘. 플러그인 이름은 ‘Simple Notice Bar’이고, 관리자 페이지에서 공지 텍스트와 배경색을 설정할 수 있어야 해. 설정한 내용이 사이트 최상단에 배너로 표시되어야 하고, 사용자가 닫기 버튼으로 숨길 수 있어야 해.”

Claude Code는 이 요청을 받아 자동으로 아래 파일들을 생성합니다.

simple-notice-bar/simple-notice-bar.php (메인 플러그인 파일)
simple-notice-bar/admin/settings-page.php (관리자 설정 페이지)
simple-notice-bar/assets/style.css (배너 스타일)
simple-notice-bar/assets/script.js (닫기 기능 스크립트)

3단계: 수정 요청으로 기능 다듬기

생성된 코드를 테스트하다가 문제가 생기면, 그냥 대화하듯 수정을 요청하면 됩니다.

“닫기 버튼을 누르면 오늘 하루 동안 다시 표시되지 않도록 쿠키를 적용해줘.”

Claude Code는 기존 파일을 직접 열어 해당 로직을 추가해 줍니다. 따로 파일을 열거나 붙여넣기할 필요가 없어요.

Claude Code 사용법: 플러그인 개발 핵심 팁

실제로 사용해 보면서 효율을 높이는 팁들을 정리했습니다.

💡 CLAUDE.md 파일을 활용하세요
프로젝트 루트에 CLAUDE.md 파일을 만들어 프로젝트 규칙을 적어두면, Claude Code가 매번 동일한 규칙을 참고하며 작업합니다. 예를 들어 “모든 함수명은 snb_ 접두사를 사용할 것”, “PHP 8.0 이상 지원” 같은 내용을 미리 작성해두면 일관성이 높아집니다.

💡 작은 단위로 나눠서 요청하기
한 번에 모든 기능을 요청하기보다는 핵심 기능 → 관리자 UI → 프론트엔드 출력 순서로 단계별 요청하는 것이 결과물 품질에 훨씬 좋습니다.

💡 /review 명령으로 코드 검토 요청
완성 후 /review 명령어를 입력하면 보안 취약점이나 성능 이슈를 자체적으로 점검해 줍니다. 워드프레스 플러그인 배포 전 필수 과정으로 활용해 보세요.

💡 기존 플러그인 분석도 가능
이미 사용 중인 플러그인 코드를 붙여넣고 “이 코드의 구조를 설명하고 개선점을 알려줘”라고 하면 학습 도구로도 활용할 수 있습니다.