Claude Code에도 /goal 기능 추가 — 목표 기반 자율 코딩의 새 시대

Claude Code에도 /goal 기능 추가 — 목표 기반 자율 코딩의 새시대

Claude Code /goal 기능 — 목표 기반 자율 코딩의 새 시대

Claude Code에 드디어 /goal 기능이 추가되었다. 사용자가 설정한 목표가 완료될 때까지 Claude가 자동으로 여러 턴을 이어서 실행하는 기능이다. 기존 채팅형 코드 어시스턴트와는 결이 다른, 목표 기반 자율 작업자(Goal-Oriented Autonomous Agent)로의 전환을emarks하는 변화다.

/goal이란 무엇인가

간단히 말해, /goal은 Claude Code에 달성해야 할 목표를 설정하면 Claude가 스스로 반복 실행하며 목표를 완료할 때까지 작업을 이어가는 명령어다.

기존 Claude Code의 동작 방식은 단순했다. 사용자가 한 번의 명령을 내리면 Claude가 한 번 응답하고, 사용자가 다시 명령을 내리면 다음 턴이 시작된다. 개발자는 매번 다음 단계가 무엇인지를 직접 지시해야 했다.

/goal이 도입된 뒤 동작 방식은 근본적으로변료. 개발자는 최종 목표만 설정하고, Claude가 각 턴 종료 시 스스로 판단하며 자동으로 다음 턴을 실행한다.

동작 원리: Fast Model 평가 기반 자동 반복

/goal의 핵심은 각 턴 종료 시점에서의 자동 평가 메커니즘에 있다. 구체적인 동작 흐름은 다음과 같다.

[Turn 1] 개발자: /goal "REST API 서버 구축"→ Claude: 파일 생성, 의존성 설치 등 첫 번째 작업 실행→ Fast Model 평가: "목표 달성 여부 — 미완료"→ 다음 턴 자동 시작[Turn 2] → Claude: 다음 작업 실행→ Fast Model 평가: "목표 달성 여부 — 미완료"→ 다음 턴 자동 시작[Turn 3] → Claude: 마지막 작업 실행→ Fast Model 평가: "목표 달성 여부 — 완료"→ /goal 자동 제거, 작업 종료

여기서 주목할 점은 평가자가 파일 시스템이나 명령 실행 결과를 직접 확인하지 않는다는 것이다. 대화 기록(Conversation History)만 기준으로 목표 달성 여부를 판단한다. 이 설계는 evaluation cost를 줄이면서도 충분한 품질 판단 근거를 확보하기 위한 것으로 풀이된다.

세션 관리: 1개 목표, 1개 세션

/goal은 한 세션에 하나만 활성화할 수 있다. 이미 활성 목표가 있는 상태에서 /goal을 다시 호출하면 이전 목표가 교체된다. --resume 또는 --continue 옵션으로 세션을 복원하면, 이전에 설정한 목표도 함께 복원된다.

이 제약은 의도적인 설계로 보인다. 목표가 여럿이라면 작업 범위가 불분명해지고, 각 목표 간 우선순위 판단이 복잡해져 Claude의 자율 판단 품질이 떨어질 수 있다.

Codex CLI와의 차이: 같은 이름, 다른 철학

흥미로운 점은 OpenAI의 Codex CLI에도 /goal 기능이 있다는 것이다. 이름이 동일하지만, 구현 철학에는명현한 차이가 있다.

Codex의 /goal은 goal continuation과 budget limit에 중점을 둔 프롬프트 텰플릿 중심의 접근이다. 목표를 프롬프트에 임베딩하고, 토큰 사용량에 따른 budget 한계를 두는 방식이다.

Claude Code의 /goal은 기존 /loop, Auto Mode 체계 안에서 설명된다. Auto Mode가 도구 승인 자동화에 집중한다면, /goal은 턴 반복 자동화에 초점을 맞춘다. Claude 문서에서는 이를 session-scoped Stop hook의 래퍼(Wrapper)로 설명한다.

두 도구 모두 채팅형 보조자에서 목표 기반 자율 작업자로 수렴하고 있다는 점에서는 동일하다. 그러나 각각의 체계 안에서 /goal이 차지하는 위치와 역할은 다르다.

Claude Code 자동화 체계 전체 보기

/goal은 Claude Code의 자동화 기능 군 속에서 가장 새로운 구성 요소다. 현재 Claude Code가 지원하는 주요 자동화 기능을 정리하면 다음과 같다.

기능	역할	자율 수준
/goal	목표 기반 턴 자동 반복	⭐⭐⭐
/loop	동일한 명령 반복 실행	⭐⭐
Auto Mode	도구 승인 자동화	⭐⭐⭐
HTTP Hook	외부 웹훅 연동	⭐
Auto-Memory	대화 내용 기반 메모리 관리	⭐

Auto Mode는 도구 사용 승인 프로세스를 자동화하여Claude가인적화대로 연속 도구 호출을 할 수 있게 한다. /goal은 그 위에서 목표 달성이라는 의도(Intent)를자동으로 판단하는 레이어다.

실용적 활용 시나리오

/goal이 실제로 유용한 시나리오에는 다음과 같은 경우가 있다.

긴밀한 리팩토링 작업. "기존 모놀리식 인증 모듈을 마이크로서비스로 분리"와 같이 여러 파일에 걸친 복합 작업에서, 개발자는 최종 상태만 정의하고Claude가 나머지를 자동 수행하게 할 수 있다.

반복적인 테스트 작성. "모든 공개 메서드에 단위 테스트 추가"와 같은 목표를 설정하면,Claude가 코드베이스를 스캔하며 테스트 파일을 순차적으로 생성한다.

문서화 작업. "이 레포지터리의 README를 API 문서까지 포함해 재작성"처럼, 기존 문서를 분석하고새로 작성하는 복합 작업을 한 명령으로 처리할 수 있다.

토큰 사용에 대한 주의

긱뉴스 댓글에서 지적된 것처럼, /goal을 무분별하게 사용하면 순식간에 토큰 사용량이 급증할 수 있다. 각 턴마다 Fast Model의 평가가 발생하고, 목표 미달성 시 연속 턴이 실행되므로 의도치 않게 많은 턴이 쌓일 수 있다.

실무적인 운용 팁은 다음과 같다.

• 목표는 구체적으로 설정할 것. "API 서버 구축"보다 "Flask 기반 REST API 서버,GET/POST /users 엔드포인트 포함"이 더 명확한 완료 시점을 가진다.

• 수정 실행 전 Dry Run. 처음 사용할 때는 --dry-run 옵션으로Claude의 예상 동작을 먼저 확인한다.

• 토큰 사용량 모니터링. Claude Code의 /usage 명령으로 세션별 사용량을 주기적으로 확인한다.

향후 전망

/goal의 도입은 AI 코딩 도구가 단순한 명령 실행기에서 자율적 작업 파트너로 나아가는 과정을 보여준다. 개발자가 의도와 방향만 설정하면, AI가 구체적인 실행 과정을 자율적으로계화하고실행하며 결과를반회받는 구조다.

Codex CLI와의 명령어 명칭 유사성도 주목할 만하다. 서로 다른 조직에서 만든 도구가 문제 해결의 본질에 대해 유사한 해법으로 수렴하고 있다는 것은, AI 에이전트 분야의 공통 설계 패턴이 형성되고 있음을 시사한다.

앞으로 /goal이 Auto Mode와 더욱 긴밀하게 통합되어, 목표 설정만으로 완전한 자율 코딩 세션이 구성되는 날이 올지도 모른다.

---

핵심 요약

• Claude Code에 /goal 기능 추가: 목표 설정 시 달성할 때까지 자동 반복 실행

• 각 턴 종료 시 Fast Model이 목표 달성 여부 평가

• 평가 기준은 대화 기록이며, 파일/명령 직접 확인 없음

• 세션당 1개 목표만 활성화, --resume/--continue 시 복원

• Codex CLI의 /goal과 이름은 동일하나 구현 철학은 다름

• 토큰 소비에 주의하며 구체적인 목표 설정이 중요

태그: Claude Code, Anthropic, AI Coding Agent, Autonomous Agent, Codex CLI, Auto Mode, 개발 자동화, AI 도구

---

📚 출처

• https://news.hada.io/topic?id=29428