Claude Code /goal, 목표만 던지면 AI가 알아서 끝낸다

AI한테 시켰는데, 왜 나만 계속 확인해야 하죠?

AI 코딩 도구를 써보셨다면 이런 경험, 한 번쯤 있으실 거예요.

큰 작업을 시켜놓고 잠깐 화장실 다녀왔더니, AI가 어딘가에서 멈춰서 기다리고 있어요. "계속해줘"라고 입력하면 또 조금 하다가 멈춥니다. 결국 내가 아무것도 안 한 게 아니라 "계속해" 버튼만 계속 누르고 있는 셈이죠.

이 불편함을 정확히 건드린 기능이 2026년 5월 12일, Claude Code에 추가됐습니다. 바로 /goal 명령어입니다.

한 줄 요약부터 드리자면, /goal은 AI가 "다 됐나요?" 하고 물어보지 않고 끝까지 혼자 달려가게 만드는 명령어입니다. 목표 조건을 한 번만 설정하면, 그 조건이 충족될 때까지 AI가 스스로 작업을 이어갑니다.

사실 이 기능, OpenAI Codex가 먼저였어요

/goal은 원래 OpenAI의 Codex CLI 0.128.0 업데이트에서 먼저 등장한 기능이에요. "조건 기반 에이전트 루프"라는 개념인데, 공개되자마자 개발자 커뮤니티에서 꽤 주목받았습니다.

Anthropic은 빠르게 Claude Code에도 동일한 이름의 명령어를 추가했어요. 두 회사가 거의 동시에 같은 방향을 택했다는 건, 이게 단순한 편의 기능이 아니라 AI 코딩 도구가 나아가야 할 방향에 대한 공통된 인식이 있다는 신호로 읽힙니다.

2026년 현재, AI 에이전트 시장에서는 "코드를 짜주는 AI"를 넘어 "목표를 향해 스스로 작업을 완수하는 AI"로 전환이 진행 중이에요. /goal은 그 흐름의 한 단면입니다.

사용법은 생각보다 단순해요

사용법 자체는 굉장히 간단합니다.

/goal 뒤에 원하는 완료 조건을 입력하면 됩니다. 예를 들어 이렇게요.

/goal all tests in test/auth pass and the lint step is clean

이렇게 입력하면 Claude가 조건을 인식하고, 그 조건이 충족될 때까지 별도의 입력 없이 작업을 계속 이어갑니다. 사용자가 "다음으로 넘어가줘" 같은 말을 할 필요가 없어요.

/goal이 실행 중일 때는 대화창에 실행 시간 표시기가 나타나요. 현재 상태가 궁금하면 인수 없이 /goal만 입력하면 실행 시간, 소비된 토큰, 최근 평가 결과를 바로 확인할 수 있습니다. 중단하고 싶다면 /goal clear를 입력하면 됩니다. stop, off, reset, cancel도 동일하게 처리돼요.

참고로 이 기능은 Claude Code v2.1.139 버전 이상에서만 사용 가능해요. 이전 버전에서 실행하면 Unknown command로 표시되니, 먼저 버전 확인 후 업데이트하세요.

안에서 무슨 일이 벌어지는 걸까요?

/goal이 흥미로운 이유는 단순히 반복 실행이 아니라, 작업하는 AI와 평가하는 AI를 분리해둔다는 점이에요.

기술적으로 설명하면, /goal은 세션 범위의 프롬프트 기반 Stop hook의 래퍼 형태로 구현되어 있어요. Claude가 매 턴을 완료할 때마다, 완료 조건과 현재까지의 대화가 소형 평가 모델로 전달됩니다. 기본값은 Haiku인데, Claude의 경량 모델이라 평가 전용으로만 사용되어 비용을 최소화할 수 있어요.

쉽게 말하면 이런 구조예요. 작업자(Claude)가 한 턴을 끝내면 감독자(Haiku)가 "조건 충족됐냐?"고 확인합니다. 아직 안 됐으면 감독자가 사유를 돌려보내고, 그 사유가 다음 턴의 방향 힌트가 되어 작업자가 계속 이어갑니다. 충족됐다고 판단되면 그때서야 멈추고요.

이 구조가 중요한 이유는 "내가 다 한 것 같아"가 아니라 "실제로 조건이 충족됐다"를 기준으로 멈춘다는 점이에요. 작업 AI가 스스로 완료를 선언하는 게 아니라, 별도의 평가자가 실제 결과를 보고 판단하기 때문에 신뢰도가 훨씬 높아집니다.

조건을 잘 써야 잘 멈춥니다, 이게 진짜 핵심이에요

/goal을 쓸 때 가장 중요한 건 완료 조건을 얼마나 명확하게 작성하느냐예요.

평가 AI(Haiku)는 Claude가 대화에서 직접 보여준 내용만 기준으로 판단합니다. 파일을 독립적으로 열거나 명령어를 별도로 실행하지 않아요. 그래서 조건은 Claude가 실행하고 결과를 대화에 출력할 수 있는 형태여야 합니다.

잘 작동하는 조건의 세 가지 요소는 이렇습니다.

하나, 측정 가능한 완료 상태. "tests/auth 하위 테스트 전체 통과"처럼 예/아니오로 판단 가능한 기준이어야 해요.

둘, 확인 방법. Claude가 실행하고 결과를 출력할 수 있는 명령어나 기준이 있어야 합니다.

셋, 제약 조건. "최대 20회 실행" 같은 안전장치를 넣어주세요. 무한 루프를 방지하는 데 꼭 필요해요.

반대로 잘 안 작동하는 조건도 있어요. "코드가 깔끔해질 때까지"처럼 측정 기준이 없는 조건이나, "파일 크기가 특정 수치 이하가 되면"처럼 Claude가 직접 확인해서 출력하지 않으면 평가 AI가 판단할 수 없는 조건은 의도대로 멈추지 않을 수 있어요. 조건은 최대 4,000자까지 지원하니, 미니 PRD처럼 상세하게 작성해도 충분합니다.

/loop, Stop hook이랑은 어떻게 다른가요?

비슷해 보이는 기능이 여러 개 있어서 헷갈릴 수 있는데, 실제로는 꽤 명확하게 구분돼요.

/goal은 현재 세션에만 적용되는 단발성 목표 설정입니다. 이전 턴이 완료될 때 다음 턴을 시작하고, 평가 모델이 조건 충족을 확인하면 멈춥니다.

/loop는 시간 간격이 지나면 다음 턴을 시작하는 구조예요. 사용자가 직접 멈추거나 Claude가 완료라고 판단할 때까지 계속 실행됩니다.

Stop hook은 설정 파일에 정의해두면 모든 세션에 걸쳐 작동하는 상시 자동화입니다. 사용자가 직접 작성한 스크립트나 프롬프트가 중단 여부를 결정해요.

자동 모드(Auto Mode)와의 차이도 중요해요. 자동 모드는 단일 턴 안에서 도구 호출을 자동 승인하지만 새 턴을 시작하지는 않습니다. /goal은 턴과 턴 사이의 자동화를 담당하고, 자동 모드는 턴 안의 자동화를 담당해요. 둘을 함께 쓰면 완전 자율 실행에 가까워집니다.

실무에서 어떤 작업에 써야 할까요?

/goal은 검증 가능한 최종 상태가 있는 작업에서 가장 빛을 발해요.

코드 관련으로는 API 마이그레이션(모든 호출 사이트가 컴파일되고 테스트 통과할 때까지), 테스트 커버리지 확보(특정 모듈 테스트 커버리지 80% 이상까지), 백로그 처리(레이블된 이슈 큐가 비워질 때까지) 같은 작업에 효과적입니다.

개발자가 아닌 분들에게도 응용할 수 있어요. "마케팅 자료 초안 3종이 모두 특정 형식을 갖출 때까지" 또는 "10개 항목이 모두 특정 기준에 맞게 분류될 때까지"처럼 반복 문서 작업에도 충분히 활용 가능합니다.

비대화형 모드에서는 -p 플래그와 함께 쓸 수도 있어요. claude -p "/goal CHANGELOG.md has an entry for every PR merged this week" 이렇게 입력하면 단일 호출로 루프를 완료까지 실행하고, CI 파이프라인이나 야간 자동화 스크립트에 직접 붙일 수 있어요.

이 기능이 의미하는 진짜 변화

/goal 하나가 단순한 편의 향상이 아닌 이유가 있어요.

AI 코딩 도구는 지금 단순한 자동완성을 넘어 자율적인 코딩 에이전트로 빠르게 진화하고 있습니다. 2024년에는 "AI가 코드를 짜준다"가 새로웠고, 2025년에는 "AI가 자율적으로 짜준다"가 화제였다면, 2026년엔 "코드를 짜던 AI가 코드 밖의 모든 컴퓨터 작업으로 나간다"는 단계로 넘어오고 있어요.

/goal은 그 흐름 속에서 사람의 역할이 어떻게 바뀌는지를 잘 보여주는 기능입니다. AI에게 매번 "계속해줘"를 외치는 사람이 아니라, 목표를 정의하고 결과를 검토하는 사람으로 역할이 이동하고 있어요.

Andrej Karpathy가 "코드를 직접 쓰는 게 아니라, AI 에이전트를 오케스트레이션하고 감독하는 것이 엔지니어의 역할"이라고 말한 것처럼요. /goal은 그 말을 제품 기능으로 구현한 셈입니다.

완료 조건을 명확하게 정의하는 능력, 결과 기준을 측정 가능한 언어로 표현하는 능력. 이건 AI를 잘 쓰는 기술이기도 하지만, 사실 좋은 기획과 좋은 요구사항 문서가 갖춰야 할 역량이기도 해요. 개발자뿐 아니라 기획자, PM에게도 /goal이 유의미한 이유가 바로 여기에 있습니다.

마무리

Claude Code의 /goal은 AI와 일하는 방식에 대한 근본적인 질문을 던집니다. AI를 어시스턴트로 쓰는 것과 에이전트로 쓰는 것의 차이, 사람이 개입해야 하는 순간과 빠져도 되는 순간을 구분하는 능력이 이제 실무 역량이 되고 있어요.

/goal을 잘 쓰는 핵심은 단 하나예요. 조건을 측정 가능하게 쓰는 것, 그리고 무한 루프 방지 제약을 꼭 넣는 것. 이 두 가지만 지켜도 AI가 끝까지 혼자 달려가게 만들 수 있습니다. 오늘 Claude Code를 쓰고 계신다면 /goal 한 번 써보세요. "계속해줘"를 입력하지 않아도 되는 그 해방감, 직접 느껴보시길 추천드립니다.