Codex CLI 목표 설정 시작: /goal로 작업 기준을 처음 고정하는 법
TL;DR
Codex CLI의
/goal
은 현재 채팅에 작업 목표를 붙이는 슬래시 명령입니다. 입력창에
/goal <objective>
를 넣으면 목표가 활성화되고 작업이 이어지는 동안 채팅에 유지됩니다. 로컬
codex-cli 0.144.6
에서는 Enter 직후
Goal active
가 표시되면서 목표 추구가 시작됐습니다. 첫 실행부터 실제 저장소를 쓰지 말고 비민감한 빈 테스트 폴더와 승인된 안전 목표로 확인해야 합니다.
핵심 3줄 요약
핵심 1
/goal
은 운영체제 shell이 아니라 Codex CLI 입력창에 넣습니다.
핵심 2
목표는 비어 있을 수 없고 최대 4,000자이며, 조회·수정·일시정지·재개·삭제 명령이 따로 있습니다.
핵심 3
목표 설정 직후 작업이 시작될 수 있으므로 Enter 전에 허용 입력, 제외 입력, 완료 기준, 사람 승인 지점을 정합니다.
이 글에서 다룰 내용
-
/goal이 하는 일과 지속 범위 - 현재 설치본에서 명령을 찾는 위치
- 비민감한 첫 목표를 설정하고
Goal active를 확인하는 순서 -
/goal edit,/goal pause,/goal resume,/goal clear의 구분 - 목표를 지침 파일이나 메모리로 오해하지 않기 위한 주의점
먼저 답: /goal은 무엇을 설정하나
/goal
은 현재 active chat에 하나의 작업 목표를 붙입니다. 공식 문서는
/goal <objective>
로 목표를 설정하고, 인수 없이
/goal
만 입력하면 현재 목표를 볼 수 있다고 설명합니다. 설정된 목표는 작업이 이어지는 동안 현재 채팅에 유지됩니다.
이 기능은 영구 프로젝트 규칙을 만드는 명령이 아닙니다.
AGENTS.md
나 메모리처럼 다음 세션까지 이어질 지침을 대신하지도 않습니다. 새 채팅을 만드는
/clear
나
/new
와도 목적이 다릅니다.
/goal
의 범위는 지금 열려 있는 채팅의 작업 목표입니다.
공식 문서에는 운영체제, 플랜, 지역, 언어, 최소 버전 조건이 적혀 있지 않습니다. 아래 설명은 2026년 8월 19일 공식 문서와 로컬
codex-cli 0.144.6
관찰을 구분합니다. 그래서 현재 설치본의 입력창에 명령이 보이는지부터 확인합니다.
시작 전 확인할 것
비민감한 빈 테스트 폴더를 엽니다
첫 실행은 고객 코드, 자격증명, 운영 데이터가 없는 빈 폴더에서 확인합니다. 로컬 관찰에서는 목표를 설정한 직후 Codex가 목표 추구를 시작했습니다. 실제 저장소에서 처음 시험하면 예상하지 못한 파일 읽기나 명령 실행으로 이어질 수 있습니다.
목표와 승인 지점을 먼저 적습니다
Enter를 누르기 전에 목표, 허용 입력, 제외 입력, 출력 형식, 완료 기준을 한 줄로 정합니다. 파일 읽기나 명령 실행, 파일 수정, 외부 전송은 별도 승인 지점으로 남겨 둡니다.
진행 중인 작업이 없는지 봅니다
기존 작업이 끝난 새 composer에서 시작합니다. 목표 설정 여부만 확인하는 첫 실행에서는 다른 요청이나 실제 수정 작업을 함께 넣지 않습니다. 완료 기준은
Goal active
표시 확인까지입니다.
실행 순서: /goal로 안전한 목표를 한 번 설정하기
1. Codex CLI 입력창에서 슬래시 목록을 엽니다
Codex CLI interactive TUI를 연 뒤 composer에
/
를 입력합니다. slash popup에서
/goal
과 설명을 확인합니다. 이 명령을 PowerShell, Bash, zsh 같은 운영체제 shell에 입력하면 안 됩니다.
로컬
codex-cli 0.144.6
에서는
/goal SAFE_GOAL_PROBE_20260819
를 Enter 전에 입력했을 때 명령이 인식됐습니다. 이 버전 표기는 해당 설치본의 관찰일 뿐 보편적인 최소 버전 조건이 아닙니다.
2. 안전한 첫 목표를 한 줄로 붙입니다
/goal
뒤에 아래 템플릿처럼 비민감한 목표를 적습니다. 첫 확인에서는 goal 문장 자체만 허용 입력으로 두고 파일, 명령, 네트워크, 외부 전송을 제외합니다.
목표는 빈 값일 수 없고 최대 4,000자입니다. 공식 문서는 더 긴 지침이 필요하면 내용을 파일에 두고 goal이 그 파일을 가리키게 하라고 안내합니다. 다만 파일을 읽게 하는 흐름은 첫 실행 완료 범위에서 제외합니다.
3. Enter 한 번 뒤 Goal active를 확인합니다
문장을 검토한 뒤 Enter를 한 번 누릅니다. 로컬 설치본에서는
Goal active
와 목표 문장이 표시된 뒤 목표 추구가 시작됐습니다. 명령이 ordinary prompt로 제출된 것이 아니라
/goal
동작으로 인식된 결과였습니다.
예상하지 못한 작업이 시작되면 즉시 중단합니다. 첫 실행은
Goal active
확인에서 끝내며 파일 변경, 명령 실행, 배포, 외부 전송을 완료 조건으로 삼지 않습니다.
4. 현재 목표를 조회하거나 상태를 바꿉니다
공식 문서상
/goal
만 입력하면 현재 목표를 봅니다. 목표 문구를 바꿀 때는
/goal edit
, 잠시 멈출 때는
/goal pause
, 다시 이어갈 때는
/goal resume
, 제거할 때는
/goal clear
를 사용합니다.
네 동작을 한꺼번에 시험할 필요는 없습니다. 첫 실행에서는 설정과
Goal active
만 확인합니다. 실제 작업을 시작하기 전에는 승인자가 목표와 입력 범위를 다시 봐야 합니다.
복사해서 쓰는 첫 목표 템플릿
/goal 목표: 이 goal 문장만 읽고 이해한 범위를 3줄로 정리한다
허용 입력: 이 goal 문장
제외 입력: 파일·명령·네트워크·외부 전송·새로운 사실
출력 형식: 목표·제외 범위·다음 승인 지점 각 1줄
완료 기준: Goal active 표시와 3줄 요약 확인
추측 금지: 제공되지 않은 파일·환경·결과를 가정하지 않는다
승인 지점: 파일 읽기·명령 실행·수정 전에 사람에게 확인한다
이 템플릿은 기능의 존재와 목표 활성화만 확인하려고 만든 예시입니다. 업무에 쓸 때는 허용할 저장소, 읽을 파일, 실행할 검증, 수정 금지 범위, 최종 승인자를 구체적으로 적습니다. 사람이 문구를 검토한 뒤 Enter를 누릅니다.
실전 인사이트: 목표와 실행 권한을 따로 검토합니다
좋은 goal 문장이 있어도 현재 세션의 권한과 승인 정책이 자동으로 좁아지는 것은 아닙니다. 목표는 Codex가 추구할 결과를 설명하고, 권한 설정은 어떤 파일과 명령에 접근할 수 있는지를 정합니다. 두 범위를 같은 것으로 취급하면 안 됩니다.
실무에서는 목표 문장과 실행 경계를 따로 기록하는 편이 명확합니다. 목표에는 기대 결과와 완료 기준을 넣고 별도 검토 항목에는 허용 입력, 금지 행동, 승인자를 둡니다.
Goal active
는 목표가 붙었다는 신호일 뿐 결과의 정확성과 안전성을 보증하지 않습니다.
주의할 점
-
/goal <objective>를 실행하면 로컬 설치본에서 곧바로 목표 추구가 시작됐습니다. 실제 저장소에서는 승인된 목표와 안전 경계를 먼저 준비합니다. - goal은 현재 active chat에 붙습니다. 영구 프로젝트 규칙, 조직 정책, 세션 간 메모리로 설명하지 않습니다.
- 목표는 비어 있을 수 없고 최대 4,000자입니다. 긴 지침 파일을 가리키는 방식은 파일 접근 승인을 별도로 검토합니다.
-
/goal edit,/goal pause,/goal resume,/goal clear는 서로 다른 동작입니다. 일시정지는 삭제가 아니고 clear는 저장소 변경을 되돌리는 명령이 아닙니다. - 공식 문서에 운영체제, 플랜, 지역, 언어, 최소 버전 조건이 없으므로 현재 계정과 설치본의 입력창을 확인합니다.
자주 묻는 질문
/goal은 어디에 입력하나요?
Codex CLI interactive TUI의 composer에 입력합니다. 운영체제 shell 명령이 아닙니다. 입력창에서
/
를 먼저 입력해 slash popup의
/goal
을 확인한 뒤 목표를 붙입니다.
/goal만 입력하면 어떻게 되나요?
공식 문서상 현재 설정된 목표를 보여줍니다. 새 목표를 설정하려면
/goal <objective>
형식으로 비어 있지 않은 목표를 넣습니다.
목표를 멈추거나 지우려면 어떻게 하나요?
공식 문서는
/goal pause
,
/goal resume
,
/goal clear
를 각각 일시정지, 재개, 제거 동작으로 안내합니다.
clear
는 goal 제거이며 파일 변경이나 이전 작업을 되돌린다는 뜻이 아닙니다.
Goal active가 보이면 작업이 끝난 건가요?
아닙니다. 현재 채팅에 목표가 붙었다는 뜻입니다.
결과의 정확성, 파일 변경의 안전성, 테스트 통과를 보증하지 않습니다. 실제 작업 결과는 diff, 검증 기록, 남은 위험을 사람이 따로 확인해야 합니다.
출처
- OpenAI Codex CLI slash commands 공식 문서 —
/goal설정·조회·edit·pause·resume·clear, 현재 채팅 지속 범위, 4,000자 제한을 확인했습니다. 2026년 8월 19일 확인.
마무리
/goal
의 첫 실행은 명령을 찾고 목표를 붙인 뒤
Goal active
를 확인하는 짧은 절차입니다. 다만 로컬 설치본에서는 Enter 직후 목표 추구가 시작됐습니다. 안전한 빈 폴더와 제한된 목표를 준비한 뒤 실행해야 합니다.
업무에 적용할 때는 목표 문장과 실행 권한을 나눠 검토합니다. 무엇을 목표로 삼을지, 어떤 입력을 허용할지, 어디서 사람 승인을 받을지 정한 뒤 현재 채팅에 붙이면 됩니다.
