Codex 스킬 가이드
작업 실행
- 새 세션의 경우(재개 시 이전 모델/노력을 상속받습니다 — 5단계 참조), 사용자에게 모델과 추론 노력을 두 가지 질문이 포함된 단일 프롬프트로 물어보세요(
AskUserQuestion통해). 사용자가 선호도를 표현하지 않으면gpt-6-astra와high를 기본값으로 사용합니다.- 모델 — 기본값
gpt-6-astra:- GPT-6:
gpt-6-astra(최첨단 / 가장 강력함 — 기본값) - GPT-5.6:
gpt-5.6-sol(믿을 수 있는 에이전트 워크호스),gpt-5.6-terra(균형 잡힌 일상용),gpt-5.6-luna(빠르고 저렴함) - 레거시(호환성 유지):
gpt-5.5,gpt-5.4,gpt-5.4-mini,gpt-5.3-codex-spark,gpt-5.3-codex
- GPT-6:
- 추론 노력 — 기본값
high:low,medium,high,xhigh,max,ultra.max/ultra는 GPT-6 또는 GPT-5.6 모델이 필요하며,ultra는astra/sol/terra에서만 사용 가능합니다(luna는max까지 제한). 레거시 모델은xhigh까지 제한됩니다.ultra= 최대 추론 및 자동 작업 위임(가장 느리고 비쌈 — 가장 어려운 작업에만 사용).- 선택한 노력이 선택한 모델의 최대치를 초과하면 해당 모델이 지원하는 가장 높은 노력으로 대체하고 사용자에게 알립니다.
- 모델 — 기본값
- 작업에 필요한 샌드박스 모드를 선택합니다. 편집이나 네트워크 액세스가 필요하지 않으면 기본값
--sandbox read-only를 사용합니다. - 적절한 옵션으로 명령어를 조립합니다:
-m, --model <MODEL>--config model_reasoning_effort="<low|medium|high|xhigh|max|ultra>"(max/ultra는 GPT-6 / GPT-5.6 모델에서만, ultra는 astra/sol/terra에서만 사용 가능 — 1단계 참조)--sandbox <read-only|workspace-write|danger-full-access>--full-auto-C, --cd <DIR>--skip-git-repo-check"your prompt here"(최종 위치 인자로)
- 항상
--skip-git-repo-check를 사용하세요. - 이전 세션을 계속할 때는
codex exec --skip-git-repo-check resume --last를 stdin을 통해 사용하세요. 재개 시 사용자가 모델이나 추론 노력을 명시적으로 요청하지 않는 한 어떤 구성 플래그도 사용하지 마세요. 재개 구문:echo "your prompt here" | codex exec --skip-git-repo-check resume --last 2>/dev/null. 모든 플래그는 exec와 resume 사이에 위치해야 합니다. - 중요: 기본적으로 모든
codex exec명령어에2>/dev/null을 추가하여 생각 토큰(stderr)을 숨기세요. 사용자가 명시적으로 생각 토큰 보기를 요청하거나 디버깅이 필요한 경우에만 stderr를 표시하세요. - 중요 (stdin):
codex exec는 항상 stdin을 읽고 위치 프롬프트와 결합합니다. 프롬프트가 온전히 위치 인자로 제공된 경우에도 마찬가지입니다. stdin이 닫히지 않으면 codex가 영원히 차단됩니다. harness(백그라운드 작업, 훅, stdin이 TTY가 아니지만 닫히지 않은 스크립트)에서 호출할 때는 명령어에</dev/null을 명시적으로 리디렉션하세요. 예:codex exec ... "prompt" </dev/null 2>/dev/null. 이 부분을 잘못 처리하면 stdout 0바이트, CPU 누적 0, 프로세스가 무기한 중단된 것처럼 보입니다. - 명령어를 실행하고 stdout/stderr를 캡처한 후(적절히 필터링), 결과를 사용자에게 요약합니다.
- Codex 완료 후, 사용자에게 알립니다: "이 Codex 세션은 언제든지 'codex resume'이라고 말하거나 추가 분석이나 변경을 요청하여 재개할 수 있습니다."
빠른 참조
| 사용 사례 | 샌드박스 모드 | 주요 플래그 |
|---|---|---|
| 읽기 전용 리뷰 또는 분석 | read-only | --sandbox read-only 2>/dev/null |
| 로컬 편집 적용 | workspace-write | --sandbox workspace-write --full-auto 2>/dev/null |
| 네트워크 또는 광범위한 액세스 허용 | danger-full-access | --sandbox danger-full-access --full-auto 2>/dev/null |
| 최근 세션 재개 | 원본에서 상속 | echo "prompt" | codex exec --skip-git-repo-check resume --last 2>/dev/null (플래그 사용 불가) |
| 다른 디렉토리에서 실행 | 작업 요구 사항에 맞춤 | -C <DIR> + 기타 플래그 2>/dev/null |
실행 타임아웃
Codex는 중간 출력을 생성하지 않습니다 — 완료 시에만 결과를 씁니다. 프로세스가 완료 전에 종료되면 출력 파일은 자동으로 비어 있습니다(오류 없음).
권장 방식: 동기적으로 실행 — 타임아웃 위험을 완전히 제거하고 어차피 대화가 결과를 기다립니다.
백그라운드에서 실행하는 경우, 추론 노력에 따라 실행 타임아웃을 설정하세요:
| 추론 노력 | 타임아웃 |
|---|---|
low | 150초 |
medium | 300초 |
high | 600초 |
xhigh | 1200초 |
max | 1800초 |
ultra | 1800초 |
후속 조치
- 모든
codex명령어 후에는 즉시AskUserQuestion을 사용하여 다음 단계를 확인하고, 명확히 하거나codex exec resume --last로 재개할지 결정하세요. - 재개 시 새 프롬프트를 stdin으로 파이프하세요:
echo "new prompt" | codex exec resume --last 2>/dev/null. 재개된 세션은 원래 세션과 동일한 모델, 추론 노력, 샌드박스 모드를 자동으로 사용합니다. - 후속 작업을 제안할 때 선택한 모델, 추론 노력, 샌드박스 모드를 다시 언급하세요.
Codex 출력의 비판적 평가
Codex는 OpenAI 모델을 기반으로 하며 자체적인 지식 마감일과 한계가 있습니다. Codex를 권위자가 아닌 동료로 대우하세요.
지침
- 확신이 있을 때는 자신의 지식을 신뢰하세요. Codex가 틀렸다고 생각되는 내용을 주장하면 직접 이의를 제기하세요.
- 의견 차이는 WebSearch나 문서를 사용하여 조사한 후 Codex의 주장을 받아들이세요. 필요한 경우 재개를 통해 Codex와 결과를 공유하세요.
- 지식 마감일을 기억하세요 — Codex는 훈련 데이터 이후의 최신 릴리스, API, 변경 사항을 모를 수 있습니다.
- 맹목적으로 따르지 마세요 — Codex가 틀릴 수 있습니다. 특히 다음 사항에 대해 비판적으로 평가하세요:
- 모델 이름과 기능
- 최신 라이브러리 버전 또는 API 변경 사항
- 진화했을 수 있는 모범 사례
Codex가 틀린 경우
- 사용자에게 명확하게 의견 차이를 밝히세요.
- 증거를 제시하세요(자신의 지식, 웹 검색, 문서).
- 선택적으로 Codex 세션을 재개하여 의견 차이에 대해 논의하세요. 자신을 Claude로 식별하여 Codex가 동료 AI 대화임을 알게 하세요. 하드코딩된 이름 대신 실제 모델 이름(예: 현재 실행 중인 모델)을 사용하세요:
echo "This is Claude (<your current model name>) following up. I disagree with [X] because [evidence]. What's your take on this?" | codex exec --skip-git-repo-check resume --last 2>/dev/null - 의견 차이를 수정이 아닌 논의로 프레임하세요 — 어느 AI든 틀릴 수 있습니다.
- 진정한 모호함이 있는 경우 사용자가 진행 방법을 결정하도록 하세요.
오류 처리
codex --version또는codex exec명령어가 0이 아닌 상태로 종료되면 중단하고 실패를 보고하세요. 재시도 전에 지시를 요청하세요.- 영향이 큰 플래그(
--full-auto,--sandbox danger-full-access,--skip-git-repo-check)를 사용하기 전에, 사용자가 이미 허가하지 않은 경우AskUserQuestion을 통해 허가를 요청하세요. - 출력에 경고 또는 부분 결과가 포함된 경우 요약하고
AskUserQuestion을 사용하여 조정 방법을 물어보세요.