AI 코딩, 비개발자용 명세 5칸 양식과 검토표
AI 코딩으로 비개발자가 사내 업무 도구를 만드는 방법입니다. 대화형 AI · 편집기 안의 AI · 코딩 에이전트 · 노코드 + AI 비교표, 주문 CSV 정리 스크립트로 채운 명세 5칸, 진행 6단계, 공유 전 보안 검토표와 개발자에게 넘기는 기준을 담았습니다.
AI 코딩은 만들 프로그램을 말로 설명하면 AI가 코드를 써 주는 작업 방식으로, 비개발자도 주문 파일 정리 · 엑셀 매크로 · 간단한 사내 안내 페이지 정도는 만들 수 있습니다. 방법은 하나입니다 — 만들 것을 환경 · 입력 · 처리 · 출력 · 예외 다섯 칸 명세로 먼저 쓰고, 작은 단위로 만들어 실행하고 확인하기를 되풀이합니다. 다만 고객 정보를 저장하거나 결제를 다루거나 외부에 공개하는 서비스는 개발자 검토를 거칩니다.
AI 코딩 — 비개발자도 할 수 있나요
혼자 또는 팀 안에서 쓰는 도구라면 됩니다. 매주 손으로 하던 엑셀 정리, 여러 파일을 한 파일로 합치기, 구글 시트에 들어온 문의를 메일로 알리기처럼 입력과 결과가 분명한 일이 잘 맞습니다. 이런 일은 결과가 맞는지 사람이 바로 확인할 수 있어서, AI가 틀린 코드를 써도 손으로 계산한 값과 견주면 틀린 곳이 드러납니다. 말로 설명해 코드를 받는 이 방식을 바이브 코딩(vibe coding)이라고 부르기도 합니다.
어려워지는 지점도 분명합니다. 여러 사람이 동시에 쓰는 서비스, 로그인과 권한, 결제, 개인정보를 저장하는 데이터베이스는 코드가 돌아가는 것만으로는 안전한지 판단하기 어렵습니다. 그래서 비개발자에게 필요한 능력은 코드를 쓰는 것이 아니라 원하는 것을 정확히 설명하고, 결과가 맞는지 확인하는 것입니다. 어떤 반복 업무부터 고를지는 업무 자동화, 어디서부터 시작하나의 기준으로 좁히면 됩니다.
AI 코딩 툴 종류는 어떻게 나뉘나요
도구 이름보다 유형을 먼저 고릅니다. 같은 회사의 도구도 대화창 · 편집기 확장 · 에이전트로 나뉘어 있어서, 내가 어디서 무엇을 할지에 따라 맞는 유형이 다릅니다. 아래 요금 예시는 2026년 10월 15일 각 공식 요금 페이지 기준이며 자주 바뀌므로 쓰는 날 다시 확인합니다.
| 유형 | 쓰는 곳 | 잘하는 일 | 비개발자 난이도 | 요금 구조(예시) |
|---|---|---|---|---|
| 대화형 AI | ChatGPT · Claude · Gemini 같은 브라우저 대화창 | 코드 조각 작성, 오류 메시지 설명 | 쉬움 — 복사해서 붙여 넣기 | 무료 플랜과 월 구독. 예: Claude Pro 월 20달러 |
| 편집기 안의 AI | VS Code 확장(GitHub Copilot 등), Cursor 같은 AI 편집기 | 자동 완성, 파일 단위 수정 | 보통 — 편집기 사용법 필요 | 무료 범위와 월 구독. 예: GitHub Copilot Free는 월 2,000회 자동 완성 · 50회 채팅, Pro 월 10달러 |
| 코딩 에이전트 | 터미널 · 편집기 · 웹에서 동작하는 에이전트 | 여러 파일을 직접 고치고 명령까지 실행 | 보통 이상 — 실행 권한 관리 필요 | 유료 플랜에서 쓰는 예가 있음. 예: Claude Code · Copilot 코딩 에이전트 모두 Pro 이상(무료 플랜 미포함) |
| 노코드 + AI | 앱 · 자동화 빌더 안 | 말로 화면 · 흐름 초안 만들기 | 쉬움 — 빌더 안에서만 동작 | 빌더 요금제에 따름 — 쓰는 날 확인 |
처음이라면 대화형 AI로 시작하는 편이 부담이 적습니다. 코드를 받아 내 PC에서 직접 실행하므로 무엇이 어디서 돌아가는지 보이기 때문입니다. 코딩 에이전트는 파일을 지우거나 명령을 실행할 수 있어 편하지만, 그만큼 맡기는 권한을 먼저 정해야 합니다.
AI 코딩 명세 5칸은 어떻게 쓰나요
예시는 쇼핑몰 관리자 화면에서 내려받은 주문 CSV를 상품별 · 날짜별 합계로 정리하는 스크립트입니다. 열 이름과 조건은 예시로 가정한 값입니다.
| 칸 | 적는 것 | 주문 CSV 정리 예시 |
|---|---|---|
| 환경 | 어디서 무엇으로 실행하나 | 회사 PC(윈도우)에서 파이썬으로 실행. 설치가 안 돼 있으면 설치 방법부터 안내 |
| 입력 | 어떤 파일 · 어떤 열 · 어떤 형식 | 주문 CSV 한 개 — 열은 주문번호 · 주문일 · 상품명 · 옵션 · 수량 · 결제금액 · 주문자 · 연락처 · 주소, 첫 줄은 열 이름 |
| 처리 | 무엇을 어떤 순서로 | 상품명 + 옵션별 수량 합계, 주문일별 결제금액 합계. 주문자 · 연락처 · 주소 열은 읽지 않음 |
| 출력 | 결과물의 모양과 위치 | 새 엑셀 파일 한 개에 시트 두 장(상품별 · 날짜별), 파일 이름에 오늘 날짜 |
| 예외 | 이상한 입력을 만나면 | 빈 줄은 건너뜀, 수량이 숫자가 아닌 줄은 줄 번호를 따로 시트에 적음, 원본 파일은 고치지 않음 |
다섯 칸을 한 문단으로 이어 붙이면 그대로 요청문이 됩니다. 마지막에 "코드를 쓰기 전에 이해한 내용을 다섯 줄로 다시 설명해 달라"는 문장을 붙이면, AI가 잘못 이해한 부분을 코드가 나오기 전에 바로잡을 수 있습니다. 시험용 입력 파일은 실제 주문에서 고객 정보를 지운 10줄짜리 견본으로 따로 만듭니다.
AI 코딩은 어떤 순서로 진행하나요
- 명세 — 위 다섯 칸을 채웁니다. 기능이 여러 개면 가장 작은 것 하나만 먼저 적습니다.
- 생성 — 명세를 붙여 넣고 코드와 실행 방법을 함께 받습니다. 한 번에 한 기능만 요청합니다.
- 실행 — 견본 파일로 돌립니다. 원본이 아닌 복사본 폴더에서 실행합니다.
- 오류 붙여 넣기 — 오류가 나면 메시지 전체와 방금 한 일을 함께 붙여 넣습니다. "안 돼요"만 쓰면 AI도 짐작으로 고칩니다.
- 확인 — 견본 10줄의 합계를 엑셀에서 손으로 더해 결과 파일과 같은지 봅니다.
- 기록 — 완성 코드 · 명세 · 날짜 · 쓴 도구를 한 폴더에 둡니다. 다음에 고칠 때 이 기록을 그대로 붙여 넣습니다.
3번에서 5번까지가 한 바퀴입니다. 한 바퀴가 끝나면 다음 기능 하나를 명세에 더해 같은 순서로 돌립니다. 기능을 한꺼번에 요청하면 오류가 어디서 났는지 찾기 어려워집니다.
AI가 만든 코드를 믿어도 되나요
돌아간다고 안전한 것은 아닙니다. 실행 전과 공유 전에 다섯 가지를 확인합니다.
| 항목 | 확인할 것 | 이렇게 합니다 |
|---|---|---|
| 비밀번호 · 키 | 코드 안에 비밀번호나 API 키가 그대로 적혀 있지 않은가 | 별도 설정 파일로 빼고 공유 폴더 · 저장소에는 올리지 않음. 노출됐다면 그 키를 바로 폐기하고 새로 발급 |
| 개인정보 | 필요 없는 개인정보 열을 읽거나 저장하지 않는가 | 명세 처리 칸에 읽지 않을 열을 적고, 결과 파일에 그 열이 없는지 확인 |
| 백업 | 원본 파일을 덮어쓰지 않는가 | 결과는 늘 새 파일로, 시험은 복사본 폴더에서 |
| 권한 | 지우기 · 보내기 · 결제처럼 되돌릴 수 없는 동작이 있는가 | 실행 전에 한 번 묻는 확인 단계를 넣고, 에이전트에는 삭제 권한을 주지 않음 |
| 외부 전송 | 데이터를 처음 보는 주소로 보내지 않는가 | 모르는 주소 · 설치 패키지가 나오면 왜 필요한지 AI에게 다시 묻고 기록 |
키를 저장소에 올리는 실수에 대비해 GitHub 같은 코드 저장소 서비스는 올라온 키를 찾아 알려 주는 기능을 따로 둡니다. 그래도 가장 확실한 방법은 처음부터 코드에 키를 적지 않는 것입니다.
어디까지 맡기고 어디부터 개발자에게 넘기나요
다음 중 하나라도 해당하면 직접 만든 것을 초안으로 두고 개발자 검토를 받습니다.
- 고객 개인정보를 저장하거나 외부로 보냅니다.
- 결제 · 정산 · 세금 계산처럼 틀리면 돈이 오가는 일입니다.
- 로그인이 있는 화면을 외부에 공개합니다.
- 여러 사람이 동시에 쓰거나, 멈추면 매일 업무가 서는 도구입니다.
이때 직접 만든 명세 5칸과 시험 기록은 그대로 외주 자료가 됩니다. 무엇을 원하는지 이미 문장과 견본으로 정리돼 있어 견적과 일정 이야기가 빨라집니다. 넘길 문서의 목차는 제안요청서(RFP) 쓰는 법에 정리돼 있습니다.
자주 묻는 질문
코딩을 전혀 몰라도 할 수 있나요?
코드 문법은 몰라도 되지만 세 가지는 알아야 합니다. 파일과 폴더가 어디에 있는지, 만든 코드를 어떻게 실행하는지, 오류가 났을 때 메시지 전체를 복사하는 법입니다. 이 세 가지는 첫 요청에서 AI에게 "처음 하는 사람 기준으로 실행 방법부터 알려 달라"고 하면 단계별로 안내받을 수 있습니다.
어떤 언어로 만들어 달라고 해야 하나요?
회사 환경이 정합니다. 엑셀 안에서 버튼으로 돌리려면 VBA 매크로, 구글 시트 안에서 돌리려면 Apps Script, 내 PC의 파일을 한꺼번에 정리하려면 파이썬을 많이 씁니다. 명세의 환경 칸에 "회사 PC는 윈도우, 설치 권한 없음"처럼 제약을 적으면 AI가 그 조건에 맞는 언어를 고르게 할 수 있습니다.
회사 자료를 AI에 넣어도 되나요?
회사 AI 사용 지침의 허용 도구 · 입력 금지 자료 기준을 먼저 봅니다. 지침이 없다면 고객 이름 · 연락처 · 주소는 지운 견본 파일로 만들고, 비밀번호와 접속 키는 넣지 않는 것을 기본으로 둡니다. AI는 열 이름과 형식만 알면 코드를 쓸 수 있어 실제 고객 데이터가 필요하지 않습니다.
만든 도구는 누가 관리하나요?
만든 사람이 관리자입니다. 코드 파일 옆에 명세 5칸 · 만든 날짜 · 쓴 AI 도구 · 실행 방법을 적은 메모를 함께 두면, 담당자가 바뀌어도 다음 사람이 같은 AI에게 메모를 붙여 넣고 이어서 고칠 수 있습니다. 매일 돌아가는 업무가 이 도구에 기대게 되면 그때 개발자 검토로 넘깁니다.
오늘 할 일
이번 주에 손으로 되풀이한 작업 하나를 골라 환경 · 입력 · 처리 · 출력 · 예외 다섯 칸을 한 문단으로 적으십시오. 고객 정보를 지운 10줄짜리 견본 파일까지 만들어 두면 AI 코딩을 바로 시작할 수 있습니다.
이어서 읽기 — 구글 앱스 스크립트 사용법, 자동화 예시 5개 · 앱 만들기, 노코드·외주·직접 개발 비교표 · 챗GPT API, 키 발급 순서와 월 요금 계산표
