AI시대

AI 코딩 에이전트 goal·ultracode 명령어 정리

AI 코딩 에이전트 goal·ultracode 명령어 정리

 

2026년 들어 AI 코딩 에이전트를 쓰는 방식이 한 번 크게 바뀌었습니다. 예전에는 한 번 시키고 결과를 확인한 뒤 다시 시키는 식이었다면, 이제는 goal 같은 명령어로 '완료 조건'만 정해주면 에이전트가 알아서 끝까지 돌아갑니다. 이 글에서는 goal·loop·batch·ultracode처럼 자율 실행을 제어하는 명령어를 계열별로 정리하고, Claude Code·Codex·Hermes가 이걸 어떻게 다르게 구현했는지 표로 비교해 보겠습니다.

"goal이랑 ultracode, 결국 같은 기능 아닌가요?"
"Codex에도 goal 있다던데 Claude Code랑 뭐가 달라요?"
"loop랑 batch는 대체 언제 쓰는 거예요?"

이런 질문을 최근에 자주 봅니다. 명령어 이름이 비슷비슷해서 헷갈리는데, 사실 각자 조절하는 '축'이 다릅니다. 터미널 기반 코딩 에이전트를 이제 막 써보시는 분, 혹은 어떤 명령어가 어떤 상황에 맞는지 한번 정리하고 싶으신 분께 도움이 될 내용입니다.

목차

  1. 프롬프트에서 '목표 지시'로 바뀐 흐름
  2. 자율 실행 명령어 한눈에 보기
  3. goal과 ultracode, 헷갈리기 쉬운 두 축
  4. Codex·Claude Code·Hermes의 goal 비교
  5. 쓰기 전에 알아두면 좋은 점

1. 프롬프트에서 '목표 지시'로 바뀐 흐름

2026년 4월 말 OpenAI Codex CLI가 goal을 실험 기능으로 먼저 내놓았고, 5월에 Claude Code가 같은 개념을 도입했습니다. Nous Research의 Hermes는 처음부터 비슷한 기능을 갖고 있었고요. 세 생태계가 거의 같은 시기에 같은 아이디어로 수렴한 셈입니다.

차이는 간단합니다. 일반 프롬프트는 "이거 해줘"라서 사람이 매 턴 운전대를 잡아야 합니다. 결과를 보고, 다음을 시키고, 승인하고, 계속 이어가라고 말하는 과정을 반복하죠. 반면 goal은 "이 결과를 달성해줘"입니다. 완료 조건을 한 번 정해두면, 에이전트가 매 턴 뒤에 별도의 평가자 모델로 "목표에 도달했나?"를 확인하고, 아직이면 사람에게 묻지 않고 다음 턴으로 넘어갑니다.

💡 한 줄 정리
프롬프트는 '지시', goal은 '위임'입니다. 무엇을 할지가 아니라, 무엇이 끝난 상태인지를 정의하는 방식이에요.

2. 자율 실행 명령어 한눈에 보기

Claude Code 기준으로, 자율 실행과 관련된 명령어를 계열별로 묶으면 이렇습니다. 이름은 버전에 따라 바뀔 수 있으니 개념 위주로 보시는 걸 권합니다.

반응형
명령어 하는 일 조절하는 축
/goal 완료 조건까지 자율로 반복 실행. 턴마다 평가자가 달성 여부 판정 언제 멈출까
/loop 세션이 열려 있는 동안 프롬프트를 반복. goal과 짝지어 자기수정 루프로 사용 얼마나 반복할까
/batch 작업을 여러 독립 단위로 쪼개 단위마다 백그라운드 에이전트를 병렬로 실행 몇 개를 동시에
/effort (ultracode) 추론 강도 조절. ultracode는 높은 추론에 병렬 서브에이전트 오케스트레이션을 결합 한 턴에 얼마나 깊게
/fork · /branch 대화를 복제해 서브에이전트로 분기하거나 사본으로 전환 (버전에 따라 동작 차이) 어디서 갈라질까
/plan 착수 전 접근 방식을 먼저 합의하는 플랜 모드 어떻게 시작할까

3. goal과 ultracode, 헷갈리기 쉬운 두 축

가장 많이 뒤섞이는 조합입니다. 이름이 비슷해서 하나로 묶어 부르기도 하는데, 실제로는 서로 다른 걸 조절합니다. 그래서 둘을 같이 쓸 수도 있습니다.

항목 /goal ultracode
성격 자율 완료 루프 노력(effort) 레벨
조절 대상 목표 달성까지 반복 여부 추론 강도 + 병렬 서브에이전트
지속성 세션 걸쳐 유지 (pause·resume) 세션 한정
핵심 메커니즘 턴마다 평가자가 완료 판정 오케스트레이터가 서브에이전트 결과 통합

4. Codex·Claude Code·Hermes의 goal 비교

같은 goal이라도 도구마다 강점과 구현 방식이 조금씩 다릅니다. 흥미로운 점은 하위 명령어 형식은 세 도구에서 대체로 비슷하게 맞춰졌다는 것입니다.

항목 Codex CLI Claude Code Hermes
도입 4월 말 먼저 (실험 기능) 5월 도입 원래 내장
강점 스펙 주고 만들기 문제 찾기·검증 조율(오케스트레이션)
하위 명령어 /goal · pause · resume · clear /goal + 내장 평가자, Ctrl+C 중단 Kanban 목표 카드, 하위 목표 위임
특징 config에서 활성화, 목표를 세션 걸쳐 유지 매 턴 판정, 모든 단계 로깅 직접 코딩보다 도구 배분·핸드오프

정리하면 Codex는 '만드는 쪽', Claude Code는 '검증하는 쪽', Hermes는 '지휘하는 쪽'에 무게가 실려 있습니다. 셋을 조합해서 Hermes가 지휘하고 Codex·Claude Code가 실무를 나눠 맡는 파이프라인을 짜는 사례도 있습니다.

5. 쓰기 전에 알아두면 좋은 점

자율 실행은 편하지만, 조건을 잘못 주면 오히려 손이 더 갑니다. 몇 가지만 챙기면 실패 확률이 확 줄어듭니다.

📌 목표는 검증 가능하게
"코드 개선해줘" 같은 모호한 목표는 무한 루프에 빠지거나, 다 안 됐는데 됐다고 끝내버리기 쉽습니다. "tsc가 에러 0으로 통과", "테스트 전부 통과"처럼 기계가 확인할 수 있는 조건으로 적어야 합니다.

그밖에 챙기면 좋은 것들입니다.

  • CLAUDE.md나 agents.md에 아키텍처·컨벤션·수용 기준을 적어두면, 에이전트가 매 턴 읽어서 엉뚱한 추측을 줄입니다.
  • git 브랜치와 샌드박스에서 돌리고 로그를 남기면, 몇 시간짜리 세션도 나중에 감사·복구가 가능합니다.
  • 명령어 이름과 별칭은 버전마다 자주 바뀝니다. 예를 들어 fork와 branch는 한동안 같은 명령이었다가 나중에 갈라졌습니다.

결국 goal 계열의 핵심은 '무엇이 끝난 상태인가'를 사람이 정확히 정의하는 데 있습니다. 그 정의가 명확할수록 에이전트가 알아서 갈 수 있는 거리가 길어집니다. 도구 선택보다 조건을 잘 정의하는 감각이 먼저인 셈이죠.

자주 묻는 질문

goal과 ultracode는 같이 쓸 수 있나요?

네. 하나는 '목표 달성까지 반복'을, 다른 하나는 '한 턴의 추론 강도와 병렬화'를 조절하는 서로 다른 축이라 함께 켜둘 수 있습니다.

goal 명령어는 어느 도구에 있나요?

OpenAI Codex CLI, Claude Code, 그리고 Nous Research의 Hermes에 있습니다. 하위 명령어 형식은 세 도구가 대체로 비슷하게 맞춰져 있습니다.

goal을 쓰면 사람이 전혀 개입 안 해도 되나요?

그렇지는 않습니다. 승인 범위 설정, 중간 중단(Ctrl+C 등), 완료 조건 검증은 여전히 사람 몫입니다. 자율성은 높아졌지만 방치해도 된다는 뜻은 아닙니다.

📚 함께 보면 좋은 글

 

AI 코딩 컨벤션 시대, 컨벤션 문서의 독자가 바뀌었다

AI 코딩 컨벤션이라는 말이 낯설게 들릴 수 있습니다. 코드 컨벤션은 원래 사람 팀원끼리 지키던 약속이었는데, 요즘은 그 규칙 문서를 읽는 쪽이 AI로 바뀌었습니다. CLAUDE.md, AGENTS.md 같은 파일이

devwar.tistory.com

 

클로드코드 권한 모드 4개 아니라 사실 6개, Auto와 Plan 차이

클로드코드 권한 모드는 흔히 아는 것보다 하나 더, 둘 더 있습니다. Shift+Tab을 눌러 순환하면 Manual, Accept edits, Plan, 조건이 맞으면 Auto까지 서너 개가 돌아가는데, 공식 문서 기준 실제 권한 모드

devwar.tistory.com

 

goal 명령어 뜻, 목표만 주면 AI가 다 만든다

개발은 원래 배운 사람이나 하는 일이라고 여겨졌습니다. 그런데 요즘 AI 코딩 도구에 들어간 goal 명령어를 보면 그 상식이 조금씩 흔들립니다. 이제는 코드를 한 줄씩 시키는 게 아니라, 원하는

lsy7651.tistory.com

반응형