코딩을 몰라도 첫 화면을 띄우는 과정부터

ChatGPT에게 “이런 프로그램을 만들고 싶다”고 요청하면 몇 초 뒤 코드가 길게 나타납니다. 초보자에게 진짜 어려운 순간은 그다음입니다. “그래서 이걸 어디에 넣고, 어떻게 실행하지?”라는 질문이 생기기 때문입니다.

MathGenix를 처음 만들 때도 비슷했습니다. AI가 코드를 만들어주는 것과 그 코드가 실제 프로그램으로 실행되는 것은 전혀 다른 문제였습니다. 이 글에서는 복잡한 개발 환경을 설명하기보다, AI가 만든 코드가 실제 화면으로 나타나는 기본 흐름을 이해해보겠습니다.

오늘의 목표

  • 코드와 프로그램의 차이를 이해합니다.
  • 코드 파일을 만들고 실행한다는 의미를 이해합니다.
  • AI에게 처음 코드를 요청할 때 무엇을 함께 물어봐야 하는지 배웁니다.
  • 오류가 나왔을 때 당황하지 않고 AI에게 다시 질문하는 방법을 익힙니다.

01. 코드는 완성품이 아니라 설계도에 가깝다

AI가 만들어준 코드는 화면에 보이는 글자들의 묶음입니다. 그 자체로는 우리가 클릭해서 사용하는 서비스가 아닙니다. 컴퓨터가 이 코드를 읽고 실행해야 실제 프로그램이 됩니다.

요리로 비유하면 코드는 레시피이고, 실행은 그 레시피대로 실제 음식을 만드는 과정입니다. 레시피만 복사해놓았다고 음식이 완성되지 않는 것과 같습니다.

02. 먼저 “어떤 파일로 저장해야 하나요?”를 물어보자

초보자에게 중요한 습관은 코드만 요청하지 않는 것입니다. 예를 들어 AI가 HTML 코드를 만들어줬다면 “이 코드는 어떤 파일명으로 저장해야 하나요? Windows에서 가장 간단하게 확인하는 방법도 알려줘”라고 같이 물어보는 것이 좋습니다.

HTML이라면 보통 .html 확장자의 파일로 저장해 브라우저에서 열 수 있고, Python이라면 Python 실행 환경이 필요합니다. 즉 언어마다 실행 방법이 다릅니다. 그래서 코드와 함께 실행 방법을 반드시 받아야 합니다.

03. 처음에는 아주 작은 것부터 실행한다

처음부터 로그인, 데이터베이스, AI 호출까지 모두 들어간 프로그램을 실행하려 하면 오류가 생겼을 때 어디가 문제인지 찾기 어렵습니다. 가장 좋은 방법은 “화면에 제목 하나 띄우기”, “버튼 하나 만들기”처럼 아주 작은 코드부터 실제로 실행해보는 것입니다.

작은 결과가 화면에 나타나는 경험이 중요한 이유는 “AI에게 요청 → 파일 저장 → 실행 → 결과 확인”이라는 개발의 기본 반복 과정을 익히게 해주기 때문입니다.

04. 오류 화면도 중요한 정보다

초보자는 빨간 글씨가 나오면 코드가 망가졌다고 생각하기 쉽습니다. 하지만 오류 메시지는 컴퓨터가 “어디에서 무엇이 잘못되었는지” 알려주는 단서입니다.

오류가 생겼다면 메시지를 지우거나 대충 설명하지 말고, 가능한 한 전체 문구를 AI에게 보여주는 것이 좋습니다. 화면 캡처를 사용할 때는 계정 정보, API 키, 비밀번호 같은 민감한 내용이 보이지 않는지 먼저 확인해야 합니다.

05. AI에게 이렇게 질문해보자

“저는 코딩을 처음 합니다. 아래 코드를 Windows에서 실행하려고 합니다. 1) 어떤 파일명으로 저장하는지, 2) 어떤 프로그램이 필요한지, 3) 실행 방법, 4) 정상이라면 무엇이 보여야 하는지를 한 단계씩 설명해줘.”

이런 질문은 단순히 “실행해줘”라고 하는 것보다 훨씬 좋습니다. 초보자가 필요한 것은 정답 코드 한 덩어리보다 다음 행동을 이해하는 것이기 때문입니다.

06. MathGenix 초기에 했던 방식

처음에는 ChatGPT가 만들어준 코드를 복사해 직접 파일에 붙여넣는 방식으로 프로그램을 키웠습니다. 작은 기능을 만들 때는 이 방식도 충분히 가능했습니다. 문제는 파일과 기능이 많아지면서부터였습니다. 어느 파일에 무엇을 넣어야 하는지 헷갈리고, 한 곳을 고치면 다른 곳이 영향을 받기 시작했습니다.

이 경험이 다음 단계로 이어집니다. AI가 코드를 만들어주는 것만으로는 부족하고, 프로젝트 전체를 함께 살피는 방식이 필요해진 것입니다.

SUMMARY

  • AI가 만든 코드는 실제로 저장하고 실행해야 프로그램이 됩니다.
  • 언어마다 파일 형식과 실행 방법이 다르므로 코드와 함께 실행 방법을 요청합니다.
  • 처음에는 아주 작은 기능부터 실행하고 결과를 확인합니다.
  • 오류 메시지는 실패가 아니라 문제를 찾는 단서입니다.

ONE LINE TAKEAWAY

첫 개발의 목표는 멋진 서비스를 완성하는 것이 아니라, AI가 만든 작은 코드 하나를 내 컴퓨터에서 실제로 실행해보는 것입니다.

NEXT IN SERIES

STEP 005 — 코드 복사·붙여넣기 방식이 한계에 부딪힌 순간