처음 시작 지도

AI 코딩을 처음 시작할 때 많은 사람들이 “프롬프트에 뭐라고 써야 하지?”부터 고민합니다. 하지만 진짜 첫 번째 질문은 **“어디서 켜야 안전하고 빠른가?”**입니다.

터미널(CLI), VS Code 편집기(IDE 확장), 데스크톱 앱, 웹 브라우저(클라우드) 중 어디서 시키느냐에 따라 AI에게 쥐여주는 권한과 작업 속도가 완전히 달라집니다.

까만 터미널 창이 낯설다면: VS Code 편집기 안에서 열린 파일을 보며 가장 작은 수정부터 시작하면 됩니다.
내 컴퓨터 파일이 망가질까 봐 불안하다면: 클라우드 웹 환경에서 안전하게 격리된 상태로 조사를 시키면 됩니다.
가장 빠르고 통제된 결과를 원한다면: 터미널(CLI)에서 딱 4줄짜리 요청서로 실행하면 됩니다.

이 문서는 복잡한 설정 없이, 첫 10분 만에 내 프로젝트를 망가뜨리지 않고 가장 안전하게 첫 결과를 뽑아내는 시작 지도입니다.

이 문서를 읽으면

Codex를 켜는 장소별 차이(터미널, 편집기, 앱, 클라우드)를 단번에 이해합니다.
내 상황에 딱 맞는 첫 작업 위치를 고릅니다.
결과를 어떤 눈에 보이는 증거로 확인해야 하는지 배웁니다.

오늘 바로 해볼 일

새로운 대형 기능을 통째로 맡기지 않습니다. 파일 딱 하나에서 끝나는 오타 수정이나 간단한 테스트 보강을 고릅니다. 아래 10분 실습 쪽지처럼 실행 위치, 목표, 금지만 적어서 가볍게 맡깁니다.

처음 10분 실습

처음 작업은 복잡한 파이프라인 구축이 아니라 사람이 바로 확인할 수 있는 확인 가능한 결과입니다. 최근 도입된 저비용/고효율 모델(GPT-6 Luna)을 활용해 가볍고 빠르게 첫 작업을 테스트해보는 것을 권장합니다. 아래 빈칸을 채운 뒤 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 (인수인계)