Claude Code /goal 출시: 목표만 주면 AI가 끝까지 처리한다

Claude Code에도 /goal 기능이 추가되었습니다.

얼마 전 Codex에 목표를 입력하면 입력된 목표를 기반으로 자동으로 업무를 완수하는 Codex Goal 기능이 주목받고 있는데요. Anthropic에서도 바로 Claude Code에 /goal 기능을 추가했습니다. 

사용자가 목표를 설정하면 Claude Code가 작업을 독립적으로 이어가고, 목표 달성 조건에 가까워질 때까지 실행을 계속하도록 설계된 방식이지만 Codex Goal 기능과는 다르게 작동합니다. 

Codex Goal과는 어떻게 다를지, 실무에서는 어떻게 활용하면 좋을지 확인해보겠습니다.

Claude Code Goal 핵심 요약 4가지

• Claude Code Goal은 목표 기반으로 작업을 이어가는 자동 실행 명령입니다. /goal 뒤에 완료 조건을 입력하면 Claude가 조건이 충족될 때까지 사용자의 추가 입력 없이 작업을 턴마다 이어갑니다.
• 작업 모델과 평가자 모델을 분리해 더 정확한 결과를 만듭니다. Haiku가 기본값으로 설정된 소형 평가 모델이 매 턴 완료 조건 충족 여부를 독립적으로 판단하고, 그 사유를 다음 턴의 방향 힌트로 전달합니다.
• Codex Goal과 명령어는 같지만 작동 방식이 다릅니다. Codex Goal이 동일한 모델로 작업과 판단을 함께 처리하는 구조라면, Claude Code Goal은 작업과 검증을 분리해 조건이 복잡하거나 장기간 이어지는 작업에서 신뢰도 높은 결과를 만들어냅니다.
• 버그 수정, 장기 자동화, CI 파이프라인 통합에 특히 유용합니다. auto mode와 함께 사용하면 사용자 개입 없이 조건 충족까지 작업을 이어갈 수 있고, -p 플래그로 헤드리스 모드 실행도 지원합니다.

Claude Code Goal이란? 

Claude Code Goal은 Anthropic이 Claude Code에 정식으로 탑재한 목표 기반 자동 실행 명령입니다. 

/goal 뒤에 완료 조건을 입력하면 Claude가 그 조건이 충족될 때까지 사용자의 추가 입력 없이 작업을 턴마다 이어갑니다. 조건이 충족되는 순간 목표는 자동으로 해제됩니다. 

작업 모델과 평가자 모델을 분리해 더 정확한 결과를

Claude Code /goal은 기능 안에 작업 모델과 평가자 모델을 분리해 놓았습니다. 작업 진행 외에 Haiku가 기본값으로 정해진 소형 평가 모델로 완료 조건 충족 여부를 판단합니다.

Claude가 이미 보여준 결과를 기준으로 예/아니오와 짧은 사유를 반환하고, 아니오가 나오면 그 사유가 다음 턴의 방향 힌트로 전달되고 Claude는 작업을 이어갑니다. 

덕분에 사용자는 작업이 어느 방향으로 흘러가고 있는지 매 턴 평가 사유로 확인하면서, 중간에 직접 개입하지 않아도 작업 결과에 대한 원인과 흐름을 파악할 수 있어 더 정확한 결과를 만들 수 있습니다. 

Claude Code Goal 

vs Codex Goal, 무엇이 다를까? 

Claude Code Goal이 출시되기 앞서 Codex CLI 0.128.0 업데이트에 Codex Goal이 먼저 등장했습니다. 작업 목표와 완료 기준만 입력하면 AI 모델이 스스로 작업을 이어가는 방식으로, 공개 직후 개발자들 사이에서 빠르게 주목받았습니다. 

Anthropic은 이에 Claude Code에 동일한 /goal 명령을 정식 탑재하며 목표 기반 자동화 경쟁에 합류했습니다. 명령어도 같고, 방향도 같으나 작동 방식에 차이를 두었습니다.

Codex Goal, 

작업 흐름을 사용자가 직접 제어하는 자동화 모델

Codex Goal은 작업 흐름을 사용자가 직접 제어하는 방식을 우선시합니다. /goal pause와 /goal resume으로 작업을 원하는 시점에 멈추고 재개할 수 있어, 중간 결과를 검토하며 방향을 조정하는 패턴에 적합합니다. 

작업 흐름 전체를 동일한 모델이 처리하는 구조로, 작업 흐름의 주도권을 사용자가 쥐고 싶을 때 강점이 드러납니다. 

▶ Codex Goal의 특징과 사용법 보러가기

Claude Code Goal, 

작업과 검증을 분리한 목표 기반 자동화 모델 

Claude Code Goal은 작업 모델과 별도로 소형 평가 모델을 분리해 매 턴 완료 조건을 독립적으로 검증합니다. 

평가자 모델은 조건 충족 여부와 함께 그 사유를 매 턴 사용자에게 노출하기 때문에, 작업이 어느 단계까지 진행됐는지, 어떤 조건이 아직 충족되지 않았는지를 실시간으로 파악할 수 있습니다. 

사용자가 중간에 개입하지 않아도 작업 결과의 원인과 흐름을 놓치지 않는 구조로 이루어져 있어 조건이 복잡하거나 장기간 이어지는 자동화 작업에서 더 신뢰도 높은 결과를 만들어냅니다.

Claude Code Goal 사용법 

Claude Code Goal의 사용법에 대해 알아보겠습니다. 

Claude Code 실행하기 

Claude Code /goal을 사용하려면 먼저 Claude Code가 설치되어 있어야 합니다. 설치 및 실행 방법이 필요한 분은 아래 링크를 참고하시면 됩니다. 

▶ Claude Code 설치 사용방법 보러가기 

/goal 명령을 사용하기 위해는 Claude Code를 v2.1.139 이상 버전으로 업데이트 해야합니다. 위의 명령어를 입력해 Claude Code를 최신 버전으로 업데이트 합니다.

Claude Code의 버전이 최신 버전으로 업데이트 된 것을 확인할 수 있습니다.

/goal 명령으로 목표 설정하기 

Claude Code를 실행한 뒤 /goal 뒤에 완료 조건을 입력하면 목표가 즉시 설정되고 작업이 시작됩니다. Codex Goal과 달리 config.toml 같은 별도 설정 파일을 수정할 필요가 없습니다. 추가 프롬프트 없이 조건 자체가 첫 번째 지시로 전달됩니다. 

Claude Code Goal 작동 테스트

Claude Code Goal이 어떻게 작동하는지 확인하기 위한 작동 테스트를 실행해보겠습니다. 

Claude Code Goal 작동 테스트 상황

npm test를 실행하면 5개 테스트 중 3개는 통과하지만 2개가 실패합니다. 발급된 액세스 토큰에 만료 시간이 설정되어 있어야 한다는 테스트와, 리프레시 토큰으로 발급된 새 액세스 토큰에 role 정보가 포함되어야 한다는 테스트입니다. 

Claude Code Goal 시나리오 구성

• auth.js: 버그 2개(expiresIn 누락, role 누락) + 중복 에러 처리 코드
• auth.utils.js: 공통 에러 처리 헬퍼 함수 (이미 존재하지만 auth.js가 사용하지 않는 상태)
• auth.test.js: 4개 테스트, 3개 실패
• 완료 조건: auth.js만 수정, auth.utils.js와 auth.test.js는 수정 금지

테스트에 사용한 프롬프트

/goal을 실행하자 Claude가 먼저 프로젝트 구조를 파악한 뒤 auth.js에서 버그 두 가지를 스스로 찾아냈습니다. 

login의 accessToken에 expiresIn 옵션이 누락된 것과 refreshAccessToken의 페이로드에 role이 누락된 것입니다. auth.js 파일 수정 진행을 위해 허가 여부를 묻는 것을 볼 수 있습니다. 

node_modules가 없자 Claude가 스스로 npm install을 실행하고, 의존성 설치 후 npm test를 돌려 5/5 테스트 전부 통과했습니다. 

auth.js에서 수정한 내용 두 가지와 auth.test.js는 변경하지 않았다는 것까지 요약해줬습니다. 

요청한 완료 조건대로 작업 범위를 지키면서 마무리한 것을 확인할 수 있습니다. 별도 평가자 모델이 매 턴 완료 조건을 검수하며 요청한 작업 범위를 끝까지 지키도록 한 결과입니다. 

Claude Code Goal, 

이런 작업에 유용합니다

버그 수정: 원인 파악부터 검증까지 이어갈 때

버그 수정은 단순히 코드를 바꾸는 문제가 아니라 왜 발생했는지 확인하고 재발 가능성을 줄이는 과정입니다. 

Claude Code Goal을 활용하면 의심되는 파일 하나만 고치는 것이 아니라 관련 흐름을 따라가며 원인 파악부터 수정, 검증까지 이어갈 수 있습니다. 

별도 평가자 모델이 매 턴 어떤 조건이 아직 충족되지 않았는지 사유를 표시하기 때문에 작업이 올바른 방향으로 흘러가고 있는지 중간에 개입하지 않아도 파악할 수 있습니다.

장기 자동화: 사용자 개입 없이 끝까지 실행할 때

Claude Code Goal은 auto mode와 함께 사용할 때 강점이 극대화됩니다. 

auto mode가 단일 턴 안에서 도구 호출 승인을 자동화한다면, /goal은 턴 자체의 반복을 자동화합니다. 

두 기능을 함께 쓰면 API 마이그레이션, 대용량 파일 모듈 분리처럼 여러 파일에 걸쳐 반복 작업이 필요한 장기 작업을 사용자 개입 없이 조건 충족까지 이어갈 수 있습니다.

CI 파이프라인 통합: 자동화 워크플로우에 붙일 때

Claude Code Goal은 -p 플래그로 헤드리스 모드 실행을 지원합니다. 대화형 인터페이스 없이 단일 호출로 /goal 루프를 완료까지 실행할 수 있어 CI나 야간 자동화 작업에 직접 붙일 수 있습니다. 

완료 조건을 명시해두면 파이프라인 안에서 Claude가 스스로 작업을 이어가고 조건이 충족되면 종료합니다.

Claude Code Goal 사용 시 주의할 점 

Claude Code v2.1.139 이상에서만 사용할 수 있습니다

/goal 명령은 Claude Code v2.1.139 업데이트에서 추가된 기능입니다. 이전 버전에서 실행하면  ‘Unknown command’로 표시됩니다. 사용 전 버전을 확인하고 최신 버전으로 업데이트해야 합니다.

세션당 하나의 목표만 활성화됩니다

Claude Code Goal은 세션당 하나의 목표만 유지합니다. 새로운 /goal을 입력하면 기존 목표가 덮어써집니다. 

여러 목표를 동시에 관리해야 하는 작업이라면 목표를 순차적으로 설정하거나 완료 조건 안에 여러 기준을 함께 담아야 합니다.

신뢰 대화 상자를 

수락한 워크 스페이스에서만 동작합니다

평가자 모델은 Claude Code의 hooks 시스템 일부로 동작하기 때문에 신뢰 대화상자를 수락하지 않은 워크스페이스에서는 /goal이 실행되지 않습니다. 

새 프로젝트에서 처음 사용할 때 반드시 확인해야 합니다.

완료 조건은 대화 흐름에서 

확인할 수 있는 형태로 작성해야 합니다

평가자 모델은 Claude가 대화 흐름에서 이미 보여준 결과를 기준으로 조건 충족 여부를 판단합니다. 

외부 스크립트를 직접 실행하거나 파일 시스템을 독립적으로 확인하지 않습니다. "npm test가 0으로 종료됐다", "변경 내용 요약이 포함됐다"처럼 Claude의 출력에서 직접 확인할 수 있는 형태로 조건을 작성해야 평가자 모델이 정확하게 판단합니다.

Claude Code의 AI 에이전트 능력 업그레이드 콘텐츠

클로드 코드 에이전트 팀 사용법, 역할별 AI 팀으로 개발 자동화하기

Claude Code Subagent 사용법, 역할만 정해주면 알아서 처리합니다

tmux 사용법, Claude Code와 연동한 멀티플렉서로 생산성을 극대화하는 방법