Cmd. /goal
긴 작업에 지속 목표를 붙이고 확인·pause·resume·clear하는 /goal 명령. 현재 기본 활성화된 안정 기능이며 multi-day 작업에 사용합니다.
핵심 요약
- 긴 작업에 지속 목표를 붙이고 확인·pause·resume·clear하는 /goal 명령. 현재 기본 활성화된 안정 기능이며 multi-day 작업에 사용합니다.
- 목표에는 결과 기준과 중단 조건을 4,000자 이내로 적고,
/goal pause·resume·clear로 진행을 관리합니다.
역할
긴 작업에 지속 목표를 붙이고 확인·pause·resume·clear하는 /goal 명령. 현재 기본 활성화된 안정 기능이며 multi-day 작업에 사용합니다.
/goal사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-10-23 · Codex CLI 0.163.0 |
features.goals는 현재 안정 기능이며 기본 활성화입니다. 사용자·조직 설정이 이를 비활성화할 수 있습니다.
사용 예
/goal Finish the migration and keep the tests green
/goal/goal edit
/goal pause
/goal resume
/goal clear선택 시점
/goal Finish the migration and keep tests green처럼 결과와 검증 기준을 함께 적음- 오래 걸리는 작업을 재개한 직후
/goal로 현재 목표가 여전히 맞는지 확인 - 범위가 바뀌면 기존 goal을
/goal clear로 지우고 새 goal을 설정
관련 명령 선택
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
| /goal | 긴 작업의 지속 목표 | 장기 migration, 반복 검증, multi-day 작업 |
| /plan | 계획 모드 전환 | 구현 전 계획과 단계 분해가 필요할 때 |
| /status | 현재 세션 상태 | goal보다 모델/권한/토큰 상태가 궁금할 때 |
실행 결과와 유지 범위
현재 스레드에 목표를 연결해 여러 턴에 걸쳐 유지합니다. 작업 범위가 바뀌면 목표도 갱신하거나 해제합니다.
/goal은 긴 작업에 지속 목표를 붙이고 현재 goal을 확인하거나 pause/resume/clear하는 명령.
운영 메모
- 장시간 goal을 예약하거나 reminder와 함께 운영할 때는 UTC 기준 시각과 현재 시각 해석을 명시하세요. 0.142.0에서 scheduled UTC reminders와 current-time handling이 보강됐습니다.
- multi-agent delegation modes를 쓰는 goal은 parent/child agent의 완료 조건과 인계 규칙을 goal 본문이나 linked runbook에 함께 적습니다.
- 시작 전
/usage weekly와 rollout token budget을 확인하고, earned reset은 실패 재시도나 고우선 작업에만 사용하세요.
주의사항
목표 내용은 비어 있지 않아야 하며 4,000자를 넘을 수 없습니다. 긴 지시는 파일로 분리해 참조하세요. v0.151.0+에서는 중첩된 서브에이전트의 토큰 사용량도 루트 목표 예산에 포함됩니다.
- 조직·사용자 설정에서 goals를 비활성화했는지 확인하고, 목표의 범위와 중단 기준을 명시하세요
- goal에는 상세 실행 절차보다 결과 기준과 stopping rule을 적는 쪽이 안정적입니다
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록