Ch10. Codex App/IDE

Codex는 데스크톱 앱(Codex App), IDE 확장, CLI 세 가지 인터페이스를 제공합니다. 각 인터페이스는 동일한 config/skills/MCP 설정을 공유하면서, 사용 맥락에 맞는 최적의 UX를 제공합니다.

Codex App (macOS & Windows 데스크톱)

Codex App은 멀티에이전트 병렬 작업에 최적화된 데스크톱 앱입니다.

핵심 기능

• 프로젝트별 스레드 관리: 사이드바에서 프로젝트 전환, 각 스레드가 독립 컨텍스트 유지
• Git 워크트리: 여러 에이전트가 같은 레포에서 충돌 없이 병렬 작업(격리된 브랜치)
• 인라인 diff 리뷰: 에이전트 변경사항을 앱 내에서 리뷰, 코멘트, 스테이지/리버트
• 스레드별 터미널: 각 스레드에서 독립적으로 테스트·빌드·스크립트 실행
• 자동화(Automations): Skills와 연동한 백그라운드 작업, 인박스에 결과 수집
• Plan Mode: 복잡한 변경을 읽기 전용으로 분석한 뒤 사용자와 논의 후 실행

운영 팁

• 워크트리 활용: 각 에이전트가 독립 워크트리에서 작업하므로, 메인 브랜치 오염 없이 여러 접근을 동시 시도
• Auto Context: IDE 확장과 공유되는 자동 컨텍스트로, 열린 파일/커서 위치 등이 연동
• 앱 ↔ CLI 연동: codex app <path>로 CLI에서 앱 전환, 설정은 동기화

IDE 확장

모드(권한) 이해

IDE 확장은 기본적으로 Auto(Agent) 모드로 동작합니다.

/permissions로 세션 중 모드 전환이 가능합니다.

웹 검색(web search) 기본값

IDE 확장에는 1st-party 웹 검색 도구가 포함되어 있으며, 기본은 캐시 모드입니다. Full Access에서는 live 모드로 동작할 수 있으므로, web_search 설정으로 팀 정책을 명시하세요.

Cloud 위임

IDE에서 장시간 작업을 Codex Cloud로 위임할 수 있습니다. 진행 상황을 모니터링하고, 완료 시 diff를 로컬에 적용하는 워크플로우를 지원합니다.

Steering/Resume API (0.99.0~0.107.0)

앱 서버를 직접 붙여 쓰는 고급 팀이라면, 최근 릴리스의 steering/resume 계열 API를 꼭 봐야 합니다.

• active turn steering: 진행 중인 turn에 중간 지시를 넣어 방향을 조정
• resume_agent / thread resume: 연결이 끊겨도 agent 재개가 쉬움
• approval/input 상태 복원: 재연결 시 승인 대기나 추가 입력 대기 상태까지 복원
• notification opt-out / feature discovery: 내부 UI를 만들 때 필요한 이벤트만 구독 가능

이 기능은 "긴 작업을 멈추고 다시 시키는" 대신, 실행 중인 세션을 안전하게 계속 조정하는 데 가치가 있습니다.

이미지 드래그&드롭

스크린샷/디자인 이미지를 프롬프트에 바로 넣어 맥락 전달이 빨라집니다. CLI에서도 codex -i screenshot.png "설명" 형태로 이미지 첨부가 가능합니다.

prompt history recall + /title (0.117.0)

• prompt history recall: app-server TUI에서 세션 간 prompt history recall이 동작해 반복 프롬프트 재사용이 쉬워졌습니다
• /title terminal-title picker: classic TUI와 app-server TUI 모두에서 터미널 제목을 분명하게 설정할 수 있어, 여러 세션을 병렬로 띄우는 팀에 유용합니다

Codex App 26.312: 테마 & 자동화 개편 (2026-03-12)

테마 커스터마이징

Codex App에서 외관을 자유롭게 변경할 수 있게 되었습니다.

• 베이스 테마 선택: 라이트/다크 등 기본 테마 중 선택
• 색상 조정: 액센트, 배경, 전경 색상을 개별 조정
• 폰트 변경: UI 폰트와 코드 폰트를 각각 설정
• 테마 공유: 커스텀 테마를 팀원과 공유 가능

팀에서는 "팀 표준 테마"를 만들어 공유하면 스크린샷·화면 공유 시 일관된 환경을 유지할 수 있습니다.

자동화(Automations) 개편

자동화 기능이 대폭 강화되었습니다.

• 로컬 vs 워크트리 실행 선택: 자동화 작업을 메인 워킹 디렉토리에서 할지, 격리된 워크트리에서 할지 선택
• 커스텀 추론 수준/모델: 자동화별로 reasoning effort와 모델을 독립 지정
• 템플릿 기반 발견: 자동화 템플릿에서 영감을 얻어 빠르게 시작

Codex App 26.415: 작업 공간 확장 (2026-04-16)

26.415는 앱을 "코드 편집기 보조 UI"에서 작업 공간 전체를 다루는 워크벤치 쪽으로 밀어 올린 릴리즈입니다.

검증/리뷰 표면 확장

• in-app browser: 로컬 개발 서버, 파일 기반 프리뷰, 로그인 없는 공개 페이지를 앱 안에서 열고 코멘트 가능
• PR sidebar workflow: GitHub PR을 사이드바에서 보고 diff/comment를 검토한 뒤 Codex에게 후속 수정과 검증을 계속 맡길 수 있음
• artifact viewer: PDF, spreadsheet, document, presentation 같은 생성 산출물을 사이드바에서 미리보기
• Memories: 반복되는 선호와 프로젝트 관례를 다음 스레드로 가져오는 메모리 surface가 더 전면화됨

시작/추적/지속 실행 UX

• Chats: 프로젝트 폴더 없이 스레드를 시작할 수 있어 리서치·기획·분석 작업 진입 비용이 낮아짐
• thread automations: 같은 스레드를 스케줄에 따라 다시 깨워 follow-up loop를 이어감
• task sidebar: plan, sources, generated artifacts, summary를 한곳에서 추적
• context-aware suggestions: 작업 시작 시점과 복귀 시점에 후속 액션 추천

환경/플랫폼 확장

• SSH remote connections alpha: 앱에서 원격 호스트 프로젝트를 직접 열어 작업 가능
• multiple terminals / multi-window: 병렬 실행과 분리된 확인 흐름을 더 쉽게 관리
• Intel Mac support + new plugins: Apple Silicon 외 Mac 지원이 넓어지고 플러그인 surface가 확장

Codex App 26.423: 브라우저·리뷰 워크플로우 심화 (2026-04-23)

26.423는 26.415에서 열린 작업 공간을 실제 검증/코멘트 루프까지 밀어붙인 릴리즈입니다.

브라우저 surface 현실화

• browser cookies 유지: 로그인된 프리뷰나 세션 기반 QA를 더 현실적으로 재현할 수 있음
• browser use 지원: 브라우저 상호작용을 작업 흐름 안에서 직접 다룰 수 있음
• browser on popout windows: 분리된 브라우저 창에서도 같은 워크플로우를 이어갈 수 있음

리뷰/산출물 흐름 확장

• diff reviewer comments: diff reviewer가 코멘트를 직접 남길 수 있어, 단순 확인을 넘어 리뷰 협업이 가능
• direct images to thread: 스크린샷/디자인 레퍼런스를 더 빨리 붙일 수 있음
• slides generate/edit + Figma integration: 코드 외 산출물을 앱 안에서 바로 만들고 수정하는 surface가 넓어짐

지속 실행 UX

• continue current task from notification: 알림에서 현재 task를 바로 이어가도록 진입 비용이 줄어듦
• automatic approval review: 승인 요청 전에 subagent review를 자동 실행하는 흐름이 앱 UX와 연결됨

Codex for Chrome: 로그인 브라우저 작업 (2026-05-07)

Chrome 확장은 Codex가 사용자의 로그인된 Chrome 상태가 필요한 웹사이트에서 작업하게 해줍니다. Salesforce, Gmail, LinkedIn, 사내 어드민처럼 plugin이나 in-app browser만으로는 부족한 작업에 적합합니다.

운영 기준은 명확히 분리하세요.

• in-app browser 우선: localhost, file preview, 로그인 없는 공개 페이지 검증
• plugin 우선: GitHub, Slack, Google Drive처럼 전용 integration이 있는 업무
• Chrome 확장 사용: 로그인 상태, 실제 브라우저 프로필, 탭 그룹 기반 병렬 작업이 꼭 필요한 경우

Codex Windows 앱 출시 (2026-03-04)

macOS에 이어 Windows 네이티브 앱이 출시되었습니다.

• 네이티브 에이전트 샌드박스: 제한된 토큰, 파일시스템 ACL, 전용 격리 환경
• PowerShell 지원: Windows 개발 환경에 최적화
• 크로스 플랫폼 세션 동기화: ChatGPT 계정 기반으로 macOS/Windows 간 세션 이동
• 모든 ChatGPT 플랜 지원: Plus, Pro, Go, Free 모두 사용 가능

App 26.305 (2026-03-05)

• 원격 연결 개선: 오류 메시지와 상태 표시가 더 명확해짐
• Windows 통합 터미널에서 복사/붙여넣기 단축키 수정
• 보관된 고정 스레드가 사이드바에 다시 나타나는 버그 수정

$ 멘션 피커 개선 (0.114.0)

작성기에서 $를 입력하면 나타나는 멘션 피커가 개선되었습니다.

• 카테고리 라벨: Skills, Apps, Plugins가 명확히 구분 표시되어, 원하는 항목을 빠르게 찾을 수 있습니다
• 번들 시스템 스킬 비활성화: config에서 번들 시스템 스킬을 끌 수 있는 스위치가 추가되어, 팀에서 허용하는 스킬만 피커에 노출 가능
• 기존 @ 파일 첨부와 $ 멘션을 조합하면, 컨텍스트+도구를 한 프롬프트에 정밀하게 지정할 수 있습니다

배포 상태 엔드포인트: healthz/readyz (0.114.0)

WebSocket 기반 app-server 배포 환경에서 헬스 체크 엔드포인트가 추가되었습니다.

• GET /readyz: 서버가 요청을 받을 준비가 되었는지 확인(프로브용)
• GET /healthz: 서버가 정상 동작 중인지 확인(라이브니스 체크)
• Kubernetes, ECS 등 오케스트레이터에서 readiness/liveness probe로 직접 연결 가능
• 기존에는 커스텀 헬스 체크를 만들어야 했던 부분이 1st-party로 해결됨

팀에서 app-server를 직접 운영한다면, 배포 파이프라인에 이 엔드포인트를 즉시 연결하세요.

Handoff 시 실시간 트랜스크립트 전달 (0.114.0)

에이전트 간 Handoff 시 실시간 트랜스크립트 컨텍스트가 함께 전달됩니다. 이전에는 handoff 후 새 에이전트가 이전 대화 맥락을 잃는 문제가 있었으나, 이제 진행 중이던 대화 흐름이 자연스럽게 이어집니다.

고급 팁(시니어용)

• @로 파일 첨부: 작성기에서 @ 입력 → 퍼지 검색 → Tab/Enter로 삽입
• $로 도구 멘션: 작성기에서 $ 입력 → Skills/Apps/Plugins 카테고리별 선택
• 선택 영역 기반 컨텍스트: 필요한 부분만 컨텍스트로 추가
• 변경 검증 루틴: diff 확인 → 테스트 → 요약 순서 고정
• 세션 분리: 리팩토링/버그 수정 세션을 분리해 품질 유지
• Enter 중 주입: 실행 중에 Enter를 눌러 추가 지시를 중간에 삽입 가능
• 이전 메시지 편집: 빈 작성기에서 Esc 두 번 → 이전 사용자 메시지 편집
• Fast/Standard 구분: 최신 TUI는 세션 헤더에 Fast/Standard를 보여주므로, 리뷰/민감 작업은 Standard로 내리는 규칙을 두기 좋음

참고 문서

• Codex App: https://developers.openai.com/codex/app (영어)
• Codex IDE 개요: https://developers.openai.com/codex/ide (영어)
• IDE 설정: https://developers.openai.com/codex/ide/settings (영어)
• IDE 기능(Cloud Tasks): https://developers.openai.com/codex/ide/features (영어)
• config 기본(web_search): https://developers.openai.com/codex/config-basic (영어)