Codex CLI 튜토리얼: 설치, 로그인부터 첫 작업까지
첫 세션에 필요한 모든 것: 설치와 로그인, 낯선 저장소 해설, full-auto 모드에서의 변경, 스크린샷을 동작하는 앱으로 재현하기. GPT-6 Sol과 Luna가 추가된 0.157.0 릴리스 기준으로 업데이트되었습니다.
Codex CLI 한눈에 보기
- npm install -g @openai/codex 한 번이면 설치 끝. ChatGPT 플랜이나 API 키로 로그인합니다.
- 언제나 통하는 첫 프롬프트: "explain this codebase to me and how do I run it?"
- --full-auto는 샌드박스 안에서 파일 편집과 명령 실행을 자동화합니다. 출시 데모에서는 프롬프트 하나로 다크 테마 전체를 완성했죠.
- 0.157.0은 카탈로그에 GPT-6 Sol과 Luna를 추가하고, Amazon Bedrock 지원과 세션을 다른 앱으로 포크하는 f 키를 제공합니다.
OpenAI Codex CLI
영상:OpenAI6:19
Codex CLI in 12 mins
영상:lustoykov12:14
openai/codex releases
체인지로그:GitHub changelog
이 페이지의 모든 스크린샷은 OpenAI 공식 Codex CLI 출시 녹화에서 가져왔습니다. 터미널과 브라우저 화면만 있으며 얼굴 출연 프레임은 없습니다. 명령·플래그·워크플로 세부는 두 번째 영상과 교차 확인했고, 릴리스 사실은 위의 공식 체인지로그에 근거합니다.
출처 영상: OpenAI의 "OpenAI Codex CLI"와 lustoykov의 "Codex CLI in 12 mins"(YouTube), 타임스탬프 딥링크로 연결됩니다. 페이지 본문은 오리지널입니다.
워크스루: 14단계
Codex CLI 설치 및 로그인
- 1
Codex CLI 전역 설치
Codex CLI는 npm으로 배포됩니다. 아무 터미널에서 npm install -g @openai/codex를 실행하세요. 유일한 선행 요건은 Node.js(없으면 nodejs.org에서). macOS에서는 brew install --cask codex도 가능합니다. CLI는 GitHub에서 Apache-2.0 오픈소스입니다.
- 2
Codex 실행하고 로그인
codex를 실행하면 첫 실행 때 로그인 절차가 시작됩니다. 기존 Plus·Pro·Business·Edu·Enterprise 플랜을 쓰려면 Sign in with ChatGPT(디바이스 코드 옵션도 있음), 종량제라면 자신의 API 키를 제공하세요. 브라우저가 로그인을 처리하고 터미널에 성공이 표시됩니다.
첫 작업: 코드베이스 해설시키기
- 3
저장소에서 Codex를 실행하고 가장 중요한 질문하기
아무 프로젝트에서 cd 후 codex를 다시 실행하면 이번엔 작업 세션이 시작됩니다. 입력 전에 헤더에 작업 디렉터리·모델·승인 모드가 표시됩니다. OpenAI 출시 데모의 대상은 openai-fm이었고 질문은 만능 한 줄: "explain this codebase to me and how do I run it?"
세션 헤더 확인, 질문 입력, Enter 순서입니다.1:27 보기 - 4
Codex가 돌려준 High-level overview 읽기
Codex는 파일을 읽고 구조적으로 답합니다. 저장소의 프레임워크와 스타일링 스택, 상태가 사는 곳, 오디오 생성 방식, 어떤 라우트가 선택 사항인지까지. 낯선 코드베이스에 가장 빨리 적응하는 방법입니다.
개요가 스택을 명시합니다: Next.js 15, React 19, Tailwind 4, Zustand.1:45 보기 - 5
Typical file map 파악하기
답변에는 파일 맵이 이어집니다. layout.tsx는 전역 HTML, page.tsx는 엔트리 페이지, api/는 서버 사이드 라우트. 다음 프롬프트부터는 모호한 설명 대신 실제 경로를 인용할 수 있습니다.
맵의 모든 경로는 다음 프롬프트에서 인용할 수 있는 컨텍스트입니다.1:50 보기 - 6
Codex가 써 준 실행 지침 따르기
같은 답변의 끝은 바로 복붙할 수 있는 런북입니다. Node 20+와 API 키, git clone과 npm install, .env.local에 OPENAI_API_KEY 한 줄, 그리고 npm run dev(next dev --turbopack)로 http://localhost:3000 방문. Codex 안에서도 ! 접두사로 셸 명령을 직접 실행할 수 있습니다.
clone부터 dev 서버까지 문서 열 필요가 없습니다.1:55 보기 - 7
라이트 모드의 대상 페이지 만나기
데모의 첫 편집은 방금 실행한 사이트의 테마 변경입니다. OpenAI.fm은 라이트 모드에서 보이스 카드, vibe 프리셋, 주황색 Play 버튼을 렌더링합니다. 현재 상태를 이만큼 정확히 아는 것이 다음 프롬프트를 먹히게 만듭니다.
변경 전: 라이트 모드, 보이스 카드, vibe 프리셋, 주황색 Play.1:15 보기
첫 변경: full-auto 모드로 다크 테마
- 8
full-auto로 재시작하고 정확한 프롬프트 보내기
종료 후 codex --full-auto로 재시작하고 변경을 지시합니다: "Implement dark mode based on system settings — make sure every surface adapts automatically, like buttons and toggles." full-auto에서는 Codex가 매번 묻지 않고 파일을 편집하고 명령을 실행합니다. OpenAI 데모의 설명으로는 네트워크 비활성화, 시작한 디렉터리로 샌드박스. 현재 빌드에서는 --ask-for-approval(untrusted·on-request·never)과 --sandbox(read-only·workspace-write·danger-full-access)로 노출됩니다.
- 9
결과 확인: 모든 표면이 따라옵니다
새로고침 한 번이면 사이트 전체가 다크로. 배경·카드·문자가 시스템 설정을 따르고, 데모 프롬프트는 Play 버튼 문구를 Introduce Codex로 바꾸는 것까지 처리했습니다. full-auto는 샌드박스 안이라 잘못된 편집도 작업 사본에만 닿습니다.
프롬프트 하나 뒤의 다크 모드. 버튼 문구도 함께 업데이트.3:05 보기
스크린샷에서 동작하는 앱으로
- 10
빈 폴더에서 처음부터 시작
스크린샷을 앱으로 바꾸기는 Codex의 시그니처 기술입니다. 빈 디렉터리를 만들고 모델·승인 모드·첨부를 한 줄로 지정해 실행하세요: codex -m o4-mini -a full-auto -i <스크린샷>. -i는 이미지 첨부, -a는 승인, -m은 모델 선택입니다.
한 명령으로 모델, 승인, 첨부 이미지를 모두 지정.3:50 보기 - 11
스크린샷을 Codex가 분석하게 두기
세션 헤더가 받은 것을 확인합니다. workdir, 모델, full-auto 승인, 이미지 경로. 그리고 첫 턴은 온전히 Thinking뿐으로, 코드는 아직 한 줄도 없습니다.
코드 작성 전에 헤더에 첨부 스크린샷이 표시됩니다.3:58 보기 - 12
확인 질문에 답하기
Codex는 추측 대신 Clarifying user intent 섹션으로 질문합니다. Python/OpenCV로 비슷한 것을 만들까요, thermal-vision 같은 특정 효과 구현이 궁금한가요, UI/레이아웃 가이던스가 필요한가요? 짧은 평문 답변이 모호한 스크린샷을 명세로 바꿉니다.
세 개의 질문 만에 스크린샷이 명세가 됩니다.4:00 보기 - 13
단일 파일 앱을 작성하는 장면 보기
명세가 정해지면 Codex는 apply_patch를 스트리밍하며 index.html을 위에서 아래로 생성합니다. devicePixelRatio로 크기를 맞춘 캔버스 그리드, 패널별 ctx.drawImage, 라이브 영상의 requestAnimationFrame, load 리스너. 마지막에 Done을 보고합니다.
패치는 Done으로 끝납니다. 앱 전체가 HTML 파일 하나입니다.4:42 보기 - 14
index.html을 열고 비교하기
Codex의 마무리는 레시피 그 자체입니다. 3×3 그리드의 아홉 캔버스, Sepia와 B&W부터 Comic Book, Thermal, X-Ray까지의 필터 라인업, Screen Orientation API로 가로 고정. 그리고 핵심 지시: HTTPS나 localhost에서 index.html을 열면 카메라가 동작합니다.
이 마무리 메시지가 생성된 앱의 README 역할을 합니다.4:50 보기
하우스 룰: AGENTS.md, 샌드박스, 기억할 명령어
/init을 실행하면 Codex가 저장소에 AGENTS.md를 생성합니다. 작업 전에 읽는 시스템 프롬프트 스타일 파일로, 네이밍·프레임워크·테스트 관례를 프로젝트 안에 두게 해 매 세션 반복 입력이 필요 없습니다.
이해할 두 다이얼은 승인과 격리입니다. /permissions는 세션 안의 전체 접근을 토글하고, --ask-for-approval(untrusted·on-request·never)과 --sandbox(read-only·workspace-write·danger-full-access)가 기본값을 정하며, ~/.codex/config.toml에 영구 저장됩니다. --yolo는 never 더하기 danger-full-access 조합입니다. 편리하지만 위험도 그대로입니다.
일상 주력: /model은 모델과 추론 강도를 바꾸고(medium이 무난, high는 토큰 소모), /plan은 요청을 검토 가능한 계획으로, /review는 커밋되지 않은 변경이나 브랜치를 감사하고, /compact는 긴 세션 후 컨텍스트를 비우며, /new는 깨끗한 대화를 시작합니다. TUI 밖에서는 codex exec "…"가 일회성 비대화 작업을, codex resume(또는 codex resume-last)이 닫힌 세션을 다시 엽니다. 파일은 @로 참조하고 스킬은 $로 로드합니다. 스킬은 설명 파일을 담은 폴더로 ~/.codex/skills에 설치됩니다.
Codex CLI 0.157.0 신규: GPT-6 Sol·Luna, Amazon Bedrock, 포크 키
0.157.0은 2026년 9월 25일 출시되었습니다. 공식 체인지로그에서 업데이트할 가치가 있는 다섯 가지:
- 1GPT-6 Sol과 Luna가 모델 카탈로그에 추가되었습니다. /model에서 다른 항목처럼 선택할 수 있습니다.
- 2Amazon Bedrock 지원이 도착했습니다. 새 모델의 Bedrock 카탈로그와 함께 오래된 모델 이름을 옮기는 마이그레이션 프롬프트도 포함됩니다.
- 3전체 화면 트랜스크립트가 기본 활성화되었고 Shift-click 텍스트 선택도 확장되었습니다.
- 4새 f 단축키는 열려 있는 대화를 다른 앱으로 포크하며 초안과 대기 중 프롬프트를 유지합니다.
- 5/import가 이제 원격 세션과 로컬 background-server 세션에서 동작합니다. 해당 대상 인터랙티브 세션에서는 background-server가 자동 시작됩니다.
어떤 모델을 고를까요? GPT-6 Sol은 상태 표시줄의 기본으로, 무거운 에이전틱 작업에 유지하세요. Luna는 '빠르고 저렴한 에이전틱 모델' 라벨대로 짧은 편집과 대량 실행에 적합하고, Terra는 그 사이의 균형형 일상 옵션입니다. /model로 전환하고, 모델별 추론 강도를 정하고, config.toml에 기본값을 고정하세요. 전체 전환 과정은 Codex 모델 피커 튜토리얼에 있습니다.