← 에디토리얼

바이브코딩 실험 · 2026.11.20 · 6분

클로드 코드에 '/goal' 걸고 손 뗐더니 31초 만에 테스트 16개 통과

AItoZ 개발팀 · 2026.11.20 발행

클로드 코드에 '/goal' 걸고 손 뗐더니 31초 만에 테스트 16개 통과 — 바이브코딩 실험

클로드 코드 사용방법 · 클로드 코드 goal — /goal 한 줄에 '테스트 16개 통과, 아니면 20턴 뒤 멈춤' 조건을 걸고 손을 뗐더니 31초 · 1턴 만에 실패하던 테스트 13개가 다 고쳐졌어요. 조건을 대충 쓰면 '달성'인데도 테스트 9개가 실패로 남았습니다. 조건 문장 쓰는 법과 두 번의 시험 기록을 정리했습니다.

2026년 11월 20일 직접 시험 · Claude Code 2.1.326 · sonnet · auto mode · 연습용 작은 프로젝트(테스트 16개 중 13개 실패 상태에서 시작) · 시험은 각 1회 · /goal 동작 설명은 공식 문서(code.claude.com/docs/en/goal) 기준

클로드 코드로 버그를 고치다 보면 "계속", "이어서 해 줘"를 몇 번씩 누르게 됩니다. /goal은 그 일을 대신해 주는 명령이에요. 끝 조건을 한 줄 걸어 두면, 조건이 채워질 때까지 클로드가 스스로 다음 턴을 이어 갑니다. 실제로 걸고 손을 떼 봤습니다.

/goal은 그냥 시키는 것과 무엇이 다른가요?

일하는 클로드와 별도로, 판정하는 모델이 매 턴 끝에 조건이 채워졌는지 확인한다는 점이 다릅니다. 공식 문서에 따르면 조건이 아직이면 클로드가 다음 턴을 스스로 시작하고, 그래서 "다 됐어요" 하고 일찍 멈추는 일을 막아 줍니다.

/goal이 도는 방식 — 클로드가 일함 → 판정 모델이 조건 확인 → 아직이면 다음 턴

멈추는 때는 네 가지입니다(공식 문서).

  1. 조건이 채워졌을 때
  2. 판정 모델이 불가능하다고 볼 때
  3. 사람이 직접 고쳐야 하는 오류가 났을 때
  4. /goal clear로 직접 끌 때

세션 하나에 목표는 하나이고, 걸려 있는 동안 화면 아래에 ◎ /goal active가 보입니다. Ctrl+O를 누르면 판정 이유를 펼쳐 볼 수 있어요.

실제로 걸어 보니 어땠나요?

31초 · 1턴 만에 테스트 16개가 모두 통과했고, 그동안 제가 손댄 건 0번이었습니다. 연습용 쇼핑몰 코드(장바구니 · 쿠폰 · 가격 · 배송비)에 일부러 버그를 넣어 테스트 16개 중 13개가 실패하는 상태로 시작했어요.

제가 친 건 이 한 줄뿐입니다.

/goal npm test를 돌렸을 때 테스트 16개가 전부 통과(fail 0)할 것. 아니면 20턴 뒤 멈춤

/goal 조건을 걸자 아래에 ◎ /goal active가 뜬다

클로드는 먼저 npm test로 현재 상태를 보고, 배송비 · 쿠폰 · 가격 · 장바구니 소스를 차례로 고친 뒤 다시 테스트를 돌렸어요. 결과 화면은 "통과 16개, 실패 0개"였고, 테스트 파일은 건드리지 않고 src/ 구현만 고쳤다고 밝혔습니다. 끝 줄에는 ✔ Goal achieved (31s · 1 turn · 2.1k tokens)가 찍혔어요.

Goal achieved — 31초 · 1턴, 통과 16개 · 실패 0개

턴이 1번이었다는 건, 첫 턴에서 이미 조건을 채워 판정 모델이 바로 멈췄다는 뜻입니다. 고칠 게 더 많은 프로젝트라면 턴이 여러 번 이어질 거예요.

조건을 대충 쓰면 어떻게 되나요?

판정 모델은 '내가 쓴 문장'을 기준으로 보기 때문에, 문장이 애매하면 일이 덜 끝나도 '달성'으로 멈춥니다. 같은 프로젝트를 처음 상태로 되돌리고 이번엔 이렇게 걸었어요.

/goal 장바구니 코드를 깔끔하게 정리할 것

29초 · 1턴 만에 ✔ Goal achieved가 떴습니다. 클로드는 장바구니(src/cart.js)를 정리했고, 배송비 테스트 실패는 "이번 목표 범위 밖이라 건드리지 않았다"고 적었어요.

대충 건 조건 — 장바구니만 정리하고 달성

바로 npm test를 돌려 보니 16개 중 7개만 통과하고 9개가 실패였습니다(쿠폰 4 · 가격 2 · 배송비 3). 목표 문장 그대로라면 틀린 판정은 아니지만, 제가 원한 '다 고쳐진 상태'와는 거리가 멀었어요.

같은 목표 직후 npm test — pass 7 · fail 9

조건 문장은 어떻게 쓰면 되나요?

명령 하나로 확인할 수 있는 끝 상태 + 턴 상한, 이 두 가지를 같이 쓰면 됩니다.

대충 건 조건 vs 확인되는 조건

구분 대충 건 조건 확인되는 조건
문장 장바구니 코드를 깔끔하게 정리할 것 npm test 16개 전부 통과(fail 0), 아니면 20턴 뒤 멈춤
판정 기준 '깔끔함' — 사람마다 다름 테스트 결과 숫자
결과(11/20) 29초 · 1턴 '달성', 테스트 9개 실패 31초 · 1턴 달성, 16/16 통과

조건 예시를 몇 개 더 적어 둡니다(우리가 실제로 돌린 건 위 두 문장뿐이에요).

  • npm run build가 오류 없이 끝나고 npm test가 fail 0일 것. 아니면 15턴 뒤 멈춤
  • npx eslint src가 경고 0개일 것. 아니면 10턴 뒤 멈춤
  • test/cart.test.js 5개가 통과하고 다른 테스트 파일은 고치지 않을 것

따라 할 때 주의할 점은?

자리를 비우려면 auto mode를 켜고, 턴마다 사용량이 든다는 걸 기억하세요.

따라 하기 — 확인 가능한 끝 상태 · 턴 상한 · auto mode

  • auto mode: 수동 모드면 도구를 쓸 때마다 허락을 묻기 때문에 자리를 비우면 멈춰 있습니다(공식 문서). 우리 시험도 auto mode(Shift+Tab으로 전환)에서 했어요.
  • 사용량: 공짜로 밤새 돌리는 기능이 아닙니다. 턴이 늘어날수록 사용량도 늡니다. 우리 시험 화면에는 2.1k tokens가 찍혔어요. 그래서 '아니면 20턴 뒤 멈춤' 같은 상한을 꼭 넣으세요.
  • 조건 길이: 조건은 최대 4,000자까지 쓸 수 있습니다(공식 문서).
  • 테스트 먼저: 확인할 명령(테스트 · 빌드 · 린트)이 없으면 조건을 숫자로 쓰기 어렵습니다. 테스트가 없는 프로젝트라면 먼저 테스트부터 만들게 하는 편이 낫습니다.

한 번에 정리

  • /goal 조건을 걸면 판정 모델이 매 턴 조건을 확인하고, 아직이면 클로드가 다음 턴을 스스로 시작합니다.
  • 확인되는 조건(테스트 16개 통과 + 20턴 상한)으로 걸었더니 31초 · 1턴 만에 16/16, 사람 손 0번.
  • 대충 건 조건(깔끔하게 정리)은 29초 만에 '달성'이었지만 테스트 9개가 실패로 남았습니다.
  • 조건은 명령으로 확인할 수 있는 끝 상태 + 턴 상한, 그리고 auto mode.

출처: Claude Code 공식 문서 /goal https://code.claude.com/docs/en/goal · 직접 시험 기록(2026-11-20, 연습 프로젝트, Claude Code 2.1.326 · sonnet · auto mode, 각 1회).

영상으로 보기: AItoZ 유튜브 쇼츠 '클로드 코드에 /goal 걸고 손 뗐더니 31초 만에 테스트 16개 통과'

다음 글클로드 코드 플러그인 추천, 앱 출시 전 꼭 깐 4개 — 조사 · 디자인 · 세팅 · 심사→