처음 시작 지도

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

이 문서를 읽으면

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

오늘 바로 해볼 일

작은 문서 수정이나 테스트 하나를 고르는 것부터 시작합니다. 목표, 수정 범위, 금지할 행동, 확인할 증거를 한 줄씩 적은 뒤 CLI나 IDE에서 맡겨보세요.

실행 표면 빠른 판단

실행 표면	맡기기 좋은 작업	닫히는 증거
CLI	로컬 패치, 테스트 재현, 작은 리팩터링, 스크립트 자동화	diff, command output
IDE extension	열린 파일, 선택 영역, @file 맥락을 살린 구현	file diff, editor context
Codex app	여러 thread, review, worktree, automation, in-app browser 운영	review note, task state
Web/Cloud	긴 분석, 비동기 구현, 격리된 환경 작업, GitHub 연결 작업	cloud log, PR 또는 handoff
GitHub/CI	PR 리뷰, CI 실패 분석, 릴리스 확인	review comments, CI rerun

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

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

쉬운 기준

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

자주 실패하는 장면

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

남길 증거

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

공식 문서

• Codex app
• Codex CLI
• Codex Web
• Codex use cases