Codex
프로필
- (프로필 없음) — 읽기 전용 분석 (컴파일 없음, 테스트 없음)
--profile edit— 로컬 편집, 빌드 또는 테스트 (workspace-write, 완전 자동)--profile full— 네트워크 또는 광범위한 파일 시스템 접근 (danger-full-access, 완전 자동)
작업에 go test, go build 또는 빌드 아티팩트를 쓰는 명령이 포함될 때는 항상 --profile edit을 사용하세요. 기본 읽기 전용 샌드박스는 컴파일러 임시 디렉토리를 포함한 모든 쓰기를 차단합니다.
복잡한 작업의 경우 --config model_reasoning_effort="xhigh"를 추가하세요.
모델 선택
기본값은 프로젝트 .codex/config.toml에 정의된 모델(gpt-5.4)입니다.
속도 우선 대화형 작업에는 --model gpt-5.3-codex-spark를 사용하세요:
- 긴밀한 왕복 반복
- 빠른 버그 수정 및 대상 편집
- 중소 규모 리팩토링 또는 UI 조정
- 빈번한 방향 전환이나 중단이 예상되는 빠른 프로토타이핑
깊이 우선 작업에는 기본 gpt-5.4를 유지하세요:
- 긴 자동 실행
- 많은 추론이 필요한 광범위한 다중 파일 변경
- 테스트 또는 검증이 많은 작업
- 더 깊은 추론이 추가 지연 시간을 정당화하는 높은 정확도/위험 표면
사용자가 특정 모델을 명시적으로 요청하는 경우, 사용자의 요청을 따르세요.
명령어
프로젝트 기본값은 .codex/config.toml에 있습니다. 항상 --skip-git-repo-check와 2>/dev/null을 포함하세요. 사용자가 명시적으로 요청하거나 작업이 위의 Spark 속도 우선 기준에 명확히 부합할 때만 모델을 재정의하세요.
| 사용 사례 | 명령어 |
|---|---|
| 읽기 전용 분석 | codex exec --skip-git-repo-check -o "$CODEX_OUT" "프롬프트" 2>/dev/null |
| 속도 우선 대화형 루프 (Spark) | --model gpt-5.3-codex-spark 추가 |
| 로컬 편집 적용 | --profile edit 추가 |
| 네트워크 / 광범위한 접근 | --profile full 추가 |
| 세션 재개 | `echo "프롬프트" |
실행 전에 출력용 임시 파일을 생성하세요: CODEX_OUT=$(mktemp /tmp/codex-out.XXXXXX). 완료 후 $CODEX_OUT에서 결과를 읽으세요.
Bash에서 run_in_background: true로 실행하세요. block: true, timeout: 600000으로 TaskOutput을 통해 모니터링하세요. 폴링을 위해 sleep 명령을 사용하지 마세요. 최종 답변을 위해 -o 파일을 읽으세요.
재개
재개할 때 모델/노력/샌드박스 플래그를 전달하지 마세요 — 원래 세션 설정이 유지됩니다. -o는 포함해도 안전합니다.
규칙
이 프로젝트는 Go 프로젝트입니다. 프롬프트에 go test, go build, go vet를 사용하세요. Codex 작업자는 CLAUDE.md나 훅을 받지 않으므로 프로젝트 규칙을 명시적으로 포함해야 합니다.
실행 후 검증
항상 git diff --stat를 통해 Codex 출력을 검증하세요 — 작업자가 보고한 파일 목록을 신뢰하지 마세요. Codex 작업자가 범위를 벗어난 변경(파일 삭제, 관련 없는 코드 되돌리기, 테스트 함수 제거)을 수행할 수 있습니다. 완료 약속에는 의도한 파일만 나열되고 파괴적인 부작용이 생략될 수 있습니다.
동일한 코드베이스에 다른 작업이 있는 경우, 프롬프트에 명시적인 "수정하거나 삭제하지 마세요" 파일 목록을 포함하세요. 긍정적인 지시("이 파일들만 건드리세요")만으로는 충분하지 않습니다 — Codex는 "정리"를 광범위하게 해석합니다.
[[principles/prove-it-works]]: 자기 보고가 아닌 아티팩트를 신뢰하세요.
작업 트리 사용법
-C <작업트리-디렉토리>를 사용하면 작업 트리에 자체 git 인덱스가 있습니다. .claude/는 .agents/에 심볼릭 링크될 수 있습니다 — git 작업에는 .agents/ 경로를 사용하세요.