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를 사용합니다. - 이전 세션을 계속할 때는 stdin을 통해
codex exec --skip-git-repo-check resume --last를 사용합니다. 재개할 때 사용자가 모델이나 추론 수준을 명시적으로 요청하지 않는 한 구성 플래그를 사용하지 마세요. 재개 구문: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가 영원히 블로킹됩니다. 백그라운드 작업, 훅, 스크립트 등 stdin이 TTY가 아니지만 닫히지 않은 환경에서 호출할 때는 명시적으로 stdin을 리디렉션합니다: 명령어에</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가 잘못된 내용을 주장한다고 확신하면 직접 반박하세요.
- 불일치 사항을 조사하려면 Codex의 주장을 받아들이기 전에 WebSearch나 문서를 사용하세요. 필요한 경우 발견한 내용을 재개를 통해 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을 사용하여 조정 방법을 물어보세요.