Claude Code를 위한 장기 작업 자동화 도구: /goal 커맨드

실용적 조언

복잡한 리팩터링이나 기능 구현 시 adversarial 모드를 활성화하여 Claude가 놓칠 수 있는 엣지 케이스를 독립적으로 검증하세요.
비용 절감이 중요한 단순 반복 작업에서는 self 모드를 사용하여 검토 속도를 높이고 추가 비용을 줄이세요.
작업 시작 시 --tokens 옵션을 사용하여 예상치 못한 비용 발생을 방지하는 습관을 권장합니다.

섹션별 상세

Claude Code 내에서 /goal 커맨드를 사용하여 장기 작업을 설정하고 여러 턴에 걸쳐 중단 없이 작업을 수행한다. 사용자가 입력한 요구사항 명세서를 기반으로 모든 항목이 구현될 때까지 Claude가 작업을 지속하며, 사용자는 작업 완료 시점까지 개입할 필요가 없다. 이는 기존에 매 턴마다 수동으로 진행 상황을 확인해야 했던 번거로움을 해결한다.

bash

/plugin marketplace add balakumardev/claude
/plugin install claude-code-goal

Claude Code에 Goal 플러그인을 설치하는 명령어

작업 완료 후에는 독립적인 두 번째 Claude 세션이 결과물을 검토하는 adversarial 모드가 기본으로 작동한다. 검토 세션은 현재 저장소의 상태를 원래의 목표와 대조하여 Claude가 실패한 테스트를 삭제하는 등의 방식으로 속이지 못하도록 감시한다. 이를 통해 모델이 단순히 작업을 완료했다고 주장하는 대신 실제 요구사항 충족 여부를 객관적으로 확인한다.

bash

/goal config set audit.mode adversarial

독립적인 Claude 세션이 결과를 검토하도록 감사 모드를 설정하는 명령어

사용자의 필요에 따라 검토 모드를 세 가지로 설정하여 비용과 엄격함 사이의 균형을 맞춘다. 독립 세션이 검토하는 adversarial 방식 외에도 모델 스스로 검토하는 self 모드와 검토 과정을 생략하는 off 모드를 지원한다. /goal config set audit.mode 명령어를 통해 실시간으로 설정을 변경하며 워크플로를 최적화한다.

장기 실행 시 발생할 수 있는 비용 문제를 관리하기 위해 소프트 토큰 예산(Soft Token Budget) 기능을 포함한다. --tokens 250K와 같은 옵션을 통해 지정된 토큰이 소진되면 작업을 마무리하도록 유도한다. 이는 무한 루프나 예상치 못한 API 비용 폭증을 방지하는 안전장치 역할을 한다.

용어 해설

토큰 예산(Token Budget): — AI 모델이 작업을 수행할 때 사용할 수 있는 최대 토큰 수를 제한하는 설정이다. 긴 연구나 프로토타이핑 세션에서 비용을 관리하고 모델이 무한 루프에 빠지는 것을 방지하기 위해 사용된다.
적대적 검토(Adversarial Review): — 작업을 수행한 모델과 독립된 별도의 AI 세션이 결과물을 검증하는 방식이다. 모델이 스스로의 오류를 간과하거나 작업을 완료했다고 거짓 보고하는 것을 방지하여 결과의 신뢰성을 높인다.
감사 모드(Audit Mode): — 작업 완료 후 결과물이 원래의 목표와 요구사항을 충족하는지 검증하는 설정이다. Claude Code Goal 플러그인에서는 독립적 검토, 자기 검토, 검토 없음 중 하나를 선택하여 작업의 엄격함을 조절한다.

언급된 도구

Claude Code추천

Anthropic의 공식 CLI 코딩 에이전트 도구

claude-code-goal추천

장기 작업 관리 및 자동 검토를 위한 Claude Code용 플러그인

언급된 리소스

GitHubbalakumardev/claude 플러그인 마켓플레이스