>마일드코드

클로드 코드 창시자가 직접 알려주는 '진짜' 바이브코딩

2026.10.07읽는 시간 10분영상
#클로드코드#하네스#바이브코딩
영상: 클로드 코드 창시자가 직접 알려주는 '진짜' 바이브코딩
한눈에 답하면

클로드 코드 팀은 최신 모델용 시스템 프롬프트를 80% 넘게 걷어냈습니다. 그런데 클로드 코드를 만든 보리스 체르니가 계속 강조하는 것이 하나 남아 있습니다. 클로드 코드가 자기 결과물을 스스로 확인할 수단입니다. 고쳐 달라고 할수록 서비스가 망가지는 이유와, 성공 기준과 검사를 내 프로젝트에 세우는 법을 정리했습니다.

걷어낸 것과 남긴 것

보리스 체르니는 클로드 코드를 처음 만든 사람이고, 지금은 앤트로픽에서 클로드 코드를 총괄합니다. 올해 6월 Fortune 인터뷰에서는 8개월째 손으로 코드를 한 줄도 안 썼다고 했고요.

올해 7월 앤트로픽 공식 블로그에 이런 글이 올라왔습니다. 클로드 코드 팀이 최신 모델용 시스템 프롬프트를 80% 넘게 걷어냈는데, 코딩 평가에서 손실이 없었다. 모델이 그만큼 좋아졌다는 겁니다.

그런데 보리스가 여전히 중요하다고, 새 모델에서는 어느 때보다 중요하다고 말하는 게 하나 있습니다. 클로드 코드에게 자기 작업을 확인할 방법을 주는 것. 늘 그랬고 지금은 어느 때보다 중요하다고 했습니다.

이 말을 우리 쪽으로 옮기면 이렇습니다. 요즘 모델은 점점 똑똑해지는데, 우리 설정과 하네스는 그 속도에 맞춰 개편되지 않는 경우가 많습니다. 남들이 좋다고 해서 깔았던 스킬과 플러그인은 이제 필요 없을 수도 있습니다. 그런 걸 정리하고 딱 하나만 제대로 세우면 됩니다. 클로드 코드가 자기 결과물이 완성됐는지, 안전한지를 시스템으로 확인하고 스스로 고칠 수 있게 하는 장치입니다.

고쳐 달라고 할수록 망가지는 이유

클로드 코드로 서비스를 좀 만들어보신 분들은 아실 텐데요. 프로젝트가 좀 커진 상태에서 작은 기능 하나를 추가했는데 멀쩡하던 화면이 갑자기 안 열립니다. 고쳐 달라고 하면 이번엔 다른 곳에서 문제가 생기고요.

그렇게 몇 번 반복하다 보면 몸도 마음도 지치고, 사용량 한도는 어느새 바닥나 있습니다. 추가 결제까지 해가면서 붙잡고 있다가 결국 근본적인 문제를 못 풀고 관두는 분들을 정말 많이 봤습니다. 저도 처음엔 어떻게 풀어야 할지 감을 못 잡고 고쳐 달라고만 반복했습니다. 안 되면 아예 직접 코딩하기도 했고요. 그건 지속 가능하지 않았습니다.

클로드 코드가 스스로 확인하는 장치가 없는 상태로 바이브코딩을 하면, 프로젝트가 커질수록 통제력을 잃습니다. 그래서 필요한 건 이겁니다.

INFO

클로드 코드에게 정확한 성공 기준을 주고, 잘못된 방식으로 진행하더라도 그 기준을 넘지 못한 코드는 결과물로 제출될 수 없는 시스템을 설계하는 것. 이게 정공법입니다.

확인하라는 말 대신 확인할 수단을

이 문제를 풀려고 이런 시도들 해보셨을 겁니다. 지시문에 「꼭 이걸 확인해라」, 「기존 동작이 깨지지 않게 해라」라고 적어보기도 하고, 체크리스트까지 만들어서 검수해보라고 쥐여주기도 하고요. 그런데 어느 순간 또 똑같은 실수를 반복합니다.

현업에서 매일 클로드 코드를 쓰는 엔지니어로서 이건 자신 있게 말씀드릴 수 있습니다. 지시문에 그런 명령을 백날 넣어도 완벽하게 지켜질 수는 없습니다.

클로드 코드 공식 문서의 베스트 프랙티스도 맨 앞 절이 이겁니다. 클로드 코드에게 자기 작업을 확인할 방법을 줘라. 테스트든 빌드든 비교할 스크린샷이든 돌려볼 수 있는 검사를 주고, 통과와 실패가 나오는 걸 주면 루프가 스스로 닫힌다고 적혀 있습니다. 같은 문서에 이런 문장도 있고요.

If you can't verify it, don't ship it.

확인해 달라는 말을 반복하는 게 아니라, 확인할 수단과 통과 기준을 주는 게 이제는 정석입니다. 저는 결과를 내놓기 전에 반드시 통과해야 하는 기준과, 그걸 확인할 수단을 시스템으로 만든 것을 하네스라고 부릅니다. 그걸 통과하지 못하면 그 코드는 완성된 결과물이 될 수 없습니다.

만든 사람은 어떻게 확인시키나

보리스는 올해 1월에 자기 사용법을 정리한 글을 올렸습니다. 당시 설정 기준으로, 자기가 내보내는 변경마다 클로드 코드가 크롬을 직접 열어서 화면을 눌러보고, 될 때까지 고치게 한다고 했습니다. 여기서 성공 기준은 코드가 완성됐느냐가 아니라 화면에서 기능이 실제로 작동하느냐입니다. 사람이 코드를 한 줄씩 읽는 게 아니라 클로드 코드가 결과 화면을 직접 보고 확인합니다.

9월에 올린 글에서는 클로드 코드가 쓴 운영 코드는 사람이 쓴 코드보다 더 높은 기준을 넘어야 하고, 그 기준을 지키려고 앤트로픽 안에는 자동 검사, 테스트, 자동 리뷰 같은 장치가 여러 겹 있다고 했습니다. 이런 장치가 없으면 나중에 유지보수하기 어려운 엉망이 될 수 있다고요.

7월 와이 컴비네이터 강연에서는 요즘 필요한 기술은 프롬프트를 잘 쓰는 것보다 클로드 코드가 일하는 중간에 스스로 확인할 수 있게 만들어주는 쪽이라고 하면서, 사람들이 제대로 못 하는 단 하나를 꼽자면 아마 검증일 거라고 했습니다.

다만 보리스는 원칙을 말해줬지, 우리 프로젝트에서 어디서부터 어떻게 하라고까지 말해주지는 않았습니다. 그럼 어디서부터 시작하느냐. 하네스의 시작은 클로드 코드가 할 작업의 성공 기준을 세우는 것입니다.

성공 기준은 질문 하나로 정합니다

저는 성공 기준을 질문 하나로 정의합니다. 무엇이 되면 클로드 코드의 작업물이 합격인가.

이게 빠진 채로 일을 시키면 클로드 코드는 후보만 늘어놓고 결정하지 못합니다. 처음엔 열심히 읽고 고르다가, 너무 많이 물어보니까 지쳐서 나중엔 추천하는 선택지를 읽지도 않고 누르게 되죠. 그렇게 쌓인 완성물은 내가 생각한 것과 멀어져 있습니다.

보통은 일단 만들고 나서 품질을 평가할 방법을 찾습니다. 순서를 뒤집어야 합니다. 평가 방법을 먼저 정하고, 그다음에 만듭니다. 그래야 내 기준에 맞는 결과물을 받습니다.

  • 서비스 하나를 시작할 때는 무엇이 되면 완성인지를 문장 한 줄로 적고, 그 아래에 무엇을 만들지 않을지를 전부 적어둡니다. 만들 것보다 안 만들 것 목록을 잘 정하는 게 정말 중요합니다.
  • 기능 하나를 만들 때도 바로 코드를 짜게 하지 않습니다. 클로드 코드가 직접 돌려볼 수 있는 검사와 완료 기준을 먼저 세우고 구현에 들어가게 합니다.

이 기준을 얼마나 시스템으로 잘 만들어두느냐에서 결과가 완전히 달라집니다.

기준은 매번 읽는 자리에 둡니다

성공 기준은 대화창에 한 번 말하고 끝내면 안 됩니다. 클로드 코드가 코드를 바꾸기 전에 매번 먼저 읽는 프로젝트 안의 파일 하나에 넣어둡니다.

기준이 없으면 클로드 코드는 정해주지 않은 부분을 「보통 이렇게들 하니까」 하고 알아서 채웁니다. 기준이 대화 안에만 있으면 고쳐 달라고 할 때마다 그 짐작이 달라지고요. 성공 기준이 파일로 분명하게 있으면 클로드 코드가 임의로 기준을 잡지 않고, 어긋나는 요청에는 먼저 되묻습니다. 문서로 이 정도만 세팅해도 결과물 품질이 확 달라집니다.

저는 고객에게 구독료를 받는 서비스를 혼자 운영합니다. 링크 단축과 트래픽 분석을 하는 서비스라, 여기서 문제가 생기면 고객이 광고로 데려온 트래픽을 랜딩 페이지로 못 보내게 됩니다. 기능 하나 깨지는 게 곧 장애입니다. 그래서 이 서비스에서는 성공 기준을 강하게 먼저 세워두고, 그 아래에서 클로드 코드에게 일을 시킵니다.

CAUTION

그런데 성공 기준을 세워도 구멍은 남습니다. 결국 이것도 일종의 지시문이라 클로드 코드가 벗어날 확률이 있습니다. 그 구멍은 테스트 코드와 장치로 막습니다.

테스트 코드는 성공 기준을 코드로 적은 것

테스트 코드는 성공 기준을 사람 말이 아니라 코드로 적어둔 겁니다. 테스트가 있으면 클로드 코드가 작업을 끝낼 때마다 그걸 직접 돌려서 스스로 확인합니다. 앤트로픽 공식 문서도 클로드 코드에게 확인할 수단이 없으면 사람이 그 확인 자리를 대신 맡게 된다고 말합니다.

테스트 코드도 클로드 코드한테 쓰게 하면 됩니다. 이게 쌓이면서 서비스를 지켜주는 시스템이 점점 단단해집니다. 문제를 발견했을 때도 고치고 끝내는 게 아니라, 같은 문제가 다시 생기면 잡히도록 테스트로 남겨둡니다.

그런데 테스트를 먼저 쓰라고 아무리 지시해도 클로드 코드는 코드만 고치고 넘어갈 때가 많습니다. 그래서 저는 편집을 지켜보다가 테스트 계획 없이 큰 변경을 하면 거기서 턴을 끝내지 못하게 막는 장치를 걸어둡니다. 이것도 부탁이 아니라 장치입니다.

저장하는 순간, 올리는 순간, 배포하는 순간

테스트를 돌리는 일은 클로드 코드의 기억이나 내 지시에 맡기지 않습니다. 저장하는 순간에 걸어둡니다. 제 프로젝트에서는 코드를 저장하는 순간, 그러니까 커밋할 때마다 테스트를 포함한 검사가 자동으로 돌고, 하나라도 통과하지 못하면 커밋 자체가 안 됩니다. 이 검사가 있어서 새 기능을 자신 있게 내보냅니다.

잘못된 코드가 저장되기 전에 막으니까, 문제가 제일 작을 때 잡혀서 큰 문제로 번지지 않습니다. 검사 자체는 클로드 코드가 아니라 내 컴퓨터가 돌리는 거라 사용량도 들지 않습니다. 처음이라면 클로드 코드한테 「커밋할 때마다 검사가 돌게 해줘」라고 시키는 것부터 시작하시면 됩니다.

코드를 저장소에 올리는 순간에는 실제로 빌드가 되는지 같은 더 무거운 검사가 한 번 더 돕니다. 배포도 마찬가지입니다. 검사를 통과하지 못한 코드는 서비스에 나가지 못합니다. 잘못 만들어진 코드가 결국 결과물이 될 수 없는 것. 이게 서비스를 시스템으로 안전하게 운영하는 방식입니다.

작은 단계마다 검사를 통과해야 다음으로

이런 검사를 사람이 매번 기억해서 켜는 건 무리입니다. 그래서 일하는 순서 자체를 고정해둡니다.

  1. 완료 기준을 정한 기능 하나를 계획서로 적는다
  2. 그 기능을 작은 단계로 나눈다
  3. 한 단계를 만들 때마다 검사를 돌리고, 통과해야 다음 단계로 간다
  4. 다 끝나면 커밋을 남기고, 중간에 내린 결정과 배운 것도 기록으로 남긴다

검사를 통과하기 전에는 다음 단계로 넘어가지 않고, 끝났다는 말도 하지 않게 해둡니다. 그러면 우리는 의도를 주고, 클로드 코드는 그 의도를 기준을 넘긴 결과물로 돌려줍니다.

보리스가 공개한 클로드 코드 팀의 팁에도 같은 말이 있습니다. 뭔가 틀어지는 순간 계속 밀어붙이지 말고, 다시 계획으로 돌아가서 계획을 새로 세우라고요.

이런 반론이 있을 수 있습니다. 개발자는 코드를 읽고 판단할 수 있지만, 나는 코드를 못 읽는데 결과물이 맞는지 어떻게 아느냐. 그렇기 때문에 더더욱 시스템으로 클로드 코드의 작업 범위를 가두고 통제해야 합니다.

되돌릴 수 없는 일은 장치로 막습니다

결과물이 진짜 맞는지는 장치를 어디에 걸고, 그 장치가 진짜 잡는지로 봅니다. 코드를 한 줄씩 읽어서 문제를 잡는 방식은 개발자인 저도 이제 쓰지 않습니다. 문제가 생길 수 있는 자리마다 방어 장치를 세워두는 게 제 전략입니다.

장치를 걸지 말지 정하는 기준은 하나입니다. 그 작업이 되돌릴 수 있느냐.

되돌릴 수 있는 일되돌릴 수 없는 일
버튼 문구, 화면 디테일핵심 로직 계산, 비밀 키 같은 민감한 값, 유저 데이터
클로드 코드에게 믿고 맡긴다지시가 아니라 안전 장치로 막는다

지시문은 확률을 낮추는 거고, 안전 장치는 확정으로 막는 겁니다.

TIP

장치를 걸었으면 그게 진짜 잡는지도 꼭 보세요. 계산 코드에 일부러 버그를 하나 심어보면 검사가 실패하는지 확인할 수 있습니다. 버그를 심는 것도 클로드 코드한테 시키면 됩니다.

하네스는 도구가 아니라 내 프로젝트 안에

트렌드가 바뀔 때마다 작업 환경을 통째로 버리고 새 도구를 들이는 걸 반복하는 경우가 많습니다. 올해 봄에도 앤트로픽이 오픈클로 같은 외부 도구를 구독에서 잠깐 떼어냈을 때, 헤르메스로 옮겨 가는 분들이 눈에 띄게 늘었습니다.

헤르메스 같은 에이전트 도구를 깔아서 쓰는 것도 충분히 좋은 선택입니다. 다만 도구가 바뀔 때마다 그 안에 세워뒀던 기준과 검사를 다시 맞춰야 합니다.

그래서 저는 특정 도구에 기대지 않고 성공 기준과 검사, 장치를 제 프로젝트 안에 직접 세워두는 쪽을 택했습니다. 무엇이 어떻게 돌아가는지 제가 다 아니까 원하는 대로 제어할 수 있고, 나중에 도구를 바꿔도 이 하네스는 그대로 가져갈 수 있습니다. 한 번 제대로 이해하고 나면 유지보수도 편합니다.

결국 중요한 건 어떤 도구를 쓰느냐가 아니라 클로드 코드 같은 AI 가 어떻게 일하는지를 정확하게 이해하는 겁니다. 그때부터 내 작업 환경을 통제할 수 있고, 새 도구가 나올 때마다 따라가야 할 것 같던 막연한 불안도 사라집니다.

모델이 좋아져도 빼면 안 되는 것

보리스와 클로드 코드 팀이 지시문을 그렇게까지 걷어낼 수 있었던 건, 무엇을 남겨야 하는지 정확히 알았기 때문입니다. 확인해 달라는 지시문은 지우고, 확인할 수단만 남긴 겁니다.

처음에 깔아뒀던 스킬과 플러그인을 정리하고 딱 하나만 남기면 된다고 했는데, 그 하나는 특정 스킬이나 플러그인이 아닙니다. 내가 정한 성공 기준을 클로드 코드가 매번 읽고, 그 기준을 못 넘긴 코드는 결과물로 제출되지 않게 만드는 하네스입니다.

그때부터는 만드는 과정을 클로드 코드에게 맡겨도 됩니다. 대신 무엇이 성공인지, 무엇을 깨면 안 되는지는 내가 정합니다. 모델이 꾸준히 좋아지는 지금, 빼도 되는 도구와 설정, 그리고 모델이 아무리 좋아져도 빼면 안 되는 것을 구분하는 눈이 거기서 생깁니다.

COPY THIS PROMPT
새 기능을 만들기 전에 성공 기준부터 같이 세우자. 아직 코드는 짜지 마.

만들 기능: [예: 회원이 비밀번호를 잊었을 때 이메일로 다시 설정하는 기능]

1. "무엇이 되면 이 기능이 합격인가"를 한 문장으로 제안해줘.
2. 이번에 만들지 않을 것을 목록으로 적어줘. 애매한 건 나한테 먼저 물어봐.
3. 합격인지 네가 직접 돌려서 확인할 수 있는 검사를 정해줘(테스트, 빌드, 화면 확인 중 무엇으로 할지).
4. 이 기능에서 되돌릴 수 없는 부분(데이터, 비밀 값, 계산)이 있으면 따로 짚고, 거기는 어떤 장치로 막을지 제안해줘.
5. 위 내용을 프로젝트 안의 기준 파일에 정리하고, 작업을 작은 단계로 나눈 계획을 보여줘. 단계마다 검사를 통과해야 다음으로 간다.

자주 묻는 것

COURSE
만드는 건 이제 쉽습니다. 문제는 그다음입니다.

바이브코딩 바닥부터 프로 개발자처럼 서비스를 운영하는 법과 수익화까지, 인프런 강의 「모두의 클로드 코드」에 순서대로 담았습니다.

개인 링크 페이지, 구글 로그인과 관리자 화면이 붙은 구독 관리 서비스, 결제 알림이 오는 모바일 앱, 자동 배포 파이프라인까지 네 가지를 직접 만들어 봅니다.

모두의 클로드 코드 보기