AI 코딩 도우미는 실패한 검사를 계속 다룰 수 있지만 검사 자체와 최종 코드는 사람이 검토해야 합니다. 이 가이드는 저장소를 관리하며 테스트, 빌드, 코드 스타일 명령 하나가 이미 실패하는 개발자를 위한 것입니다. Claude Code의 제한된 Goal 또는 별도 대안인 대화형 Codex CLI를 사용합니다. 하나만 선택하세요. 사전에 지정한 동작을 보존하는 검토된 변경에서 원래 명령이 통과해야 완료입니다. 입증하지 못하면 실패와 정확한 장애를 남깁니다. 문서 기반 절차이며 BIG CHANGE는 이 글을 위해 Goal을 실행하거나 저장소를 수정하지 않았습니다.

큰 변화

  • 달라진 점: 문서화된 /goal 명령은 목표를 여러 턴에 걸쳐 유지하므로 도우미가 실패를 조사하고 범위 내 수정 후 다시 검사할 수 있습니다. 매 턴 새로운 지시를 줄 필요가 없습니다.
  • 중요한 이유: 원래 실패 명령, 허용 파일, 보존 동작을 시작 전에 정할 수 있습니다. 연속 시도에 같은 수락 기준을 줍니다.
  • 살펴볼 점: Goal 상태나 모델 판정은 수정 증거가 아닙니다. 실제 출력과 최종 diff를 읽고 변경을 수락할지 직접 결정하세요.

시작 전: 실패와 경계 기록하기

변경 권한이 있는 저장소를 사용합니다. 로컬 지침을 읽고, 있다면 AGENTS.md 또는 CLAUDE.md 도 확인합니다. 브랜치, 기존 변경, 추적하지 않는 파일을 살펴봅니다. Git에서는 다음 명령으로 초기 목록을 얻습니다.

Terminal
git status --short
git diff --stat
git diff

기존 작업과 도우미 변경을 구분하도록 목록을 보관합니다. 실제로 실패하는 검사 를 한 번 실행하거나 정확한 명령, 전체 오류, 종료 상태가 있는 최근의 신뢰할 수 있는 실행 기록을 저장합니다. 글의 예제 명령으로 대체하지 마세요. 접근 불가 서비스, 비밀 정보, 플랫폼에 의존하면 먼저 기록합니다. 알려진 단일 수정은 일반 요청이 더 적합할 수 있습니다. 검사 결과마다 다음 진단 단계가 결정되면 Goal이 유용합니다.

Goal 밖에 짧은 수락 메모를 씁니다. 원래 명령, 현재 출력, 허용 경로와 도구, 보존 동작 및 다른 검사, 멈추고 검토할 결정을 적습니다. 무관한 기존 변경을 명시적으로 보호합니다. 통과를 꾸미려고 검사를 지우거나 약화시키게 하지 마세요. 도구 세션 허용 전에 직접 읽습니다. 일정 턴 후 중단 요청은 모델 지침일 뿐 지출 상한을 보장하지 않습니다.

1. Goal 환경 하나 선택하기

대상이 Claude Code라면 지정 저장소 세션을 열고 /goal 사용 가능 여부를 확인합니다. Goal 설명서를 2026년 10월 20일 확인했으며 작업 공간 신뢰와 훅 설정에 달려 있다고 설명합니다. 세션마다 Goal 하나가 활성화될 수 있습니다. 새 조건은 이전 것을 대체하고 즉시 시작합니다. Goal은 권한 모드를 바꾸지 않습니다. 수동 모드는 도구 호출 전에 계속 물을 수 있고 자동 모드는 별도 설정입니다. 파일, 명령, 네트워크의 기존 통제를 유지하세요.

대안인 대화형 Codex CLI에서는 설치 버전과 슬래시 명령 목록을 봅니다. OpenAI의 Goals 실용 가이드 는 Codex 0.128.0부터 시작한다고 설명합니다. 사용 사례 가이드 는 features.goals 스위치를 설명합니다. 명령이 없으면 자신의 설치에서 확인할 사항이며 이 글에서는 실행하지 않았습니다.

Terminal
codex --version
codex features enable goals

설치에 필요하고 조직이 허용할 때만 기능을 켭니다. 이 Codex 지침은 대화형 CLI용입니다. codex exec 이나 모든 데스크톱 빌드에서 같은 슬래시 지원이 있다고 가정하지 마세요. 여전히 없으면 멈추고 버전, 기능 설정, 계정이나 작업 공간 접근을 확인한 뒤 다른 방법을 고릅니다.

2. 범위가 정해진 조건 설정하기

사용할 명령은 /goal 이며 검토한 조건을 이어 씁니다. 실제 검사 명령과 허용 경로를 쓰고 가짜 테스트명을 붙이지 마세요. 예를 들면 “수락 메모의 경로와 도구만 사용해 내 검사를 통과시켜 주세요. 이 검사는 이미 실패하고 있습니다. 시도마다 명령, 전체 결과, 변경 파일을 보여 주세요. 보호 동작과 무관한 변경을 유지하세요. 실행할 수 없거나 범위 안에 안전한 수정이 남지 않으면 정확한 오류, 시도한 변경, 나에게 필요한 정보를 남기고 멈추세요.”라고 쓸 수 있습니다. “내 검사”를 정확한 명령으로 바꾸고 시작 전에 메모를 첨부하거나 위치를 지정합니다.

두 문서의 /goal 명령 모두 최대 4,000자의 빈칸 아닌 조건을 받습니다. 상세 제약은 메모에 둡니다. Claude Code의 /goal <condition> 는 즉시 턴을 시작합니다. 대화형 Codex CLI의 /goal <objective> 는 현재 대화에 지속 목표를 붙입니다. 둘 다 새 파일, 명령, 계정 권한을 주지 않습니다. 더 넓은 경로, 외부 서비스, 비밀 정보, 병합, 배포가 필요하면 소유자 결정을 위해 멈춥니다.

3. 작업 중 증거 살펴보기

의미 있는 시도마다 정확한 출력과 변경 파일 목록을 요청합니다. 인수 없이 /goal 를 실행하면 상태를 봅니다. Claude Code는 평가 후 경과 시간, 평가 턴, 토큰 사용량, 평가자의 최신 이유를 보여 줍니다. 평가자는 Claude가 대화에 드러낸 내용을 읽을 뿐 독립적으로 검사하거나 파일을 살펴보지 않습니다 . 따라서 “met”는 검증하라는 신호이며 수정 증거가 아닙니다. Codex Goal 상태도 실제 출력과 diff가 있어야 결과를 확정할 수 있습니다.

원래 범위를 유지합니다. 허용 전에 제안 명령을 읽고 특히 삭제, 이력 재작성, 저장소 밖 전송, 권한 변경을 주의합니다. 검사가 약화되거나 무관한 파일이 설명 없이 바뀌거나 비공개 데이터가 노출되면 멈춥니다. 다음 작업을 안전하게 허용할 수 없다면 Goal 상태를 기록하고 더 좁은 계획을 요청하세요.

4. 완료를 직접 검증하기

도우미가 성공을 보고하면 전체 최종 diff를 초기 목록과 비교합니다. 변경 및 새 파일 모두 허용 경로인지 봅니다. 가능하면 동일한 원래 검사 명령 을 다시 실행하고 전체 출력과 종료 상태를 보관합니다. 수락 메모의 관련 미변경 테스트도 실행하고 보존할 동작을 검토합니다. 대체 검사가 통과해도 약속을 충족하지 않습니다.

증거가 검토 조건과 맞고 diff를 승인해야 변경을 받아들입니다. Commit, 병합, 배포는 별도 허가 결정입니다. 검증 실패 시 명령과 출력, 변경 파일, Goal 상태, 정확히 빠진 권한·의존성·결정을 보관합니다. 일시정지, 중단, 불가능, 차단 또는 예산 제한된 Goal은 완료된 수정이 아닙니다.

Goal이 멈추거나 막히면

대상이 Claude Code라면 /goal 는 현재 조건과 최신 이유를 보여 주고 /goal clear 는 활성 Goal을 제거합니다. 설명서 에 따르면 세션 재개 시 조건이 복원될 수 있으나 시간, 턴, 토큰 기준값은 초기화됩니다. 세션 선택기 복원은 v2.1.239에서 수정됐습니다. Claude Code가 관리하는 인증 실패, 크레딧 소진, 복구 불가 컨텍스트 초과, 모델 불가로 Goal이 지워질 수 있습니다. 호스트 관리 인증은 활성 상태로 남길 수 있습니다. 다른 오류는 유지한 채 재시도하거나 일시정지할 수 있으며 대화형 알림은 v2.1.269 이상에서 문서화됐습니다. 설정 또는 재개 전에 경고, 상태, 저장 출력, 작업 diff를 읽으세요. 새 조건은 이전 것을 대체합니다.

대상이 대화형 Codex CLI라면 /goal 는 목표를 보여 주고 /goal edit, /goal pause, /goal resume 및 /goal clear 는 CLI 명령 참조에 문서화된 제어입니다. 실용 가이드 는 완료와 일시정지, 중단, 예산 제한, 장애를 구분합니다. 재개하거나 목표를 바꾸기 전에 현재 상태와 실제 저장소 증거를 확인합니다. 예산이나 접근이 일을 막았다면 정확한 장애 설명이 추가 시도보다 유용할 수 있습니다.

모델 턴은 계정 한도나 크레딧을 사용하고 Claude Code의 별도 평가자도 토큰을 씁니다. 자기 계정의 현재 통제와 한도를 확인하세요. 글로 쓴 시간이나 턴 조건이 달러 지출 상한을 보장하지 않습니다. 허용 자료만 사용하고 비밀과 무관한 개인 파일을 제외하며 저장소 지침은 도우미가 따르기 전에 검토합니다.

별도 설정 배경은 Codex Cloud 환경 가이드 에서 원격 저장소 연결과 준비를 설명합니다. 공유 Team Tasks 가이드 는 ChatGPT 반복 작업을 다룹니다. 둘 다 위 로컬 검사 절차에 필수는 아닙니다.

출처와 추가 자료