[2회차] Vibe Coding 중급

활용 가능한 AI 도구, 필수 기능, 실전 예시

지난 글에서는 Vibe Coding의 기본 개념과 간단한 사용법을 살펴보았습니다.
이번 글에서는 한 단계 더 들어가서 실제 개발에 활용할 수 있는 AI 도구, 반드시 알아야 할 기능, 그리고 실무형 예시를 정리해 보겠습니다.

Vibe Coding은 단순히 “코드 만들어줘”라고 요청하는 수준에서 끝나지 않습니다.
중급 단계부터는 AI를 개발 파트너처럼 활용해야 합니다.

즉, AI에게 다음과 같은 작업을 맡길 수 있어야 합니다.

• 화면 설계
• DB 테이블 설계
• API 설계
• 코드 생성
• 오류 분석
• 리팩토링
• 테스트 코드 작성
• 문서 작성
• 배포 절차 정리

---

1. Vibe Coding에 활용 가능한 AI 도구

현재 Vibe Coding에 활용할 수 있는 AI 도구는 다양합니다.
각 도구마다 장점이 다르기 때문에 목적에 맞게 선택하는 것이 중요합니다.

---

2. ChatGPT

ChatGPT는 가장 범용적으로 사용할 수 있는 AI 도구입니다.

활용 범위가 넓습니다.

• 코드 작성
• 오류 분석
• SQL 작성
• 화면 설계
• 블로그 작성
• 제안서 작성
• 매뉴얼 작성
• API 사용법 정리
• 개발 방향 검토

특히 개발 초기에 아이디어를 구체화하거나, 기존 소스를 붙여 넣고 오류를 분석할 때 유용합니다.

예를 들어 다음과 같이 요청할 수 있습니다.

C# WinForm에서 MariaDB를 연결해서 품목 목록을 조회하는 코드를 만들어줘.
연결 오류가 발생해도 프로그램이 종료되지 않게 하고, 오류 내용은 log 폴더에 날짜별 txt 파일로 저장해줘.

이런 식으로 요청하면 단순 코드뿐 아니라 예외 처리와 로그 구조까지 함께 받을 수 있습니다.

---

3. Codex

Codex는 코딩 작업에 특화된 AI 도구입니다.
단순히 코드를 답변으로 보여주는 수준을 넘어, 프로젝트 구조를 이해하고 파일 단위로 수정하는 방식에 적합합니다.

특히 다음 작업에 유리합니다.

• 기존 프로젝트 분석
• 여러 파일 동시 수정
• 빌드 오류 수정
• 테스트 실행
• 반복 작업 자동화
• 기능 단위 개발
• 코드 리팩토링

예를 들어 기존 C# 프로젝트가 있을 때 다음처럼 요청할 수 있습니다.

현재 WinForm 프로젝트에서 사용하지 않는 버튼과 이벤트를 정리해줘.
기존 기능은 유지하고, 오류가 발생할 가능성이 있는 부분은 try-catch로 보완해줘.
log 폴더에 일자별 로그를 남기도록 공통 로그 클래스를 추가해줘.

이런 작업은 일반 대화형 AI보다 프로젝트 파일을 직접 다루는 AI 도구가 더 적합합니다.

---

4. Claude / Claude Code

Claude는 긴 문서나 큰 코드 분석에 강점이 있습니다.
Claude Code는 에이전트형 코딩 도구로, 코드베이스를 읽고 수정하고 명령 실행까지 연결하는 방식에 적합합니다.

활용 예시는 다음과 같습니다.

• 복잡한 소스 구조 분석
• 기능별 영향도 분석
• 리팩토링 방향 제안
• 대용량 코드 리뷰
• 터미널 기반 개발 보조
• 반복 수정 작업

예를 들어 다음과 같은 요청이 가능합니다.

이 프로젝트의 로그인, 권한, 메뉴 처리 구조를 분석해줘.
메뉴 권한이 없는 사용자는 버튼이 보이지 않게 수정하고, 전체 구조를 유지하면서 최소 수정으로 반영해줘.

---

5. GitHub Copilot

GitHub Copilot은 개발 도구 안에서 바로 코드를 추천해 주는 방식에 강점이 있습니다.

Visual Studio Code, Visual Studio, JetBrains 계열 IDE와 함께 사용하면 편리합니다.

활용하기 좋은 작업은 다음과 같습니다.

• 함수 자동 완성
• 반복 코드 작성
• 단위 코드 생성
• 주석 기반 코드 생성
• 테스트 코드 초안 작성
• GitHub 저장소 기반 코드 개선

예를 들어 주석으로 다음처럼 작성하면 Copilot이 코드를 제안합니다.

// MariaDB에서 품목코드와 품목명을 조회해서 DataGridView에 표시한다.

이런 방식은 개발 중간중간 빠르게 코드를 보완하는 데 좋습니다.

---

6. Cursor / Windsurf

Cursor와 Windsurf는 AI 기반 IDE에 가깝습니다.
프로젝트 전체를 읽고, 파일을 수정하고, 채팅과 코드 편집을 함께 처리하는 방식입니다.

장점은 다음과 같습니다.

• 코드와 대화가 한 화면에서 이루어진다.
• 여러 파일을 동시에 수정하기 쉽다.
• 프로젝트 컨텍스트를 이해한다.
• 반복적인 UI 수정에 편리하다.
• 프론트엔드 개발에 특히 유용하다.

웹, 앱, 프론트엔드, API 서버를 함께 다루는 프로젝트라면 이런 AI IDE도 좋은 선택입니다.

---

7. 중급 단계에서 꼭 알아야 할 필수 기능

Vibe Coding 중급 단계에서는 단순히 코드를 생성하는 것보다, AI에게 작업 단위를 정확하게 나누어 지시하는 능력이 중요합니다.

---

8. 요구사항 분해

좋지 않은 요청:

ERP 만들어줘.

좋은 요청:

ERP의 거래처 관리 화면을 먼저 만들어줘.
거래처코드, 거래처명, 사업자번호, 대표자명, 전화번호, 사용여부를 관리해줘.
조회, 신규, 저장, 삭제 기능을 포함해줘.
DB는 MariaDB이고 C# WinForm 기준으로 작성해줘.

업무 시스템은 반드시 기능을 쪼개야 합니다.

예를 들어 MES라면 다음처럼 나눌 수 있습니다.

• 품목관리
• BOM관리
• 공정관리
• 설비관리
• 작업지시
• 생산실적
• LOT 추적
• 불량등록
• 출하검사
• 재고조회

이렇게 나누어 요청해야 AI가 정확한 결과를 만듭니다.

---

9. 기존 소스 기준 수정 요청

실무에서는 새로 만드는 것보다 기존 소스를 수정하는 일이 많습니다.
이때는 반드시 “기존 구조 유지”를 요청해야 합니다.

예시는 다음과 같습니다.

첨부한 기존 소스 기준으로 수정해줘.
기존 변수명, 클래스명, 이벤트명은 가능하면 유지해줘.
새 기능 추가가 필요한 부분만 최소 수정해줘.
전체 소스를 다시 만들지 말고 변경된 파일 기준으로 정리해줘.

이렇게 요청해야 불필요하게 전체 구조가 바뀌는 문제를 줄일 수 있습니다.

---

10. 오류 메시지 기반 수정

Vibe Coding에서 오류 메시지는 매우 중요합니다.
오류 메시지를 정확히 제공하면 AI가 훨씬 빠르게 원인을 찾습니다.

예를 들어 다음처럼 요청합니다.

다음 오류가 발생해.
'DataRow'은 System.Data.DataRow 및 Syncfusion.WinForms.DataGrid.DataRow 사이에 모호한 참조입니다.
기존 기능은 유지하고 오류가 발생하지 않게 수정 방법을 알려줘.

이 경우 AI는 보통 다음과 같은 해결책을 제안할 수 있습니다.

• using 충돌 제거
• System.Data.DataRow처럼 전체 네임스페이스 명시
• 별칭 사용
• 불필요한 참조 정리

오류를 설명할 때는 다음 정보를 함께 주면 좋습니다.

• 개발 언어
• 프레임워크
• 오류 메시지 전체
• 발생 위치
• 최근 수정한 내용
• 원하는 결과

---

11. 실무 예시 1: C# WinForm 품목관리 화면

요청 예시는 다음과 같습니다.

C# WinForm으로 품목관리 화면을 만들어줘.
DB는 MariaDB를 사용하고 테이블은 item_master야.
컬럼은 item_code, item_name, spec, unit, use_yn, remark로 구성해줘.
상단에는 품목코드, 품목명 검색 조건을 두고, 중앙에는 DataGridView를 배치해줘.
하단에는 조회, 신규, 저장, 삭제, 닫기 버튼을 배치해줘.
저장 시 필수값 검사를 하고, 오류는 MessageBox와 log 파일에 남겨줘.

이 정도로 요청하면 AI가 화면 구조, DB 처리, 이벤트 구조를 어느 정도 맞춰서 생성할 수 있습니다.

---

12. 실무 예시 2: Python Flask API 서버

요청 예시는 다음과 같습니다.

Python Flask로 품목관리 API를 만들어줘.
MariaDB와 연결하고, 품목 조회, 단건 조회, 등록, 수정, 삭제 API를 만들어줘.
JSON 형태로 요청과 응답을 처리해줘.
DB 오류가 발생하면 500 오류와 함께 오류 메시지를 JSON으로 반환해줘.

이렇게 요청하면 프론트엔드, 앱, WinForm에서 공통으로 호출할 수 있는 API 서버 초안을 만들 수 있습니다.

---

13. 실무 예시 3: MAUI 앱 화면

요청 예시는 다음과 같습니다.

.NET MAUI로 파일 업로드 앱 화면을 만들어줘.
사진 촬영, 이미지 선택, 서버 업로드, 서버 파일 목록 조회 기능을 포함해줘.
업로드 결과와 오류 내용은 하단 로그 영역에 표시해줘.
화면은 모바일 기준으로 스크롤 가능하게 구성해줘.

앱 개발에서는 화면 크기, 권한, 네트워크 오류, 이미지 처리 등을 반드시 함께 요청해야 합니다.

---

14. 중급 단계에서 중요한 검증 방법

AI가 만든 코드는 반드시 검증해야 합니다.

확인해야 할 항목은 다음과 같습니다.

• 빌드가 되는가?
• 실행 중 오류가 없는가?
• DB 연결이 정상인가?
• 저장/수정/삭제가 정상인가?
• 예외 처리가 되어 있는가?
• 로그가 남는가?
• 사용하지 않는 코드가 포함되어 있지 않은가?
• 보안상 위험한 정보가 코드에 직접 들어가 있지 않은가?

특히 DB 비밀번호, API Key, 인증 토큰은 코드에 직접 넣지 않는 것이 좋습니다.
환경설정 파일이나 보안 저장소를 사용하는 방식이 바람직합니다.

---

15. 중급용 프롬프트 템플릿

아래 템플릿을 사용하면 실무 요청 품질을 높일 수 있습니다.

[개발 환경]
- 언어:
- 프레임워크:
- DB:
- 사용 컨트롤:

[만들 기능]
- 기능명:
- 주요 화면:
- 주요 버튼:
- 주요 처리:

[데이터 구조]
- 테이블명:
- 컬럼명:
- 필수값:

[처리 조건]
- 조회 조건:
- 저장 조건:
- 삭제 조건:
- 오류 처리:
- 로그 처리:

[요청 사항]
- 기존 구조 유지 여부:
- 전체 소스 필요 여부:
- 변경 부분만 표시 여부:
- 디자인 개선 필요 여부:

이런 형식으로 요청하면 AI가 훨씬 안정적으로 결과를 만들어 줍니다.

---

16. 정리

Vibe Coding 중급 단계의 핵심은 “AI에게 일을 잘 나누어 맡기는 것”입니다.

기초 단계에서는 간단한 코드 생성과 오류 수정이 중심이었다면, 중급 단계에서는 화면, DB, API, 예외 처리, 로그, 테스트, 문서까지 개발 흐름 전체에 AI를 활용해야 합니다.

하지만 여전히 최종 검토는 개발자의 몫입니다.
AI가 만든 코드를 그대로 믿기보다, 실행하고 확인하고 수정하는 반복 과정이 필요합니다.

다음 글에서는 고급 단계로 넘어가겠습니다.
고급 단계에서는 단순 AI 대화가 아니라, 에이전트 기반 개발 방식, 프로젝트 전체 수정, 자동 테스트, Git 연동, 실무 적용 기준까지 살펴보겠습니다.