분명 시킨 대로 했는데 에러 — AI가 '옛날 버전'으로 코드 짤 때

"AI가 짜준 대로 했는데 에러가 나요." 바이브 코딩에서 제일 자주 막히는 지점이에요. 코드가 틀린 게 아니라 한 세대 전 방식인 경우가 많아요. 왜 그런지 알면 대처가 쉬워져요.

원인 ① 학습 시점 이후를 몰라요

AI 모델은 어느 시점까지의 데이터로 학습하고 그 뒤로는 새로 배우지 않아요. 그래서 학습 이후에 나온 버전·문법·API는 아예 모릅니다. Claude, GPT, Gemini 전부 마찬가지예요. 모델마다 그 시점이 다르고, 새 모델이 나올 때마다 갱신돼요.

원인 ② 이게 더 중요해요 — 옛날 코드가 훨씬 많아요

학습 시점 안에 있는 버전인데도 옛날 방식으로 짜주는 경우가 있어요. 인터넷에 쌓인 예제·블로그·질문글이 압도적으로 구버전이기 때문이에요. AI 입장에선 "많이 본 방식"이 자연스럽게 느껴지는 거죠.

그래서 "최신으로 해줘"라고만 하면 잘 안 통해요. 뭐가 최신인지 모델이 정확히 모를 수 있거든요.

AI가 옛날 문법으로 코드 짤 때 해결법 — 버전을 숫자로 못 박기

가장 확실한 방법은 버전을 직접 알려주는 것이에요. 아래는 그대로 복사해서 쓸 수 있는 프롬프트예요.

# ① 버전을 숫자로 명시 (제일 중요)
Next.js 15 App Router 기준으로 작성해줘.
# ② 금지 항목을 못 박기
deprecated된 API는 쓰지 말고,
# ③ 모르면 찾아보라고 지시
확실하지 않으면 웹 검색으로 확인한 뒤 답해줘.
# ④ 검증할 수 있게 출처 요구
어떤 문서를 봤는지 링크도 같이 알려줘.

③번이 핵심이에요. 요즘 도구는 웹 검색이나 공식 문서 연결이 되니까, 모르면 지어내지 말고 찾아보라고 지시하면 정확도가 확 올라가요.

매번 쓰기 귀찮다면 CLAUDE.md에 박아두기

프로젝트 규칙 파일(CLAUDE.md, AGENTS.md)에 버전을 박아두면 새 대화마다 다시 말할 필요가 없어요.

## 기술 스택 (반드시 이 버전 기준으로)
# 프레임워크와 방식까지 함께
- Next.js 15 App Router
# 주요 라이브러리 버전
- React 19 / TypeScript
# 지어내기 방지 규칙
- 확실하지 않은 API는 추측하지 말고 물어볼 것

규칙 파일 쓰는 법은 이 글에서 자세히 다뤘어요.

정리

• 에러가 나면 코드를 의심하기 전에 "이거 몇 버전 기준이야?" 라고 먼저 물어보세요
• "최신으로" 대신 버전 숫자로 말하세요
• 자주 쓰는 스택은 규칙 파일에 한 번만 적어두세요

여러분은 AI가 옛날 문법으로 짜줘서 헤맨 적 있으세요? 어떤 라이브러리에서 제일 심했는지 노하우 방에 공유해 주세요 ⚡