OpenAI Codex CLI • 24 Verified Docs

Codex로 일하는 표준

AI가 코드를 바꾸면, 당신은 무엇을 믿고 합치나요?
요청·검증·인수인계를 하나의 표준으로 묶는 실전 플레이북입니다.

5분 실습 해보기 4단계 루프 보기

왜 시스템이 필요한가

자동완성에서 작업 운영으로

큰 프로젝트나 복잡한 버그 수정에서 AI를 어떻게 통제하고 리뷰해야 할지 고민이신가요? 프롬프트 대신 "맡기기 ➔ 고치기 ➔ 검증하기 ➔ 남기기"라는 확실한 작업 운영 파이프라인을 제안합니다.

맡기기

목표와 범위를 작게 자르고, 실행 표면을 먼저 고릅니다.

산출물: 작업 요청서

고치기

관계없는 리팩터링을 막고, 리뷰 가능한 diff로 만듭니다.

산출물: 패치 루프

검증하기

테스트, 빌드, 스크린샷, CI 결과로 말보다 증거를 남깁니다.

산출물: 검증 증거

남기기

다음 사람이나 다음 세션이 이어받을 수 있게 위험과 판단을 적습니다.

산출물: 인수인계 (handoff)

설치 없이 지금 바로

README 한 줄, 5분 안에 더 좋게

코드를 몰라도 됩니다. 가장 무해하고 결과가 바로 보이는 첫 경험부터 시작하세요. 아래 요청서를 복사해 Codex에게 붙여넣으면, 원문과 수정안을 나란히 보여줍니다.

10분 실습 복사해서 쓰는 첫 요청서

대상 파일: (예: README.md 또는 CHANGELOG.md)
목표: 위 파일에서 가장 어색하거나 불명확한 문장 하나를 더 명확하게 다듬기
허용 범위: 해당 파일 1개, 1~3줄 이내 수정
금지: 문서 구조 변경, 섹션 추가/삭제, 코드 수정
먼저 확인할 것: 현재 문서에서 가장 이해하기 어려운 부분이 어디인지 한 줄로 알려줘
수정 후: 원문과 수정안을 나란히 보여줘
남길 증거: 수정한 줄, 수정 이유 한 문장
중단 조건: 단어 뜻이 바뀌거나 사실이 달라지면 수정하지 말고 보고

받아야 할 완료 보고 (검증 증거)

수정 전 원문 1줄
수정 후 결과 1줄
수정 이유 한 문장
더 손볼 부분이 있다면 목록으로

✓ 복사되었습니다 (출처 포함)

30초

README 또는 문서 파일 하나 열기

아무 프로젝트의 README.md, CHANGELOG, 주석 한 줄도 충분합니다. 코드를 고치지 않아도 됩니다.
1분

아래 요청서 복사해서 붙여넣기

목표, 허용 범위, 금지 사항이 이미 채워져 있습니다. 파일 이름만 바꿔 Codex에 바로 넘기세요.
2-4분

결과물 확인하기

어떤 줄이 바뀌었는지 diff로 보여줍니다. 마음에 들면 저장, 아니면 거절 — 완전히 되돌릴 수 있습니다.
5분

이게 전부입니다

거창한 셋업이 없었죠? 이 패턴이 버그 수정, 기능 추가, CI 설정에도 그대로 확장됩니다.