처음 시작 지도

Codex를 잘 쓰는 첫 질문은 “무엇을 시킬까?”가 아닙니다. 먼저 어디서 실행할 일인지 정해야 합니다. 이 문서에서는 그 장소를 실행 표면이라고 부르되, 처음 읽을 때는 “실행 위치”라고 이해하면 됩니다. 같은 요청도 CLI, IDE extension, Codex app, Web/Cloud, GitHub/CI 중 어디에 놓이느냐에 따라 권한, 속도, 검증, 인계가 달라집니다.

이 문서를 읽으면

Codex를 켜는 장소별 차이를 이해합니다.
첫 작업을 CLI, IDE extension, Codex app, Web/Cloud 중 어디에 둘지 고릅니다.
결과를 어떤 증거로 확인해야 하는지 정합니다.

오늘 바로 해볼 일

지금 10분만 쓴다면 새 기능을 맡기지 말고, 파일 하나에서 끝나는 작은 문서 수정이나 테스트 보강을 고릅니다. 아래 실습처럼 실행 위치, 목표, 금지, 증거를 먼저 적은 뒤 CLI나 IDE에서 맡겨보세요.

처음 10분 실습

처음 성공은 “멋진 자동화”가 아니라 사람이 바로 확인할 수 있는 작은 결과입니다. 아래 빈칸을 채운 뒤 Codex에게 그대로 넘기면 됩니다.

내가 고른 파일:
실행 표면: CLI 또는 IDE extension
목표:
금지:
남길 증거: 바뀐 파일, 핵심 diff (변경점), 확인하지 못한 것

완료 보고에서 diff (변경점) 1개와 확인한 증거 1개를 받으면 성공입니다. 요청이 커지거나 secret (비밀값), 배포, 패키지 설치가 필요하다는 말이 나오면 여기서 멈추고 안전선과 승인으로 이동합니다.

실행 표면 빠른 판단

실행 표면	맡기기 좋은 작업	완료 증거
CLI	로컬 수정, 테스트 재현, 작은 리팩터링, 스크립트 자동화	diff (변경점), 명령 출력
IDE extension	열린 파일, 선택 영역, `@file` 맥락을 살린 구현	파일 변경점, 편집기 맥락
Codex app	여러 thread (작업 대화), 리뷰, worktree (작업 책상), automation (자동화) 운영	리뷰 메모, 작업 상태
Web/Cloud	긴 분석, 비동기 구현, 격리된 환경 작업, GitHub 연결 작업	클라우드 로그, PR 또는 handoff (인수인계)
GitHub/CI	PR 리뷰, CI 실패 분석, 릴리스 확인	리뷰 댓글, CI 재실행 결과

공식 실행 표면을 작업 언어로 읽기

공식 이름	플레이북에서 보는 기준
Codex app	여러 프로젝트와 thread (작업 대화)를 나란히 보고, worktree (작업 책상), 리뷰, 터미널 작업, automation (자동화), Skill (반복 절차)을 묶어 운영하는 곳
CLI	내 터미널에서 파일을 읽고 고치고 명령을 실행하는 로컬 작업 위치. Windows에서는 PowerShell 네이티브 sandbox와 WSL2를 목적에 맞게 고릅니다.
IDE extension	편집기 안의 열린 파일, 선택 영역, 명령 팔레트, slash command를 활용해 짧은 맥락으로 정확히 고치는 위치
Web/Cloud	GitHub 저장소와 연결해 백그라운드 작업, 환경 설정, 인터넷 접근 여부, PR 생성까지 다루는 위치
GitHub, Slack, Linear	이슈, PR, 대화에서 바로 작업을 만들 수 있지만, 권한과 알림 경로를 먼저 정해야 하는 통합 위치

쉬운 기준

내 컴퓨터에서 바로 확인해야 하면 CLI나 IDE extension으로 시작합니다.
여러 thread (작업 대화), worktree (작업 책상), 리뷰를 한곳에서 봐야 하면 Codex app으로 모읍니다.
긴 분석이나 병렬 작업이면 Codex app 또는 Web/Cloud로 보냅니다.
PR이나 CI와 연결된 작업이면 처음부터 리뷰와 CI 증거를 요구합니다.
인터넷 접근, 패키지 설치, 외부 서비스 호출이 필요하면 먼저 승인선을 둡니다.

첫 10분 선택표

첫 작업은 도구 탐색이 아니라 실행 표면 선택으로 시작합니다. 아래 표에서 하나를 고른 뒤, 작업 요청서 문서의 기본 구조로 넘기면 됩니다.

지금 상황	시작 위치	처음 10분에 할 일	끝났다는 증거
파일 하나를 고치고 바로 테스트할 수 있음	CLI 또는 IDE extension	관련 파일과 테스트를 읽고 작은 diff (변경점) 후보를 만듭니다.	수정 파일 목록, 실행한 명령, 실패/통과 결과
여러 파일 흐름을 먼저 이해해야 함	Codex app 또는 Web/Cloud	읽기 전용으로 진입점, 호출 흐름, 위험 파일을 요약합니다.	저장소 지도, 추정과 사실의 구분
PR을 리뷰해야 함	Codex app review 또는 GitHub	요약보다 회귀, 누락 테스트, 보안 위험을 먼저 찾습니다.	파일/라인이 있는 review note (리뷰 메모)
UI를 보고 고쳐야 함	CLI + 브라우저 확인	데스크톱/모바일 폭을 정하고 스크린샷 기준을 잡습니다.	전후 스크린샷, overflow 여부
반복 알림이나 자동화를 만들고 싶음	Codex app, Web/Cloud, CI	읽기/쓰기 권한, 실패 알림, 승인선을 먼저 적습니다.	실행 로그, 사람이 볼 요약, 중단 조건

이 표에서 바로 고르기 어렵다면 작업이 아직 너무 큽니다. “읽기 전용 조사”와 “수정 가능한 patch”를 분리한 뒤 다시 고릅니다.

공식 유스케이스를 작업 흐름으로 읽기

OpenAI 공식 유스케이스 페이지는 Codex를 “채팅창”이 아니라 실제 업무 흐름에 붙이는 예시를 모읍니다. 여기서 바로 복사할 것은 프롬프트 문장이 아니라 어떤 실행 표면, 어떤 입력, 어떤 완료 증거가 필요한가입니다.

공식 유스케이스 흐름	먼저 고를 실행 표면	플레이북에서 이어 볼 곳
프론트엔드 프로토타입, Figma나 스크린샷 기반 UI	IDE extension 또는 CLI + 브라우저 확인	`패치 루프`의 UI 검증
대형 코드베이스 이해, 여러 파일 리팩터링	CLI, Codex app, worktree (작업 책상)	`작업 요청서`, `병렬·클라우드 운영`
PR 리뷰, triage (버그 분류), QA	GitHub/CI, Codex app review	`패치 루프`, `안전선과 승인`
문서 최신화, 지식 정리, 회의·피드백 요약	Web/Cloud 또는 읽기 전용 CLI	`작업 요청서`, `자료 근거`
MCP, Slack, Linear 같은 앱 연결 자동화	Codex app, Web/Cloud, MCP	`병렬·클라우드 운영`, `팀 도입`
목표(goal)처럼 오래 가는 작업 추적	Codex app 또는 Cloud	`병렬·클라우드 운영`, `쉬운 용어집`

처음에는 “가장 멋진 기능”보다 가장 작은 완료 증거를 고릅니다. 예를 들어 UI는 스크린샷, 리팩터링은 테스트, 문서화는 업데이트된 링크와 근거, 자동화는 실패 시 사람이 볼 요약이 있어야 합니다.

자주 실패하는 장면

로컬 비밀정보가 필요한 작업을 클라우드에 그대로 넘깁니다.
IDE에 열린 파일만 보고 저장소 전체 흐름을 놓칩니다.
CLI에서 끝날 작은 패치를 클라우드 작업으로 과하게 보냅니다.
CI에서만 재현되는 실패를 로컬 문제처럼 고칩니다.

남길 증거

선택한 실행 표면과 이유
실행한 명령 또는 클라우드 작업 로그
수정된 diff (변경점) 범위
검증 결과
다음 사람이 이어받을 handoff (인수인계)