오픈코드로 워드프레스 플러그인 만들기: 월 10달러로 시작하는 AI 에이전트
오픈코드(OpenCode)는 터미널에서 쓰는 오픈소스 AI 코딩 에이전트로, 월 10달러 정도로 여러 AI 모델을 바꿔 가며 써 볼 수 있어서 에이전트를 처음 경험해 보기에 부담이 적습니다. 내 PC의 파일을 읽고 고치고 명령을 실행할 수 있기 때문에, “글 하단에 마지막 수정일 표시” 같은 간단한 워드프레스 플러그인을 말로 설명해서 만들어 보는 연습에 잘 맞습니다. 다만 만든 코드는 반드시 테스트 사이트에서 먼저 확인해야 합니다.
목차
오픈코드가 무엇이고 왜 입문용으로 좋은가
오픈코드는 채팅창에서 대화만 하는 AI가 아니라, 내 컴퓨터의 작업 폴더 안에서 직접 파일을 만들고 수정하고 터미널 명령을 실행하는 “에이전트” 도구입니다. 제가 입문용으로 좋다고 보는 이유는 세 가지입니다.

- 비용 부담이 작습니다. 공식 구독 상품인 OpenCode Go는 월 10달러입니다.
- 여러 모델을 한곳에서 써 볼 수 있습니다. Go 하나로 GLM, Kimi, Qwen, DeepSeek, MiniMax 등 여러 회사의 모델을 바꿔 가며 쓸 수 있어, 작업마다 어떤 모델이 맞는지 직접 비교해 볼 수 있습니다.
- 에이전트 방식을 체험하기 좋습니다. 파일을 만들고 고치는 과정을 눈으로 보면서, AI에게 일을 맡길 때 어떻게 지시해야 하는지 감을 잡을 수 있습니다.
OpenCode Go 요금과 모델 (2026년 11월 기준)
OpenCode Go 공식 문서 기준으로 정리하면 다음과 같습니다.
| 항목 | 내용 |
|---|---|
| 요금 | Go 월 $10, Go Plus 월 $40, Go Teams 멤버당 월 $20 |
| 사용 한도 | 모델별 월 사용 금액 한도. 5시간 단위는 월 한도의 20%, 주간은 50% |
| 무료 모델 | Beam Free, Iceman Contributor Free, LongCat 2.5 Free (모두 기간 한정, 지역·데이터 조건 있음) |
| 할인 모델 | Muse Spark Contributor: 요청 데이터를 모델 학습에 쓰는 조건으로 크게 할인 |
| DeepSeek | V4 Pro, V4.1 Flash 포함. 설정에서 지역을 Global로 바꿔야 사용 가능 |
무료 모델과 할인 모델은 내 요청 내용이 모델 학습에 쓰이는 조건이 붙는 경우가 있습니다. 개인 정보나 회사 코드, 비밀번호가 들어간 작업에는 학습에 쓰이지 않는 모델을 고르세요. 모델 목록과 한도는 자주 바뀌므로 구독 전에 공식 문서를 다시 확인하는 것이 좋습니다.
설치하고 연결하기
- 오픈코드 공식 사이트의 설치 안내에 따라 오픈코드를 설치합니다.
- OpenCode 콘솔에서 Go를 구독하고 API 키를 복사합니다.
- 작업할 폴더에서 터미널을 열고 오픈코드를 실행합니다.
/connect를 입력하고 OpenCode Go를 선택한 뒤 API 키를 붙여 넣습니다./models로 사용할 모델을 고릅니다.
간단한 워드프레스 플러그인 만들어 보기
처음에는 사이트에 큰 영향을 주지 않는 작은 기능으로 시작하는 것이 좋습니다. 예를 들어 “글 본문 아래에 마지막 수정일을 표시하는 플러그인”은 파일 하나로 끝나는 연습용으로 적당합니다.

- 빈 작업 폴더 준비: 예를 들어
last-updated-note라는 폴더를 만들고 그 안에서 오픈코드를 실행합니다. - 원하는 동작을 구체적으로 설명: “워드프레스 플러그인을 만들어 줘. 글(post) 본문 맨 아래에 ‘마지막 수정: 날짜’를 표시하고, 수정일이 발행일과 같으면 표시하지 마. 파일은 last-updated-note.php 하나로 만들고 플러그인 헤더를 넣어 줘.”처럼 조건까지 적습니다.
- 만든 코드를 읽어 보기: 에이전트가 만든 파일을 열어 보고, 이해가 안 되는 줄은 “이 줄은 무슨 뜻이야?”라고 다시 물어봅니다.
- 압축해서 테스트 사이트에 설치: 폴더를 zip으로 압축해 테스트용 워드프레스의 플러그인 > 새로 추가 > 플러그인 업로드로 올리고 활성화합니다.
- 동작 확인 후 수정 요청: 표시 위치나 문구가 마음에 들지 않으면 그대로 다시 요청해 고칩니다.
플러그인 기본 구조와 지켜야 할 규칙은 워드프레스 플러그인 개발자 핸드북에 정리되어 있습니다. 에이전트가 만든 코드가 핸드북의 기본 규칙(플러그인 헤더, 직접 접근 차단, 출력 이스케이프)을 지키는지 함께 확인하면 실력도 빨리 늡니다.
실제 사이트에 넣기 전 주의할 점
- 운영 중인 사이트에 바로 올리지 않기: 직접 만든 플러그인도 다른 플러그인과 충돌할 수 있습니다. 테스트용 사이트는 작은 VPS에 이지패널로 워드프레스를 하나 더 띄워 두면 부담 없이 시험할 수 있습니다. 오류가 나면 복구 모드나 plugins 폴더 이름 변경으로 플러그인을 끄는 방법을 미리 알아 두세요.
- 에이전트에게 맡길 폴더를 분리하기: 오픈코드는 실행한 폴더의 파일을 수정할 수 있으므로, 중요한 파일이 있는 폴더에서 실행하지 않습니다.
- 비밀번호를 대화에 넣지 않기: 서버 접속 정보가 필요하면 설정 파일로 따로 관리하고, 워드프레스 API에는 애플리케이션 비밀번호처럼 용도별 비밀번호를 씁니다.
- 백업 후 적용: 운영 사이트에 올릴 때는 백업을 먼저 만들어 둡니다.
에이전트에게 일을 맡기는 요령
- 결과를 구체적으로 설명하기: “멋지게 만들어 줘”보다 “어디에, 무엇을, 어떤 조건에서” 보여 줄지 적어야 원하는 결과가 나옵니다.
- 한 번에 하나씩: 기능을 여러 개 한꺼번에 요청하면 오류를 찾기 어렵습니다. 하나를 완성하고 확인한 뒤 다음 기능을 추가합니다.
- 모델 바꿔 보기: 같은 요청도 모델마다 결과가 다릅니다. 막히면 다른 모델로 같은 요청을 해 보는 것이 Go 구독의 장점입니다.
- 설명 요청하기: 코드를 만든 뒤 “이 코드가 하는 일을 순서대로 설명해 줘”라고 하면 검토가 쉬워집니다.
자주 묻는 질문
코딩을 전혀 몰라도 쓸 수 있나요?
간단한 기능은 설명만으로 만들 수 있습니다. 다만 결과물을 확인하고 문제를 설명하는 정도의 기본 이해는 필요하니, 만든 코드를 한 줄씩 물어보며 익히는 것을 권합니다.
Go 구독 없이도 쓸 수 있나요?
오픈코드 자체는 오픈소스라 다른 AI 서비스의 API 키를 연결해서 쓸 수도 있습니다. Go는 여러 모델을 한 번에 저렴하게 쓰기 위한 선택지입니다.
한도를 다 쓰면 어떻게 되나요?
공식 문서에 따르면 콘솔에 잔액이 있으면 추가 사용(Extra Usage)을 켜서 종량제로 이어 쓸 수 있고, 무료 모델은 계속 사용할 수 있습니다.


